Amazon Cognito User Pools에 사용되는 작업, 리소스 및 조건 키

Amazon Cognito User Pools(서비스 접두사: cognito-idp)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.

참조:

• 이 서비스를 구성하는 방법을 알아봅니다.

• 이 서비스에 사용 가능한 API 작업의 목록을 봅니다.

• IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.

Amazon Cognito User Pools에서 정의한 작업

IAM 정책 설명의 Action 요소에서 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.

작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.

작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.

참고

리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.

다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.

작업	설명	액세스 레벨	리소스 유형(*필수)	조건 키	종속 작업
AddCustomAttributes	사용자 풀 스키마에 사용자 속성을 추가할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminAddUserToGroup	그룹에 사용자를 추가할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminConfirmSignUp	확인 코드 없이 사용자의 등록을 확인할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminCreateUser	새 사용자를 생성하고 이메일 또는 SMS를 통해 환영 메시지를 전송할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminDeleteUser	사용자를 삭제할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminDeleteUserAttributes	사용자로부터 속성을 삭제할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminDisableProviderForUser	타사 ID 제공업체(IdP) 사용자로부터 사용자 풀 사용자를 연결 해제할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminDisableUser	사용자를 비활성화할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminEnableUser	사용자를 활성화할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminForgetDevice	사용자의 디바이스를 등록 취소할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminGetDevice	사용자의 디바이스에 대한 정보를 가져올 수 있는 권한을 부여합니다.	읽기	userpool*
AdminGetUser	사용자 이름으로 사용자를 조회할 수 있는 권한을 부여합니다.	읽기	userpool*
AdminInitiateAuth	사용자를 인증할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminLinkProviderForUser	사용자 풀 사용자를 타사 ID 제공업체(IdP) 사용자에 연결할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminListDevices	사용자의 기억된 디바이스를 나열할 수 있는 권한을 부여합니다.	목록	userpool*
AdminListGroupsForUser	사용자가 속하는 그룹을 나열할 수 있는 권한을 부여합니다.	목록	userpool*
AdminListUserAuthEvents	사용자의 로그인 이벤트를 나열할 수 있는 권한을 부여합니다.	읽기	userpool*
AdminRemoveUserFromGroup	그룹에서 사용자를 제거할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminResetUserPassword	사용자의 암호를 재설정할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminRespondToAuthChallenge	사용자가 인증하는 중에 인증 챌린지에 응답할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminSetUserMFAPreference	사용자의 선호하는 MFA 방법을 설정할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminSetUserPassword	사용자의 암호를 설정할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminSetUserSettings	사용자에 대해 사용자 설정을 설정할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminUpdateAuthEventFeedback	사용자의 인증 이벤트에 대한 고급 보안 피드백을 업데이트할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminUpdateDeviceStatus	사용자의 기억된 디바이스의 상태를 업데이트할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminUpdateUserAttributes	사용자의 표준 또는 사용자 지정 속성을 업데이트할 수 있는 권한을 부여합니다.	쓰기	userpool*
AdminUserGlobalSignOut	모든 세션에서 사용자를 로그아웃시킬 수 있는 권한을 부여합니다.	쓰기	userpool*
AssociateSoftwareToken	사용자에 대해 고유하게 생성된 공유 비밀 키 코드를 반환할 수 이는 권한을 붕합니다	쓰기
AssociateWebACL [권한만 해당]	사용자 풀을 AWS WAF 웹 ACL과 연결할 수 있는 권한을 부여합니다.	쓰기	userpool*
			webacl*
ChangePassword	사용자 풀의 지정된 사용자에 대한 암호를 변경할 수 있는 권한을 부여합니다	쓰기
ConfirmDevice	장치 추적을 확인할 수 있는 권한을 부여합니다. 이 API 호출은 디바이스 추적을 시작하는 호출입니다.	쓰기
ConfirmForgotPassword	사용자가 확인 코드를 입력하여 잊어버린 암호를 재설정할 수 있는 권한을 부여합니다	쓰기
ConfirmSignUp	사용자의 등록을 확인하고 이전 사용자의 기존 별칭을 처리할 수 이는 권한을 부여합니다	쓰기
CreateGroup	새 사용자 풀 그룹을 생성할 수 있는 권한을 부여합니다.	쓰기	userpool*
CreateIdentityProvider	사용자 풀에 ID 제공업체를 추가할 수 있는 권한을 부여합니다.	쓰기	userpool*
CreateResourceServer	OAuth 2.0 리소스 서버에 대한 범위를 생성 및 구성할 수 있는 권한을 부여합니다.	쓰기	userpool*
CreateUserImportJob	사용자 .csv 가져오기 작업을 생성할 수 있는 권한을 부여합니다.	쓰기	userpool*
CreateUserPool	사용자 풀에 대한 암호 정책을 생성하고 설정할 수 있는 권한을 부여합니다.	쓰기		aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreateUserPoolClient	사용자 풀 앱 클라이언트를 생성할 수 있는 권한을 부여합니다.	쓰기	userpool*
CreateUserPoolDomain	사용자 풀 도메인을 추가할 수 있는 권한을 부여합니다.	쓰기	userpool*
DeleteGroup	빈 사용자 풀 그룹을 삭제할 수 있는 권한을 부여합니다.	쓰기	userpool*
DeleteIdentityProvider	사용자 풀에서 ID 제공업체를 삭제할 수 있는 권한을 부여합니다.	쓰기	userpool*
DeleteResourceServer	사용자 풀에서 OAuth 2.0 리소스 서버를 삭제할 수 있는 권한을 부여합니다.	쓰기	userpool*
DeleteUser	사용자가 자신을 삭제할 수 있는 권한을 부여합니다	쓰기
DeleteUserAttributes	사용자의 속성을 삭제할 수 있는 권한을 부여합니다	쓰기
DeleteUserPool	사용자 풀을 삭제할 수 있는 권한을 부여합니다.	쓰기	userpool*
DeleteUserPoolClient	사용자 풀 앱 클라이언트를 삭제할 수 있는 권한을 부여합니다.	쓰기	userpool*
DeleteUserPoolDomain	사용자 풀 도메인을 삭제할 수 있는 권한을 부여합니다.	쓰기	userpool*
DescribeIdentityProvider	사용자 풀 ID 제공업체를 설명할 수 있는 권한을 부여합니다.	읽기	userpool*
DescribeResourceServer	OAuth 2.0 리소스 서버를 설명할 수 있는 권한을 부여합니다.	읽기	userpool*
DescribeRiskConfiguration	사용자 풀 및 앱 클라이언트의 위험 구성 설정을 설명할 수 있는 권한을 부여합니다.	읽기	userpool*
DescribeUserImportJob	사용자 가져오기 작업을 설명할 수 있는 권한을 부여합니다.	읽기	userpool*
DescribeUserPool	사용자 풀을 설명할 수 있는 권한을 부여합니다.	읽기	userpool*
DescribeUserPoolClient	사용자 풀 앱 클라이언트를 설명할 수 있는 권한을 부여합니다.	읽기	userpool*
DescribeUserPoolDomain	사용자 풀 도메인을 설명할 수 있는 권한을 부여합니다.	읽기
DisassociateWebACL [권한만 해당]	사용자 풀과 AWS WAF 웹 ACL의 연결을 해제할 수 있는 권한을 부여합니다.	쓰기	userpool*
ForgetDevice	지정된 장치를 삭제할 수 있는 권한을 부여합니다	쓰기
ForgotPassword	사용자의 암호를 변경하는 데 필요한 확인 코드와 함께 최종 사용자에게 메시지를 전송할 수 있는 권한을 부여합니다	쓰기
GetCSVHeader	사용자 가져오기 .csv 파일에 대한 헤더를 만들 수 있는 권한을 부여합니다.	읽기	userpool*
GetDevice	장치를 가져올 수 있는 권한을 부여합니다	읽기
GetGroup	사용자 풀 그룹을 설명할 수 있는 권한을 부여합니다.	읽기	userpool*
GetIdentityProviderByIdentifier	사용자 풀 IdP 식별자를 IdP 이름과 연관시킬 수 있는 권한을 부여합니다.	읽기	userpool*
GetLogDeliveryConfiguration	사용자 풀에 대한 세부 활동 로깅 구성을 가져올 수 있는 권한을 부여합니다	읽기	userpool*
GetSigningCertificate	사용자 풀에 대한 서명 인증서를 조회할 수 있는 권한을 부여합니다.	읽기	userpool*
GetUICustomization	앱 클라이언트의 호스팅된 UI에 대한 UI 사용자 지정 정보를 가져올 수 있는 권한을 부여합니다.	읽기	userpool*
GetUser	사용자에 대한 사용자 속성 및 메타데이터를 가져올 수 있는 권한을 부여합니다	읽기
GetUserAttributeVerificationCode	지정된 속성 이름에 대한 사용자 속성 확인 코드를 가져올 수 있는 권한을 부여합니다	읽기
GetUserPoolMfaConfig	사용자 풀의 MFA 구성을 조회할 수 있는 권한을 부여합니다.	읽기	userpool*
GetWebACLForResource [권한만 해당]	Amazon Cognito 사용자 풀과 연결된 AWS WAF 웹 ACL을 가져올 수 있는 권한을 부여합니다.	읽기	userpool*
GlobalSignOut	모든 장치에서 사용자를 로그아웃시킬 수 있는 권한을 부여합니다	쓰기
InitiateAuth	인증 흐름을 시작할 수 있는 권한을 부여합니다	쓰기
ListDevices	모든 장치를 나열할 수 있는 권한을 부여합니다	목록
ListGroups	사용자 풀의 모든 사용자 그룹을 나열할 수 있는 권한을 부여합니다.	목록	userpool*
ListIdentityProviders	사용자 풀의 모든 ID 제공업체를 나열할 수 있는 권한을 부여합니다.	목록	userpool*
ListResourceServers	사용자 풀의 모든 리소스 서버를 나열할 수 있는 권한을 부여합니다.	목록	userpool*
ListResourcesForWebACL [권한만 해당]	AWS WAF 웹 ACL과 연결된 사용자 풀을 나열할 수 있는 권한을 부여합니다.	목록	webacl*
ListTagsForResource	Amazon Cognito 사용자 풀에 할당된 태그를 나열할 수 있는 권한을 부여합니다.	목록	userpool
ListUserImportJobs	모든 사용자 가져오기 작업을 나열할 수 있는 권한을 부여합니다.	목록	userpool*
ListUserPoolClients	사용자 풀의 모든 앱 클라이언트를 나열할 수 있는 권한을 부여합니다.	목록	userpool*
ListUserPools	모든 사용자 풀을 나열할 수 있는 권한을 부여합니다.	목록
ListUsers	모든 사용자 풀 사용자를 나열할 수 있는 권한을 부여합니다.	목록	userpool*
ListUsersInGroup	그룹의 사용자를 나열할 수 있는 권한을 부여합니다.	목록	userpool*
ResendConfirmationCode	사용자 풀의 특정 사용자에게 확인(등록 확인용)을 재전송할 수 있는 권한을 부여합니다	쓰기
RespondToAuthChallenge	인증 챌린지에 응답할 수 있는 권한을 부여합니다	쓰기
RevokeToken	지정된 새로 고침 토큰으로 생성된 모든 액세스 토큰을 취소할 수 있는 권한을 부여합니다	쓰기
SetLogDeliveryConfiguration	사용자 풀의 세부 활동 로깅 구성을 설정하거나 수정할 수 있는 권한을 부여합니다	쓰기	userpool*
SetRiskConfiguration	사용자 풀 및 앱 클라이언트의 위험 구성을 설정할 수 있는 권한을 부여합니다.	쓰기	userpool*
SetUICustomization	앱 클라이언트에 대해 호스팅된 UI를 사용자 지정할 수 있는 권한을 부여합니다.	쓰기	userpool*
SetUserMFAPreference	사용자 풀의 사용자에 대한 MFA 기본 설정을 지정할 수 있는 권한을 부여합니다	쓰기
SetUserPoolMfaConfig	사용자 풀 MFA 구성을 설정할 수 있는 권한을 부여합니다.	쓰기	userpool*
SetUserSettings	다중 인증(MFA)과 같은 사용자 설정을 지정할 수 있는 권한을 부여합니다	쓰기
SignUp	지정된 사용자 풀에 사용자를 등록하고 사용자 이름, 암호 및 사용자 속성을 생성할 수 있는 권한을 부여합니다	쓰기
StartUserImportJob	사용자 가져오기 작업을 시작할 수 있는 권한을 부여합니다.	쓰기	userpool*
StopUserImportJob	사용자 가져오기 작업을 중지할 수 있는 권한을 부여합니다.	쓰기	userpool*
TagResource	사용자 풀에 태그를 지정할 수 있는 권한을 부여합니다.	태그 지정	userpool
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	사용자 풀에서 태그를 해제할 수 있는 권한을 부여합니다.	태그 지정	userpool
				aws:TagKeys
UpdateAuthEventFeedback	사용자 인증 이벤트에 대한 피드백을 업데이트할 수 있는 권한을 부여합니다	쓰기	userpool*
UpdateDeviceStatus	장치 상태를 업데이트할 수 있는 권한을 부여합니다	쓰기
UpdateGroup	그룹에서 구성을 업데이트할 수 있는 권한을 부여합니다.	쓰기	userpool*
UpdateIdentityProvider	사용자 풀 IdP의 구성을 업데이트할 수 있는 권한을 부여합니다.	쓰기	userpool*
UpdateResourceServer	OAuth 2.0 리소스 서버의 구성을 업데이트할 수 있는 권한을 부여합니다.	쓰기	userpool*
UpdateUserAttributes	사용자가 특정 속성을 (한 번에 하나씩) 업데이트하도록 허용할 수 있는 권한을 부여합니다	쓰기
UpdateUserPool	사용자 풀의 구성을 업데이트할 수 있는 권한을 부여합니다.	쓰기	userpool*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateUserPoolClient	사용자 풀 앱 클라이언트를 업데이트할 수 있는 권한을 부여합니다.	쓰기	userpool*
UpdateUserPoolDomain	사용자 지정 도메인의 인증서를 교체할 수 있는 권한을 부여합니다.	쓰기	userpool*
VerifySoftwareToken	사용자가 입력한 TOTP 코드를 등록하고, 성공할 경우 사용자의 소프트웨어 토큰 MFA 상태를 확인됨으로 표시할 수 있는 권한을 부여합니다	쓰기
VerifyUserAttribute	일회성 인증 코드를 사용하여 사용자 속성을 확인할 수 있는 권한을 부여합니다	쓰기

Amazon Cognito User Pools에서 정의한 리소스 유형

이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.

리소스 유형	ARN	조건 키
userpool	arn:${Partition}:cognito-idp:${Region}:${Account}:userpool/${UserPoolId}	aws:ResourceTag/${TagKey}
webacl	arn:${Partition}:wafv2:${Region}:${Account}:${Scope}/webacl/${Name}/${Id}

Amazon Cognito User Pools에 사용되는 조건 키

Amazon Cognito User Pools는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.

모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.

조건 키	설명	유형
aws:RequestTag/${TagKey}	요청에 태그 키-값 페어가 있는지 여부를 기준으로 액세스를 필터링합니다.	문자열
aws:ResourceTag/${TagKey}	리소스에 연결된 태그 키-값 페어를 기준으로 액세스를 필터링합니다.	문자열
aws:TagKeys	요청에 포함된 키를 기준으로 액세스를 필터링합니다.	ArrayOfString