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

Pengaturan pesan SMS untuk kolam pengguna Amazon Cognito

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

Amazon Cognito dapat mengirim pesan SMS dengan salah satu konfigurasi berikut:

Kumpulan pengguna menggunakan satu konfigurasi SMS pada satu waktu. Amazon SNS dan konfigurasi AWS Olah Pesan Pengguna Akhir SMS langsung saling eksklusif. Saat Anda mengatur satu konfigurasi, Amazon Cognito menghapus yang lain. Ini berlaku untuk CreateUserPool, UpdateUserPool, dan SetUserPoolMfaConfigoperasi.

Amazon SNS SMS tersedia di Wilayah AWS daftar. Konfigurasi wilayah jalur Amazon SNS Untuk mengirim pesan SMS dari kumpulan pengguna di tempat lain Wilayah AWS, gunakan AWS Olah Pesan Pengguna Akhir SMS secara langsung.

Jika Anda mengirim pesan teks melalui Amazon Cognito untuk pertama kalinya, AWS Olah Pesan Pengguna Akhir SMS menempatkan Anda di lingkungan kotak pasir. Di lingkungan kotak pasir, Anda dapat menguji aplikasi Anda untuk pesan teks SMS. Di kotak pasir, Anda dapat mengirim pesan ke sejumlah nomor telepon tujuan terverifikasi jika Anda memiliki identitas originasi, atau mensimulasikan pengiriman pesan jika tidak.

AWS Olah Pesan Pengguna Akhir SMS biaya untuk pesan teks SMS. Untuk informasi selengkapnya, lihat harga AWS Olah Pesan Pengguna Akhir SMS.

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

Opsi pesan

¹ Memerlukan paket fitur Essentials atau yang lebih tinggi dan konfigurasi email Amazon SES.

² Untuk pesan SMS dan email.

³ Anda hanya dapat menyesuaikan template pesan MFA saat MFA diperlukan atau opsional di kumpulan pengguna Anda. Saat MFA tidak aktif, Amazon Cognito mengirimkan kata sandi satu kali dengan templat default.

AWS Olah Pesan Pengguna Akhir SMS biaya untuk pesan SMS. Untuk informasi selengkapnya, lihat harga AWS Olah Pesan Pengguna Akhir SMS.

Untuk mempelajari lebih lanjut tentang MFA, lihat. SMS dan pesan email MFA

Amazon Cognito dapat mencegah pengiriman email atau pesan SMS tambahan ke satu tujuan dalam waktu singkat. Jika Anda yakin kumpulan pengguna terpengaruh, konfigurasikan dan tinjau log untuk kesalahan pengiriman pesan, lalu hubungi tim akun Anda.

Memilih antara Amazon SNS dan AWS Olah Pesan Pengguna Akhir SMS

Kumpulan pengguna Amazon Cognito dapat mengirim pesan SMS melalui dua jalur: Amazon AWS Olah Pesan Pengguna Akhir SMS SNS atau langsung. Untuk kumpulan pengguna baru, gunakan jalur AWS Olah Pesan Pengguna Akhir SMS langsung. Amazon SNS SMS hanya tersedia dalam satu set tetap. Wilayah AWS AWS Olah Pesan Pengguna Akhir SMS Jalur langsung mendukung Wilayah tambahan dan mengekspos fitur yang tidak dimiliki jalur Amazon SNS. Kedua jalur mengirimkan pesan melalui AWS Olah Pesan Pengguna Akhir SMS.

Tabel berikut membandingkan dua jalur konfigurasi SMS.

Konfigurasi SMS di API kumpulan pengguna Amazon Cognito

SmsConfigurationTypeObjek di API kumpulan pengguna Amazon Cognito berisi konfigurasi SMS untuk kumpulan pengguna Anda. Objek ini memiliki jalur konfigurasi berikut:

Untuk informasi selengkapnya, lihat SmsConfigurationTypedi Referensi API Kumpulan Pengguna Amazon Cognito.

Praktik terbaik

Karena volume lalu lintas SMS yang tidak diminta di seluruh dunia, beberapa pemerintah memberlakukan hambatan antara pengirim dan penerima pesan SMS. Saat Anda menggunakan pesan SMS untuk MFA dan pembaruan pengguna, Anda harus mengambil langkah-langkah tambahan untuk memastikan bahwa pesan Anda terkirim. Anda juga harus memantau SMS-message-related peraturan di negara tempat pengguna Anda mungkin tinggal dan menjaga konfigurasi pesan SMS Anda tetap terkini. Untuk informasi selengkapnya, lihat kemampuan dan batasan negara SMS dan MMS di Panduan AWS Olah Pesan Pengguna Akhir SMS Pengguna.

Penggunaan pesan SMS untuk mengautentikasi dan memverifikasi pengguna bukanlah praktik terbaik keamanan. Nomor telepon dapat mengubah pemilik, dan mungkin tidak secara andal mewakili sesuatu yang Anda miliki faktor MFA untuk pengguna Anda. Sebagai gantinya, terapkan TOTP MFA di aplikasi Anda atau dengan iDP pihak ketiga Anda. Anda juga dapat membuat faktor otentikasi kustom tambahan denganPemicu Lambda tantangan autentikasi kustom.

Tinjau tautan berikut untuk informasi tentang mengamankan arsitektur pengiriman pesan SMS Anda.

Menyiapkan pesan SMS untuk pertama kalinya di kumpulan pengguna Amazon Cognito

Amazon Cognito menggunakan Amazon SNS (dan AWS Olah Pesan Pengguna Akhir SMS secara tidak langsung) AWS Olah Pesan Pengguna Akhir SMS atau langsung untuk mengirim pesan SMS dari kumpulan pengguna Anda. Anda juga dapat menggunakan a Pemicu Lambda pengirim SMS kustom untuk menggunakan sumber daya Anda sendiri untuk mengirim pesan SMS. Pertama kali Anda mengatur pesan teks SMS di AWS Olah Pesan Pengguna Akhir SMS tempat tertentu Wilayah AWS, tempatkan Anda Akun AWS di kotak pasir SMS untuk Wilayah itu. AWS Olah Pesan Pengguna Akhir SMS menggunakan kotak pasir untuk mencegah penipuan dan penyalahgunaan dan untuk memenuhi persyaratan kepatuhan. Ketika Anda Akun AWS berada di kotak pasir, AWS Olah Pesan Pengguna Akhir SMS memberlakukan beberapa batasan. Misalnya, Anda dapat mengirim pesan teks ke maksimum 10 nomor tujuan terverifikasi jika Anda memiliki identitas originasi, atau Anda dapat mensimulasikan pengiriman pesan tanpa identitas originasi. Sementara Akun AWS sisa-sisa Anda di kotak pasir, jangan mengirim pesan SMS dalam produksi. Saat Anda berada di sandbox, Amazon Cognito tidak dapat mengirim pesan ke nomor telepon pengguna Anda.

Siapkan peran IAM yang dapat digunakan Amazon Cognito untuk mengirim pesan SMS AWS Olah Pesan Pengguna Akhir SMS

Saat Anda mengirim pesan SMS dari kumpulan pengguna Anda, Amazon Cognito mengambil peran IAM di akun Anda. Izin yang diperlukan peran bergantung pada jalur konfigurasi SMS yang Anda pilih:

Di konsol Amazon Cognito, Anda dapat mengatur pemilihan peran IAM dari menu Metode otentikasi kumpulan pengguna, di bawah SMS atau membuat pilihan ini selama panduan pembuatan kumpulan pengguna.

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

Ketentuan kebijakan kepercayaan ini berlaku untuk jalur Amazon SNS dan jalur AWS Olah Pesan Pengguna Akhir SMS langsung.

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

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

Untuk mengirim pesan SMS untuk otentikasi multi-faktor, kebijakan kepercayaan peran IAM Anda harus memiliki kondisi. sts:ExternalId Nilai kondisi ini harus sesuai dengan ExternalId properti kumpulan pengguna Anda. SmsConfiguration Saat Anda membuat peran IAM 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 peran IAM yang ada.

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

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

Untuk mengatur AWS Olah Pesan Pengguna Akhir SMS SMS langsung untuk kumpulan pengguna

Gunakan prosedur berikut untuk mengonfigurasi kumpulan pengguna Anda untuk mengirim pesan SMS secara langsung AWS Olah Pesan Pengguna Akhir SMS. Konfigurasi ini menggunakan EumsSms objek di SmsConfigurationType.

Izin IAM untuk AWS Olah Pesan Pengguna Akhir SMS SMS langsung

Peran IAM dalam CallerArn membutuhkan kebijakan kepercayaan yang memungkinkan kepala cognito-idp.amazonaws.com layanan untuk mengambilnya. Gunakan struktur kebijakan kepercayaan yang sama dengan jalur Amazon SNS (lihatSiapkan peran IAM yang dapat digunakan Amazon Cognito untuk mengirim pesan SMS AWS Olah Pesan Pengguna Akhir SMS). Peran ini juga memerlukan kebijakan izin yang memberikan sms-voice:SendTextMessage cakupan ARN identitas originasi Anda (lihat prosedur penyiapan di). Untuk mengatur AWS Olah Pesan Pengguna Akhir SMS SMS langsung untuk kumpulan pengguna

Pilih Wilayah AWS untuk pesan SMS

Konfigurasi wilayah jalur Amazon SNS

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

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

Saat peluncuran, bagi sebagian orang Wilayah AWS, Amazon Cognito mengirim pesan SMS dengan sumber daya Amazon SNS 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 Anda dapat mengirim pesan SMS dengan sumber daya Amazon SNS di Wilayah Amazon SNS lama.

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

Amazon SNS (melalui AWS Olah Pesan Pengguna Akhir SMS) 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 pesan SMS Amazon SNS Wilayah AWS untuk Amazon, buka kasus peningkatan kuota di AWS Support Center untuk meningkatkan batas Anda di Wilayah baru. Untuk informasi selengkapnya, lihat Memindahkan dari kotak pasir AWS Olah Pesan Pengguna Akhir SMS MMS dan Voice ke produksi di AWS Olah Pesan Pengguna Akhir SMS Panduan Pengguna.

Anda dapat mengirim pesan SMS untuk Wilayah Amazon Cognito di tabel berikut dengan AWS Olah Pesan Pengguna Akhir SMS sumber daya di Wilayah pesan SMS yang sesuai.

AWS Olah Pesan Pengguna Akhir SMS Konfigurasi wilayah jalur langsung

AWS Olah Pesan Pengguna Akhir SMS tersedia dalam set sendiri Wilayah AWS, yang dapat berbeda dari Wilayah di mana Amazon SNS atau kumpulan pengguna Amazon Cognito tersedia. Untuk daftar saat ini, lihat Wilayah dan negara yang Didukung di Panduan AWS Olah Pesan Pengguna Akhir SMS Pengguna.

RegionBidang EumsSms objek di SmsConfigurationTypeset di Wilayah AWS mana Amazon Cognito memanggil. AWS Olah Pesan Pengguna Akhir SMS AWS Olah Pesan Pengguna Akhir SMS harus tersedia di Wilayah kumpulan pengguna Anda. Hilangkan Region dan Amazon Cognito AWS Olah Pesan Pengguna Akhir SMS digunakan di Wilayah kumpulan pengguna Anda, atau Region setel ke Wilayah kumpulan pengguna Anda secara eksplisit. Amazon Cognito menolak nilai lainnya.

Dapatkan identitas originasi untuk mengirim pesan SMS ke nomor telepon AS

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

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 originasi, lihat Meminta nomor telepon di Panduan AWS Olah Pesan Pengguna Akhir SMS Pengguna.

Jika Anda memiliki lebih dari satu identitas originasi yang sama Wilayah AWS, AWS Olah Pesan Pengguna Akhir SMS pilih jenis identitas originasi dalam urutan prioritas berikut: kode pendek, 10DLC, nomor bebas pulsa. Anda tidak dapat mengubah prioritas ini. Untuk informasi lebih lanjut, lihat AWS Olah Pesan Pengguna Akhir SMS FAQ.

Konfirmasikan bahwa Anda berada di sandbox SMS

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

Pindahkan akun Anda dari kotak pasir

Untuk menggunakan aplikasi Anda dalam produksi, pindahkan akun Anda dari kotak pasir SMS dan masuk ke produksi. Setelah Anda mengonfigurasi identitas originasi di Wilayah AWS yang berisi AWS Olah Pesan Pengguna Akhir SMS sumber daya yang Anda inginkan untuk digunakan Amazon Cognito, Anda dapat memverifikasi nomor telepon AS saat Akun AWS Anda tetap berada di kotak pasir SMS. Ketika lingkungan Anda dalam produksi, Anda tidak perlu memverifikasi nomor telepon pengguna sebelum Anda mengirim pesan SMS kepada mereka.

Anda dapat membuat permintaan untuk keluar dari kotak pasir dari AWS Olah Pesan Pengguna Akhir SMS konsol atau konsol Amazon SNS. Untuk petunjuk terperinci, lihat Memindahkan dari Kotak Pasir SMS di Panduan AWS Olah Pesan Pengguna Akhir SMS Pengguna.

Gunakan nomor simulator atau nomor telepon terverifikasi dengan AWS Olah Pesan Pengguna Akhir SMS

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

Jika Anda berada di kotak pasir tetapi telah menyiapkan nomor originasi, Anda dapat mengirim pesan ke nomor tujuan yang diverifikasi. Untuk menyiapkan tujuan terverifikasi, lihat Menambahkan nomor telepon tujuan terverifikasi di Panduan AWS Olah Pesan Pengguna Akhir SMS Pengguna.

Anda juga dapat mengirim pesan dengan pengirim dan tujuan simulasi. Pesan simulator menghasilkan log tetapi tidak dikirim melalui jaringan operator. Dari menu Pintasan, pilih Uji pengiriman SMS dengan simulator SMS. Untuk informasi selengkapnya, lihat Nomor telepon Simulator di Panduan AWS Olah Pesan Pengguna Akhir SMS Pengguna.

Selesaikan pengaturan kumpulan pengguna di Amazon Cognito

Kembali ke tab browser tempat Anda membuat atau mengedit kumpulan pengguna Anda. Selesaikan prosedur. Ketika Anda telah berhasil menambahkan konfigurasi SMS ke kumpulan pengguna Anda, Amazon Cognito mengirimkan pesan pengujian ke nomor telepon internal untuk memverifikasi bahwa konfigurasi Anda berfungsi. AWS Olah Pesan Pengguna Akhir SMS biaya untuk setiap pesan SMS tes.