Proveedores de credencial

v2: CredentialProviderChain en Node.js resuelve las credenciales de los orígenes en el siguiente orden:

Si uno de los proveedores de credenciales anteriores no logra resolver la credencial de AWS, la cadena pasa al siguiente proveedor hasta que se resuelve una credencial válida, y la cadena generará un error cuando todos los proveedores fallen.

En los tiempos de ejecución de Browser y React Native, la cadena de credenciales está vacía y las credenciales deben configurarse de forma explícita.

v3: defaultProvider. Los orígenes de credenciales y el orden de reserva no cambian en v3. También es compatible con las credenciales de AWS IAM Identity Center.

v2: ChainableTemporaryCredentials representa las credenciales temporales recuperadas de AWS.STS. Sin ningún parámetro adicional, las credenciales se obtendrán de la operación AWS.STS.getSessionToken(). Si se proporciona un rol de IAM, en su lugar se utilizará la operación AWS.STS.assumeRole() para obtener las credenciales del rol. AWS.ChainableTemporaryCredentials difiere de AWS.TemporaryCredentials en la forma en que se administran las masterCredentials y las actualizaciones. AWS.ChainableTemporaryCredentials actualiza las credenciales caducadas mediante las masterCredentials transferidas por el usuario para admitir el encadenamiento de credenciales de STS. Sin embargo, AWS.TemporaryCredentials contrae las masterCredentials de forma recursiva durante la creación de instancias, lo que impide actualizar las credenciales que requieren credenciales intermedias y temporales.

El TemporaryCredentials original ha quedado obsoleto en favor de ChainableTemporaryCredentials en v2.

v3: fromTemporaryCredentials. Puede llamar a fromTemporaryCredentials() desde el paquete @aws-sdk/credential-providers. A continuación se muestra un ejemplo:

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 las credenciales recuperadas de la federación de identidades web de STS mediante el servicio de Amazon Cognito Identity.

v3: Cognito Identity Credential Provider El paquete @aws/credential-providers proporciona dos funciones de proveedor de credenciales, una de las cuales, fromCognitoIdentity, utiliza un ID de identidad y llama a cognitoIdentity:GetCredentialsForIdentity, mientras que la otra, fromCognitoIdentityPool, utiliza un ID de grupo de identidades, llama a cognitoIdentity:GetId en la primera invocación y, a continuación, llama a fromCognitoIdentity. Las invocaciones posteriores de esta última no vuelven a invocar GetId.

El proveedor implementa el “flujo simplificado” descrito en la Guía para desarrolladores de Amazon Cognito. El “flujo clásico”, que implica llamar a cognito:GetOpenIdToken y, a continuación, llamar a sts:AssumeRoleWithWebIdentity, no es compatible. Si lo necesita, envíenos una solicitud de característica.

// 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. Crea un proveedor de credenciales que obtendrá las credenciales del servicio de metadatos de la instancia de 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 o RemoteCredentials

v3: fromContainerMetadata. Crea un proveedor de credenciales que obtendrá las credenciales del servicio de metadatos de contenedores de 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 las credenciales de un archivo JSON en el disco.

v3: obsoleto. Puede leer de forma explícita el archivo JSON y proporcionarlo al cliente. Si lo necesita, envíenos una solicitud de característica.

v2: SAMLCredentials representa las credenciales recuperadas de la compatibilidad con SAML de STS.

v3: no disponible. Si lo necesita, envíenos una solicitud de característica.

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