Provedores de credenciais

v2: CredentialProviderChain no Node.js resolve a credencial das fontes na seguinte ordem:

Se um dos provedores de credenciais acima não conseguir resolver a credencial da AWS, a cadeia voltará para o próximo provedor até que uma credencial válida seja resolvida, e a cadeia gerará um erro quando todos os provedores falharem.

Nos runtimes do Browser e do React Native, a cadeia de credenciais está vazia e as credenciais devem ser definidas explicitamente.

v3: defaultProvider. As fontes de credenciais e a ordem de fallback não mudam na v3. Também oferece suporte a credenciais do Centro de Identidade do AWS IAM.

v2: ChainableTemporaryCredentials representa credenciais temporárias recuperadas do AWS.STS. Sem nenhum parâmetro extra, as credenciais serão obtidas da operação AWS.STS.getSessionToken(). Se um perfil do IAM for fornecido, a operação AWS.STS.assumeRole() será usada para buscar credenciais para o perfil. AWS.ChainableTemporaryCredentials difere de AWS.TemporaryCredentials em como as masterCredentials e as atualizações são tratadas. AWS.ChainableTemporaryCredentials atualiza as credenciais expiradas usando as masterCredentials passadas pelo usuário para oferecer suporte ao encadeamento de credenciais STS. No entanto, AWS.TemporaryCredentials reduz recursivamente as masterCredentials durante a instanciação, impedindo a capacidade de atualizar credenciais que exigem credenciais intermediárias temporárias.

O TemporaryCredentials original foi substituído por ChainableTemporaryCredentials na v2.

v3: fromTemporaryCredentials. Você pode chamar fromTemporaryCredentials() do pacote @aws-sdk/credential-providers. Veja um exemplo abaixo:

import { FooClient } from "@aws-sdk/client-foo";
import { fromTemporaryCredentials } from "@aws-sdk/credential-providers"; // ES6 import
// const { FooClient } = require("@aws-sdk/client-foo");
// const { fromTemporaryCredentials } = require("@aws-sdk/credential-providers"); // CommonJS import

const sourceCredentials = {
  // A credential can be a credential object or an async function that returns a credential object
};
const client = new FooClient({
  credentials: fromTemporaryCredentials({
    masterCredentials: sourceCredentials,
    params: { RoleArn },
  }),
});

v2: CognitoIdentityCredentials representa as credenciais recuperadas da federação de identidades do STS Web usando o serviço de identidades do Amazon Cognito.

v3: Cognito Identity Credential Provider O pacote @aws/credential-providers fornece duas funções de provedor de credenciais, uma das quais fromCognitoIdentity recebe um ID de identidade e chama cognitoIdentity:GetCredentialsForIdentity, enquanto a outra fromCognitoIdentityPool recebe um ID de banco de identidades, chama cognitoIdentity:GetId na primeira invocação e, em seguida, chama fromCognitoIdentity. As invocações subsequentes da última não invocam novamente o GetId.

O provedor implementa o “Fluxo simplificado” descrito no Guia do Desenvolvedor do Amazon Cognito. O “Classic Flow”, que envolve chamar cognito:GetOpenIdToken e depois chamarsts:AssumeRoleWithWebIdentity, não é compatível. Abra uma solicitação de recurso, se precisar.

// fromCognitoIdentityPool example
import { fromCognitoIdentityPool } from "@aws-sdk/credential-providers"; // ES6 import
// const { fromCognitoIdentityPool } = require("@aws-sdk/credential-providers"); // CommonJS import

const client = new FooClient({
  region: "us-east-1",
  credentials: fromCognitoIdentityPool({
    clientConfig: cognitoIdentityClientConfig, // Optional
    identityPoolId: "us-east-1:1699ebc0-7900-4099-b910-2df94f52a030",
    customRoleArn: "arn:aws:iam::1234567890:role/MYAPP-CognitoIdentity", // Optional
    logins: {
      // Optional
      "graph.facebook.com": "FBTOKEN",
      "www.amazon.com": "AMAZONTOKEN",
      "api.twitter.com": "TWITTERTOKEN",
    },
  }),
});

// fromCognitoIdentity example
import { fromCognitoIdentity } from "@aws-sdk/credential-providers"; // ES6 import
// const { fromCognitoIdentity } = require("@aws-sdk/credential-provider-cognito-identity"); // CommonJS import

const client = new FooClient({
  region: "us-east-1",
  credentials: fromCognitoIdentity({
    clientConfig: cognitoIdentityClientConfig, // Optional
    identityId: "us-east-1:128d0a74-c82f-4553-916d-90053e4a8b0f",
    customRoleArn: "arn:aws:iam::1234567890:role/MYAPP-CognitoIdentity", // Optional
    logins: {
      // Optional
      "graph.facebook.com": "FBTOKEN",
      "www.amazon.com": "AMAZONTOKEN",
      "api.twitter.com": "TWITTERTOKEN",
    },
  }),
});

v2: EC2MetadataCredentials

v3: fromInstanceMetadata. Cria um provedor de credenciais que pegará credenciais do serviço de metadados da instância do Amazon EC2.

import { fromInstanceMetadata } from "@aws-sdk/credential-providers"; // ES6 import
// const { fromInstanceMetadata } = require("@aws-sdk/credential-providers"); // CommonJS import

const client = new FooClient({
  credentials: fromInstanceMetadata({
    maxRetries: 3, // Optional
    timeout: 0, // Optional
  }),
});

v2: ECSCredentials ou RemoteCredentials

v3: fromContainerMetadata. Cria um provedor de credenciais que pegará credenciais do serviço de metadados do contêiner do Amazon ECS.

import { fromContainerMetadata } from "@aws-sdk/credential-providers"; // ES6 import

const client = new FooClient({
  credentials: fromContainerMetadata({
    maxRetries: 3, // Optional
    timeout: 0, // Optional
  }),
});

v2: FileSystemCredentials. Representa credenciais de um arquivo JSON no disco.

v3: obsoleto. Você pode ler explicitamente o arquivo JSON e fornecer ao cliente. Abra uma solicitação de recurso, se precisar.

v2: SAMLCredentials representa as credenciais recuperadas do suporte ao STS SAML.

v3: não disponível. Abra uma solicitação de recurso, se precisar.

v2: SharedIniFileCredentials

v3: fromIni

import { fromIni } from "@aws-sdk/credential-providers";
// const { fromIni } from("@aws-sdk/credential-providers");

const client = new FooClient({
  credentials: fromIni({
    configFilepath: "~/.aws/config", // Optional
    filepath: "~/.aws/credentials", // Optional
    mfaCodeProvider: async (mfaSerial) => {
      // implement a pop-up asking for MFA code
      return "some_code";
    }, // Optional
    profile: "default", // Optional
    clientConfig: { region }, // Optional
  }),
});

v2: TokenFileWebIdentityCredentials

v3: fromTokenFile

import { fromTokenFile } from "@aws-sdk/credential-providers"; // ES6 import
// const { fromTokenFile } from("@aws-sdk/credential-providers"); // CommonJS import

const client = new FooClient({
  credentials: fromTokenFile({
    // Optional. If skipped, read from `AWS_ROLE_ARN` environmental variable
    roleArn: "arn:xxxx",
    // Optional. If skipped, read from `AWS_ROLE_SESSION_NAME` environmental variable
    roleSessionName: "session:a",
    // Optional. STS client config to make the assume role request.
    clientConfig: { region },
  }),
});

v2: WebIdentityCredentials

v3: fromWebToken

import { fromWebToken } from "@aws-sdk/credential-providers"; // ES6 import
// const { fromWebToken } from("@aws-sdk/credential-providers"); // CommonJS import

const client = new FooClient({
  credentials: fromWebToken({
    // Optional. If skipped, read from `AWS_ROLE_ARN` environmental variable
    roleArn: "arn:xxxx",
    // Optional. If skipped, read from `AWS_ROLE_SESSION_NAME` environmental variable
    roleSessionName: "session:a",
    // Optional. STS client config to make the assume role request.
    clientConfig: { region },
  }),
});