Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Pemicu Lambda pra pendaftaran
Anda mungkin ingin menyesuaikan proses pendaftaran di kumpulan pengguna yang memiliki opsi pendaftaran swalayan. Beberapa penggunaan umum dari pemicu pra pendaftaran adalah untuk melakukan analisis kustom dan pencatatan pengguna baru, menerapkan standar keamanan dan tata kelola, atau menautkan pengguna dari iDP pihak ketiga ke profil pengguna terkonsolidasi. Anda mungkin juga memiliki pengguna tepercaya yang tidak diharuskan menjalani verifikasi dan konfirmasi.
Sesaat sebelum Amazon Cognito mendaftarkan pengguna lokal atau federasi baru, ini mengaktifkan fungsi Lambda pra pendaftaran. Sebagai bagian dari proses pendaftaran, Anda dapat menggunakan fungsi ini untuk menganalisis peristiwa masuk dengan logika khusus, dan memodifikasi atau menolak pengguna baru.
Topik
- Aliran Lambda pra pendaftaran
- Parameter pemicu Lambda pra-pendaftaran
- Tutorial pendaftaran
- Contoh pra pendaftaran: Konfirmasi otomatis pengguna dari domain terdaftar
- Contoh pra pendaftaran: Konfirmasi otomatis dan verifikasi otomatis semua pengguna
- Contoh pra pendaftaran: Tolak pendaftaran jika nama pengguna memiliki kurang dari lima karakter
Aliran Lambda pra pendaftaran
Alur pendaftaran klien
Alur pendaftaran server
Permintaan tersebut mencakup data validasi dari klien. Data ini berasal dari ValidationData
nilai yang diteruskan ke kumpulan pengguna SignUp dan AdminCreateUser API metode.
Parameter pemicu Lambda pra-pendaftaran
Permintaan yang diteruskan Amazon Cognito ke fungsi Lambda ini adalah kombinasi dari parameter di bawah ini dan parameter umum yang ditambahkan Amazon Cognito ke semua permintaan.
Parameter permintaan pra-pendaftaran
- userAttributes
-
Satu atau lebih pasangan nilai-nama yang mewakili atribut pengguna. Nama atribut adalah kuncinya.
- validationData
-
Satu atau beberapa pasangan nilai kunci dengan data atribut pengguna yang diteruskan aplikasi Anda ke Amazon Cognito dalam permintaan untuk membuat pengguna baru. Kirim informasi ini ke fungsi Lambda Anda dalam ValidationData parameter AdminCreateUseratau SignUpAPIpermintaan Anda.
Amazon Cognito tidak menyetel ValidationData data Anda sebagai atribut pengguna yang Anda buat. ValidationData adalah informasi pengguna sementara yang Anda berikan untuk tujuan pemicu Lambda pra pendaftaran Anda.
- clientMetadata
-
Satu atau lebih pasangan nilai-kunci yang dapat Anda berikan sebagai masukan kustom ke fungsi Lambda yang Anda tentukan untuk pemicu pra pendaftaran. Anda dapat meneruskan data ini ke fungsi Lambda Anda dengan menggunakan ClientMetadata parameter dalam API tindakan berikut: AdminCreateUser,, AdminRespondToAuthChallengeForgotPassword, dan. SignUp
Parameter respons pra pendaftaran
Dalam respons, Anda dapat mengatur autoConfirmUser
ke true
jika Anda ingin mengonfirmasi pengguna secara otomatis. Anda dapat mengatur autoVerifyEmail
ke true
untuk memverifikasi secara otomatis email pengguna. Anda dapat mengatur autoVerifyPhone
ke true
untuk memverifikasi secara otomatis nomor telepon pengguna.
catatan
Parameter responsautoVerifyPhone
, autoVerifyEmail
dan autoConfirmUser
diabaikan oleh Amazon Cognito saat fungsi Lambda pra pendaftaran dipicu oleh. AdminCreateUser
API
- autoConfirmUser
-
Atur ke
true
untuk mengonfirmasi otomatis pengguna, ataufalse
untuk sebaliknya. - autoVerifyEmail
-
Setel
true
untuk menetapkan alamat email pengguna yang mendaftar sebagai terverifikasi, ataufalse
sebaliknya. JikaautoVerifyEmail
diatur ketrue
, atributemail
harus memiliki nilai yang valid dan bukan nol. Jika tidak, kesalahan akan terjadi dan pengguna tidak akan bisa menyelesaikan pendaftaran.Jika
email
atribut dipilih sebagai alias, alias akan dibuat untuk alamat email pengguna saatautoVerifyEmail
disetel. Jika alias dengan alamat email tersebut sudah ada, alias akan dipindahkan ke pengguna baru dan alamat email pengguna sebelumnya akan ditandai sebagai tidak diverifikasi. Untuk informasi selengkapnya, lihat Menyesuaikan atribut masuk. - autoVerifyPhone
-
Atur ke
true
untuk mengatur sebagai terverifikasi nomor telepon dari pengguna yang mendaftar, ataufalse
untuk sebaliknya. JikaautoVerifyPhone
diatur ketrue
, atributphone_number
harus memiliki nilai yang valid dan bukan nol. Jika tidak, kesalahan akan terjadi dan pengguna tidak akan bisa menyelesaikan pendaftaran.Jika atribut
phone_number
dipilih sebagai alias, alias akan dibuat untuk nomor telepon pengguna ketikaautoVerifyPhone
diatur. Jika alias dengan nomor telepon tersebut sudah ada, alias akan dipindahkan ke pengguna baru dan nomor telepon pengguna sebelumnya akan ditandai sebagai tidak terverifikasi. Untuk informasi lebih lanjut, lihat Menyesuaikan atribut masuk.
Tutorial pendaftaran
Fungsi Lambda pra pendaftaran dipicu sebelum pengguna mendaftar. Lihat tutorial pendaftaran Amazon Cognito ini untuk JavaScript, Android, dan iOS.
Platform | Tutorial |
---|---|
JavaScript Identitas SDK | Mendaftar pengguna dengan JavaScript |
Identitas Android SDK | Mendaftar pengguna dengan Android |
Identitas iOS SDK | Mendaftar pengguna dengan iOS |
Contoh pra pendaftaran: Konfirmasi otomatis pengguna dari domain terdaftar
Anda dapat menggunakan pemicu Lambda pra pendaftaran untuk menambahkan logika khusus yang memvalidasi pengguna baru yang mendaftar ke kumpulan pengguna Anda. Ini adalah contoh JavaScript program yang menunjukkan cara mendaftar pengguna baru. Ini memanggil pemicu Lambda pra-pendaftaran sebagai bagian dari otentikasi.
Ini adalah sampel pemicu Lambda yang dipanggil tepat sebelum mendaftar dengan pemicu Lambda pra pendaftaran kolam pengguna. Ini menggunakan atribut kustom custom:domain untuk mengonfirmasi pengguna baru secara otomatis dari domain email tertentu. Setiap pengguna baru yang tidak berada dalam domain kustom akan ditambahkan ke kolam pengguna, tetapi tidak dikonfirmasi secara otomatis.
Amazon Cognito meneruskan informasi peristiwa ke fungsi Lambda Anda. Fungsi kemudian mengembalikan objek acara yang sama ke Amazon Cognito, dengan perubahan apa pun dalam respons. Di konsol Lambda, Anda dapat mengatur peristiwa pengujian dengan data yang relevan dengan pemicu Lambda Anda. Berikut ini adalah peristiwa pengujian untuk sampel kode ini:
Contoh pra pendaftaran: Konfirmasi otomatis dan verifikasi otomatis semua pengguna
Contoh ini mengonfirmasi semua pengguna dan mengatur atribut email
dan phone_number
pengguna menjadi terverifikasi jika atribut tersebut ada. Juga, jika aliasing diaktifkan, alias akan dibuat untuk phone_number
dan email
saat verifikasi otomatis diatur.
catatan
Jika alias dengan nomor telepon yang sama sudah ada, alias akan dipindahkan ke pengguna baru, dan phone_number
pengguna sebelumnya akan ditandai sebagai belum diverifikasi. Hal yang sama berlaku untuk alamat email. Untuk mencegah hal ini terjadi, Anda dapat menggunakan kumpulan pengguna ListUsers APIuntuk melihat apakah ada pengguna yang sudah menggunakan nomor telepon atau alamat email pengguna baru sebagai alias.
Amazon Cognito meneruskan informasi peristiwa ke fungsi Lambda Anda. Fungsi kemudian mengembalikan objek acara yang sama ke Amazon Cognito, dengan perubahan apa pun dalam respons. Di konsol Lambda, Anda dapat mengatur peristiwa pengujian dengan data yang relevan dengan pemicu Lambda Anda. Berikut ini adalah peristiwa pengujian untuk sampel kode ini:
Contoh pra pendaftaran: Tolak pendaftaran jika nama pengguna memiliki kurang dari lima karakter
Contoh ini memeriksa panjang nama pengguna dalam permintaan pendaftaran. Contoh mengembalikan kesalahan jika pengguna telah memasukkan nama yang panjangnya kurang dari lima karakter.
Amazon Cognito meneruskan informasi peristiwa ke fungsi Lambda Anda. Fungsi kemudian mengembalikan objek acara yang sama ke Amazon Cognito, dengan perubahan apa pun dalam respons. Di konsol Lambda, Anda dapat mengatur peristiwa pengujian dengan data yang relevan dengan pemicu Lambda Anda. Berikut ini adalah peristiwa pengujian untuk sampel kode ini: