작업할 기본 설정 AWS 서비스 - AWS SDK for Java 1.x

The AWS SDK for Java 1.x는 2024년 7월 31일부터 유지 관리 모드로 전환되었으며 2025년 12월 31end-of-support일에 도달할 예정입니다. 새로운 기능, 가용성 개선 사항 및 보안 업데이트를 AWS SDK for Java 2.x 계속 받으려면 로 마이그레이션하는 것이 좋습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

작업할 기본 설정 AWS 서비스

개요

를 AWS 서비스 사용하여 에 액세스하는 애플리케이션을 성공적으로 개발하려면 AWS SDK for Java다음 조건이 필요합니다.

  • AWS IAM Identity Center에서 사용할 수 있는 AWS 액세스 포털에 로그인할 수 있어야 합니다.

  • 에 대해 구성된 IAM 역할의 권한은 애플리케이션에 필요한 AWS 서비스 에 대한 액세스를 허용SDK해야 합니다. PowerUserAccess AWS 관리형 정책과 연결된 권한은 대부분의 개발 요구 사항에 충분합니다.

  • 다음 요소가 포함된 개발 환경

중요

이 설정 섹션의 지침은 사용자 또는 조직이 IAM Identity Center를 사용한다고 가정합니다. 조직에서 IAM Identity Center와 독립적으로 작동하는 외부 자격 증명 공급자를 사용하는 경우 JavaSDK에서 사용할 임시 자격 증명을 가져오는 방법을 알아봅니다. 이 지침에 따라 ~/.aws/credentials 파일에 임시 자격 증명을 추가하세요.

자격 증명 공급자가 ~/.aws/credentials 파일에 임시 자격 증명을 자동으로 추가하는 경우 또는 에 프로필 이름을 제공할 필요가 [default] 없도록 프로필 이름이 인지 확인합니다SDK AWS CLI.

AWS 액세스 포털에 로그인 기능

AWS 액세스 포털은 IAM Identity Center에 수동으로 로그인하는 웹 위치입니다. 의 형식은 d-xxxxxxxxxx.awsapps.com/start또는 URL입니다your_subdomain.awsapps.com/start.

AWS 액세스 포털에 익숙하지 않은 경우 AWS SDKs 및 도구 참조 가이드의 IAM Identity Center 인증 주제 1단계의 계정 액세스 지침을 따르세요. AWS SDK for Java 1.x는 2단계에서 설명하는 에 대한 임시 보안 인증 정보의 자동 토큰 새로 고침 및 자동 검색을 지원하지 않으므로 2SDK단계를 따르지 마세요.

공유 구성 파일 설정

공유 구성 파일은 개발 워크스테이션에 상주하며 모든 AWS SDKs 및 AWS Command Line Interface ()에서 사용하는 기본 설정을 포함합니다CLI. 공유 구성 파일에는 여러 설정이 포함될 수 있지만 이 지침은 에서 작동하는 데 필요한 기본 요소를 설정합니다SDK.

공유 config 파일 설정

다음 예제에서는 config 파일의 내용을 보여 줍니다.

[default] region=us-east-1 output=json

개발 목적으로 코드를 실행하려는 위치에 AWS 리전 가장 가까운 를 사용합니다. config 파일에 사용할 지역 코드 목록은 Amazon Web Services 일반 참조 가이드를 참조하세요. 출력 형식에 대한 json 설정은 가능한 여러 값 중 하나입니다.

이 섹션의 지침에 따라 config 파일을 생성하세요.

에 대한 임시 자격 증명 설정 SDK

AWS 액세스 포털을 통해 AWS 계정 및 IAM 역할에 액세스한 후 가 액세스할 SDK 수 있는 임시 보안 인증 정보로 개발 환경을 구성합니다.

임시 자격 증명으로 로컬 credentials 파일을 설정하는 단계
  1. 공유 credentials 파일 생성.

  2. credentials 파일에 동작하는 임시 보안 인증을 붙여 넣을 때까지 다음의 자리 표시자 텍스트를 붙여 넣습니다.

    [default] aws_access_key_id=<value from AWS access portal> aws_secret_access_key=<value from AWS access portal> aws_session_token=<value from AWS access portal>
  3. 파일을 저장합니다. 이제 파일 ~/.aws/credentials이 로컬 개발 시스템에 존재해야 합니다. 이 파일에는 이름이 지정된 특정 프로파일이 지정되지 않은 경우 Java용 가 사용하는 [기본값] 프로파일이 포함되어 있습니다. SDK

  4. AWS 액세스 포털 에 로그인합니다.

  5. 수동 자격 증명 새로 고침 제목의 다음 지침에 따라 AWS 액세스 포털에서 IAM 역할 자격 증명을 복사합니다.

    1. 연결된 지침의 4단계에서 개발 요구 사항에 대한 액세스 권한을 부여하는 IAM 역할 이름을 선택합니다. 이 역할에는 일반적으로 PowerUserAccess 또는 개발자 와 같은 이름이 있습니다.

    2. 7단계에서 AWS 보안 인증 파일에 수동으로 프로필 추가 옵션을 선택하고 내용을 복사합니다.

  6. 복사한 자격 증명을 로컬 credentials 파일에 붙여넣고 붙여넣은 프로필 이름을 모두 제거합니다. 파일은 다음과 유사해야 합니다.

    [default] aws_access_key_id=AKIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
  7. credentials 파일을 저장합니다.

SDK for Java는 서비스 클라이언트를 생성하고 각 요청에 사용할 때 이러한 임시 보안 인증 정보에 액세스합니다. 5a단계에서 선택한 IAM 역할의 설정에 따라 임시 보안 인증이 유효한 기간이 결정됩니다. 최대 유효 기간은 12시간입니다.

임시 보안 인증이 만료되면 4~7단계를 반복합니다.

Java 개발 환경을 설치합니다.

AWS SDK for Java V1에는 Java 7 JDK 이상이 필요합니다. 버전 1.12.767 이하를 사용하는 경우 Java 7을 사용할 SDK수 있지만 버전 1.12.768 이상 을 사용하는 경우 SDKJava 8이 필요합니다. Maven 중앙 리포지토리에는 JavaSDK용 의 최신 버전이 나열됩니다.

Oracle Java SE 개발 키트Amazon Corretto , Red Hat OpenJDKAdoptium 과 같은 Open Java 개발 키트(Open JDK) 배포와 함께 AWS SDK for Java 작동합니다.