기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

SMS Amazon Cognito 사용자 풀에 대한 메시지 설정

사용자 풀에 대한 일부 Amazon Cognito 이벤트로 인해 Amazon Cognito가 사용자에게 SMS 문자 메시지를 보낼 수 있습니다. 예를 들어 전화 확인이 필요하도록 사용자 풀을 구성하면 사용자가 앱의 새 계정에 가입하거나 암호를 재설정할 때 Amazon Cognito가 SMS 문자 메시지를 보냅니다. SMS 문자 메시지를 시작하는 작업에 따라 메시지에 확인 코드, 임시 암호 또는 환영 메시지가 포함됩니다.

Amazon Cognito는 Amazon Simple Notification Service(Amazon SNS)를 사용하여 SMS 문자 메시지를 전송합니다. Amazon Cognito 또는 Amazon을 통해 문자 메시지를 SNS 처음 보내는 경우 Amazon은 사용자를 샌드박스 환경에 SNS 배치합니다. 샌드박스 환경에서 애플리케이션에 SMS 텍스트 메시지가 있는지 테스트할 수 있습니다. 샌드박스에서 메시지는 확인된 전화 번호로만 보낼 수 있습니다.

Amazon은 SMS 문자 메시지에 대해 SNS 요금을 부과합니다. 자세한 내용은 Amazon SNS 요금 섹션을 참조하세요.

Amazon Cognito는 사용자가 입력할 수 있는 코드를 사용하여 사용자에게 SMS 메시지를 보냅니다. 다음 표에는 SMS 메시지를 생성할 수 있는 이벤트가 나와 있습니다.

메시지 옵션

1 SMS 메시지의 경우.

Amazon Cognito 사용자 풀에서 처음으로 SMS 메시징 설정

Amazon Cognito는 AmazonSNS을 사용하여 사용자 풀로 SMS 메시지를 전송합니다. 사용자 지정 SMS 발신자 Lambda 트리거 를 사용하여 자체 리소스를 사용하여 SMS 메시지를 보낼 수도 있습니다. 특정 에서 SMS 문자 메시지를 보내SNS도록 Amazon을 처음 설정한 경우 AWS 리전 Amazon은 해당 리전의 SMS샌드박스 AWS 계정 에 를 SNS 배치합니다.Amazon은 샌드박스를 SNS 사용하여 사기 및 남용을 방지하고 규정 준수 요구 사항을 충족합니다. AWS 계정 가 샌드박스에 있을 때 Amazon은 몇 가지 제한을 SNS 적용합니다. 예를 들어 Amazon 에서 확인한 최대 10개의 전화번호로 문자 메시지를 보낼 수 있습니다SNS. 가 샌드박스에 AWS 계정 남아 있는 동안에는 프로덕션 중인 애플리케이션에 Amazon SNS 구성을 사용하지 마세요. 샌드박스에서는 Amazon Cognito가 사용자의 전화 번호로 메시지를 보낼 수 없습니다.

Amazon Cognito가 Amazon으로 SMS 메시지를 보내는 데 사용할 수 있는 IAM 역할 준비 SNS

사용자 풀에서 SMS 메시지를 보내면 Amazon Cognito가 계정에서 IAM 역할을 맡습니다. Amazon Cognito는 해당 역할에 할당된 sns:Publish 권한을 사용하여 사용자에게 SMS 메시지를 보냅니다. Amazon Cognito 콘솔의 사용자 풀의 메시징 탭에서 IAM 역할 선택을 설정SMS하거나 사용자 풀 생성 마법사 중에 선택할 수 있습니다.

다음 IAM 역할 신뢰 정책 예제는 Amazon Cognito 사용자 풀에 역할을 수임할 수 있는 제한된 기능을 부여합니다. Amazon Cognito는 다음 조건을 충족하는 경우에만 역할을 수임할 수 있습니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service": "cognito-idp.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "sts:ExternalId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
                    "aws:SourceAccount": "111122223333"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:cognito-idp:us-west-2:111122223333:userpool/us-west-2_EXAMPLE"
                }
            }
        }
    ]
}

aws:SourceArn 조건 값에 정확한 사용자 풀 ARN 또는 와일드카드ARN를 지정할 수 있습니다. DescribeUserPool API 요청으로 AWS Management Console 또는 에서 사용자 풀ARNs의 를 조회합니다.

다중 인증 에 대한 SMS 메시지를 보내려면 IAM 역할 신뢰 정책에 sts:ExternalId 조건이 있어야 합니다. 이 조건의 값은 SmsConfiguration 사용자 풀의 ExternalId 속성과 일치해야 합니다. Amazon Cognito 콘솔에서 사용자 풀 생성 프로세스 중에 IAM 역할을 생성할 때 Amazon Cognito는 역할 및 사용자 풀 설정에서 외부 ID를 구성합니다. 기존 IAM 역할을 사용할 때는 그렇지 않습니다.

UpdateUserPool API 요청에서 사용자 풀 ExternalId 파라미터를 업데이트하고 IAM 역할 신뢰 정책을 동일한 값의 sts:externalId 조건으로 업데이트해야 합니다. API 를 사용하여 원래 구성을 보존하는 방식으로 사용자 풀을 업데이트하는 방법을 알아보려면 섹션을 참조하세요사용자 풀 및 앱 클라이언트 구성 업데이트.

IAM 역할 및 신뢰 정책에 대한 자세한 내용은 AWS Identity and Access Management 사용 설명서의 역할 용어 및 개념을 참조하세요.

Amazon SNS SMS 메시지 AWS 리전 용 을 선택합니다.

일부 에서는 Amazon Cognito SMS 메시지에 사용할 Amazon SNS 리소스가 포함된 리전을 선택할 AWS 리전수 있습니다. 아시아 태평양(서울)을 제외하고 Amazon Cognito를 사용할 수 AWS 리전 있는 모든 AWS 리전 에서 사용자 풀을 생성한 에서 Amazon SNS 리소스를 사용할 수 있습니다. 리전을 선택할 때 SMS 메시징을 더 빠르고 안정적으로 만들려면 사용자 풀과 동일한 리전의 Amazon SNS 리소스를 사용합니다.

새 사용자 풀 마법사의 메시지 전송 구성 단계에서 SMS 리소스의 리전을 선택합니다. 기존 사용자 풀의 SMS 메시징 탭에서 아래에서 편집을 선택할 수도 있습니다.

시작 시 일부 의 경우 AWS 리전 Amazon Cognito는 대체 리전의 Amazon SNS 리소스와 함께 SMS 메시지를 보냈습니다. 선호하는 리전을 설정하려면 사용자 풀에 대한 SmsConfigurationType 객체 SnsRegion 파라미터를 사용합니다. 다음 테이블에서 프로그래밍 방식으로 Amazon Cognito 리전에 Amazon Cognito 사용자 풀 리소스를 생성하고 SnsRegion 파라미터를 제공하지 않으면 사용자 풀이 레거시 Amazon SNS 리전 의 Amazon SNS 리소스와 함께 SMS 메시지를 보낼 수 있습니다.

아시아 태평양(서울)의 Amazon Cognito 사용자 풀 AWS 리전 은 아시아 태평양(도쿄) 리전에서 Amazon SNS 구성을 사용해야 합니다.

Amazon은 모든 신규 계정에 대한 지출 할당량을 매월 $1.00(USD)로 SNS 설정합니다. Amazon Cognito 에 사용하는 에서 지출 한도를 늘렸 AWS 리전 을 수 있습니다. Amazon SNS SMS 메시지에 AWS 리전 대한 를 변경하기 전에 AWS 지원 센터에서 할당량 증가 사례를 열어 새 리전에서 한도를 늘립니다. 자세한 내용은 Amazon Simple Notification Service 개발자 안내서의 Amazon에 대한 월별 SMS 지출 할당량 증가 요청을 참조하세요SNS.

다음 표의 모든 Amazon Cognito 리전에 대해 해당 Amazon 리전 의 Amazon SNS 리소스와 함께 SMS 메시지를 보낼 수 SNS 있습니다.

미국 전화번호로 SMS 메시지를 전송하기 위한 발신 자격 증명 획득

SMS 문자 메시지를 미국 전화번호로 보내려는 경우 SMS샌드박스 테스트 환경을 구축하든 프로덕션 환경을 구축하든 관계없이 발신 ID를 얻어야 합니다.

2021년 6월 1일부터 미국 이동 통신사는 미국 전화 번호로 메시지를 보낼 때 발신 자격 증명을 요구합니다. 발신 자격 증명이 아직 없는 경우 받아야 합니다. 소스 자격 증명을 얻는 방법을 알아보려면 Amazon Pinpoint 사용 설명서에서 번호 요청을 참조하세요.

다음 에서 작업하는 경우 AWS Support 티켓을 열어 오리진 자격 증명을 얻어야 AWS 리전합니다. 지침은 Amazon Simple Notification Service 개발자 안내서의 SMS 메시징 지원 요청을 참조하세요.

동일한 에 두 개 이상의 오리진 자격 증명이 있는 경우 Amazon은 단축 코드 AWS 리전, 10DLC, 수신자 부담 전화번호의 우선 순위 순서로 오리진 자격 증명 유형을 SNS 선택합니다. 이 우선 순위는 변경할 수 없습니다. 자세한 내용은 Amazon SNS FAQs을 참조하세요.

SMS 샌드박스에 있는지 확인

다음 절차에 따라 SMS샌드박스에 있는지 확인합니다. 프로덕션 Amazon Cognito 사용자 풀이 AWS 리전 있는 각 에 대해 반복합니다.

Amazon SNS샌드박스에서 계정 이동

앱을 테스트하고 있고 관리자가 확인할 수 있는 전화번호로만 SMS 메시지를 전송하면 되는 경우 이 단계를 건너뜁니다.

프로덕션에서 앱을 사용하려면 계정을 SMS샌드박스에서 프로덕션으로 이동합니다. Amazon Cognito에서 사용하려는 Amazon SNS 리소스가 포함된 에서 AWS 리전 오리진 자격 증명을 구성한 후에는 가 SMS샌드박스에 AWS 계정 있는 동안 미국 전화번호를 확인할 수 있습니다. Amazon SNS 환경이 프로덕션 상태인 경우 사용자에게 SMS 메시지를 보내기 SNS 위해 Amazon의 사용자 전화번호를 확인할 필요가 없습니다.

자세한 지침은 Amazon Simple Notification Service 개발자 안내서의 SMS Sandbox 밖으로 이동을 참조하세요.

Amazon에서 Amazon Cognito의 전화번호 확인 SNS

SMS 샌드박스에서 계정을 이동한 경우 이 단계를 건너뜁니다.

SMS 샌드박스에 있는 경우 Amazon 에서 확인한 모든 전화번호로 메시지를 보낼 수 있습니다SNS.

전화 번호를 확인하려면 다음을 수행합니다.

자세한 지침은 Amazon Simple Notification Service 개발자 안내서의 SMS샌드박스에서 전화번호 추가 및 확인을 참조하세요.

Amazon Cognito에서 사용자 풀 설정 완료

사용자 풀을 생성 또는 편집하던 브라우저 탭으로 돌아갑니다. 절차를 완료합니다. 사용자 풀에 SMS 구성을 성공적으로 추가하면 Amazon Cognito는 구성이 작동하는지 확인하기 위해 내부 전화번호로 테스트 메시지를 보냅니다. Amazon은 각 테스트 SMS 메시지에 대해 SNS 요금을 부과합니다.