보안 인증 공급자

v2: Node.js의 CredentialProviderChain은 소스의 자격 증명을 다음 순서로 확인합니다.

위의 자격 증명 공급자 중 하나가 AWS 자격 증명을 확인하지 못하면 유효한 자격 증명이 확인될 때까지 체인이 다음 공급자로 돌아가고 모든 공급자가 실패하면 체인에서 오류가 발생합니다.

브라우저 및 React Native 런타임에서 자격 증명 체인은 비어 있으며 자격 증명을 명시적으로 설정해야 합니다.

v3: defaultProvider. 자격 증명 소스와 대체 순서는 v3에서 변경되지 않습니다. 또한 AWS IAM Identity Center 자격 증명을 지원합니다.

v2: ChainableTemporaryCredentials는 AWS.STS에서 검색된 임시 자격 증명을 나타냅니다. 추가 파라미터가 없으면 AWS.STS.getSessionToken() 작업에서 자격 증명을 가져옵니다. IAM 역할이 제공된 경우, AWS.STS.assumeRole() 작업이 해당 역할의 자격 증명을 가져오는 데 사용됩니다. AWS.ChainableTemporaryCredentials는 AWS.TemporaryCredentials와는 다른 방식으로 masterCredentials 및 갱신을 처리합니다. AWS.ChainableTemporaryCredentials는 사용자가 전달한 masterCredentials를 사용하여 만료된 자격 증명을 갱신하여 STS 자격 증명의 체인 연결을 지원합니다. 그러나 AWS.TemporaryCredentials는 인스턴스화 중에 masterCredentials를 반복적으로 축소하므로 중간 임시 자격 증명이 필요한 자격 증명을 새로 고칠 수 없습니다.

원본 TemporaryCredentials는 v2의 ChainableTemporaryCredentials에서 더 이상 사용되지 않습니다.

v3: fromTemporaryCredentials. @aws-sdk/credential-providers 패키지에서 fromTemporaryCredentials()를 호출할 수 있습니다. 다음은 그 예입니다.

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 Amazon Cognito Identity 서비스를 사용하여 STS 웹 ID 페더레이션에서 검색된 자격 증명을 나타냅니다.

v3: Cognito Identity Credential Provider @aws/credential-providers 패키지는 두 개의 자격 증명 공급자 함수를 제공합니다. 하나는 fromCognitoIdentity로, 자격 증명 ID를 받아 cognitoIdentity:GetCredentialsForIdentity를 직접 호출합니다. 다른 하나는 fromCognitoIdentityPool로, 자격 증명 풀 ID를 받아 첫 번째 간접 호출 시 cognitoIdentity:GetId를 직접 호출한 후 직접 호출합니다fromCognitoIdentity. 후자의 후속 간접 호출은 GetId를 다시 간접 호출하지 않습니다.

공급자는 Amazon Cognito 개발자 안내서에 설명된 ‘간소화된 흐름’을 구현합니다. 직접 호출 cognito:GetOpenIdToken 및 sts:AssumeRoleWithWebIdentity를 포함하는 ‘클래식 흐름’은 지원되지 않습니다. 필요한 경우 기능 요청을 시작해 주세요.

// 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. 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 또는 RemoteCredentials

v3: fromContainerMetadata. 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. 디스크에 있는 JSON 파일의 자격 증명을 나타냅니다.

v3: 더 이상 사용되지 않습니다. JSON 파일을 명시적으로 읽고 클라이언트에 제공할 수 있습니다. 필요한 경우 기능 요청을 시작해 주세요.

v2: SAMLCredentials STS SAML 지원에서 검색된 자격 증명을 나타냅니다.

v3: 사용할 수 없습니다. 필요한 경우 기능 요청을 시작해 주세요.

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