Komponen bawaan autentikasi mengumpulkan informasi dari pengguna untuk mengautentikasinya ke level autentikasi yang diperlukan. Komponen ini mencakup persyaratan autentikasi yang umum, tetapi tidak eksklusif, untuk industri jasa keuangan (FSI). Komponen ini menggunakan komponen bawaan Pengumpulan tanggal habis masa berlaku kartu kredit, Pengumpulan tanggal lahir, dan Pengumpulan nomor telepon untuk mengumpulkan dan memvalidasi detail pengguna.
Level autentikasi
Ada beberapa tingkat autentikasi yang diperlukan oleh berbagai komponen bawaan, dengan tingkat yang lebih tinggi memerlukan lebih banyak informasi pengguna untuk mengautentikasi pengguna. Dengan komponen Authentication, pengguna dapat melakukan autentikasi ke Level 0 (ANI Match), Level 1 (Dasar), atau Level 2 (Multi-faktor) seperti yang dijelaskan dalam tabel Authentication Level.
| Tingkat Autentikasi | Persyaratan |
|---|---|
| Level 0: Kecocokan ANI | Pengguna diautentikasi dengan menelepon dari atau memberikan nomor telepon yang sesuai dengan akun terdaftar. Pengguna dapat diautentikasi ke Level 0 menggunakan komponen bawaan Salam. |
| Level 1: Dasar | Pengguna diautentikasi dengan memverifikasi kode sandi sekali pakai (OTP) yang dikirim ke email atau nomor telepon mereka. Jika verifikasi OTP gagal, pengguna dapat menjawab tiga dari empat pertanyaan keamanan agar autentikasi berhasil: tanggal lahir (DOB), empat digit terakhir kartu debit atau tanggal habis masa berlaku kartu kredit pengguna (bergantung pada apakah mereka merupakan rekening atau pemegang kartu), jumlah transaksi terakhir, dan metode pembayaran tagihan kartu kredit terakhir. |
| Level 2: Multi-faktor | Pengguna juga diautentikasi dengan memverifikasi kunci keamanan yang dibuat oleh aplikasi pengautentikasi eksternal atau notifikasi push. |
Jenis pengguna yang didukung
Komponen autentikasi memberikan dukungan untuk pengguna yang merupakan pelanggan bank terdaftar yang merupakan pemegang rekening, pemegang kartu, atau keduanya. Komponen ini juga mendukung autentikasi untuk pengguna yang bukan pelanggan bank terdaftar, tetapi memiliki surat kuasa untuk akun yang terdaftar di bank. Pengguna mungkin memiliki satu atau beberapa rekening atau kartu yang terdaftar di bank.
Jenis autentikasi
Dengan komponen ini, Anda dapat mengonfigurasi apakah pengguna harus diautentikasi sebagai pemegang akun, pemegang kartu, atau keduanya. Opsi ini dikonfigurasi dengan menetapkan parameter input $session.params.account_auth_enabled dan $session.params.card_auth_enabled. Tabel ini menjelaskan perilaku komponen untuk berbagai kombinasi nilai untuk autentikasi akun dan flag autentikasi kartu.
| account_auth_enabled | card_auth_enabled | Authentication type |
|---|---|---|
true |
false |
Pengguna akan diotentikasi sebagai pemegang rekening, yang memverifikasi bahwa pengguna memiliki satu atau beberapa rekening di bank dan mengonfirmasi pertanyaan keamanan termasuk empat digit terakhir kartu debit yang terdaftar. |
false |
true |
Pengguna akan diautentikasi sebagai pemegang kartu, yang memverifikasi bahwa pengguna memiliki satu atau beberapa kartu kredit dengan bank dan mengonfirmasi pertanyaan keamanan termasuk tanggal habis masa berlaku kartu kredit untuk kartu kredit terdaftar. |
true |
true |
Komponen tersebut akan memeriksa terlebih dahulu apakah pengguna merupakan pemegang akun yang terdaftar. Jika pengguna memiliki satu atau beberapa rekening di bank, komponen akan mengautentikasi pengguna menggunakan informasi rekening. Jika pengguna tidak memiliki rekening apa pun di bank, komponen akan mencoba mengautentikasi pengguna menggunakan informasi pemegang kartu. |
false |
false |
Komponen tersebut akan memeriksa terlebih dahulu apakah pengguna merupakan pemegang akun yang terdaftar. Jika pengguna memiliki satu atau beberapa rekening di bank, komponen akan mengautentikasi pengguna ke Autentikasi level 0. Jika pengguna tidak memiliki rekening apa pun di bank, komponen akan memeriksa apakah pengguna adalah pemegang kartu. Jika pengguna memiliki satu atau beberapa kartu kredit di bank, komponen akan mengautentikasi pengguna ke Autentikasi level 0. |
Batasan
Selain batasan komponen bawaan yang umum, komponen bawaan ini memiliki batasan berikut:
- OTP hanya akan dikirim ke nomor ponsel atau alamat email yang sebelumnya terdaftar kepada pengguna. Komponen ini tidak akan menggunakan OTP untuk mengautentikasi pelanggan yang melakukan panggilan dari nomor telepon alternatif yang tidak terdaftar pada akun mereka. Saat pengguna menelepon dari nomor telepon alternatif, pertanyaan keamanan akan digunakan untuk mengautentikasi pemanggil.
- Komponen ini tidak mengenkripsi data apa pun.
Contoh dialog
Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Contoh dialog ini menunjukkan perilaku saat komponen dipanggil menggunakan telepon, yang memicu Intent Selamat Datang Default dan respons agen pertama di awal percakapan.
Autentikasi level 1 berhasil: OTP
Pengguna sebelumnya telah diautentikasi ke autentikasi Level 0. Komponen mengirim dan meminta pengguna untuk mengonfirmasi OTP yang dikirim ke saluran pilihan pengguna. Pengguna dapat memberikan OTP yang valid dan berhasil diautentikasi ke Level 1.
| Input pengguna | Respons agen |
|---|---|
| Untuk tujuan keamanan, kami perlu memvalidasi identitas Anda, sehingga kami akan mengirimkan kode kepada Anda. Apakah Anda lebih suka menerima kode melalui telepon atau email? | |
| Telepon | |
| Kami telah mengirimkan kode ke nomor telepon Anda yang terdaftar yang diakhiri dengan 0000. Proses ini mungkin perlu waktu beberapa detik. Bisakah Anda mengonfirmasi kodenya? | |
| Kodenya adalah 123457 | |
| Terima kasih, Anda telah berhasil diautentikasi. |
Autentikasi tingkat 1 berhasil: pertanyaan keamanan
Komponen mengonfirmasi autentikasi Level 0 pengguna dengan mengumpulkan dan memverifikasi nomor telepon yang diberikan. Komponen meminta dan memvalidasi jawaban pengguna yang benar atas tiga pertanyaan keamanan - tanggal lahir, empat digit terakhir nomor kartu debit pengguna, dan jumlah transaksi terakhir. Pengguna berhasil diautentikasi ke Level 1.
| Input pengguna | Respons agen |
|---|---|
| Apakah Anda nasabah bank kami, atau apakah Anda memiliki surat kuasa? Konfirmasi dengan mengatakan ya atau tidak. | |
| Ya | |
| Oke, kami perlu mengumpulkan nomor telepon Anda untuk mengambil detail akun. | |
| Agen mengumpulkan nomor telepon pengguna menggunakan komponen bawaan Pengumpulan nomor telepon | |
| Oke. Nomor yang Anda sebutkan adalah plus 1 6502530000, apakah itu benar? | |
| Ya | |
| Bagus, kami telah selesai mengumpulkan nomor telepon. Oke, untuk tujuan keamanan, kami memerlukan beberapa informasi lebih lanjut untuk memvalidasi identitas Anda. |
|
| Agen mengumpulkan tanggal lahir pengguna menggunakan komponen bawaan Pengumpulan tanggal lahir | |
| Oke, tanggal lahir Anda adalah 3 Februari 1995, apa benar? | |
| Ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. Harap beri tahu kami empat digit terakhir nomor kartu debit Anda. |
|
| 1234 | |
| Harap beri tahu kami jumlah dolar dari transaksi terakhir Anda. Misalnya, jika jumlah transaksi terakhir Anda adalah Rp1.003.000, ucapkan "100". | |
| Sebelumnya 500 dolar | |
| Terima kasih, Anda telah berhasil diautentikasi. |
Autentikasi level 2 berhasil: autentikasi 2 langkah
Pengguna sebelumnya telah diautentikasi ke autentikasi Level 1. Komponen meminta pengguna untuk membuat kunci keamanan menggunakan aplikasi bank atau autentikasi. Pengguna berhasil mengonfirmasi kunci keamanan yang dibuat dan diautentikasi ke Level 2.
| Input pengguna | Respons agen |
|---|---|
| Bagikan kunci keamanan Anda. Buat kunci keamanan 6 digit di aplikasi bank atau aplikasi pengautentikasi Anda. Lalu, ucapkan atau masukkan digitnya. |
|
| 232425 | |
| Terima kasih, Anda telah berhasil diautentikasi. |
Penyangkalan informasi
Pengguna menolak untuk memberikan informasi yang diperlukan untuk mengautentikasi. Komponen keluar dengan pesan kegagalan.
| Input pengguna | Respons agen |
|---|---|
| Untuk tujuan keamanan, kami perlu memvalidasi identitas Anda, sehingga kami akan mengirimkan kode kepada Anda. Apakah Anda lebih suka menerima kode melalui telepon atau email? | |
| Tidak, saya tidak ingin membagikan | |
| Oke, demi keamanan, kami memerlukan beberapa informasi lebih lanjut untuk memvalidasi identitas Anda. | |
| Agen mengumpulkan tanggal lahir pengguna menggunakan komponen bawaan Pengumpulan tanggal lahir | |
| Oke, tanggal lahir Anda adalah 3 Februari 1995, apa benar? | |
| Ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. Harap beri tahu kami empat digit terakhir nomor kartu debit Anda. |
|
| 1234 | |
| Harap beri tahu kami jumlah dolar dari transaksi terakhir Anda. Misalnya, jika jumlah transaksi terakhir Anda adalah Rp1.003.000, ucapkan "100". | |
| Saya tidak ingin membagikan detail | |
| Kami tidak dapat mengautentikasi Anda, sehingga kami tidak dapat menyelesaikan tindakan ini. Kami mohon maaf atas ketidaknyamanan ini. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Nama Komponen] | Authentication |
| Intent Khusus Komponen | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_authentication_power_of_attorney |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_authentication_payment_mode |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_authentication:telephony_verification |
Parameter input
Parameter input adalah parameter yang digunakan untuk mengonfigurasi perilaku tertentu dari komponen. Parameter akan digunakan oleh satu atau beberapa kondisi dalam flow untuk menentukan perilaku komponen. Parameter cakupan alur harus ditetapkan di halaman awal komponen seperti yang dijelaskan di bawah. Parameter cakupan sesi dapat ditetapkan oleh alur panggilan, atau di halaman awal komponen ini.
Komponen bawaan ini menerima parameter input berikut:
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.auth_level | (opsional) Menunjukkan tingkat autentikasi pengguna akhir saat ini. | bilangan bulat |
| $session.params.auth_level_req | Menentukan tingkat autentikasi yang akan digunakan pengguna akhir untuk diautentikasi. Nilai yang valid adalah 0, 1, atau 2. |
bilangan bulat |
| $session.params.account_auth_enabled | Menunjukkan apakah pengguna harus diautentikasi sebagai pemegang akun. Perilaku komponen bergantung pada nilai ini dan nilai $session.params.card_auth_enabled seperti yang dijelaskan di Tingkat autentikasi. |
boolean |
| $session.params.card_auth_enabled | Menunjukkan apakah pengguna harus diautentikasi sebagai pemegang kartu atau tidak. Perilaku komponen bergantung pada nilai ini dan nilai $session.params.account_auth_enabled seperti yang dijelaskan di Tingkat autentikasi. |
boolean |
| $session.params.phone_number | (opsional) Nomor telepon pengguna akhir. Jika parameter ini tidak diberikan, komponen akan mengumpulkan nomor telepon dari pengguna akhir. | string |
| $flow.max_retry_telephone_counter | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan nomor telepon pengguna. Nilai defaultnya adalah 1. |
bilangan bulat |
| $flow.max_retry_security_ans_count | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan jawaban keamanan. Nilai defaultnya adalah 3. |
bilangan bulat |
| $flow.max_retry_security_key | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan kunci keamanan. Nilai defaultnya adalah 3. |
bilangan bulat |
| $flow.max_retry_otp_not_received | Menentukan jumlah percobaan ulang yang diizinkan saat Sandi Sekali Pakai (OTP) tidak diterima. Nilai defaultnya adalah 1. |
bilangan bulat |
| $flow.max_retry_otp_count | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan Sandi Sekali Pakai (OTP). Nilai defaultnya adalah 3. |
bilangan bulat |
| $flow.security_ans_denial_count | Menentukan jumlah percobaan ulang yang diizinkan saat pengguna menolak untuk memberikan informasi yang diminta. Nilai defaultnya adalah 1. |
bilangan bulat |
| $flow.security_ans_mid_count | Menentukan jumlah jawaban keamanan yang salah yang dapat diberikan pengguna. Nilai defaultnya adalah 2, yang berarti jika pemanggil memberikan jawaban yang salah untuk dua pertanyaan berbeda, komponen akan keluar dengan gagal. |
bilangan bulat |
| $flow.max_retry_card_counter | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan empat digit terakhir kartu debit pengguna akhir. Nilai defaultnya adalah 2. |
bilangan bulat |
| $flow.security_key_length | Menentukan panjang kunci keamanan valid yang disediakan oleh aplikasi pengautentikasi untuk autentikasi Level 2. Nilai defaultnya adalah 6. |
bilangan bulat |
| $flow.otp_length | Menentukan panjang Sandi Sekali Pakai (OTP) yang valid untuk autentikasi Level 1. Nilai defaultnya adalah 6. |
bilangan bulat |
Guna mengonfigurasi parameter input untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Build.
- Klik komponen yang diimpor di bagian Flows.
- Klik Halaman Awal di bagian Halaman.
- Klik Rute true di Halaman Awal.
- Di jendela Rute, edit nilai Parameter Presets sesuai kebutuhan.
- Klik Save.
Parameter output
Parameter output adalah parameter sesi yang akan tetap aktif setelah keluar dari komponen. Parameter ini berisi informasi penting yang dikumpulkan oleh komponen. Komponen bawaan ini memberikan nilai untuk parameter output berikut:
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| auth_level | Menunjukkan tingkat autentikasi pengguna akhir saat ini. | bilangan bulat |
| phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
| transfer_reason | Parameter ini menunjukkan alasan keluarnya flow, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari:agent: pengguna akhir meminta agen manusia pada waktu tertentu selama percakapan.denial_of_information: pengguna akhir menolak untuk membagikan informasi yang diminta oleh komponen.max_no_input: percakapan telah mencapai jumlah percobaan ulang maksimum untuk peristiwa tanpa input. Lihat peristiwa bawaan tanpa input.max_no_match: percakapan mencapai jumlah percobaan ulang maksimum untuk peristiwa tanpa kecocokan. Lihat peristiwa bawaan yang tidak cocok.webhook_error: terjadi error webhook. Lihat peristiwa bawaan webhook.error. webhook_not_found: URL webhook tidak dapat dijangkau. Lihat peristiwa bawaan webhook.error.not-found. |
string |
Penyiapan dasar
Untuk menyiapkan komponen bawaan ini:
- Impor komponen bawaan.
- Konfigurasikan Webhook fleksibel yang disediakan dengan konfigurasi yang mendeskripsikan layanan eksternal Dialogflow Anda. Lihat penyiapan Webhook di bawah.
Penyiapan webhook
Untuk menggunakan komponen ini, Anda harus mengonfigurasi Webhook fleksibel yang disertakan untuk mengambil informasi yang diperlukan dari layanan eksternal Anda.
Verifikasi telepon
Webhook prebuilt_components_authentication:telephony_verification digunakan oleh komponen untuk mengambil detail akun pengguna berdasarkan nomor telepon yang diberikan.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| account_count | Jumlah akun yang dikaitkan dengan nomor telepon yang terdaftar. Akun ini mencakup akun mandiri dan akun yang kuasa hukumnya dimiliki pengguna. | bilangan bulat |
| last_four_digit_of_account_number | Jika pengguna memiliki satu akun, empat digit terakhir nomor rekening akan ditampilkan. Jika pengguna memiliki lebih dari satu akun, nilai parameter ini adalah null. |
string |
Email yang terdaftar dengan akun. Jika tidak ada email yang terdaftar dengan akun, nilai parameter ini adalah null. |
string |
Untuk mengonfigurasi webhook verifikasi Telepon untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_authentication:telephony_verification.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
- Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Save.
Dapatkan detail kartu kredit
Webhook prebuilt_components_account_services:get_credit_card_details digunakan oleh komponen untuk mendapatkan informasi tentang kartu kredit yang terdaftar untuk pengguna.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| credit_card_count | Jumlah kartu kredit yang terkait dengan nomor telepon yang terdaftar. | bilangan bulat |
| last_four_digit_of_credit_card_number | Jika pengguna memiliki satu kartu kredit, empat digit terakhir nomor kartu akan ditampilkan. Jika pengguna memiliki lebih dari satu kartu, nilai parameter ini adalah null. |
string |
Email yang terdaftar dengan akun. Jika tidak ada email yang terdaftar dengan akun, nilai parameter ini adalah null. |
string |
Guna mengonfigurasi webhook Dapatkan detail kartu kredit untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_account_services:get_credit_card_details.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
- Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Save.
Kirim OTP
Webhook prebuilt_components_authentication:send_otp digunakan oleh komponen untuk mengirim sandi sekali pakai (OTP) ke saluran terdaftar yang dipilih oleh pengguna akhir.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
| $flow.channel | Saluran yang dipilih pengguna untuk menerima OTP. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_authentication_channel. Secara default, email dan mobile didukung. |
string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| generated_otp | Nilai OTP yang dihasilkan dan dikirim ke pengguna menggunakan saluran yang dipilih. | string |
Guna mengonfigurasi webhook Send OTP untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_authentication:send_otp.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
- Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Save.
Jawaban keamanan
Webhook prebuilt_components_authentication:security_answers digunakan oleh komponen untuk mengambil jawaban keamanan pengguna akhir dari akun terdaftar mereka.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| security_last_trans_amount | Menunjukkan jumlah lengkap transaksi terakhir pengguna, tanpa simbol mata uang. Misalnya, jika jumlah transaksi terakhir pengguna adalah Rp1.003.000, nilai yang diharapkan untuk kolom ini adalah "100.30". |
string |
| last_payment_mode | Metode pembayaran yang digunakan untuk transaksi terakhir pengguna, dengan nilai valid yang ditetapkan oleh entitas kustom prebuilt_components_authentication_payment_mode. Secara default, nilai ini mencakup mobile, upi, online, debit, credit, dan account. |
string |
| security_card_number | Empat digit terakhir nomor kartu debit pengguna. | string |
| user_dob | Tanggal lahir (DOB) pengguna dalam format YYYY-MM-DD. | string |
| cards_exp_date_all | Tanggal habis masa berlaku semua kartu kredit yang didaftarkan kepada pengguna dalam format MMYYYY. | Daftar (string) |
Guna mengonfigurasi webhook jawaban Keamanan untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_authentication:security_answers.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
- Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Save.
Validasi dua faktor
Webhook prebuilt_components_authentication:2fa_validation digunakan oleh komponen untuk memvalidasi kunci keamanan yang disediakan oleh pengguna akhir untuk autentikasi 2 langkah.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
| $flow.security_key | Kunci keamanan yang diberikan oleh pengguna akhir, yang dibuat menggunakan aplikasi bank atau aplikasi pengautentikasi. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| security_key_verified | Menunjukkan apakah kunci keamanan yang diberikan pengguna akhir valid. true menunjukkan bahwa kunci keamanan yang diberikan valid. false menunjukkan bahwa kunci keamanan yang diberikan tidak valid. |
boolean |
Guna mengonfigurasi webhook Validasi 2 langkah untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_authentication:2fa_validation.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
- Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Save.
Selesai
Agen Anda dan webhook-nya sekarang telah disiapkan dan siap diuji.