A versão 4 (V4) do SDK para .NET está em pré-visualização! Para ver informações sobre essa nova versão na versão prévia, consulte o Guia do desenvolvedor AWS SDK para .NET (versão 4).
Observe que a V4 do SDK está em versão prévia, portanto, seu conteúdo está sujeito a alterações.
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á.
Resolução de perfil e credenciais
Ele AWS SDK para .NET pesquisa as credenciais em uma determinada ordem e usa o primeiro conjunto disponível para o aplicativo atual.
Ordem de pesquisa de credencial
-
Credenciais que são definidas explicitamente no cliente do AWS serviço, conforme descrito em. Acessar credenciais e perfis em um aplicativo
nota
Esse tópico está na seção Considerações especiais porque não é o método preferencial para especificar credenciais.
-
Um perfil de credenciais com o nome especificado por um valor emAWSConfigs. AWSProfileNome.
-
Um perfil de credenciais com o nome especificado pela variável de ambiente
AWS_PROFILE. -
O perfil de credenciais
[default]. -
Sessões AWSCredentials criadas a partir das variáveis de
AWS_SESSION_TOKENambienteAWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY,, e, se todas não estiverem vazias. -
Básicos AWSCredentials que são criados a partir das variáveis de
AWS_SECRET_ACCESS_KEYambienteAWS_ACCESS_KEY_IDe, se ambas não estiverem vazias. -
Metadados da EC2 instância Amazon.
Se seu aplicativo estiver sendo executado em uma EC2 instância da Amazon, como em um ambiente de produção, use uma função do IAM conforme descrito emConceder acesso utilizando um perfil do IAM. Caso contrário, como em testes de pré-lançamento, armazene suas credenciais em um arquivo que usa o formato de arquivo de AWS credenciais ao qual seu aplicativo web tem acesso no servidor.
Resolução do perfil
Com dois mecanismos de armazenamento de credenciais diferentes, é importante entender como configurá-los AWS SDK para .NET para usá-los. AWSConfigsA. AWSProfilesA propriedade de localização controla como AWS SDK para .NET ele encontra perfis de credenciais.
| AWSProfilesLocal | Comportamento da resolução do perfil |
|---|---|
|
nulo (não definido) ou vazio |
Pesquise na SDK Store se a plataforma for compatível e, em seguida, pesquise o arquivo de credenciais compartilhado da AWS
no local padrão. Se o perfil não estiver em nenhum desses locais, busque |
|
O caminho para um arquivo no formato de arquivo de AWS credenciais |
Pesquise somente o arquivo especificado para um perfil com o nome especificado. |
Usar credenciais da conta de usuário federado
Os aplicativos que usam o AWS SDK para .NET (AWSSDK.Core
Suporte ao acesso federado significa que usuários podem se autenticar usando o Active Directory. São concedidas credenciais temporárias ao usuário automaticamente. Essas credenciais temporárias, válidas por uma hora, são usadas quando seu aplicativo invoca serviços AWS . O SDK faz o gerenciamento das credenciais temporárias. Para contas de usuário associados a um domínio, se o aplicativo realizar uma chamada mas as credenciais expiraram, o usuário é reautenticado automaticamente e são concedidas novas credenciais. (Para non-domain-joined contas, o usuário é solicitado a inserir as credenciais antes da reautenticação.)
Para usar esse suporte em seu aplicativo.NET, você deve primeiro configurar o perfil da função usando um PowerShell cmdlet. Para saber como, consulte a documentação do AWS Tools for Windows PowerShell.
Depois de configurar o perfil da função, faça referência ao perfil em seu aplicativo. Há várias maneiras de fazer isso, uma delas é usando AWSConfigso. AWSProfileNomeie a propriedade da mesma forma que você faria com outros perfis de credenciais.
A AWS Security Token Servicemontagem (AWSSDK. SecurityToken
Especificar funções ou credenciais temporárias
Para aplicativos executados em EC2 instâncias da Amazon, a maneira mais segura de gerenciar credenciais é usar funções do IAM, conforme descrito emConceder acesso utilizando um perfil do IAM.
Para cenários do aplicativo em que o executável do software está disponível para usuários de fora da organização, recomendamos que você projete o software para usar credenciais de segurança temporárias. Além de fornecer acesso restrito aos AWS recursos, essas credenciais têm a vantagem de expirar após um período de tempo especificado. Para obter mais informações sobre as credenciais de segurança temporárias, consulte:
Usar credenciais de proxy
Se seu software se comunicar AWS por meio de um proxy, você poderá especificar as credenciais para o proxy usando a ProxyCredentials propriedade da Config classe de um serviço. A classe Config de um serviço normalmente faz parte do namespace primário do serviço. Os exemplos incluem o seguinte: AmazonCloudDirectoryConfigna Amazon. CloudDirectorynamespace e AmazonGameLiftConfigna Amazon. GameLiftnamespace.
Para o Amazon S3, por exemplo, você pode usar um código semelhante ao seguinte, onde SecurelyStoredUserName e SecurelyStoredPassword são o nome de usuário e a senha do proxy especificados em um NetworkCredential
AmazonS3Config config = new AmazonS3Config();
config.ProxyCredentials = new NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword);nota
Versões anteriores do SDK utilizavam ProxyUsername e ProxyPassword, mas estas propriedades estão obsoletas.
