A versão 4 (V4) do AWS SDK para .NET foi lançada!

Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o tópico de migração.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Compartilhado AWS arquivo de credenciais

(Assegure-se de revisar os avisos e orientações importantes para credenciais.)

Uma forma de fornecer credenciais para seus aplicativos é criar perfis no arquivo de credenciais compartilhado da AWS e, em seguida, armazenar as credenciais nesses perfis. Esse arquivo pode ser usado pelos outros AWS SDKs. Ele também pode ser usado pelo AWS CLI AWS Tools for Windows PowerShell, pelo e pelos AWS kits de ferramentas para Visual Studio e VS Code. JetBrains

Informações gerais

Por padrão, o arquivo de AWS credenciais compartilhadas está localizado no .aws diretório do seu diretório inicial e tem um nomecredentials, ou seja, ~/.aws/credentials (Linux ou macOS) ou %USERPROFILE%\.aws\credentials (Windows). Para obter informações sobre locais alternativos, consulte Localização dos arquivos compartilhados no Guia de referência de SDKs e ferramentas da AWS.

O arquivo de AWS credenciais compartilhadas é um arquivo de texto sem formatação e segue um determinado formato. Para obter informações sobre o formato dos arquivos de AWS credenciais, consulte Formato do arquivo de credenciais no Guia de referência de AWS SDKs e ferramentas.

Você pode gerenciar os perfis no arquivo de AWS credenciais compartilhado de várias maneiras.

Exemplos de gerenciamento de perfil

As seções a seguir mostram exemplos de perfis no arquivo de AWS credenciais compartilhadas. Alguns dos exemplos mostram o resultado, que pode ser obtido através de qualquer um dos métodos de gerenciamento de credenciais descritos anteriormente. Outros exemplos mostram como usar um método específico.

O perfil padrão.

O arquivo de AWS credenciais compartilhadas quase sempre terá um perfil chamado default. É aqui que AWS SDK para .NET ele procura credenciais se nenhum outro perfil for definido.

O perfil [default] geralmente é parecido com o mostrado a seguir.

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

Criar um perfil de forma programática

Este exemplo mostra como criar um perfil e salvá-lo no arquivo de AWS credenciais compartilhadas de forma programática. Ele usa as seguintes classes do Amazon.Runtime.CredentialManagement namespace: CredentialProfileOptions CredentialProfile, e. 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);
}

A seguir está o perfil que foi criado por este exemplo.

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

Atualizar um perfil existente de forma programática

Este exemplo mostra como atualizar de forma programática o perfil que foi criado anteriormente. Ele usa as seguintes classes do Amazon.Runtime.CredentialManagement namespace: e. CredentialProfile SharedCredentialsFile Ele também usa a RegionEndpoint classe do namespace Amazon.

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);
    }
}

A seguir está o perfil atualizado.

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

Como seu aplicativo usa esse arquivo