콘텐츠로 이동

웹사이트 아이덴티티 프로바이더

웹사이트 인증은 Amazon Cognito 사용자 풀을 생성하며, 기본적으로 해당 풀에 사용자 이름과 비밀번호가 있는 사용자만 로그인할 수 있습니다. 직원이나 고객이 Okta, Auth0 또는 Microsoft Entra ID와 같은 아이덴티티 프로바이더(IdP)에 이미 계정을 가지고 있다면, 웹사이트를 위해 별도의 두 번째 계정이 필요하게 됩니다.

--federation=oidc와 함께 ts#website#auth를 실행하면 사용자 풀에 외부 OpenID Connect (OIDC) 아이덴티티 프로바이더를 추가할 수 있습니다. 인프라 코드에 아이덴티티 프로바이더를 나열합니다: CDK의 UserIdentity의 oidcIdentityProviders prop 또는 Terraform의 user_identity 모듈의 oidc_identity_providers 변수입니다. 그러면 로그인 페이지에 사용자 이름과 비밀번호 양식 옆에 각 아이덴티티 프로바이더를 위한 버튼이 표시됩니다.

  • 웹사이트는 여전히 사용자를 Cognito 로그인 페이지로 보냅니다. 이제 페이지에는 각 아이덴티티 프로바이더의 이름이 붙은 버튼이 있습니다.
  • 버튼을 선택한 사용자는 해당 아이덴티티 프로바이더에서 로그인합니다. 아이덴티티 프로바이더는 리디렉션 URI인 https://<cognito domain>/oauth2/idpresponse로 사용자를 Cognito로 다시 보냅니다.
  • Cognito는 사용자 풀에 페더레이션 사용자를 생성하고, 매핑한 클레임(예: email)을 사용자의 속성으로 복사합니다.
  • 그런 다음 Cognito는 로컬 사용자에게 발급하는 것과 동일한 종류의 토큰을 발급합니다. API, 에이전트 및 아이덴티티 풀은 변경 없이 이를 수락합니다.

풀에 사용자 이름과 비밀번호가 있는 사용자는 여전히 로그인할 수 있습니다.

아이덴티티 프로바이더를 추가하면 예상보다 훨씬 많은 사람들이 웹사이트에 접근할 수 있습니다. ts#website#auth의 allowSignup 옵션은 페더레이션 사용자에게 적용되지 않습니다. Cognito는 사용자 풀이 사용자 자체 가입을 허용하지 않는 경우에도 누군가가 아이덴티티 프로바이더를 통해 처음 로그인할 때 페더레이션 사용자를 생성합니다. 각 페더레이션 사용자는 아이덴티티 풀의 인증된 역할도 받으므로 로그인한 다른 사용자와 마찬가지로 API 및 에이전트를 호출할 수 있습니다.

아이덴티티 프로바이더는 전체 사용자 풀에 적용됩니다. 풀을 사용하는 모든 웹사이트는 해당 버튼을 표시하고 사용자를 수락합니다.

따라서 아이덴티티 프로바이더가 로그인할 수 있는 사용자를 결정합니다. 웹사이트가 필요한 사람만 로그인하도록 설정하세요:

  • Microsoft Entra ID: 애플리케이션의 엔터프라이즈 애플리케이션 속성에서 “Assignment required?”를 Yes로 설정하고 액세스가 필요한 사용자 또는 그룹만 할당하세요. 기본값인 No를 사용하면 테넌트의 모든 사용자가 로그인할 수 있습니다.
  • Okta: 액세스가 필요한 그룹에만 애플리케이션을 할당하세요.
  • Auth0: 애플리케이션이 사용하는 각 연결에서 가입을 비활성화하고, 사용자가 액세스가 필요한 연결만 애플리케이션에 활성화하세요. 그렇지 않으면 활성화된 연결(예: 소셜 연결)을 통해 가입한 사람은 누구나 로그인할 수 있습니다.

ts#website#auth 생성기를 --federation=oidc와 함께 실행하세요. 아직 인증이 없는 웹사이트에서 실행하거나 이미 인증이 있는 웹사이트에서 실행할 수 있습니다. 둘 다 동일한 결과를 제공합니다.

이 제너레이터 실행@aws/nx-plugin:ts#website#auth

pnpm nx g @aws/nx-plugin:ts#website#auth --federation=oidc
명령 구성하기6

필수

생성기는 아이덴티티 프로바이더를 추가하지 않습니다. 목록은 비어 있는 상태로 시작하므로 항목을 추가할 때까지 로그인이 이전과 같이 작동합니다. 인프라 코드에 아이덴티티 프로바이더를 추가하므로 두 번째 아이덴티티 프로바이더를 추가하는 데 다른 생성기 실행이 필요하지 않습니다.

--federation=oidc와 함께 생성기를 다시 실행하면 파일이 변경되지 않습니다. --federation=none 또는 --federation 없이 실행하면 이미 있는 페더레이션이 유지됩니다.

각 아이덴티티 프로바이더에 대한 항목을 추가한 다음 배포하세요. 클라이언트 시크릿은 코드에 포함되지 않습니다. 아이덴티티 프로바이더 설정에서 설명하는 대로 AWS Secrets Manager에 저장하고 이름을 제공합니다.

스택의 UserIdentity에 아이덴티티 프로바이더를 전달하세요:

packages/infra/src/stacks/application-stack.ts
import { MyWebsite, UserIdentity } from '@my-scope/common-constructs';
const identity = new UserIdentity(this, 'Identity', {
oidcIdentityProviders: [
{
name: 'Okta',
issuerUrl: 'https://example.okta.com',
clientId: '0oa1example',
clientSecretName: 'okta-oidc-client-secret',
},
{
name: 'Entra',
issuerUrl: 'https://login.microsoftonline.com/<tenant-id>/v2.0',
clientId: '11111111-2222-3333-4444-555555555555',
clientSecretName: 'entra-oidc-client-secret',
identifiers: ['example.com'],
},
],
});
new MyWebsite(this, 'MyWebsite');

각 항목의 타입인 OidcIdentityProviderProps는 공유 구성 패키지에서 내보내지므로 다른 곳에서 목록을 작성하고 타입을 가져올 수 있습니다.

목록의 각 아이덴티티 프로바이더에는 다음 속성이 있습니다. 생성기 옵션은 웹사이트 인증에 설명되어 있습니다.

CDK propTerraform attributeRequiredDefaultDescription
namenameYes로그인 버튼에 표시됩니다. Cognito는 소문자로 페더레이션 사용자 이름에 접두사를 붙입니다(<name>_<sub>). 문자로 시작하는 3-32자의 문자, 숫자 및 하이픈입니다. COGNITO는 안 됩니다. 대소문자를 무시하고 목록에서 고유합니다. CDK에서는 토큰이 아닌 리터럴 문자열이어야 합니다.
issuerUrlissuer_urlYes아이덴티티 프로바이더의 토큰의 iss 클레임에 나타나는 그대로의 발급자입니다. https://를 사용해야 합니다.
clientIdclient_idYes아이덴티티 프로바이더에 등록된 애플리케이션의 클라이언트 ID입니다.
clientSecretNameclient_secret_nameYes클라이언트 시크릿을 일반 문자열로 보관하는 Secrets Manager 시크릿의 이름입니다. ARN이 아닌 이름입니다.
scopesscopesNoopenid, email, profile요청할 OAuth 범위입니다. openid를 포함해야 합니다.
attributeMappingattribute_mappingNoemail, given_name 및 family_name, 각각 동일한 이름의 클레임에 매핑사용자 풀 속성을 아이덴티티 프로바이더 클레임에 매핑합니다. 속성 매핑을 참조하세요.
identifiersidentifiersNoNoneCognito가 사용자를 이 아이덴티티 프로바이더로 보내는 데 사용할 수 있는 이메일 도메인과 같은 식별자입니다.

벤딩된 코드는 배포되기 전에 각 항목을 확인합니다:

UserIdentity는 규칙을 위반하는 항목으로 생성할 때 예외를 발생시키므로 cdk synth가 실패합니다. 인프라 프로젝트의 빌드는 cdk synth를 실행합니다. 메시지는 항목의 이름을 지정합니다. 예를 들어 UserIdentity: oidcIdentityProviders[1] (Entra): Microsoft Entra ID issuers have no trailing slash. Use https://login.microsoftonline.com/<tenant-id>/v2.0입니다.

토큰인 값, 예를 들어 AWS Systems Manager Parameter Store에서 읽은 값은 확인되지 않습니다. 잘못된 값은 synth 대신 배포에 실패합니다. name은 토큰이 아니어야 합니다.

규칙:

  • name: 문자로 시작하는 3-32자의 문자, 숫자 및 하이픈입니다. Cognito가 사용자 풀 자체로 로그인하기 위해 예약하므로 대소문자에 관계없이 COGNITO는 안 됩니다.
  • 이름은 대소문자를 무시하고 목록에서 고유합니다. Cognito가 소문자 이름으로 페더레이션 사용자 이름에 접두사를 붙이기 때문입니다. 예를 들어 Okta와 OKTA는 둘 다 목록에 있을 수 없습니다. test-idp와 testidp는 접두사가 다르기 때문에 가능합니다.
  • 발급자는 https://를 사용하며 쿼리, 프래그먼트, 사용자 이름, 비밀번호 또는 공백이 없습니다. CDK에서는 URL로 파싱되어야 합니다. Terraform에서는 정규 표현식이 확인하며, CDK가 거부하는 몇 가지 잘못된 형식의 URL을 허용합니다.
  • Microsoft Entra ID: 다중 테넌트 발급자(common, organizations, consumers 및 9188040d-6c67-4c5b-b112-36a304b66dad)는 거부되며, 발급자는 슬래시로 끝나지 않아야 합니다.
  • Auth0: *.auth0.com의 발급자는 슬래시로 끝나야 합니다.
  • 클라이언트 ID는 비어 있지 않습니다.
  • 시크릿 이름은 1-512자의 문자, 숫자 및 / _ + = . @ -입니다. 이는 Secrets Manager 명명 규칙이므로 ARN은 거부됩니다.
  • 범위에는 openid가 포함됩니다. CDK에서 각 범위는 비어 있지 않고 공백이 없어야 합니다.
  • 속성 매핑 키와 값은 속성 매핑의 규칙을 따릅니다.
  • 최대 50개의 식별자입니다. 각각은 1-40자의 문자, 숫자, 공백 또는 _ + = . @ -입니다.

--federation=oidc와 함께 생성기는 선택한 iac 프로바이더에 대해 다음 파일과 편집을 추가합니다:

  • 디렉터리packages/common/constructs/src/core
    • oidc-identity-providers.ts OidcIdentityProviders 구성, props 및 검증
    • index.ts 이제 oidc-identity-providers.ts를 내보냅니다
    • user-identity.ts 이제 oidcIdentityProviders prop을 가지며 아이덴티티 프로바이더를 생성합니다

편집을 통해 사용자 풀의 웹 클라이언트, 즉 웹사이트가 로그인하는 Cognito 앱 클라이언트가 아이덴티티 프로바이더를 수락할 수 있습니다:

packages/common/constructs/src/core/user-identity.ts
import {
OidcIdentityProviders,
type OidcIdentityProviderProps,
} from './oidc-identity-providers.js';
readonly mfaSecondFactor?: MfaSecondFactor;
/**
* OpenID Connect identity providers users can sign in through, next to the user pool's own sign-in.
* Applies to every website that uses this user pool.
* ...
*/
readonly oidcIdentityProviders?: OidcIdentityProviderProps[];
}
mfaSecondFactor = { sms: true, otp: true },
oidcIdentityProviders = [],
}: UserIdentityProps = {},
this.userPoolDomain = this.createUserPoolDomain(this.userPool);
new OidcIdentityProviders(this, 'OidcIdentityProviders', {
userPool: this.userPool,
userPoolDomain: this.userPoolDomain,
providers: oidcIdentityProviders,
});
this.userPoolClient = this.createUserPoolClient(this.userPool);

UserIdentity는 웹 클라이언트 전에 아이덴티티 프로바이더를 생성하므로 웹 클라이언트는 이를 나열한 다음 COGNITO를 나열합니다.

생성기는 새 파일에 대한 편집 내용을 덮어쓰지 않습니다. user-identity.ts 또는 main.tf 또는 identity.tf를 변경하여 생성기가 더 이상 인식하지 못하는 경우 생성기는 해당 파일을 변경하지 않고 그대로 둡니다. 여전히 새 파일을 추가하고 수동으로 추가할 줄을 출력합니다.

아이덴티티 프로바이더를 추가하는 배포는 Secrets Manager에서 클라이언트 시크릿을 읽습니다. 시크릿이 존재하지 않으면 배포가 실패합니다.

CloudFormation은 스택의 실행 역할로 시크릿을 읽습니다. 기본적으로 cdk-hnb659fds-cfn-exec-role-<account>-<region>입니다. 해당 역할은 시크릿에 대한 secretsmanager:GetSecretValue가 필요하며, 시크릿이 고객 관리형 AWS KMS 키로 암호화된 경우 키에 대한 kms:Decrypt도 필요합니다.

다음 단계를 이 순서대로 따르세요. 생성기는 완료 시 이러한 단계도 출력합니다.

  1. --federation=oidc와 함께 ts#website#auth를 실행하고 한 번 배포합니다.
  2. 사용자 풀의 리디렉션 URI를 찾습니다. 풀의 모든 아이덴티티 프로바이더는 동일한 것을 사용합니다.

UserIdentity를 포함하는 스택에는 <id>OidcIdentityProvidersIdpRedirectUri로 시작하는 키를 가진 출력이 있습니다. 여기서 <id>는 UserIdentity에 제공한 구성 ID입니다. 예를 들어 IdentityOidcIdentityProvidersIdpRedirectUri입니다. 배포하기 전에 ts#website#auth에 대해 선택한 cognitoDomain, AWS 계정 ID 및 리전에서 계산할 수도 있습니다:

https://<cognitoDomain>-<account>.auth.<region>.amazoncognito.com/oauth2/idpresponse
  1. 해당 리디렉션 URI로 아이덴티티 프로바이더에 애플리케이션을 등록하고 클라이언트 ID와 클라이언트 시크릿을 기록합니다. 아이덴티티 프로바이더에는 이 /oauth2/idpresponse URI만 등록하세요. 웹사이트 자체의 URL은 아이덴티티 프로바이더가 아닌 Cognito에 등록됩니다.

  2. Secrets Manager에 클라이언트 시크릿을 저장합니다. 명령줄 인수가 아닌 파일로 전달하세요. 인수는 셸 기록에 남고, 명령이 실행되는 동안 같은 컴퓨터의 다른 사용자가 프로세스 목록에서 볼 수 있습니다:

    터미널 창
    (
    umask 077
    d=$(mktemp -d) || exit
    trap 'rm -rf "$d"' EXIT
    trap 'exit 1' HUP INT TERM
    unset CLIENT_SECRET
    IFS= read -rs CLIENT_SECRET || exit 1
    printf '%s' "$CLIENT_SECRET" > "$d/secret" || exit 1
    unset CLIENT_SECRET
    aws secretsmanager create-secret --name okta-oidc-client-secret --secret-string "file://$d/secret" --region <region>
    )

    명령은 괄호 사이의 서브셸에서 실행됩니다. read는 클라이언트 시크릿을 붙여넣고 Enter를 누를 때까지 기다리며 표시하지 않습니다. 두 개의 unset 명령은 이전에 CLIENT_SECRET을 내보낸 경우에도 aws 명령의 환경에서 시크릿을 제외합니다. IFS=와 -r은 양쪽 끝의 공백과 백슬래시를 포함하여 붙여넣은 그대로 시크릿을 유지합니다. mktemp -d는 사용자만 열 수 있는 새 디렉터리(모드 700)를 생성하고, printf는 끝에 줄바꿈 없이 시크릿을 씁니다. AWS CLI는 file:// 뒤에 명명된 파일에서 --secret-string의 값을 읽고 변경하지 않고 전달하므로 파일 끝의 줄바꿈은 시크릿의 일부가 됩니다. 서브셸이 끝나면 trap 명령이 디렉터리를 삭제합니다. aws 명령이 실패하거나 Ctrl-C를 누르면 이 작업도 수행합니다. 명령은 Linux와 macOS의 기본 셸인 bash와 zsh에서 작동합니다. Windows의 경우 Mitigate the risks of using the AWS CLI to store your AWS Secrets Manager secrets를 참조하세요.

    --region을 스택의 리전으로 설정하세요. 아이덴티티 프로바이더를 추가하는 배포 전에 해당 리전에 시크릿이 존재해야 합니다. Cognito가 전체 시크릿 값을 클라이언트 시크릿으로 받기 때문에 시크릿을 JSON이 아닌 일반 문자열로 저장하세요. Secrets Manager 콘솔에서 Key/value가 아닌 Plaintext를 선택하세요.

  3. 아이덴티티 프로바이더 추가에 표시된 대로 시크릿의 이름을 clientSecretName(Terraform에서는 client_secret_name)으로 사용하여 목록에 아이덴티티 프로바이더를 추가합니다. 그런 다음 배포합니다.

생성된 사용자 풀에는 email, given_name 및 family_name 속성이 필요합니다. Cognito는 매 로그인 시 아이덴티티 프로바이더의 클레임에서 이를 채웁니다. 아이덴티티 프로바이더가 이 중 하나를 보내지 않으면 사용자의 첫 번째 로그인이 실패합니다. 따라서 UserIdentity와 Terraform 변수는 세 가지 중 하나라도 누락된 속성 매핑을 거부합니다.

attributeMapping(Terraform에서는 attribute_mapping)은 사용자 풀 속성을 클레임에 매핑합니다. 각 키는 사용자 풀 속성이고, 각 값은 1-128자 길이의 아이덴티티 프로바이더의 클레임 이름입니다. 제공하는 매핑은 기본값을 대체합니다. 기본값은 각 필수 속성을 동일한 이름의 클레임에 매핑합니다:

attributeMapping: { email: 'email', given_name: 'given_name', family_name: 'family_name' },
  • 키는 name 또는 phone_number, phone_number_verified와 같은 표준 속성 또는 custom:department와 같은 사용자 정의 속성(custom: 뒤에 최대 20자의 문자, 숫자 또는 밑줄)일 수 있습니다. 키는 CDK와 Terraform 모두에서 Cognito 속성 이름을 사용합니다. username은 거부됩니다.
  • Cognito는 매핑된 이메일 주소를 미확인으로 처리합니다. 이메일 주소를 자체적으로 확인하는 아이덴티티 프로바이더에서만 email_verified를 매핑하세요. 그렇지 않으면 사용자가 아이덴티티 프로바이더에서 다른 사람의 주소를 설정하고 풀에서 확인된 것으로 표시될 수 있습니다.
  • 아이덴티티 프로바이더에서 사용자의 이메일 주소가 변경되면 Cognito는 사용자의 다음 로그인 시 사용자 풀에 새 주소를 씁니다. email_verified는 false로 유지됩니다.
  • 사용자 정의 속성은 사용자 풀에 이미 존재해야 하며 변경 가능해야 합니다.

identity/oidc-identity-providers.tf의 Terraform 아이덴티티 프로바이더 리소스는 또한 Cognito가 아이덴티티 프로바이더를 반환할 때 추가하는 두 가지 값을 설정합니다: attribute_mapping의 username = "sub" 및 provider_details의 attributes_url_add_attributes = "false". 파일이 이를 설정하기 때문에 첫 번째 배포 후 두 번째 terraform plan은 아이덴티티 프로바이더에 대한 변경 사항을 표시하지 않습니다. 다른 아이덴티티 프로바이더를 사용하여 두 번째 플랜이 여전히 provider_details의 변경 사항을 표시하는 경우, 플랜이 Cognito가 반환하는 것으로 표시하는 값으로 해당 키를 파일에 추가하세요.

아이덴티티 프로바이더 참고 사항

섹션 제목: “아이덴티티 프로바이더 참고 사항”

아래 설정은 각 공급업체의 문서에서 가져온 것입니다. Okta는 CDK와 Terraform 모두를 사용하여 AWS에서 테스트되었습니다. Auth0 및 Microsoft Entra ID 설정은 각 공급업체의 게시된 OpenID 검색 문서와 대조하여 확인되었지만 실제 로그인으로는 테스트되지 않았습니다.

CDK와 Terraform을 사용하여 AWS에서 테스트되었습니다. Okta에서 Authorization Code 부여 및 클라이언트 시크릿을 사용하는 OIDC Web Application을 생성하세요. 아이덴티티 프로바이더 설정의 2단계에서 제공하는 /oauth2/idpresponse 리디렉션 URI로 로그인 리디렉션 URI를 설정하세요. 로그아웃 리디렉션 URI는 필요하지 않습니다. 발급자는 Okta 도메인인 https://<your-org>.okta.com이며, 이것이 테스트된 형식입니다. https://<your-org>.okta.com/oauth2/default와 같은 사용자 정의 권한 부여 서버도 발급자를 가지고 있지만 해당 형식은 테스트되지 않았습니다. 기본 범위인 openid email profile은 email, given_name 및 family_name을 반환하므로 기본 매핑이 작동합니다. 각 사용자는 Okta에 이메일, 이름 및 성이 설정되어 있어야 합니다. 액세스가 필요한 사용자 또는 그룹에만 애플리케이션을 할당하세요.

Auth0의 검색 문서와 대조하여 확인되었으며, 실제 로그인으로는 테스트되지 않았습니다. Auth0에서 Regular Web Application을 생성하세요. 발급자는 후행 슬래시를 포함하여 https://<your-tenant>.auth0.com/입니다.

Auth0은 사용자의 연결이 제공하는 경우에만 given_name 및 family_name을 반환합니다. 이를 제공하지 않는 연결의 사용자는 다른 클레임을 매핑할 때까지 로그인할 수 없습니다.

Microsoft의 검색 문서와 대조하여 확인되었으며, 실제 로그인으로는 테스트되지 않았습니다. Entra ID에서 단일 테넌트 애플리케이션을 등록하세요. 발급자는 https://login.microsoftonline.com/<tenant-id>/v2.0입니다. 벤딩된 코드는 모든 Entra ID 테넌트의 사용자를 수락하기 때문에 다중 테넌트 발급자(common, organizations 및 consumers)를 거부합니다. 또한 모든 개인 Microsoft 계정을 수락하는 테넌트 9188040d-6c67-4c5b-b112-36a304b66dad도 거부합니다.

발급자는 슬래시로 끝나지 않아야 합니다: /v2.0/이 아닌 /v2.0을 사용하세요. Entra ID 토큰의 iss 클레임에 슬래시가 없기 때문에 로그인이 실패합니다. 벤딩된 코드는 슬래시가 있는 형식을 거부합니다.

애플리케이션의 ID 토큰에 email, given_name 및 family_name을 선택적 클레임으로 추가하세요. Entra ID는 추가한 경우에만 이를 보냅니다. 각 사용자는 Mail 필드가 설정되어 있어야 합니다. 그렇지 않으면 email 클레임이 비어 있고, 사용자 풀이 email을 요구하기 때문에 사용자의 첫 번째 로그인이 실패합니다. Entra ID의 email 클레임은 확인되지 않으므로 Entra ID에서 email_verified를 매핑하지 마세요.

다른 Cognito 사용자 풀을 아이덴티티 프로바이더로 테스트하려면 발급자 https://cognito-idp.<region>.amazonaws.com/<user pool id>를 사용하세요. 앱 클라이언트에 클라이언트 시크릿, 권한 부여 코드 부여 및 범위 openid email profile을 제공합니다.

  • email이 아닌 sub 클레임(사용자 풀의 사용자 고유 ID)으로 사용자를 식별하세요. 페더레이션 사용자는 이메일이 로컬 사용자와 일치하더라도 자체 sub를 가진 풀의 새 사용자입니다. 플러그인이 생성하는 코드는 sub를 사용합니다.
  • 단일 테넌트 발급자를 사용하세요. 다중 테넌트 발급자는 모든 조직의 사용자가 로그인할 수 있도록 합니다.
  • 웹사이트 인증에서 설명하는 대로 프로덕션 스테이지에서 http://localhost 콜백 URL을 제거하세요. 페더레이션은 콜백 URL을 추가하지 않습니다.

페더레이션이 수행하지 않는 작업

섹션 제목: “페더레이션이 수행하지 않는 작업”
  • 사용자 풀에서 요구하는 MFA(다단계 인증)는 페더레이션 사용자에게 적용되지 않습니다. Cognito는 인증을 아이덴티티 프로바이더에 맡기므로 아이덴티티 프로바이더에서 MFA를 적용하세요.

  • 웹사이트에서 로그아웃하면 Cognito 세션만 종료됩니다. OIDC 아이덴티티 프로바이더에서 사용자의 세션을 종료하지 않으므로 버튼을 통한 다음 로그인은 비밀번호 없이 완료될 수 있습니다. 공유 컴퓨터에서 사용자는 아이덴티티 프로바이더에서도 로그아웃해야 합니다.

  • 사용자 메뉴에는 Cognito 사용자 이름이 표시됩니다. 페더레이션 사용자의 경우 아이덴티티 프로바이더 이름, 밑줄 및 아이덴티티 프로바이더에서의 사용자 sub가 소문자로 표시됩니다. 예를 들어 okta_00u1abcd입니다.

  • 아이덴티티 프로바이더에서 사용자를 제거하거나 비활성화하면 해당 사용자의 다음 로그인만 중지됩니다. Cognito는 자체 리프레시 토큰으로 토큰을 갱신하며 아이덴티티 프로바이더에 묻지 않고, 웹사이트는 사용자가 알아차리지 못하게 토큰을 갱신합니다. 따라서 사용자는 리프레시 토큰이 만료될 때까지, 즉 마지막 로그인 후 최대 30일까지 액세스를 유지할 수 있습니다. 사용자가 새 토큰을 받지 못하도록 하려면 모든 세션에서 로그아웃시키고 사용자 풀에서 비활성화하세요. 사용자 이름은 <identity provider name in lowercase>_<sub>입니다:

    터미널 창
    aws cognito-idp admin-user-global-sign-out --user-pool-id <user pool id> --username okta_<sub>
    aws cognito-idp admin-disable-user --user-pool-id <user pool id> --username okta_<sub>

    이는 AWS에서 테스트되었습니다. admin-user-global-sign-out 및 admin-disable-user 후에도 아이덴티티 프로바이더는 여전히 사용자를 로그인시키지만 Cognito는 거부합니다.

    이러한 명령은 사용자가 이미 가지고 있는 액세스를 종료하지 않습니다. admin-user-global-sign-out은 사용자의 리프레시 토큰을 취소하므로 웹사이트가 새 토큰을 받을 수 없으며, admin-disable-user는 다음 로그인을 중지합니다. Cognito가 이미 발급한 ID 및 액세스 토큰은 만료될 때까지 유효하며, 기본적으로 발급 후 1시간입니다(ID and access token validity). 아이덴티티 풀이 웹사이트에 이미 제공한 AWS 자격 증명도 만료될 때까지 유효하며, 발급 후 1시간입니다(identity pools authentication flow). 만료될 때까지 사용자는 여전히 웹사이트와 아이덴티티 풀의 인증된 역할을 사용할 수 있습니다.

    웹 클라이언트의 더 짧은 리프레시 토큰 유효 기간(CDK의 refreshTokenValidity, Terraform의 refresh_token_validity)은 이러한 명령을 실행하지 않는 경우 제거된 사용자가 액세스를 유지하는 시간을 단축합니다. 더 짧은 ID 및 액세스 토큰 유효 기간(CDK의 idTokenValidity 및 accessTokenValidity, Terraform의 id_token_validity 및 access_token_validity)은 명령을 실행한 후 이미 발급된 토큰이 유효한 시간을 단축하지만 항상 일부 시간이 남습니다. 둘 다 AWS에서 테스트되지 않았습니다.

Cognito는 아이덴티티 프로바이더의 설정에 클라이언트 시크릿을 보관합니다. 사용자 풀에서 cognito-idp:DescribeIdentityProvider를 호출할 수 있는 권한이 있는 사람은 누구나 이를 읽을 수 있습니다. 이것은 사용하는 IaC 프로바이더에 관계없이 Cognito가 작동하는 방식입니다.

구성은 시크릿을 동적 참조인 {{resolve:secretsmanager:<clientSecretName>:SecretString:::}}로 CloudFormation에 전달합니다. 합성된 템플릿에는 해당 참조만 포함됩니다. CloudFormation은 아이덴티티 프로바이더를 생성하거나 업데이트할 때 시크릿을 읽습니다. 시크릿을 교체하면 나중 배포에서 아이덴티티 프로바이더 리소스가 변경될 때만 Cognito가 새 값을 가져옵니다.

CloudFormation은 아이덴티티 프로바이더의 설정(ProviderDetails) 내에서 참조를 확인하므로 페더레이션 로그인이 저장된 시크릿으로 작동하며 배포된 템플릿에는 참조만 보관됩니다. 교체 후 다른 변경 사항이 없는 배포는 Cognito에 이전 시크릿을 남깁니다. 둘 다 AWS에서 확인되었습니다.

교체된 시크릿을 Cognito로 보내려면:

교체 후 배포에서 아이덴티티 프로바이더 리소스를 변경합니다. 한 가지 방법은 교체된 시크릿을 새 이름으로 저장하고 clientSecretName을 해당 이름으로 설정하는 것입니다. 그러면 템플릿의 참조가 변경되므로 CloudFormation은 아이덴티티 프로바이더를 업데이트하고 새 시크릿을 읽습니다. 나중에 이전 시크릿을 삭제하세요. 이는 동적 참조에 대한 CloudFormation 문서를 따르며 AWS에서 테스트되지 않았습니다.

앱 클라이언트는 애플리케이션이 로그인하는 Cognito 구성입니다. 생성기는 웹사이트의 앱 클라이언트인 웹 클라이언트에만 아이덴티티 프로바이더를 추가합니다. 동일한 사용자 풀의 다른 앱 클라이언트는 아이덴티티 프로바이더도 나열하는 경우에만 페더레이션 사용자를 수락합니다. 예를 들어 DCR 프록시(MCP 클라이언트, Model Context Protocol을 사용하는 AI 도구가 Cognito를 통해 로그인할 수 있도록 함)에 대해 생성하는 앱 클라이언트에는 이것이 필요합니다. 그렇지 않으면 페더레이션 사용자가 MCP 서버에 로그인할 수 없습니다.

supportedIdentityProviders 없이 UserIdentity 이후에 identity.userPool.addClient(...)로 생성하는 앱 클라이언트는 풀의 모든 아이덴티티 프로바이더와 COGNITO를 나열합니다. DCR 프록시 예제는 이렇게 합니다. 앱 클라이언트가 supportedIdentityProviders를 설정하는 경우 풀의 아이덴티티 프로바이더를 추가하세요:

import { UserPoolClientIdentityProvider } from 'aws-cdk-lib/aws-cognito';
supportedIdentityProviders: [
UserPoolClientIdentityProvider.COGNITO,
...identity.userPool.identityProviders.map((p) =>
UserPoolClientIdentityProvider.custom(p.providerName),
),
],

Cognito 인증을 사용하는 TypeScript 에이전트의 <agent>-chat 대상은 AGENT_ACCESS_TOKEN 환경 변수에서 Cognito 액세스 토큰을 읽습니다. 페더레이션 사용자에게는 Cognito 비밀번호가 없으므로 admin-initiate-auth가 작동하지 않습니다. 대신 웹사이트에 로그인하고 브라우저의 개발자 도구를 열고 세션 스토리지의 oidc.user:... 항목에서 access_token을 복사하세요.