Pengaturan verifikasi

Tab General di halaman Configure menentukan perilaku setiap verifikasi di workspace Anda. Tab ini mengatur berapa lama kode tetap berlaku, berapa banyak percobaan yang salah hingga verifikasi berakhir, seberapa cepat kode baru dapat dikirim, dan situs web pemilik kode tersebut.

Setiap kolom menampilkan nilai yang berlaku: nilai pengganti Anda jika sudah diatur, atau nilai default platform Bird jika belum. Kolom tersimpan saat Anda meninggalkannya. Duration, Maximum Retries, dan Website ditetapkan saat verifikasi dibuat, sehingga perubahannya berlaku untuk verifikasi baru. Perubahan Retry Delay berlaku untuk panggilan create berikutnya, termasuk untuk verifikasi yang sedang berjalan.

Untuk mengubah pengaturan, Anda memerlukan izin verify_management pada tingkat write, yang dimiliki peran admin dan developer. Peran analyst dapat melihat halaman ini. Lihat Pengguna, tim & peran.

Siklus verifikasi

• Duration mulai berjalan saat verifikasi dibuat. Pengiriman ulang atau peralihan ke saluran lain mengirim kode baru, tetapi tetap memakai waktu kedaluwarsa awal, sehingga pengiriman ulang yang terlambat tidak memperpanjang jangka waktunya. Untuk alur autentikasi, atur nilainya 10 menit atau kurang; Praktik terbaik menjelaskan alasannya.
• Maximum Retries menghitung kode yang salah dari semua kode yang dikirim untuk verifikasi tersebut, sehingga pengiriman ulang tidak mengatur ulang hitungannya. Jika pemeriksaan dengan kode yang salah membuat verifikasi tetap tertunda, sisa percobaan dilaporkan di attempts_remaining.
• Retry Delay berlaku saat Anda memanggil create lagi untuk penerima yang sama. Selama masa jeda, panggilan tersebut mengembalikan verifikasi yang masih aktif tanpa mengirim kode baru. Kirim kode melalui saluran lain tidak terkena jeda ini, karena peralihan saluran adalah permintaan yang berbeda dari meminta saluran yang sama lagi. Atur nilainya ke 0 untuk mengirim kode baru pada setiap panggilan create, dalam batas per penerima di Abuse guardrails.

Panjang kode tidak diatur di halaman ini. Secara default, kode terdiri dari enam digit angka, dan options.code_length menetapkan 4 hingga 8 digit untuk satu verifikasi; lihat Options.

Isi otomatis

Website menyebutkan situs tempat pengguna Anda memasukkan kode, misalnya https://login.example.com. Jika situs web ditetapkan, browser dapat menawarkan kode di situs tersebut dan tidak di situs lain. Dengan begitu, pengguna tidak perlu menyalin kode. Biarkan kosong untuk mengirim kode tanpa menyebutkan situs web.

Tulis situs web sebagai https:// diikuti domainnya dalam huruf kecil, tanpa port, path, atau garis miring di akhir. Domain internasional menggunakan bentuk xn--, misalnya https://xn--bcher-kva.example untuk bücher.example. Bentuk lain akan ditolak, dan pesan kesalahan menyebutkan bentuk yang harus dimasukkan jika ada. Gunakan situs yang persis menampilkan kolom kode: formulir di login.example.com memerlukan https://login.example.com, bukan https://example.com.

Setelah verifikasi memiliki situs web, Verify menambahkannya ke pesan kode:

• SMS: pesan diakhiri dengan baris seperti @login.example.com #123456. Tandai kolom input kode Anda dengan autocomplete="one-time-code" agar Safari dan browser lain menawarkan kode, lalu panggil WebOTP API dari halaman jika Anda ingin browser mengisinya tanpa ketukan. Baris tambahan ini dapat menambah satu segmen SMS. Dalam banyak bahasa yang memerlukan pengodean Unicode, seperti Arab, Yunani, atau Rusia, kode yang terikat ke situs memakan dua segmen alih-alih satu, sehingga biaya SMS menjadi dua kali lipat. Domain yang panjang dapat menimbulkan hal yang sama dalam bahasa lain.
• Email: pesan membawa header OTP-Token berisi kode dan situs web, sebagaimana didefinisikan oleh OTP-Token Internet-Draft, revision 01. Aplikasi email baru mulai membaca header ini, jadi perlakukan header tersebut sebagai tambahan untuk kode di dalam pesan.

Situs web ditetapkan saat verifikasi dibuat. Pengiriman ulang, fallback ke saluran lain, atau panggilan create lain untuk penerima yang sama tetap memakai situs web tersebut.

Mengikat kode per permintaan

Sebuah permintaan dapat menentukan situs webnya sendiri dengan options.autofill_origin, yang menggantikan Website untuk verifikasi tersebut. Gunakan opsi ini jika satu workspace melayani beberapa situs.

Jika kolom kode berada di iframe lintas origin, misalnya formulir pembayaran yang disematkan di halaman checkout toko, atur options.autofill_origin ke situs web iframe dan options.autofill_top_level_origin ke halaman di tab browser. Baris SMS kemudian menyebutkan kedua situs, seperti pada @shop.example #123456 @pay.example, sehingga dapat menambah satu segmen dalam bahasa apa pun. Chrome mengisi otomatis formulir tersebut jika halaman menyematkan iframe secara langsung dan memberinya allow="otp-credentials". Email tidak mengirim header OTP-Token untuk verifikasi ini, karena header tersebut hanya dapat menyebutkan satu situs web. Permintaan ditolak dengan 422 jika situs web tingkat atas formatnya salah, jika tidak ada situs web yang diatur di permintaan maupun di halaman ini, atau jika situs web tingkat atas sama dengan situs web tersebut.

Pengirim SMS terdaftar

Jika Anda mengirim SMS dari pengirim terdaftar milik Anda sendiri, misalnya kampanye 10DLC di AS, tambahkan contoh pesan yang diakhiri baris pengikat ke kampanye tersebut sebelum Anda mengatur situs web. Operator dapat memfilter pesan yang berbeda dari contoh terdaftar kampanye.

Pemecahan masalah

• Situs web ditolak. Nilainya tidak sesuai format yang diwajibkan. Masukkan format yang disarankan pesan kesalahan, misalnya https://example.com untuk https://Example.com/.
• Browser tidak menawarkan kode. Pastikan situs web sama persis dengan alamat halaman, termasuk subdomainnya, dan input kode memiliki autocomplete="one-time-code". Untuk iframe, pastikan permintaan mengatur kedua situs web dan halaman penyemat memberikan allow="otp-credentials". Isi otomatis juga bergantung pada browser: Chrome membaca baris SMS melalui WebOTP dan Safari melalui fitur isi otomatis kodenya, sedangkan Firefox tidak mendukung WebOTP (dukungan browser).
• Kode kedaluwarsa sebelum pengguna memasukkannya. Periksa waktu percobaan di log Verify sebelum menaikkan Duration. Penyebabnya biasanya jalur pengiriman yang lambat, dan jangka waktu yang lebih panjang melemahkan kode.

Langkah berikutnya

• Mengirim verifikasi: buat dan periksa verifikasi, termasuk opsi per permintaan.
• Tujuan: pilih kanal dan urutannya untuk setiap negara tujuan.
• Pengirim dan branding: lihat pesan yang dikirim Verify dan pilih pengirim untuk setiap kanal.