¡Se AWS SDK para .NET ha publicado la versión 4 (V4) del!

Para empezar a usar la nueva versión del SDK, consulte la Guía para desarrolladores AWS SDK para .NET (V4), especialmente el tema sobre la migración a la versión 4.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso del archivo de AWS credenciales compartido

(Asegúrese de revisar las advertencias y las directrices de credenciales importantes).

Una forma de proporcionar credenciales para las aplicaciones consiste en crear perfiles en el archivo de credenciales de AWS compartido y, a continuación, almacenar las credenciales en esos perfiles. Este archivo puede ser utilizado por el otro AWS SDKs. También lo pueden usar los AWS CLI AWS kits de herramientas de Visual Studio y VS Code. AWS Tools for Windows PowerShellJetBrains

Información general

De forma predeterminada, el archivo de AWS credenciales compartidas se encuentra en el .aws directorio de su directorio principal y tiene un nombrecredentials, es decir, ~/.aws/credentials (Linux o macOS) o %USERPROFILE%\.aws\credentials (Windows). Para obtener información sobre ubicaciones alternativas, consulte Ubicación de los archivos compartidos en la Guía de referencia de herramientas AWS SDKs y herramientas. Consulte también Acceso a las credenciales y perfiles en una aplicación.

El archivo de AWS credenciales compartidas es un archivo de texto sin formato y tiene un formato determinado. Para obtener información sobre el formato de los archivos de AWS credenciales, consulte Formato del archivo de credenciales en la Guía de referencia de AWS SDKs and Tools.

Puede administrar los perfiles del archivo de AWS credenciales compartido de varias maneras.

Ejemplos de administración de perfiles

En las siguientes secciones se muestran ejemplos de perfiles en el archivo de AWS credenciales compartidas. Algunos de los ejemplos muestran el resultado, que se puede obtener mediante cualquiera de los métodos de administración de credenciales mencionados anteriormente. En otros ejemplos se muestra cómo utilizar un método en particular.

El perfil predeterminado.

El archivo de AWS credenciales compartidas casi siempre tendrá un perfil denominado default. Aquí es donde AWS SDK para .NET busca las credenciales si no hay otros perfiles definidos.

El perfil [default] suele parecerse a lo siguiente.

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

Creación de un perfil mediante programación

En este ejemplo, se muestra cómo crear un perfil y guardarlo en el archivo de AWS credenciales compartidas mediante programación. Utiliza las siguientes clases de Amazon.Runtime. CredentialManagementespacio de nombres: CredentialProfileOptions, y. CredentialProfileSharedCredentialsFile

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

Este es el perfil que se ha creado en este ejemplo.

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

Actualización de un perfil existente mediante programación

En este ejemplo se muestra cómo actualizar mediante programación el perfil que creado anteriormente. Utiliza las siguientes clases de Amazon.Runtime. CredentialManagementespacio de nombres: y. CredentialProfileSharedCredentialsFile También usa la RegionEndpointclase del espacio de nombres 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 continuación se muestra el perfil actualizado.

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