

 O [Guia de referência da API do AWS SDK para JavaScript V3](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) descreve em detalhes todas as operações da API para o AWS SDK para JavaScript versão 3 (V3). 

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á.

# Definir credenciais no Node.js
<a name="setting-credentials-node"></a>

Recomendamos que novos usuários que estejam se desenvolvendo localmente e que não recebam um método de autenticação do empregador se configurem Centro de Identidade do AWS IAM. Para obter mais informações, consulte [Autenticação do SDK com AWS](getting-your-credentials.md).

Há várias maneiras em Node.js de fornecer as credenciais para o SDK. Algumas dessas são mais seguras e outras oferecem mais comodidade durante o desenvolvimento de aplicativos. Ao obter credenciais em Node.js, tome cuidado ao confiar em mais de uma origem, como uma variável de ambiente e um arquivo JSON carregado. Altere as permissões em que o código é executado sem perceber a alteração que aconteceu.

AWS SDK para JavaScript A V3 fornece uma cadeia de provedores de credenciais padrão no Node.js, portanto, você não precisa fornecer um provedor de credenciais explicitamente. A [cadeia de fornecedores de credenciais](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html#credentialProviderChain) padrão tenta resolver as credenciais de várias fontes diferentes em uma determinada precedência, até que uma credencial seja retornada de uma das fontes. [Você pode encontrar a cadeia de fornecedores de credenciais do SDK for JavaScript V3 aqui.](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromnodeproviderchain)

## Cadeia de provedores de credenciais
<a name="credchain"></a>

Todos SDKs têm uma série de locais (ou fontes) que eles verificam para obter credenciais válidas para usar para fazer uma solicitação a um AWS service (Serviço da AWS). Depois que as credenciais válidas são encontradas, a pesquisa é interrompida. Essa busca sistemática é chamada de cadeia de provedores de credenciais padrão. 

Para cada etapa da cadeia, há várias maneiras de atribuir os valores. A definição de valores diretamente no código sempre tem precedência, seguida pela configuração como variáveis de ambiente e, em seguida, no AWS `config` arquivo compartilhado. Para obter mais informações, consulte [Precedência de configurações](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html#precedenceOfSettings) no *Guia AWS SDKs de referência de ferramentas*. 

O *Guia de Referência de Ferramentas AWS SDKs e Ferramentas* tem informações sobre as configurações do SDK usadas por todos AWS SDKs e pelo AWS CLI. Para saber mais sobre como configurar o SDK por meio do AWS `config` arquivo compartilhado, consulte Arquivos de [configuração e credenciais compartilhados](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html). Para saber mais sobre como configurar o SDK por meio da definição de variáveis de ambiente, consulte [Suporte a variáveis de ambiente](https://docs.aws.amazon.com/sdkref/latest/guide/environment-variables.html).

Para se autenticar AWS, ele AWS SDK para JavaScript verifica os provedores de credenciais na ordem listada na tabela a seguir.



- **[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromenv](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromenv) **
  - **Fornecedor(es) de credenciais disponíveis:** AWS chaves de acesso a partir de variáveis de ambiente
  - ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [AWS chaves de acesso](https://docs.aws.amazon.com/sdkref/latest/guide/feature-static-credentials.html)

- **[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromsso](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromsso)**
  - **Fornecedor(es) de credenciais disponíveis:** Centro de Identidade do AWS IAM. Neste guia, consulte [Autenticação do SDK com AWS](getting-your-credentials.md).
  - ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Fornecedor de credenciais do IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html)

- ** [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromini](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromini) **
  - **Fornecedor(es) de credenciais disponíveis:** AWS chaves de acesso de `credentials` arquivos compartilhados `config` e / ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [AWS chaves de acesso](https://docs.aws.amazon.com/sdkref/latest/guide/feature-static-credentials.html)
  - **Fornecedor(es) de credenciais disponíveis:** Provedor de entidades confiável (como `AWS_ROLE_ARN`) / ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Assumir um perfil do IAM](https://docs.aws.amazon.com/sdkref/latest/guide/feature-assume-role-credentials.html#credOrSourceAssumeRole)
  - **Fornecedor(es) de credenciais disponíveis:** Token de identidade da Web de AWS Security Token Service (AWS STS) / ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Federar com identidade da Web ou OpenID Connect](https://docs.aws.amazon.com/sdkref/latest/guide/feature-assume-role-credentials.html#webidentity)
  - **Fornecedor(es) de credenciais disponíveis:** Credenciais do Amazon Elastic Container Service (Amazon ECS) / ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Provedor de credenciais de contêiner](https://docs.aws.amazon.com/sdkref/latest/guide/feature-container-credentials.html)
  - **Fornecedor(es) de credenciais disponíveis:** Credenciais do perfil de instância do Amazon Elastic Compute Cloud (Amazon EC2) (provedor de credenciais IMDS) / ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Provedor de credenciais do IMDS](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html)
  - **Fornecedor(es) de credenciais disponíveis:** Provedor de credenciais de processo / ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Provedor de credenciais de processo](https://docs.aws.amazon.com/sdkref/latest/guide/feature-process-credentials.html)
  - **Fornecedor(es) de credenciais disponíveis:** AWS Central de identidade do IAM / ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Fornecedor de credenciais do IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html)
  - **Fornecedor(es) de credenciais disponíveis:** Provedor de credenciais de login / ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Provedor de credenciais de login](https://docs.aws.amazon.com/sdkref/latest/guide/access-login.html)

- ** [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromlogincredentials](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromlogincredentials) **
  - **Fornecedor(es) de credenciais disponíveis:** Provedor de credenciais de login
  - ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Provedor de credenciais de login](https://docs.aws.amazon.com/sdkref/latest/guide/access-login.html)

- **[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromprocess](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromprocess)**
  - **Fornecedor(es) de credenciais disponíveis:** Provedor de credenciais de processo
  - ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Provedor de credenciais de processo](https://docs.aws.amazon.com/sdkref/latest/guide/feature-process-credentials.html)

- **[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromtokenfile](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromtokenfile)**
  - **Fornecedor(es) de credenciais disponíveis:** Token de identidade da Web de AWS Security Token Service (AWS STS)
  - ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Federar com identidade da Web ou OpenID Connect](https://docs.aws.amazon.com/sdkref/latest/guide/feature-assume-role-credentials.html#webidentity)

- **[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromcontainermetadata-and-frominstancemetadata](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromcontainermetadata-and-frominstancemetadata)**
  - **Fornecedor(es) de credenciais disponíveis:** Credenciais do Amazon Elastic Container Service (Amazon ECS)
  - ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Provedor de credenciais de contêiner](https://docs.aws.amazon.com/sdkref/latest/guide/feature-container-credentials.html)

- **[https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromcontainermetadata-and-frominstancemetadata](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-credential-providers/#fromcontainermetadata-and-frominstancemetadata)**
  - **Fornecedor(es) de credenciais disponíveis:** Credenciais do perfil de instância do Amazon Elastic Compute Cloud (Amazon EC2) (provedor de credenciais IMDS)
  - ***AWS SDKs Guia de referência de ferramentas e ferramentas*:** [Provedor de credenciais do IMDS](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html)



Se você seguiu a abordagem recomendada para novos usuários começarem, configurou a autenticação do Centro de Identidade do AWS IAM durante a [Autenticação do SDK com AWS](getting-your-credentials.md) do tópico Conceitos básicos. Outros métodos de autenticação são úteis para situações diferentes. Para evitar riscos de segurança, recomendamos sempre usar credenciais de curto prazo. Para outros procedimentos de método de autenticação, consulte [Autenticação e acesso](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) no *AWS SDKs Guia de referência de ferramentas*.

Os tópicos nesta seção descrevem como carregar credenciais em Node.js.

**Topics**
+ [Cadeia de provedores de credenciais](#credchain)
+ [Carregar credenciais de perfis do IAM no Node.js para o Amazon EC2](loading-node-credentials-iam.md)
+ [Carregar credenciais de uma função do Lambda do Node.js](loading-node-credentials-lambda.md)