Provedores de credenciais

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

Se um dos provedores de credenciais acima não conseguir resolver a AWS credencial, 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 tempos de execução 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. Ele também oferece suporte a AWS IAM Identity Center credenciais.

v2: ChainableTemporaryCredentialsrepresenta credenciais temporárias recuperadas de. AWS.STS Sem nenhum parâmetro extra, as credenciais serão obtidas da AWS.STS.getSessionToken() operação. Se uma função do IAM for fornecida, a AWS.STS.assumeRole() operação será usada para buscar credenciais para a função. AWS.ChainableTemporaryCredentialsdifere da AWS.TemporaryCredentials forma como as MasterCredentials e as atualizações são tratadas. AWS.ChainableTemporaryCredentialsatualiza as credenciais expiradas usando as MasterCredentials passadas pelo usuário para suportar o encadeamento de credenciais STS. No entanto, reduz AWS.TemporaryCredentials recursivamente as MasterCredentials durante a instanciação, impedindo a capacidade de atualizar credenciais que exigem credenciais intermediárias temporárias.

O original TemporaryCredentialsfoi descontinuado em favor do ChainableTemporaryCredentials v2.

v3: fromTemporaryCredentials. Você pode ligar fromTemporaryCredentials() do @aws-sdk/credential-providers pacote. 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: CognitoIdentityCredentialsrepresenta as credenciais recuperadas da STS Web Identity Federation usando o serviço Amazon Cognito Identity.

v3: Cognito Identity Credential ProviderO @aws/credential-providerspacote fornece duas funções de provedor de credenciais, uma das quais fromCognitoIdentityrecebe uma ID de identidade e chamadascognitoIdentity:GetCredentialsForIdentity, enquanto a outra fromCognitoIdentityPoolrecebe uma ID de grupo de identidades, chama a primeira invocação e, cognitoIdentity:GetId em seguida, chama. fromCognitoIdentity As invocações subsequentes deste último não são invocadas novamente. GetId

O provedor implementa o “Fluxo simplificado” descrito no Guia do Desenvolvedor do Amazon Cognito. O “Classic Flow”, que envolve chamadas cognito:GetOpenIdToken e depois chamadas, não sts:AssumeRoleWithWebIdentity é suportado. Abra uma solicitação de recurso para nós, 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 fornecerá as credenciais do Amazon EC2 Instance Metadata Service.

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 fornecerá as credenciais do Amazon ECS Container Metadata Service.

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

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

v2: FileSystemCredentials. Representa as 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 para nós, se precisar.

v2: SAMLCredentialsrepresenta as credenciais recuperadas do suporte ao STS SAML.

v3: Não disponível. Abra uma solicitação de recurso para nós, 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 },
  }),
});