AWS SDK for Java 1.x는 2025년 12월 31일에 end-of-support되었습니다. 새로운 기능, 가용성 개선 및 보안 업데이트를 계속 받으려면 [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html)로 마이그레이션하는 것이 좋습니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 작업을 위한 기본 설정 AWS 서비스
## 개요
를 AWS 서비스 사용하여에 액세스하는 애플리케이션을 성공적으로 개발하려면 다음 AWS SDK for Java조건이 필요합니다.
+ AWS IAM Identity Center에서 사용할 수 있는 [AWS 액세스 포털에 로그인](#setup-awsaccount)할 수 있어야 합니다.
+ SDK에 대해 구성된 [IAM 역할의 권한](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html)은 AWS 서비스 애플리케이션에 필요한에 대한 액세스를 허용해야 합니다. **PowerUserAccess** AWS 관리형 정책과 연결된 권한은 대부분의 개발 요구 사항에 충분합니다.
+ 다음 요소가 포함된 개발 환경
+ 다음과 같은 방식으로 설정된 [공유 구성 파일](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html):
+ `config` 파일에는를 지정하는 기본 프로필이 포함되어 있습니다 AWS 리전.
+ `credentials` 파일에는 기본 프로필의 일부인 임시 자격 증명이 들어 있습니다.
+ [Java의 적절한 설치](#java-dg-java-env).
+ [Maven](https://maven.apache.org/download.cgi) 또는 [Gradle](https://gradle.org/install/)과 같은 [빌드 자동화 도구](setup-build-tools.md).
+ 코드 작업을 위한 텍스트 편집기.
+ (선택 사항이지만 권장됨) [IntelliJ IDEA](https://www.jetbrains.com/idea/download/#section=windows), [Eclipse](https://www.eclipse.org/ide/) 또는 [NetBeans](https://netbeans.org/downloads/)와 같은 IDE(통합 개발 환경).
IDE를 사용하는 경우 보다 쉽게 작업할 수 있도록 AWS Toolkit를 통합할 수도 있습니다 AWS 서비스. [AWS Toolkit for IntelliJ](https://docs.aws.amazon.com/toolkit-for-jetbrains/latest/userguide/welcome.html) 및 [AWS Toolkit for Eclipse](https://docs.aws.amazon.com/toolkit-for-eclipse/v1/user-guide/welcome.html)는 Java 개발에 사용할 수 있는 두 가지 툴킷입니다.
**중요**
이 설정 섹션의 지침에서는 사용자 또는 조직이 IAM Identity Center를 사용한다고 가정합니다. 조직에서 IAM Identity Center와 독립적으로 작동하는 외부 ID 공급자를 사용하는 경우 Java용 SDK에 사용할 임시 자격 증명을 얻는 방법을 알아보세요. [이 지침](#setup-temp-creds)에 따라 `~/.aws/credentials` 파일에 임시 자격 증명을 추가하세요.
ID 제공자가 임시 자격 증명을 `~/.aws/credentials` 파일에 자동으로 추가하는 경우 SDK 또는 AWS CLI에 프로필 이름을 제공할 필요가 없도록 프로필 이름을 `[default]`으로 지정해야 합니다.
## AWS 액세스 포털 로그인 기능
AWS 액세스 포털은 IAM Identity Center에 수동으로 로그인하는 웹 위치입니다. URL 형식은 `d-xxxxxxxxxx.awsapps.com/start` 또는 `your_subdomain.awsapps.com/start`입니다.
AWS 액세스 포털에 익숙하지 않은 경우 AWS SDKs 및 도구 참조 안내서[의 IAM Identity Center 인증 주제 1단계](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html#idcGettingStarted)의 계정 액세스 지침을 따르세요. AWS SDK for Java 1.x는 2단계에서 설명하는 SDK에 대한 임시 자격 증명의 자동 토큰 새로 고침 및 자동 검색을 지원하지 않으므로 2단계를 따르지 마십시오.
## 공유 구성 파일 설정
공유 구성 파일은 개발 워크스테이션에 있으며 AWS SDKs 및 AWS Command Line Interface (CLI)에서 사용하는 기본 설정을 포함합니다. 공유 구성 파일에는 [여러 설정](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html)이 포함될 수 있지만 이 지침에서는 SDK를 사용하는 데 필요한 기본 요소를 설정합니다.
### 공유 `config` 파일 설정
다음 예제에서는 `config` 파일의 내용을 보여 줍니다.
```
[default]
region=us-east-1
output=json
```
개발을 위해 코드를 실행하려는 위치에 AWS 리전 [가장 가까운](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)를 사용합니다. `config` 파일에 사용할 [지역 코드 목록](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes)은 Amazon Web Services 일반 참조 가이드를 참조하세요. 출력 형식에 대한 `json` 설정은 [가능한 여러 값](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html) 중 하나입니다.
[이 섹션의](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) 지침에 따라 `config` 파일을 생성하세요.
### SDK용 임시 보안 인증을 설정합니다.
AWS 액세스 포털을 통해 AWS 계정 및 IAM 역할에 액세스한 후 SDK가 액세스할 수 있는 임시 자격 증명으로 개발 환경을 구성합니다.
**임시 자격 증명으로 로컬 `credentials` 파일을 설정하는 단계**
1. [공유 `credentials` 파일 생성](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html).
1. `credentials` 파일에 동작하는 임시 보안 인증을 붙여 넣을 때까지 다음의 자리 표시자 텍스트를 붙여 넣습니다.
```
[default]
aws_access_key_id=
aws_secret_access_key=
aws_session_token=
```
1. 파일을 저장합니다. 이제 파일 `~/.aws/credentials`이 로컬 개발 시스템에 존재해야 합니다. 이 파일에는 이름이 지정된 특정 프로필이 지정되지 않은 경우 Java용 SDK에서 사용하는 [[기본] 프로필](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile)이 들어 있습니다.
1. [AWS 액세스 포털에 로그인합니다](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosignin.html).
1. [수동 자격 증명 새로 고침](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) 제목 아래의 다음 지침에 따라 AWS 액세스 포털에서 IAM 역할 자격 증명을 복사합니다.
1. 링크된 지침의 4단계에서 개발 요건에 액세스 권한을 부여하는 IAM 역할 이름을 선택합니다. 이 역할은 일반적으로 **PowerUserAccess** 또는 **Developer**와 같은 이름을 갖습니다.
1. 7단계에서 ** AWS 보안 인증 파일에 수동으로 프로필 추가** 옵션을 선택하고 내용을 복사합니다.
1. 복사한 자격 증명을 로컬 `credentials` 파일에 붙여넣고 붙여넣은 프로필 이름을 모두 제거합니다. 파일은 다음과 유사해야 합니다.
```
[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
```
1. `credentials` 파일을 저장합니다.
Java용 SDK는 서비스 클라이언트를 생성할 때 이러한 임시 보안 인증에 액세스하여 각 요청에 사용합니다. 5a단계에서 선택한 IAM 역할 설정에 따라 [임시 보안 인증의 유효 기간](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtosessionduration.html)이 결정됩니다. 최대 유효 기간은 12시간입니다.
임시 보안 인증이 만료되면 4\$17단계를 반복합니다.
## Java 개발 환경을 설치합니다.
AWS SDK for Java V1에는 Java 7 JDK 이상이 필요하며 모든 Java LTS(장기 지원) JDK 버전이 지원됩니다. SDK 버전 1.12.767 이하를 사용하는 경우 Java 7을 사용할 수 있지만, SDK 버전 1.12.768 이상을 사용하는 경우 Java 8이 필요합니다. [Maven 중앙 리포지토리](https://central.sonatype.com/artifact/com.amazonaws/aws-java-sdk-bom)에 최신 버전의 SDK for Java가 나열되어 있습니다.
는 [Oracle Java SE 개발 키트](https://www.oracle.com/java/technologies/downloads/) 및 [Amazon Corretto](https://aws.amazon.com/corretto), Red Hat OpenJDK, [Adoptium](https://adoptium.net/)과 같은 Open Java 개발 키트(OpenJDK) 배포판과 함께 AWS SDK for Java 작동합니다. [ OpenJDK](https://developers.redhat.com/products/openjdk/overview)