デフォルトの認証情報プロバイダーチェーン

デフォルトの認証情報プロバイダーチェーンは、 DefaultCredentialsProvider クラスによって実装されます。一時的な認証情報を提供するデフォルト構成を設定できる箇所を順番に確認し、最初に設定した構成を選択します。

デフォルトの認証情報プロバイダーチェーンを使用して一時的な認証情報を指定するには、サービスクライアントビルダーを作成しますが、認証情報プロバイダーを指定しないでください。次のコードスニペットでは、デフォルトの認証情報プロバイダーチェーンを使用してデフォルトの設定を検索して取得する DynamoDbClient を作成します。

Region region = Region.US_WEST_2;
DynamoDbClient ddb = 
    DynamoDbClient.builder()
                  .region(region)
                  .build();

認証情報の設定の取得順序

SDK for Java 2.x のデフォルトの認証情報プロバイダーチェーンは、事前定義されたシーケンスを使用して、環境内の設定を検索します。

1. Java のシステムプロパティ

   • SDK は SystemPropertyCredentialsProvider クラスを使用して、aws.accessKeyId、、aws.secretAccessKeyおよび aws.sessionTokenJava システムプロパティから一時的な認証情報をロードします。

     注記

     Java システムプロパティの設定方法の詳細については、Java Tutorials の公式ウェブサイトにあるシステムプロパティのチュートリアルを参照してください。

2. 環境変数

   • SDK は EnvironmentVariableCredentialsProvider クラスを使用して、AWS_ACCESS_KEY_ID、、AWS_SECRET_ACCESS_KEYおよび AWS_SESSION_TOKEN環境変数から一時的な認証情報をロードします。

3. からのウェブ ID トークン AWS Security Token Service

   • SDK は WebIdentityTokenFileCredentialsProvider クラスを使用して、Java システムプロパティまたは環境変数から一時的な認証情報をロードします。

4. 共有 credentials および config ファイル

   • SDK は ProfileCredentialsProviderを使用して、共有 credentialsおよび config ファイルの[default]プロファイルから IAM Identity Center シングルサインオン設定または一時的な認証情報をロードします。

     AWS SDKs およびツールリファレンスガイドには、SDK for Java が IAM Identity Center シングルサインオントークンと連携して、SDK が を呼び出すために使用する一時的な認証情報を取得する方法に関する詳細情報が記載されています AWS サービス。

     注記

     credentials および configファイルは、さまざまな AWS SDKsおよびツールによって共有されます。詳細については、「 AWS SDKs and Tools リファレンスガイド」の「.aws/credentials and .aws/config files」を参照してください。

5. Amazon ECS コンテナ認証情報

   • SDK は ContainerCredentialsProvider クラスを使用して、 AWS_CONTAINER_CREDENTIALS_RELATIVE_URIシステム環境変数から一時的な認証情報をロードします。

6. Amazon EC2 IAM ロールから提供された インスタンスの認証情報

   • SDK は InstanceProfileCredentialsProvider クラスを使用して、 Amazon EC2 メタデータサービスから一時的な認証情報をロードします。