Hasilkan kata sandi satu kali (OTPs) dengan Amazon Pinpoint

Amazon Pinpoint menyertakan fitur manajemen kata sandi satu kali (OTP) yang dapat Anda gunakan untuk membuat kata sandi satu kali baru dan mengirimkannya ke penerima sebagai pesan SMS.

penting

Untuk menggunakan fitur ini, akun Anda harus memiliki akses produksi dan identitas originasi aktif. Untuk informasi selengkapnya, lihat Tentang kotak pasir SMS/MMS dan Suara dan Minta nomor telepon di Panduan Pengguna SMS Pesan Pengguna AWS Akhir.

Di beberapa negara dan Wilayah, Anda harus mendapatkan nomor telepon khusus atau ID originasi sebelum dapat mengirim pesan SMS. Misalnya, ketika Anda mengirim pesan ke penerima di Amerika Serikat, Anda harus memiliki nomor bebas pulsa khusus, nomor 10DLC, atau kode pendek. Ketika Anda mengirim pesan ke penerima di India, Anda harus memiliki ID pengirim terdaftar, yang mencakup ID Entitas Utama (PEID) dan ID Templat. Persyaratan ini masih berlaku saat Anda menggunakan fitur OTP.

Untuk menggunakan fitur ini, Anda memerlukan izin untuk mengirim dan memverifikasi pesan OTP, lihat. Kata sandi satu kali Jika Anda memerlukan bantuan untuk menentukan izin, lihatMemecahkan masalah Amazon Pinpoint identitas dan manajemen akses.

Anda dapat menggunakan SendOtpMessages operasi di Amazon Pinpoint API untuk mengirim kode OTP ke pengguna aplikasi Anda. Saat Anda menggunakan API ini, Amazon Pinpoint menghasilkan kode acak dan mengirimkannya ke pengguna Anda sebagai pesan SMS. Permintaan Anda dapat mencakup parameter berikut:

• Channel— Saluran komunikasi yang dikirim melalui kode OTP. Saat ini, hanya pesan SMS yang didukung, jadi satu-satunya nilai yang dapat diterima adalah SMS.

• BrandName— Nama merek, perusahaan, atau produk yang terkait dengan kode OTP. Nama ini dapat berisi hingga 20 karakter.

  catatan

  Saat Amazon Pinpoint mengirim pesan OTP, nama merek secara otomatis dimasukkan ke dalam templat pesan berikut:

  This is your One Time Password: {{otp}} from {{brand}}

  Jadi, jika Anda menentukan ExampleCorp sebagai nama merek Anda, dan Amazon Pinpoint menghasilkan kata sandi satu kali 123456, itu akan mengirimkan pesan berikut ke pengguna Anda:

  This is your One Time Password: 123456 from ExampleCorp

• CodeLength— Jumlah digit yang akan ada dalam kode OTP yang dikirim ke penerima. Kode OTP dapat berisi antara 5 dan 8 digit, inklusif.

• ValidityPeriod— Jumlah waktu, dalam hitungan menit, bahwa kode OTP akan valid. Masa berlaku bisa antara 5 dan 60 menit, inklusif.

• AllowedAttempts— Berapa kali penerima tidak berhasil mencoba memverifikasi OTP. Jika jumlah upaya melebihi nilai ini, OTP secara otomatis menjadi tidak valid. Jumlah maksimum upaya yang diizinkan adalah 5.

• Language— Bahasa, dalam format IETF BCP-47, untuk digunakan saat mengirim pesan. Nilai yang dapat diterima adalah:

  • de-DE— Jerman

  • en-GB— Inggris (UK)

  • en-US— Inggris (AS)

  • es-419— Spanyol (Amerika Latin)

  • es-ES— Spanyol

  • fr-CA— Prancis (Kanada)

  • fr-FR— Prancis

  • it-IT— Italia

  • ja-JP— Jepang

  • ko-KR— Korea

  • pt-BR— Portugis (Brasil)

  • zh-CN- Mandarin (Sederhana)

  • zh-TW— Tionghoa (Tradisional)

• OriginationIdentity— Identitas asal (seperti kode panjang, kode pendek, atau ID pengirim) yang digunakan untuk mengirim kode OTP. Jika Anda menggunakan kode panjang atau nomor bebas pulsa untuk mengirim OTP, nomor telepon harus dalam format E.164.

• DestinationIdentity— Nomor telepon, dalam format E.164, tempat kode OTP dikirim.

• ReferenceId— ID referensi unik untuk permintaan tersebut. ID referensi sama persis dengan ID referensi yang Anda berikan saat Anda memverifikasi OTP. ID referensi dapat berisi antara 1 dan 48 karakter, inklusif.

• EntityId— ID Entitas yang terdaftar di badan pengatur. Parameter ini saat ini hanya digunakan saat mengirim pesan ke penerima di India. Jika Anda tidak mengirim ke penerima di India, Anda dapat menghilangkan parameter ini.

• TemplateId— ID Template yang terdaftar di badan pengatur. Parameter ini saat ini hanya digunakan saat mengirim pesan ke penerima di India. Jika Anda tidak mengirim ke penerima di India, Anda dapat menghilangkan parameter ini.

  catatan

  Untuk informasi selengkapnya tentang persyaratan pengiriman pesan ke penerima di India, lihat proses pendaftaran ID pengirim India di Panduan Pengguna Amazon Pinpoint.

Untuk memastikan bahwa akun Amazon Pinpoint Anda dikonfigurasi dengan benar untuk mengirim pesan OTP, Anda dapat menggunakan AWS CLI untuk mengirim pesan pengujian. Untuk informasi selengkapnya tentang AWS CLI, lihat Panduan AWS Command Line Interface Pengguna.

Untuk mengirim pesan OTP pengujian menggunakan AWS CLI, jalankan send-otp-messageperintah di terminal:

aws pinpoint send-otp-message --application-id 7353f53e6885409fa32d07cedexample --send-otp-message-request-parameters Channel=SMS,BrandName=ExampleCorp,CodeLength=5,ValidityPeriod=20,AllowedAttempts=5,OriginationIdentity=[phone],DestinationIdentity=[phone],ReferenceId=SampleReferenceId

Pada perintah sebelumnya, lakukan hal berikut:

• Ganti 7353f53e6885409fa32d07cedexample dengan id aplikasi Anda.

• Ganti ExampleCorp dengan nama perusahaan Anda.

• Ganti 5 CodeLegth dengan jumlah digit yang akan ada dalam kode OTP yang dikirim ke penerima.

• Ganti 20 ValidityPeriod dengan jumlah waktu, dalam hitungan menit, bahwa kode OTP akan valid.

• Ganti 5 AllowedAttempts dengan berapa kali penerima tidak berhasil mencoba memverifikasi OTP.

• Ganti [phone] OriginationIdentity dengan identitas asal yang digunakan untuk mengirim kode OTP.

• Ganti [phone] DestinationIdentity dengan nomor telepon untuk mengirim kode OTP ke.

• Ganti SampleReferenceId ReferenceId dengan ID referensi unik untuk permintaan tersebut.

SendOtpMessagerespon

Ketika Anda berhasil mengirim pesan OTP, Anda menerima respons yang menyerupai contoh berikut:

{
    "MessageResponse": {
        "ApplicationId": "7353f53e6885409fa32d07cedexample",
        "RequestId": "255d15ea-75fe-4040-b919-096f2example",
        "Result": {
            "[phone]": {
                "DeliveryStatus": "SUCCESSFUL",
                "MessageId": "nvrmgq9kq4en96qgp0tlqli3og1at6aexample",
                "StatusCode": 200,
                "StatusMessage": "MessageId: nvrmgq9kq4en96qgp0tlqli3og1at6aexample"
            }
        }
    }
}