Komponen bawaan autentikasi

Komponen bawaan autentikasi mengumpulkan informasi dari pengguna untuk mencapai tingkat autentikasi yang diperlukan. Komponen ini mencakup persyaratan autentikasi yang umum, tetapi tidak eksklusif, untuk industri jasa keuangan (FSI). Agen ini menggunakan komponen bawaan Credit card expiration date collection, Date of birth collection, dan Telephone number collection untuk mengumpulkan dan memvalidasi detail pengguna.

Tingkat autentikasi

Komponen bawaan yang berbeda memerlukan beberapa tingkat autentikasi, dengan tingkat yang lebih tinggi memerlukan lebih banyak informasi pengguna untuk mengautentikasi.

Komponen autentikasi memungkinkan pengguna melakukan autentikasi ke Level 0 (Kecocokan ANI), Level 1 (Dasar), atau Level 2 (Multi-faktor) seperti yang dijelaskan dalam tabel berikut:

Tingkat Autentikasi	Persyaratan
Level 0: Pencocokan ANI	Mengautentikasi pengguna dengan menelepon dari atau memberikan nomor telepon yang sesuai dengan akun terdaftar. Pengguna dapat melakukan autentikasi ke Level 0 menggunakan komponen bawaan Salam.
Level 1: Dasar	Mengautentikasi pengguna dengan memverifikasi kode sandi sekali pakai (OTP) yang dikirim ke email atau nomor telepon mereka. Jika verifikasi OTP gagal, pengguna dapat memberikan jawaban atas tiga dari empat pertanyaan keamanan agar berhasil diautentikasi: tanggal lahir (DOB), empat digit terakhir kartu debit atau tanggal habis masa berlaku kartu kredit pengguna (bergantung pada apakah mereka adalah pemegang akun atau kartu), jumlah transaksi terakhir, dan metode pembayaran tagihan kartu kredit terakhir.
Level 2: Multi-faktor	Selain itu, mengautentikasi pengguna dengan memverifikasi kunci keamanan yang dihasilkan oleh aplikasi pengautentikasi eksternal atau notifikasi push.

Jenis pengguna yang didukung

Komponen autentikasi mendukung nasabah bank terdaftar yang merupakan pemegang akun, pemegang kartu, atau keduanya. Komponen ini juga mendukung autentikasi untuk pengguna yang bukan nasabah bank terdaftar, tetapi memiliki surat kuasa untuk rekening yang terdaftar di bank. Pengguna dapat memiliki satu atau beberapa akun atau kartu yang terdaftar di bank.

Jenis autentikasi

Komponen ini memungkinkan Anda mengonfigurasi apakah pengguna harus diautentikasi sebagai pemegang akun, pemegang kartu, atau keduanya. Anda dapat menetapkan opsi ini menggunakan parameter input $session.params.account_auth_enabled dan $session.params.card_auth_enabled.

Tabel ini menjelaskan perilaku komponen untuk berbagai kombinasi nilai flag autentikasi akun dan autentikasi kartu:

account_auth_enabled	card_auth_enabled	Jenis Autentikasi
true	false	Pengguna diautentikasi sebagai pemegang akun, yang memverifikasi bahwa pengguna memiliki satu atau beberapa akun di bank dan mengonfirmasi pertanyaan keamanan, termasuk empat digit terakhir kartu debit yang terdaftar.
false	true	Pengguna diautentikasi sebagai pemegang kartu, yang memverifikasi bahwa pengguna memiliki satu atau beberapa kartu kredit di bank dan mengonfirmasi pertanyaan keamanan, termasuk tanggal habis masa berlaku kartu kredit untuk kartu kredit yang terdaftar.
true	true	Komponen ini pertama-tama memeriksa apakah pengguna adalah pemegang akun terdaftar. Jika pengguna memiliki satu atau beberapa akun di bank, komponen akan mengautentikasi pengguna menggunakan informasi akun. Jika pengguna tidak memiliki akun di bank, komponen akan mencoba mengautentikasi pengguna menggunakan informasi pemegang kartu.
false	false	Komponen ini pertama-tama memeriksa apakah pengguna adalah pemegang akun terdaftar. Jika pengguna memiliki satu atau beberapa akun di bank, komponen akan mengautentikasi pengguna ke Autentikasi Level 0. Jika pengguna tidak memiliki akun 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 umum, komponen bawaan ini memiliki batasan berikut:

• OTP hanya dikirim ke nomor ponsel atau alamat email yang sebelumnya terdaftar di akun. Komponen ini tidak menggunakan OTP untuk mengautentikasi pelanggan yang menelepon dari nomor telepon alternatif yang tidak terdaftar di akun mereka. Saat menelepon dari nomor telepon alternatif, pertanyaan keamanan akan mengautentikasi pengguna.
• Komponen ini tidak mengenkripsi data.

Contoh dialog

Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Dialog menunjukkan perilaku saat telepon memanggil komponen, yang memicu Intent Sambutan Default dan respons agen pertama di awal percakapan.

Keberhasilan autentikasi Level 1: OTP

1. Komponen memverifikasi bahwa pengguna telah diautentikasi ke Level 0.
2. Komponen akan mengirimkan OTP ke saluran pilihan pengguna.
3. Komponen akan meminta pengguna untuk mengonfirmasi OTP.
4. Pengguna memberikan OTP yang valid untuk mengautentikasi ke Level 1.

Input Pengguna	Respons Agen
	Untuk tujuan keamanan, kami perlu memvalidasi identitas Anda, jadi kami akan mengirimkan kode kepada Anda. Apakah Anda lebih suka menerima kode melalui telepon atau email?
Telepon
	Kami telah mengirimkan kode ke nomor telepon terdaftar Anda yang berakhiran 0000. Proses ini mungkin perlu waktu beberapa detik. Dapatkah Anda mengonfirmasi kodenya?
Kodenya adalah 123457
	Terima kasih, Anda telah berhasil diautentikasi.

Keberhasilan autentikasi Level 1: pertanyaan keamanan

1. Komponen mengonfirmasi autentikasi Level 0 pengguna dengan mengumpulkan dan memverifikasi nomor telepon yang diberikan.
2. Komponen ini meminta dan memvalidasi jawaban yang benar dari pengguna untuk tiga pertanyaan keamanan, termasuk tanggal lahir, empat digit terakhir nomor kartu debit pengguna, dan jumlah transaksi terakhir.
3. Pengguna berhasil melakukan autentikasi ke Level 1.

Input Pengguna	Respons Agen
	Apakah Anda nasabah bank kami, atau apakah Anda memiliki surat kuasa? Konfirmasi dengan mengucapkan ya atau tidak.
Ya
	Oke, kami perlu mengumpulkan nomor telepon Anda untuk mengambil detail akun Anda.
	Agen mengumpulkan nomor telepon pengguna menggunakan komponen bawaan Telephone number collection.
	Oke. Nomor yang Anda sebutkan adalah plus 1 6502530000, apakah benar?
Ya
	Bagus, kami selesai mengumpulkan nomor telepon. Oke, untuk tujuan keamanan, kami memerlukan beberapa informasi lagi untuk memvalidasi identitas Anda.
	Agen mengumpulkan tanggal lahir pengguna menggunakan komponen bawaan Pengumpulan tanggal lahir.
	Oke, tanggal lahir Anda adalah 3 Februari 1995, apakah benar?
Ya
	Bagus, kami telah mengumpulkan tanggal lahir Anda. Beri tahu kami empat digit terakhir nomor kartu debit Anda.
Ini 1234
	Beri tahu kami jumlah transaksi terakhir Anda dalam dolar. Misalnya, jika jumlah transaksi terakhir Anda adalah Rp100.300, ucapkan "100".
Harganya 500 dolar
	Terima kasih, Anda telah berhasil diautentikasi.

Keberhasilan autentikasi Level 2: autentikasi 2 langkah

1. Pengguna sebelumnya telah diautentikasi ke autentikasi Level 1.
2. Pengguna membuat kunci keamanan menggunakan aplikasi bank atau aplikasi pengautentikasi.
3. Pengguna memberikan kunci keamanan ke komponen untuk melakukan autentikasi ke Level 2.

Input Pengguna	Respons Agen
	Berikan kunci keamanan Anda. Buat kunci keamanan 6 digit di aplikasi bank atau aplikasi pengautentikasi Anda. Kemudian, ucapkan atau masukkan digit tersebut.
232425
	Terima kasih, Anda telah berhasil diautentikasi.

Penolakan informasi

1. Pengguna menolak memberikan informasi yang diperlukan untuk melakukan autentikasi.
2. Komponen keluar dengan pesan kegagalan.

Input Pengguna	Respons Agen
	Untuk tujuan keamanan, kami perlu memvalidasi identitas Anda, jadi kami akan mengirimkan kode kepada Anda. Apakah Anda lebih suka menerima kode melalui telepon atau email?
Tidak, saya tidak ingin berbagi
	Oke, untuk tujuan keamanan, kami memerlukan beberapa informasi lagi untuk memvalidasi identitas Anda.
	Agen mengumpulkan tanggal lahir pengguna menggunakan komponen bawaan Pengumpulan tanggal lahir.
	Oke, tanggal lahir Anda adalah 3 Februari 1995, apakah benar?
Ya
	Bagus, kami telah mengumpulkan tanggal lahir Anda. Beri tahu kami empat digit terakhir nomor kartu debit Anda.
Ini 1234
	Beri tahu kami jumlah dolar dari transaksi terakhir Anda. Misalnya, jika jumlah transaksi terakhir Anda adalah Rp100.300, ucapkan "100".
Saya tidak ingin membagikan detailnya
	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	[Component Name]	Autentikasi
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 mengonfigurasi perilaku tertentu dari komponen. Satu atau beberapa kondisi dalam flow menggunakan parameter untuk menentukan perilaku komponen. Pengguna harus menetapkan parameter cakupan alur di halaman awal komponen seperti yang dijelaskan dalam tabel berikut. Pemanggil dapat menetapkan parameter cakupan sesi menggunakan 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 saat ini.	integer
$session.params.auth_level_req	Menentukan tingkat autentikasi yang akan digunakan untuk mengautentikasi pengguna. Nilai yang valid adalah 0, 1, atau 2.	integer
$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 dalam Tingkat autentikasi.	boolean
$session.params.card_auth_enabled	Menunjukkan apakah pengguna harus diautentikasi sebagai pemegang kartu. Perilaku komponen bergantung pada nilai ini dan nilai $session.params.account_auth_enabled seperti yang dijelaskan dalam Tingkat autentikasi.	boolean
$session.params.phone_number	(opsional) Nomor telepon lokal pengguna, tanpa kode negara. Jika parameter ini tidak diberikan, komponen akan mengumpulkan nomor telepon dari pengguna.	string
$flow.max_retry_telephone_counter	Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan nomor telepon pengguna. Nilai defaultnya adalah 1.	integer
$flow.max_retry_security_ans_count	Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan jawaban keamanan. Nilai defaultnya adalah 3.	integer
$flow.max_retry_security_key	Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan kunci keamanan. Nilai defaultnya adalah 3.	integer
$flow.max_retry_otp_not_received	Menentukan jumlah percobaan ulang yang diizinkan saat Sandi Sekali Pakai (OTP) tidak diterima. Nilai defaultnya adalah 1.	integer
$flow.max_retry_otp_count	Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan Sandi Sekali Pakai (OTP). Nilai defaultnya adalah 3.	integer
$flow.security_ans_denial_count	Menentukan jumlah percobaan ulang yang diizinkan saat pengguna menolak memberikan informasi yang diminta. Nilai defaultnya adalah 1.	integer
$flow.security_ans_mid_count	Menentukan jumlah jawaban keamanan yang salah yang dapat diberikan pengguna. Nilai defaultnya adalah 2, yang berarti jika penelepon memberikan jawaban yang salah untuk dua pertanyaan yang berbeda, komponen akan keluar dengan kegagalan.	integer
$flow.max_retry_card_counter	Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan empat digit terakhir kartu debit pengguna. Nilai defaultnya adalah 2.	integer
$flow.security_key_length	Menentukan panjang valid kunci keamanan yang diberikan oleh aplikasi pengautentikasi untuk autentikasi Level 2. Nilai defaultnya adalah 6.	integer
$flow.otp_length	Menentukan panjang yang valid untuk Sandi Sekali Pakai (OTP) untuk autentikasi Level 1. Nilai defaultnya adalah 6.	integer

Untuk mengonfigurasi parameter input komponen ini, luaskan untuk melihat petunjuk.

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Build.
5. Klik komponen yang diimpor di bagian Flows.
6. Klik Start Page di bagian Pages.
7. Klik Route true di Start Page.
8. Di jendela Route, edit nilai Parameter Presets sesuai kebutuhan.
9. Klik Simpan.

Parameter output

Parameter output adalah parameter sesi yang tetap aktif setelah pengguna 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 saat ini.	integer
phone_number	Nomor telepon lokal yang diberikan oleh pengguna, tanpa kode negara.	string
transfer_reason	Parameter ini menunjukkan alasan alur keluar, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari: agent: pengguna meminta agen manusia pada suatu waktu selama percakapan. denial_of_information: pengguna menolak untuk membagikan informasi yang diminta oleh komponen. max_no_input: percakapan mencapai jumlah percobaan ulang maksimum untuk peristiwa tanpa input. Lihat peristiwa bawaan tanpa input. max_no_match: percakapan mencapai jumlah maksimum percobaan ulang untuk peristiwa tidak ada kecocokan. Lihat peristiwa bawaan 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:

1. Impor komponen bawaan.
2. Konfigurasikan webhook fleksibel yang disediakan dengan setelan yang menjelaskan layanan eksternal Anda, lihat Penyiapan webhook.

Penyiapan webhook

Untuk menggunakan komponen ini, pengguna harus mengonfigurasi webhook fleksibel yang disertakan untuk mengambil informasi yang diperlukan dari layanan eksternal mereka.

Verifikasi telepon

Webhook prebuilt_components_authentication:telephony_verification digunakan oleh komponen untuk mengambil detail akun pengguna berdasarkan nomor telepon yang diberikan.

Parameter permintaan API

Komponen ini menyediakan parameter berikut sebagai input untuk permintaan API:

Nama Parameter	Deskripsi	Format Input
$session.params.phone_number	Nomor telepon lokal pengguna, tanpa kode negara.	string

Parameter respons API

Komponen ini mengambil parameter berikut dari respons API:

Nama Parameter	Deskripsi	Format Output
account_count	Jumlah akun yang terkait dengan nomor telepon yang terdaftar. Akun ini mencakup akun pribadi dan akun yang penggunanya memiliki surat kuasa.	integer
last_four_digit_of_account_number	Jika pengguna memiliki satu akun, empat digit terakhir nomor akun akan ditampilkan. Jika pengguna memiliki lebih dari satu akun, nilai parameter ini adalah null.	string
email	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 melihat petunjuk.

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Webhooks.
6. Pilih webhook prebuilt_components_authentication:telephony_verification.
7. Ganti URL webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Mendapatkan detail kartu kredit

Komponen ini menggunakan webhook prebuilt_components_account_services:get_credit_card_details untuk mengambil informasi tentang kartu kredit yang terdaftar untuk pengguna.

Parameter permintaan API

Komponen ini menyediakan parameter berikut sebagai input untuk permintaan API:

Nama Parameter	Deskripsi	Format Input
$session.params.phone_number	Nomor telepon lokal pengguna, tanpa kode negara.	string

Parameter respons API

Komponen ini mengambil parameter berikut dari respons API:

Nama Parameter	Deskripsi	Format Output
credit_card_count	Jumlah kartu kredit yang terkait dengan nomor telepon terdaftar.	integer
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	Email yang terdaftar dengan akun. Jika tidak ada email yang terdaftar dengan akun, nilai parameter ini adalah null.	string

Untuk mengonfigurasi webhook Dapatkan detail kartu kredit untuk komponen ini, luaskan untuk melihat petunjuknya.

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Webhooks.
6. Pilih webhook prebuilt_components_account_services:get_credit_card_details.
7. Ganti URL webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Kirim OTP

Webhook prebuilt_components_authentication:send_otp mengirimkan sandi sekali pakai (OTP) ke saluran terdaftar yang Anda pilih.

Parameter permintaan API

Komponen ini menyediakan parameter berikut sebagai input untuk permintaan API:

Nama Parameter	Deskripsi	Format Input
$session.params.phone_number	Nomor telepon lokal pengguna, tanpa kode negara.	string
$flow.channel	Saluran yang dipilih pengguna untuk menerima OTP. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_authentication_channel. Secara default, email dan mobile didukung.	string

Parameter respons API

Komponen ini mengambil parameter berikut dari respons API:

Nama Parameter	Deskripsi	Format Output
generated_otp	Nilai OTP yang dibuat dan dikirim kepada pengguna menggunakan saluran yang dipilih.	string

Untuk mengonfigurasi webhook Kirim OTP untuk komponen ini, luaskan untuk melihat petunjuk.

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Webhooks.
6. Pilih webhook prebuilt_components_authentication:send_otp.
7. Ganti URL webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Jawaban keamanan

Webhook prebuilt_components_authentication:security_answers mengambil jawaban keamanan pengguna dari akun terdaftarnya.

Parameter permintaan API

Komponen ini menyediakan parameter berikut sebagai input untuk permintaan API:

Nama Parameter	Deskripsi	Format Input
$session.params.phone_number	Nomor telepon lokal pengguna, tanpa kode negara.	string

Parameter respons API

Komponen ini mengambil parameter berikut dari respons API:

Nama Parameter	Deskripsi	Format Output
security_last_trans_amount	Menunjukkan jumlah penuh transaksi terakhir pengguna, tanpa simbol mata uang. Misalnya, jika jumlah transaksi terakhir pengguna adalah $100,30 USD, 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 ditentukan oleh entity 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 terdaftar pada pengguna dalam format MMYYYY.	Daftar (string)

Untuk mengonfigurasi webhook Security answers untuk komponen ini, luaskan untuk melihat petunjuk.

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Webhooks.
6. Pilih webhook prebuilt_components_authentication:security_answers.
7. Ganti URL webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Validasi 2 langkah

Webhook prebuilt_components_authentication:2fa_validation memungkinkan komponen memvalidasi kunci keamanan yang diberikan oleh pengguna untuk autentikasi 2 langkah.

Parameter permintaan API

Komponen ini menyediakan parameter berikut sebagai input untuk permintaan API:

Nama Parameter	Deskripsi	Format Input
$session.params.phone_number	Nomor telepon lokal pengguna, tanpa kode negara.	string
$flow.security_key	Kunci keamanan yang diberikan oleh pengguna, yang dibuat menggunakan aplikasi bank atau aplikasi pengautentikasi.	string

Parameter respons API

Komponen ini mengambil parameter berikut dari respons API:

Nama Parameter	Deskripsi	Format Output
security_key_verified	Menunjukkan apakah kunci keamanan yang diberikan pengguna valid. true menunjukkan bahwa kunci keamanan yang diberikan valid. false menunjukkan bahwa kunci keamanan yang diberikan tidak valid.	boolean

Untuk mengonfigurasi webhook Validasi dua faktor untuk komponen ini, luaskan untuk melihat petunjuk.

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Webhooks.
6. Pilih webhook prebuilt_components_authentication:2fa_validation.
7. Ganti URL webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Selesai

Komponen bawaan dan webhook-nya kini telah disiapkan dan siap diuji.