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

Amazon Cognito 사용자 풀의 SMS 메시지 설정

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

Amazon Cognito는 다음 구성 중 하나를 사용하여 SMS 메시지를 보낼 수 있습니다.

사용자 풀은 한 번에 하나의 SMS 구성을 사용합니다. Amazon SNS와 AWS 최종 사용자 메시징 SMS 직접 구성은 상호 배타적입니다. 한 구성을 설정하면 Amazon Cognito가 다른 구성을 지웁니다. 이는 CreateUserPool, UpdateUserPool 및 SetUserPoolMfaConfig 작업에 적용됩니다.

Amazon SNS SMS는에 AWS 리전 나열된에서 사용할 수 있습니다Amazon SNS 경로 리전 구성. 다른의 사용자 풀에서 SMS 메시지를 보내려면를 AWS 최종 사용자 메시징 SMS 직접 AWS 리전사용합니다.

Amazon Cognito를 통해 처음으로 문자 메시지를 보내는 경우는 사용자를 샌드박스 환경에 AWS 최종 사용자 메시징 SMS 배치합니다. 샌드박스 환경에서는 애플리케이션에서 SMS 문자 메시지를 테스트할 수 있습니다. 샌드박스에서 발신 자격 증명이 있는 경우 제한된 수의 확인된 대상 전화번호로 메시지를 보내거나 그렇지 않은 경우 메시지 전송을 시뮬레이션할 수 있습니다.

AWS 최종 사용자 메시징 SMS 는 SMS 문자 메시지에 대해 요금을 부과합니다. 자세한 내용은 AWS 최종 사용자 메시징 SMS 요금을 참조하십시오.

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

메시지 옵션

¹ Essentials 기능 플랜 이상 및 Amazon SES 이메일 구성이 필요합니다.

² SMS 및 이메일 메시지의 경우.

³ 사용자 풀에 MFA가 필요하거나 선택 사항인 경우에만 MFA 메시지 템플릿을 사용자 지정할 수 있습니다. MFA가 비활성화되면 Amazon Cognito는 기본 템플릿과 함께 일회용 암호를 전송합니다.

AWS 최종 사용자 메시징 SMS 는 SMS 메시지에 대해 요금을 부과합니다. 자세한 내용은 AWS 최종 사용자 메시징 SMS 요금을 참조하십시오.

MFA에 대한 자세한 내용은 SMS 및 이메일 메시지 MFA 섹션을 참조하세요.

Amazon Cognito는 짧은 시간 내에 단일 대상으로 추가 이메일 또는 SMS 메시지를 전송하는 것을 방지할 수 있습니다. 사용자 풀이 영향을 받았다고 생각되면 메시지 전달 오류 로그를 구성하고 검토한 후 계정 팀에 문의하세요.

Amazon SNS와 중에서 선택 AWS 최종 사용자 메시징 SMS

Amazon Cognito 사용자 풀은 Amazon SNS 또는 AWS 최종 사용자 메시징 SMS 직접이라는 두 경로를 통해 SMS 메시지를 보낼 수 있습니다. 새 사용자 풀의 경우 AWS 최종 사용자 메시징 SMS 직접 경로를 사용합니다. Amazon SNS SMS는 고정된 세트에서만 사용할 수 있습니다 AWS 리전. 직접 AWS 최종 사용자 메시징 SMS 경로는 추가 리전을 지원하고 Amazon SNS 경로가 지원하지 않는 기능을 노출합니다. 두 경로 모두 메시지를 전달합니다 AWS 최종 사용자 메시징 SMS.

다음 표에서는 두 SMS 구성 경로를 비교합니다.

Amazon Cognito 사용자 풀 API의 SMS 구성

Amazon Cognito 사용자 풀 API의 SmsConfigurationType 객체에는 사용자 풀에 대한 SMS 구성이 포함되어 있습니다. 이 객체에는 다음과 같은 구성 경로가 있습니다.

자세한 내용은 Amazon Cognito 사용자 풀 API 참조의 SmsConfigurationType을 참조하세요. Amazon Cognito

모범 사례

원치 않는 SMS 트래픽 양의 전 세계적 증가로 인해 일부 정부는 SMS 메시지 발신자와 수신자 사이에 장벽을 부과하고 있습니다. MFA와 사용자 업데이트에 SMS 메시지를 사용하는 경우 메시지가 전달되도록 추가 조치를 취해야 합니다. 또한 사용자가 거주할 수 있는 국가의 SMS 메시지 관련 규정을 모니터링하고 SMS 메시지 구성을 최신 상태로 유지해야 합니다. 자세한 내용은 AWS 최종 사용자 메시징 SMS 사용 설명서에서 SMS 및 MMS 국가별 기능과 제한 사항을 참조하세요.

SMS 메시지를 사용한 사용자 인증과 확인은 보안 모범 사례가 아닙니다. 전화번호는 소유자가 바뀔 수 있으며, 사용자의 가지고 있는 것 MFA 요소를 확실히 대표하지 못할 수 있습니다. 대신 앱이나 서드 파티 IdP를 사용하여 TOTP MFA를 구현하세요. 사용자 정의 인증 챌린지 Lambda 트리거를 사용하여 추가 사용자 지정 인증 요소를 생성할 수도 있습니다.

SMS 메시지 전송 아키텍처 보안에 대한 자세한 내용은 다음 링크를 검토하세요.

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

Amazon Cognito는 Amazon SNS(및 간접적으로 AWS 최종 사용자 메시징 SMS) 또는 AWS 최종 사용자 메시징 SMS 를 사용하여 사용자 풀에서 SMS 메시지를 보냅니다. 자체 리소스를 사용하는 사용자 지정 SMS 발신자 Lambda 트리거를 사용하여 SMS 메시지를 보낼 수도 있습니다. 특정에서 SMS 문자 메시지를 처음 설정하면가 해당 리전의 SMS 샌드박스 AWS 계정 에 AWS 리전 AWS 최종 사용자 메시징 SMS 배치됩니다. AWS 최종 사용자 메시징 SMS 는 샌드박스를 사용하여 사기 및 침해를 방지하고 규정 준수 요구 사항을 충족합니다. AWS 계정 가 샌드박스에 있는 경우는 몇 가지 제한을 AWS 최종 사용자 메시징 SMS 부과합니다. 예를 들어 발신 ID가 있는 경우 최대 10개의 확인된 대상 번호로 문자 메시지를 보내거나 발신 ID 없이 메시지 전송을 시뮬레이션할 수 있습니다. 가 샌드박스에 AWS 계정 있는 동안에는 프로덕션 환경에서 SMS 메시지를 보내지 마십시오. 샌드박스에서는 Amazon Cognito가 사용자의 전화 번호로 메시지를 보낼 수 없습니다.

Amazon Cognito가 SMS 메시지를 보내는 데 사용할 수 있는 IAM 역할 준비 AWS 최종 사용자 메시징 SMS

사용자 풀에서 SMS 메시지를 보낼 때 Amazon Cognito는 계정에서 IAM 역할을 맡습니다. 역할에 필요한 권한은 선택한 SMS 구성 경로에 따라 다릅니다.

Amazon Cognito 콘솔의 SMS 아래에 있는 사용자 풀의 인증 방법 메뉴에서 IAM 역할 선택을 설정하거나 사용자 풀 생성 마법사 중에 선택할 수 있습니다.

다음 예제에서는 IAM 역할 신뢰 정책은 Amazon Cognito 사용자 풀에 역할을 맡을 수 있는 제한된 권한을 부여합니다. Amazon Cognito는 다음 조건을 충족하는 경우에만 해당 역할을 수행할 수 있습니다.

이러한 신뢰 정책 조건은 Amazon SNS 경로와 AWS 최종 사용자 메시징 SMS 직접 경로 모두에 적용됩니다.

JSON

{
    "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 사용 설명서의 역할 용어 및 개념을 참조하세요.

사용자 풀에 대한 AWS 최종 사용자 메시징 SMS 직접 SMS를 설정하려면

다음 절차에 따라 SMS 메시지를 직접 보내도록 사용자 풀을 구성합니다 AWS 최종 사용자 메시징 SMS. 이 구성은 SmsConfigurationType의 EumsSms 객체를 사용합니다.

AWS 최종 사용자 메시징 SMS 직접 SMS에 대한 IAM 권한

의 IAM 역할에는 cognito-idp.amazonaws.com 서비스 보안 주체가 이를 수임하도록 허용하는 신뢰 정책이 CallerArn 필요합니다. Amazon SNS 경로와 동일한 신뢰 정책 구조를 사용합니다( 참조Amazon Cognito가 SMS 메시지를 보내는 데 사용할 수 있는 IAM 역할 준비 AWS 최종 사용자 메시징 SMS). 또한 역할에는 발신 자격 증명 ARN에 sms-voice:SendTextMessage 범위가 지정된 권한을 부여하는 권한 정책이 필요합니다(의 설정 절차 참조사용자 풀에 대한 AWS 최종 사용자 메시징 SMS 직접 SMS를 설정하려면).

SMS 메시지 AWS 리전 용 선택

Amazon SNS 경로 리전 구성

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

새 사용자 풀 마법사의 메시지 전송 구성(Configure message delivery) 단계에서 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 SNS(경유 AWS 최종 사용자 메시징 SMS)는 모든 신규 계정에 대한 지출 할당량을 매월 1.00 USD(USD)로 설정합니다. Amazon Cognito와 함께 사용할 AWS 리전 에서 지출 한도를 늘렸을 수도 있습니다. Amazon SNS SMS 메시지에 AWS 리전 대한를 변경하기 전에 AWS 지원 센터에서 할당량 증가 사례를 열어 새 리전의 한도를 늘리세요. 자세한 내용은 AWS 최종 사용자 메시징 SMS 사용 설명서의 AWS 최종 사용자 메시징 SMS MMS 및 Voice 샌드박스에서 프로덕션으로 이동을 참조하세요.

다음 표의 모든 Amazon Cognito 리전에 대해 해당 SMS 메시지 리전의 AWS 최종 사용자 메시징 SMS 리소스를 사용하여 SMS 메시지를 보낼 수 있습니다.

AWS 최종 사용자 메시징 SMS 다이렉트 경로 리전 구성

AWS 최종 사용자 메시징 SMS 는 자체 세트에서 사용할 수 있으며 AWS 리전, Amazon SNS 또는 Amazon Cognito 사용자 풀을 사용할 수 있는 리전과 다를 수 있습니다. 현재 목록은 AWS 최종 사용자 메시징 SMS 사용 설명서의 지원되는 리전 및 국가를 참조하세요.

SmsConfigurationType의 EumsSms 객체 Region 필드는 Amazon Cognito가를 호출 AWS 리전 하는를 설정합니다 AWS 최종 사용자 메시징 SMS. 사용자 풀의 리전에서를 사용할 수 있어야 AWS 최종 사용자 메시징 SMS 합니다. Omit Region 및 Amazon Cognito는 사용자 풀의 리전 AWS 최종 사용자 메시징 SMS 에서를 사용하거나 사용자 풀의 리전Region으로 명시적으로 설정합니다. Amazon Cognito는 다른 모든 값을 거부합니다.

미국 전화 번호로 SMS 메시지를 보내기 위한 발신 자격 증명 얻기

미국 전화 번호로 SMS 문자 메시지를 보내려는 경우 SMS 샌드박스 테스트 환경을 구축하거나 프로덕션 환경을 구축하는 경우 모두 발신 자격 증명을 얻어야 합니다.

미국 이동 통신사는 미국 전화 번호로 메시지를 보낼 때 발신 ID를 요구합니다. 발신 자격 증명이 아직 없는 경우 받아야 합니다. 발신 ID를 얻는 방법을 알아보려면 AWS 최종 사용자 메시징 SMS 사용 설명서에서 전화번호 요청을 참조하세요.

동일한에 둘 이상의 발신 자격 증명이 있는 경우는 단축 코드 AWS 리전, 10DLC, 수신자 부담 전화번호의 우선 순위에 따라 발신 자격 증명 유형을 AWS 최종 사용자 메시징 SMS 선택합니다. 이 우선 순위는 변경할 수 없습니다. 자세한 내용은 AWS 최종 사용자 메시징 SMS FAQ를 참조하세요.

환경이 SMS 샌드박스인지 확인합니다.

환경이 SMS 샌드박스인지 확인하려면 다음 절차를 따르세요. 프로덕션 Amazon Cognito 사용자 풀 AWS 리전 이 있는 각에 대해 반복합니다.

샌드박스에서 계정 이동

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

AWS 최종 사용자 메시징 SMS 콘솔 또는 Amazon SNS 콘솔에서 샌드박스를 종료하는 요청을 생성할 수 있습니다. 자세한 지침은 AWS 최종 사용자 메시징 SMS 사용 설명서의 SMS 샌드박스에서 이동을 참조하세요.

에서 시뮬레이터 번호 또는 확인된 전화번호 사용 AWS 최종 사용자 메시징 SMS

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

샌드박스에 있지만 발신 번호를 설정한 경우 확인된 대상 번호로 메시지를 보낼 수 있습니다. 확인된 대상을 설정하려면 AWS 최종 사용자 메시징 SMS 사용 설명서의 확인된 대상 전화번호 추가를 참조하세요.

시뮬레이션된 발신자 및 대상으로 메시지를 보낼 수도 있습니다. 시뮬레이터 메시지는 로그를 생성하지만 통신 사업자 네트워크를 통해 전송되지는 않습니다. 바로 가기 메뉴에서 SMS 시뮬레이터를 사용한 SMS 전송 테스트를 선택합니다. 자세한 내용은 AWS 최종 사용자 메시징 SMS 사용 설명서의 시뮬레이터 전화번호를 참조하세요.

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

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