Penyedia kredensi

v2: CredentialProviderChaindi Node.js menyelesaikan kredensi dari sumber sebagai berikut urutan:

Jika salah satu penyedia kredensi di atas gagal menyelesaikan AWS kredensi, rantai akan kembali ke penyedia berikutnya hingga kredensi yang valid diselesaikan, dan rantai akan menimbulkan kesalahan ketika semua penyedia gagal.

Di runtime Browser dan React Native, rantai kredensialnya kosong, dan kredensyal harus disetel secara eksplisit.

v3: DefaultProvider. Sumber kredensyal dan urutan fallback tidak berubah di v3. Ini juga mendukung AWS IAM Identity Center kredensyal.

v2: ChainableTemporaryCredentialsmewakili kredensyal sementara yang diambil dari. AWS.STS Tanpa parameter tambahan, kredensyal akan diambil dari operasi. AWS.STS.getSessionToken() Jika peran IAM disediakan, AWS.STS.assumeRole() operasi akan digunakan untuk mengambil kredensyal untuk peran sebagai gantinya. AWS.ChainableTemporaryCredentialsberbeda dari AWS.TemporaryCredentials cara MasterCredentials dan refresh ditangani. AWS.ChainableTemporaryCredentialsmenyegarkan kredensyal kedaluwarsa menggunakan MasterCredentials yang diteruskan oleh pengguna untuk mendukung rantai kredensyal STS. Namun, AWS.TemporaryCredentials secara rekursif menciutkan MasterCredentials selama instantiation, menghalangi kemampuan untuk menyegarkan kredenal yang memerlukan kredensial sementara menengah.

Asli TemporaryCredentialstelah ditinggalkan demi di v2. ChainableTemporaryCredentials

v3: fromTemporaryCredentials. Anda dapat menelepon fromTemporaryCredentials() dari @aws-sdk/credential-providers paket. Inilah contohnya:

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: CognitoIdentityCredentialsMerupakan kredensi yang diambil dari Federasi Identitas Web STS menggunakan layanan Identitas Amazon Cognito.

v3: Cognito Identity Credential Provider@aws/credential-providersPaket ini menyediakan dua fungsi penyedia kredensi, salah satunya fromCognitoIdentitymengambil ID identitas dan panggilancognitoIdentity:GetCredentialsForIdentity, sementara yang lain fromCognitoIdentityPoolmengambil ID kumpulan identitas, panggilan cognitoIdentity:GetId pada pemanggilan pertama, dan kemudian panggilan. fromCognitoIdentity Pemanggilan selanjutnya dari yang terakhir tidak dipanggil kembali. GetId

Penyedia mengimplementasikan “Aliran Sederhana” yang dijelaskan dalam Panduan Pengembang Amazon Cognito. “Aliran Klasik” yang melibatkan panggilan cognito:GetOpenIdToken dan kemudian panggilan sts:AssumeRoleWithWebIdentity tidak didukung. Silakan buka permintaan fitur kepada kami jika Anda membutuhkannya.

// 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: Membuat penyedia kredensyal yang akan mendapatkan kredensyal dari Layanan Metadata Instans 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 atau RemoteCredentials.

v3: fromContainerMetadatamembuat penyedia kredensyal yang akan mendapatkan kredensyal dari 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: FileSystemCredentialsmewakili kredensyal dari file JSON pada disk.

v3: Usang. Anda dapat secara eksplisit membaca file JSON dan memasok ke klien. Silakan buka permintaan fitur kepada kami jika Anda membutuhkannya.

v2: SAMLCredentialsmewakili kredensyal yang diambil dari dukungan STS SALL.

v3: Tidak tersedia. Silakan buka permintaan fitur kepada kami jika Anda membutuhkannya.

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