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

共有 AWS 認証情報ファイルの使用

(認証情報に関する重要な警告とガイダンスを必ずご確認ください)

アプリケーションに認証情報を提供する方法の 1 つは、共有 AWS 認証情報ファイルにプロファイルを作成し、そのプロファイルに認証情報を保存することです。このファイルは、他の AWS SDK で使用できます。また、AWS CLI、AWS Tools for Windows PowerShell、AWS toolkits for Visual Studio、JetBrains、VS Code でも使用できます。

一般情報

共有 AWS 認証情報ファイルは、デフォルトではホームディレクトリ内の .aws ディレクトリに credentials という名前で配置されます。すなわち、~/.aws/credentials (Linux または macOS) または %USERPROFILE%\.aws\credentials (Windows) です。別の保存場所に関する詳細については、AWS SDK とツールのリファレンスガイドの「共有ファイルの場所」を参照してください。また、「アプリケーションでの認証情報とプロファイルへのアクセス」も参照してください。

共有 AWS 認証情報ファイルはプレーンテキストファイルで、特定の形式に従います。AWS 認証情報ファイルの形式の詳細については、AWS SDK とツールのリファレンスガイドの「認証情報ファイルの形式」を参照してください。

共有 AWS 認証情報ファイルのプロファイルは、いくつかの方法で管理できます。

プロファイル管理の例

以下のセクションでは、共有 AWS 認証情報ファイル内のプロファイルの例を示します。いくつかの例では、前述の認証情報管理方法のいずれかを使用して取得できる結果が示されています。その他の例では、特定のメソッドの使用方法を示しています。

デフォルトのプロファイル

共有 AWS 認証情報ファイルにはほとんどの場合、default という名前のプロファイルがあります。ここは、他のプロファイルが定義されていない場合に AWS SDK for .NET が認証情報を検索する場所です。

[default] プロファイルは通常、以下のようになっています。

[default]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

プログラムでのプロファイルの作成

この例では、プログラムを使用してプロファイルを作成し、共有 AWS 認証情報ファイルに保存する方法を説明します。Amazon.Runtime.CredentialManagement 名前空間の次のクラスを使用します: CredentialProfileOptions、CredentialProfile、SharedCredentialsFile。

using Amazon.Runtime.CredentialManagement;
...

// Do not include credentials in your code.
WriteProfile("my_new_profile", SecurelyStoredKeyID, SecurelyStoredSecretAccessKey);
...

void WriteProfile(string profileName, string keyId, string secret)
{
    Console.WriteLine($"Create the [{profileName}] profile...");
    var options = new CredentialProfileOptions
    {
        AccessKey = keyId,
        SecretKey = secret
    };
    var profile = new CredentialProfile(profileName, options);
    var sharedFile = new SharedCredentialsFile();
    sharedFile.RegisterProfile(profile);
}

この例で作成されたプロファイルを以下に示します。

[my_new_profile]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

既存のプロファイルのプログラムでの更新

この例では、前の手順で作成したプロファイルをプログラムで更新する方法を示します。Amazon.Runtime.CredentialManagement 名前空間の次のクラスを使用します: CredentialProfile、SharedCredentialsFile。また、Amazon 名前空間の RegionEndpoint クラスも使用します。

using Amazon.Runtime.CredentialManagement;
...

AddRegion("my_new_profile", RegionEndpoint.USWest2);
...

void AddRegion(string profileName, RegionEndpoint region)
{
    var sharedFile = new SharedCredentialsFile();
    CredentialProfile profile;
    if (sharedFile.TryGetProfile(profileName, out profile))
    {
        profile.Region = region;
        sharedFile.RegisterProfile(profile);
    }
}

更新されたプロファイルを以下に示します。

[my_new_profile]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
region=us-west-2