AWS アクセスキー

警告

セキュリティリスクを避けるため、専用ソフトウェアの開発や実際のデータを扱うときは、IAM ユーザーを認証に使用しないでください。代わりに、AWS IAM Identity Center などの ID プロバイダーとのフェデレーションを使用してください。

AWS IAM ユーザーの アクセスキーを AWS 認証情報として使用できます。 AWS SDK は自動的にこれらの AWS 認証情報を使用して API リクエストに署名するため AWS、ワークロードは AWS リソースとデータに安全かつ便利にアクセスできます。認証情報が一時的なもので、有効期限が切れると無効になるように、常に aws_session_token を使用することをおすすめします。長期認証情報の使用はお勧めしません。

注記

AWS がこれらの一時的な認証情報を更新できない場合、ワークロードに影響が及ばないように認証情報の有効性 AWS を拡張できます。

共有 AWS credentialsファイルは、アプリケーションソースディレクトリの外部で安全であり、共有configファイルの SDK 固有の設定とは別のものであるため、認証情報を保存するために推奨される場所です。

AWS 認証情報とアクセスキーの使用の詳細については、IAM ユーザーガイドのAWS 「セキュリティ認証情報」と「IAM ユーザーのアクセスキーの管理」を参照してください。

この機能を設定するには、以下のように使用します。

aws_access_key_id - 共有 AWS configファイル設定

aws_access_key_id - 共有 AWS credentialsファイル設定 （推奨メソッド）

AWS_ACCESS_KEY_ID - 環境変数

aws.accessKeyId - JVM システムプロパティ: Java/Kotlin のみ

ユーザーを認証するための認証情報の一部として使用される AWS アクセスキーを指定します。

aws_secret_access_key - 共有 AWS configファイル設定

aws_secret_access_key - 共有 AWS credentialsファイル設定 （推奨メソッド）

AWS_SECRET_ACCESS_KEY - 環境変数

aws.secretAccessKey - JVM システムプロパティ: Java/Kotlin のみ

ユーザーを認証するための認証情報の一部として使用される AWS シークレットキーを指定します。

aws_session_token - 共有 AWS configファイル設定

aws_session_token - 共有 AWS credentialsファイル設定 （推奨メソッド）

AWS_SESSION_TOKEN - 環境変数

aws.sessionToken - JVM システムプロパティ: Java/Kotlin のみ

ユーザーを認証するための認証情報の一部として使用される AWS セッショントークンを指定します。この値は、ロールを引き受けるリクエストが正常に終了すると返される一時的な認証情報の一部として受け取ります。セッショントークンは、一時的なセキュリティ認証情報を手動で指定する場合にのみ必要です。ただし、長期の認証情報ではなく、一時的なセキュリティ認証情報を常に使用することをお勧めします。セキュリティの推奨事項については、「IAM でのセキュリティのベストプラクティス」を参照してください。

これらの値を取得する方法については、「短期認証情報を使用した AWS SDKs認証」を参照してください。

config または credentials ファイルに必要な値を設定する例を以下に示します。

[default]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token = AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk

Linux/macOS のコマンドラインによる環境変数の設定の例を以下に示します。

export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_SESSION_TOKEN=AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk

Windows のコマンドラインによる環境変数の設定の例を以下に示します。

setx AWS_ACCESS_KEY_ID AKIAIOSFODNN7EXAMPLE
setx AWS_SECRET_ACCESS_KEY wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
setx AWS_SESSION_TOKEN AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk

AWS SDKsとツールによるサポート

以下の SDK は、このトピックで説明する機能と設定をサポートします。部分的な例外があれば、すべて記載されています。JVM システムプロパティ設定は、 AWS SDK for Java と AWS SDK for Kotlin でのみサポートされます。

SDK	サポート	注意または詳細情報
AWS CLI v2	はい
SDK for C++	はい	共有 config ファイルはサポートされていません。
SDK for Go V2 (1.x)	はい
SDK for Go 1.x (V1)	はい	共有 config ファイル設定を使用するには、設定ファイルからの読み込みを有効にする必要があります。「セッション」を参照してください。
SDK for Java 2.x	はい
SDK for Java 1.x	はい
SDK for JavaScript 3.x	はい
SDK for JavaScript 2.x	はい
SDK for Kotlin	はい
SDK for .NET 4.x	はい
SDK for .NET 3.x	はい
SDK for PHP 3.x	はい
SDK for Python (Boto3)	はい
SDK for Ruby 3.x	はい
SDK for Rust	はい
SDK for Swift	はい
PowerShell V5 のツール	はい
PowerShell V4 のツール	はい	環境変数はサポートされていません。