のデフォルトの認証情報プロバイダーチェーン AWS SDK for Java 2.x

のデフォルトの認証情報プロバイダーチェーンは、事前定義された場所のシーケンスで AWS 認証情報 AWS SDK for Java 2.x を自動的に検索するため、アプリケーションは認証情報ソースを明示的に指定 AWS のサービス せずに で認証できます。

デフォルトの認証情報プロバイダーチェーンは DefaultCredentialsProvider クラスによって実装されます。さまざまな場所で設定をチェックする他の認証情報プロバイダーの実装に順次委任されます。必要な設定要素をすべて見つけることができる最初の認証情報プロバイダーは、チェーンを終了します。

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

// Any external Region configuration is overridden.
// The SDK uses the default credentials provider chain because no specific credentials provider is specified.
Region region = Region.US_WEST_2;
DynamoDbClient ddb = 
    DynamoDbClient.builder()
                  .region(region)
                  .build();

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

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

コードDefaultCredentialsProviderで を使用する

コードでデフォルトの認証情報プロバイダーチェーンを明示的に使用できます。これは、 SDK がDefaultCredentialsProviderデフォルトで を使用するため、認証情報プロバイダーをまったく指定しないことと機能的に同等です。ただし、明示的に使用すると、コードがより読みやすくなり、自己文書化されます。デフォルトの認証情報チェーンを使用する意図を明確に示しています。

import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;

public class ExplicitDefaultCredentialsExample {
    public static void main(String[] args) {
        // Explicitly create the DefaultCredentialsProvider.
        DefaultCredentialsProvider defaultCredentialsProvider = DefaultCredentialsProvider
                                                                    .builder().build();

        // Use it with any service client.
        S3Client s3Client = S3Client.builder()
            .region(Region.US_WEST_2)
            .credentialsProvider(defaultCredentialsProvider)
            .build();

        // Now you can use the client with the default credentials chain.
        s3Client.listBuckets();
    }
}

デフォルトの認証情報プロバイダーを構築するときに、より多くの設定を指定できます。

DefaultCredentialsProvider customizedProvider = DefaultCredentialsProvider.builder()
    .profileName("custom-profile")  // Use a specific profile if the chain gets to the `ProfileCredentialsProvider` stage.
    .asyncCredentialUpdateEnabled(true)  // Enable async credential updates.
    .build();

このアプローチにより、デフォルトの認証情報チェーンの利便性を維持しながら、より細かく制御できます。