Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

SMSpengaturan pesan untuk kumpulan pengguna Amazon Cognito

Beberapa peristiwa Amazon Cognito untuk kumpulan pengguna Anda dapat menyebabkan Amazon Cognito SMS mengirim pesan teks ke pengguna Anda. Misalnya, jika Anda mengonfigurasi kumpulan pengguna agar memerlukan verifikasi telepon, Amazon Cognito akan mengirimkan pesan SMS teks saat pengguna mendaftar akun baru di aplikasi Anda atau menyetel ulang kata sandi mereka. Bergantung pada tindakan yang memulai pesan SMS teks, pesan berisi kode verifikasi, kata sandi sementara, atau pesan selamat datang.

Amazon Cognito menggunakan Amazon Simple Notification Service SNS (Amazon) untuk pengiriman SMS pesan teks. Jika Anda mengirim pesan teks melalui Amazon Cognito atau Amazon SNS untuk pertama kalinya, Amazon SNS menempatkan Anda di lingkungan kotak pasir. Di lingkungan kotak pasir, Anda dapat menguji aplikasi Anda untuk pesan SMS teks. Di sandbox, pesan hanya bisa dikirim ke nomor telepon terverifikasi.

Amazon SNS mengenakan biaya untuk pesan SMS teks. Untuk informasi selengkapnya, lihat SNSharga Amazon.

Amazon Cognito mengirimkan SMS pesan ke pengguna Anda dengan kode yang dapat mereka masukkan. Tabel berikut menunjukkan peristiwa yang dapat menghasilkan SMS pesan.

Opsi pesan

¹ Untuk SMS pesan.

Menyiapkan SMS pesan untuk pertama kalinya di kumpulan pengguna Amazon Cognito

Amazon Cognito menggunakan Amazon SNS untuk mengirim SMS pesan ke kumpulan pengguna Anda. Anda juga dapat menggunakan a Pemicu Lambda SMS pengirim kustom untuk menggunakan sumber daya Anda sendiri untuk mengirim SMS pesan. Pertama kali Anda mengatur Amazon SNS untuk mengirim pesan SMS teks tertentu Wilayah AWS, Amazon SNS menempatkan Anda Akun AWS di SMS kotak pasir untuk Wilayah itu.Amazon SNS menggunakan kotak pasir untuk mencegah penipuan dan penyalahgunaan dan untuk memenuhi persyaratan kepatuhan. Saat Anda Akun AWS berada di kotak pasir, Amazon SNS memberlakukan beberapa batasan. Misalnya, Anda dapat mengirim pesan teks ke maksimum 10 nomor telepon yang telah Anda verifikasi dengan AmazonSNS. Saat Anda Akun AWS tetap berada di kotak pasir, jangan gunakan SNS konfigurasi Amazon Anda untuk aplikasi yang sedang diproduksi. Saat Anda berada di sandbox, Amazon Cognito tidak dapat mengirim pesan ke nomor telepon pengguna Anda.

Siapkan IAM peran yang dapat digunakan Amazon Cognito untuk mengirim SMS pesan dengan Amazon SNS

Saat Anda mengirim SMS pesan dari kumpulan pengguna, Amazon Cognito IAM berperan dalam akun Anda. Amazon Cognito menggunakan sns:Publish izin yang ditetapkan untuk peran tersebut untuk mengirim SMS pesan ke pengguna Anda. Di konsol Amazon Cognito, Anda dapat mengatur pemilihan IAM peran dari tab Pesan kumpulan pengguna, di bawah SMSatau membuat pilihan ini selama panduan pembuatan kumpulan pengguna.

Contoh kebijakan kepercayaan IAM peran berikut memberikan kumpulan pengguna Amazon Cognito kemampuan terbatas untuk mengambil peran tersebut. Amazon Cognito hanya dapat mengambil peran ketika memenuhi persyaratan berikut:

{
    "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"
                }
            }
        }
    ]
}

Anda dapat menentukan kumpulan pengguna yang tepat ARN atau wildcard ARN dalam nilai aws:SourceArn kondisi. Cari kumpulan pengguna Anda di AWS Management Console atau dengan DescribeUserPoolAPIpermintaan. ARNs

Untuk mengirim SMS pesan autentikasi multi-faktor, kebijakan kepercayaan IAM peran Anda harus memiliki sts:ExternalId kondisi. Nilai kondisi ini harus sesuai dengan ExternalId properti kumpulan pengguna Anda. SmsConfiguration Saat Anda membuat IAM peran selama proses pembuatan kumpulan pengguna di konsol Amazon Cognito, Amazon Cognito mengonfigurasi ID eksternal untuk Anda dalam peran dan pengaturan kumpulan pengguna. Ini tidak benar ketika Anda menggunakan IAM peran yang ada.

Anda harus memperbarui ExternalId parameter kumpulan pengguna dalam UpdateUserPoolAPIpermintaan dan memperbarui kebijakan kepercayaan IAM peran dengan sts:externalId kondisi dengan nilai yang sama. Untuk mempelajari cara menggunakan kumpulan pengguna API untuk memperbarui kumpulan pengguna dengan cara mempertahankan konfigurasi asli, lihatMemperbarui kumpulan pengguna dan konfigurasi klien aplikasi.

Untuk informasi selengkapnya tentang IAM peran dan kebijakan kepercayaan, lihat Istilah dan konsep peran di Panduan AWS Identity and Access Management Pengguna.

Pilih SNS SMS pesan Wilayah AWS untuk Amazon

Di beberapa Wilayah AWS, Anda dapat memilih Wilayah yang berisi SNS sumber daya Amazon yang ingin Anda gunakan untuk pesan Amazon CognitoSMS. Di Wilayah AWS mana pun Amazon Cognito tersedia, kecuali untuk Asia Pasifik (Seoul), Anda dapat menggunakan SNS sumber daya Amazon di Wilayah AWS tempat Anda membuat kumpulan pengguna. Untuk membuat SMS pesan Anda lebih cepat dan lebih andal ketika Anda memiliki pilihan Wilayah, gunakan SNS sumber daya Amazon di Wilayah yang sama dengan kumpulan pengguna Anda.

Pilih Wilayah untuk SMS sumber daya di langkah Konfigurasi pengiriman pesan dari panduan kumpulan pengguna baru. Anda juga dapat memilih Edit SMSdi bawah tab Pesan dari kumpulan pengguna yang ada.

Saat peluncuran, bagi sebagian orang Wilayah AWS, Amazon Cognito mengirim SMS pesan dengan SNS sumber daya Amazon di Wilayah alternatif. Untuk mengatur Wilayah pilihan Anda, gunakan SnsRegion parameter SmsConfigurationTypeobjek untuk kumpulan pengguna Anda. Saat Anda membuat sumber daya kumpulan pengguna Amazon Cognito secara terprogram di Wilayah Amazon Cognito dari tabel berikut dan Anda tidak memberikan SnsRegion parameter, kumpulan pengguna dapat mengirim SMS pesan dengan SNS sumber daya Amazon di Wilayah Amazon lama. SNS

Kumpulan pengguna Amazon Cognito di Asia Pasifik (Seoul) Wilayah AWS harus menggunakan SNS konfigurasi Amazon Anda di Wilayah Asia Pasifik (Tokyo).

Amazon SNS menetapkan kuota pengeluaran untuk semua akun baru sebesar $1,00 (USD) per bulan. Anda mungkin telah meningkatkan batas pengeluaran Anda dalam Wilayah AWS yang Anda gunakan dengan Amazon Cognito. Sebelum Anda mengubah SNS SMS pesan Wilayah AWS untuk Amazon, buka kasus peningkatan kuota di AWS Support Center untuk meningkatkan batas Anda di Wilayah baru. Untuk informasi selengkapnya, lihat Meminta peningkatan kuota SMS pengeluaran bulanan Anda untuk Amazon SNS di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

Anda dapat mengirim SMS pesan untuk Wilayah Amazon Cognito di tabel berikut dengan SNS sumber daya Amazon di Wilayah Amazon SNS yang sesuai.

Dapatkan identitas originasi untuk mengirim SMS pesan ke nomor telepon AS

Jika Anda berencana untuk mengirim pesan SMS teks ke nomor telepon AS, Anda harus mendapatkan identitas originasi, terlepas dari apakah Anda membangun lingkungan pengujian SMS kotak pasir, atau lingkungan produksi.

Mulai 1 Juni 2021, operator AS memerlukan identitas originasi untuk mengirim pesan ke nomor telepon AS. Jika Anda belum memiliki identitas originasi, Anda harus mendapatkannya. Untuk mempelajari cara mendapatkan identitas asal, lihat Meminta nomor dalam Panduan Pengguna Amazon Pinpoint.

Jika Anda beroperasi di bawah ini Wilayah AWS, Anda harus membuka AWS Support tiket untuk mendapatkan identitas originasi. Untuk petunjuknya, lihat Meminta dukungan untuk SMS perpesanan di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

Ketika Anda memiliki lebih dari satu identitas originasi yang sama Wilayah AWS, Amazon SNS memilih jenis identitas originasi dalam urutan prioritas berikut: kode pendek, 10DLC, nomor bebas pulsa. Anda tidak dapat mengubah prioritas ini. Untuk informasi selengkapnya, lihat Amazon SNS FAQs.

Konfirmasikan bahwa Anda berada di kotak SMS pasir

Gunakan prosedur berikut untuk mengonfirmasi bahwa Anda berada di SMS kotak pasir. Ulangi untuk setiap Wilayah AWS tempat Anda memiliki kumpulan pengguna Amazon Cognito produksi.

Pindahkan akun Anda dari kotak SNS pasir Amazon

Jika Anda menguji aplikasi dan hanya perlu mengirim SMS pesan ke nomor telepon yang dapat diverifikasi oleh administrator, lewati langkah ini.

Untuk menggunakan aplikasi Anda dalam produksi, pindahkan akun Anda dari SMS kotak pasir dan masuk ke produksi. Setelah Anda mengonfigurasi identitas originasi di Wilayah AWS yang berisi SNS sumber daya Amazon yang ingin digunakan Amazon Cognito, Anda dapat memverifikasi nomor telepon AS saat Akun AWS Anda tetap berada di SMS kotak pasir. Saat SNS lingkungan Amazon Anda dalam produksi, Anda tidak perlu memverifikasi nomor telepon pengguna di Amazon SNS untuk mengirim SMS pesan ke pengguna Anda.

Untuk petunjuk mendetail, lihat Keluar dari SMS Kotak Pasir di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

Verifikasi nomor telepon untuk Amazon Cognito di Amazon SNS

Jika Anda telah memindahkan akun Anda dari SMS kotak pasir, lewati langkah ini.

Saat Anda berada di SMS kotak pasir, Anda dapat mengirim pesan ke nomor telepon apa pun yang telah Anda verifikasi dengan AmazonSNS.

Untuk memverifikasi nomor telepon, lakukan hal berikut:

Untuk petunjuk selengkapnya, lihat Menambahkan dan memverifikasi nomor telepon di SMS kotak pasir di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

Selesaikan pengaturan kumpulan pengguna di Amazon Cognito

Kembali ke tab browser tempat Anda membuat atau mengedit kolam pengguna Anda. Selesaikan prosedur. Jika Anda berhasil menambahkan SMS konfigurasi ke kumpulan pengguna, Amazon Cognito mengirimkan pesan pengujian ke nomor telepon internal untuk memverifikasi bahwa konfigurasi Anda berfungsi. Amazon SNS mengenakan biaya untuk setiap SMS pesan pengujian.