翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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 は Amazon SNS を使用してユーザープールにSMSメッセージを送信します。を使用してカスタムSMS送信者の Lambda トリガー独自のリソースを使用してSMSメッセージを送信することもできます。特定の でSMSテキストメッセージを送信するSNSように Amazon を初めて設定すると AWS リージョン、Amazon はそのリージョン AWS アカウント のSMSサンドボックスに 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またはワイルドカードを指定できます。 AWS Management Console または DescribeUserPoolAPIリクエストを使用して、ユーザープールARNsの を検索します。

多要素認証のSMSメッセージを送信するには、IAMロールの信頼ポリシーに sts:ExternalId条件が必要です。 SMS MFAこの条件の値は、ユーザープールの 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 リージョン を選択する

一部の では AWS リージョン、Amazon Cognito SMS メッセージに使用する Amazon SNSリソースを含むリージョンを選択できます。アジアパシフィック (ソウル) を除く 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 SNSは、すべての新規アカウントの支出クォータを 1 か月あたり 1.00 USD (USD) に設定します。Amazon Cognito AWS リージョン で使用する で支出制限が引き上げられた可能性があります。 AWS リージョン Amazon SNS SMS メッセージの を変更する前に、 AWS サポートセンターでクォータ引き上げケースを開いて、新しいリージョンの制限を引き上げてください。詳細については、「Amazon Simple Notification Service デベロッパーガイド」の「Amazon の月額SMS使用クォータの引き上げをリクエストSNSする」を参照してください。

次の表の任意の Amazon Cognito リージョンのSMSメッセージは、対応する Amazon SNSリージョン の Amazon SNSリソースを使用して送信できます。

米国の電話番号にSMSメッセージを送信するための発信元 ID を取得する

米国の電話番号にSMSテキストメッセージを送信する場合は、SMSサンドボックステスト環境を構築するか、本番環境を構築するかにかかわらず、発信元 ID を取得する必要があります。

米国の通信事業者は 2021 年 6 月 1 日付けで、米国の電話番号へのメッセージの送信に発信元 ID を義務付けました。発信元 ID をまだ取得していない場合は、取得する必要があります。発信元 ID を取得する方法については、Amazon Pinpoint ユーザーガイドの「番号のリクエスト」を参照してください。

次の で運用する場合は AWS リージョン、 AWS Support チケットを開いて発信元 ID を取得する必要があります。手順については、「Amazon Simple Notification Service デベロッパーガイド」のSMS「メッセージングのサポートのリクエスト」を参照してください。

同じ に複数の発信元 ID がある場合 AWS リージョン、Amazon は、ショートコード、10、DLC通話料無料番号の優先順位で発信元 ID タイプSNSを選択します。この優先順位を変更することはできません。詳細については、「Amazon SNS FAQs」を参照してください。

SMS サンドボックスにいることを確認する

次の手順を使用して、SMSサンドボックスにいることを確認します。本番稼働用の Amazon Cognito ユーザープール AWS リージョン がある各 に対して、同じ手順を繰り返します。

Amazon SNSサンドボックスからアカウントを移動する

アプリをテストしていて、管理者が検証できる電話番号にのみSMSメッセージを送信する必要がある場合は、このステップをスキップしてください。

アプリケーションを本番環境で使用するには、アカウントをSMSサンドボックスから本番環境に移動します。Amazon Cognito で使用する Amazon SNSリソースを含む で AWS リージョン 発信元 ID を設定したら、 がSMSサンドボックスに AWS アカウント 残っている間、米国の電話番号を確認できます。Amazon SNS環境が本番環境にある場合、ユーザーにSNSSMSメッセージを送信するために Amazon でユーザーの電話番号を確認する必要はありません。

詳細な手順については、「Amazon Simple Notification Service デベロッパーガイド」のSMS「サンドボックス外への移動」を参照してください。

Amazon での Amazon Cognito の電話番号の確認 SNS

アカウントをSMSサンドボックスから移動した場合は、このステップをスキップします。

SMS サンドボックスにいるときは、Amazon で検証した任意の電話番号にメッセージを送信できますSNS。

電話番号を確認するには、次の手順を実行します。

詳細な手順については、「Amazon Simple Notification Service デベロッパーガイド」のSMS「サンドボックスでの電話番号の追加と検証」を参照してください。

Amazon Cognito でユーザープールのセットアップを完了する

ユーザープールを作成または編集していたブラウザタブに戻ります。手順を完了します。ユーザープールSMSに設定を正常に追加すると、Amazon Cognito は内部電話番号にテストメッセージを送信して、設定が機能することを確認します。Amazon では、テストSMSメッセージごとにSNS料金が発生します。