認証スキーム - AWS SDKsとツール

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

認証スキーム

注記

設定ページのレイアウトの理解、または以下の AWS SDKs「」を参照してくださいこのガイドの設定ページについて

AWS サービスは、 AWS 署名バージョン 4 (SigV4) や AWS 署名バージョン 4a (SigV4a) など、複数の認証スキームをサポートしています。デフォルトでは、SDK はサービスモデル定義に基づいて認証スキームを選択し、最適な互換性を提供するスキームを優先します。ただし、特定の要件に合わせて最適化するために、優先する認証スキームを設定できます。

SigV4 とは異なり、SigV4a で署名されたリクエストは複数の AWS リージョンで有効です。SigV4a は、クロスリージョンリクエスト署名により可用性を強化し、リージョンの中断時にバックアップリージョンへの自動フェイルオーバーを可能にします。これは、 AWS Identity and Access Management や Amazon CloudFront などのグローバルサービスに特に役立ちます。

これらの 2 つの認証スキームの詳細については、「IAM ユーザーガイド」の「API リクエストに対するAWS Signature Version 4」を参照してください。

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

auth_scheme_preference - 共有 AWS configファイル設定
AWS_AUTH_SCHEME_PREFERENCE - 環境変数
aws.authSchemePreference - JVM システムプロパティ: Java/Kotlin のみ

優先する認証スキームのカンマ区切りリストを優先する順に指定します。サービスが複数の認証スキームをサポートしている場合、SDK は指定された順序でこのリストのスキームを使用しようとし、優先するスキームが利用できない場合はデフォルトの動作に戻ります。

デフォルト値: なし。

有効な値: 次の 1 つ以上のカンマ区切りリスト。

  • sigv4 – Signature Version 4 (最速のパフォーマンス、単一リージョン)

  • sigv4a – Signature Version 4a (可用性の向上、クロスリージョンサポート、SigV4 よりも署名パフォーマンスが遅い)

  • httpBearerAuth – HTTP ベアラートークン認証

スキーム名間のスペース文字とタブ文字は無視されます。

config ファイルにこの値を設定して SigV4a を優先する例を以下に示します。

[default] auth_scheme_preference=sigv4a,sigv4
sigv4a_signing_region_set - 共有 AWS configファイル設定
AWS_SIGV4A_SIGNING_REGION_SET - 環境変数

SigV4a マルチリージョン署名 AWS リージョン 用の のカンマ区切りリストを指定します。これは、SigV4a が選択された認証スキームである場合に、リクエストのデフォルトのリージョンセットとして使用されます。

デフォルト値: リクエストによって決定されます。

有効な値: AWS リージョンのカンマ区切りリスト。リージョン間のスペース文字とタブ文字は無視されます。

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

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