Arsitektur
Ada empat bagian yang terlibat:
Kunci API Didit dan rahasia tidak pernah boleh ada di aplikasi Anda: kunci yang dapat dipublikasikan bersifat publik, dan pertukaran kode dilindungi oleh PKCE sebagai pengganti rahasia klien.
Halaman yang di-hosting atau layar Anda sendiri
Pilih tempat pengguna mengetik email, kata sandi, atau kode mereka. Pengaturannya adalahsign_in_ui (hosted secara default, atau own), dan Anda dapat mengubahnya nanti.
Passkey terkait dengan origin yang digunakan untuk sign-in aplikasi Anda.
Metode passkey dari SDK hanya berfungsi di halaman yang disajikan dari origin tersebut, jadi pada layar Anda sendiri di domain lain, arahkan pengguna ke halaman yang di-hosting untuk passkey.
Pilih SDK Anda
Tanpa SDK, terapkan sendiri alur kode otorisasi dengan PKCE: panduan cepat JavaScript menunjukkan seluruh kontrak.
Lindungi backend Anda
Pemeriksaan sesi di frontend hanya mengontrol apa yang Anda tampilkan. Backend Anda membuat setiap keputusan berdasarkan token yang sudah diverifikasi.- Verifikasi token akses di setiap permintaan. Periksa tanda tangan ES256 terhadap JWKS penerbit Anda, lalu
iss,aud,expdantyp: at+jwt, dan tolak token yang nilaiact-nya bukannull, kecuali rute tersebut menerima agen AI. Lihat verifikasi token di server Anda. - Periksa sesi yang aktif sebelum tindakan sensitif. Token akses tetap berlaku hingga kedaluwarsa, selama maksimal 5 menit.
GET /session/langsung gagal ketika sesi dicabut, tidak aktif atau kedaluwarsa, ketika pengguna diblokir, atau ketika sesi tidak lagi memenuhi kebijakan MFA Anda. Lihat memeriksa sesi. - Minta step-up saat tindakan berisiko. Sebelum pencairan dana, penambahan rekening bank baru, atau perubahan email atau nomor telepon, tanyakan ke Didit apakah orang tersebut harus melakukan verifikasi ulang, dan bertindak hanya berdasarkan step-up yang
approveddan dibaca langsung oleh backend Anda. Lihat step-up sebelum tindakan sensitif. - Ambil
vendor_datadari token yang sudah diverifikasi, jangan dari kolom yang dikirim browser, dan gunakan untuk verifikasi serta transaksi milik orang tersebut.
Sesi
Ubah durasi di Authentication > Security and sessions, atau melalui API di pengaturan aplikasi.

Authentication > Sign-ins > Active sessions, dengan Revoke pada setiap sesi.
Aplikasi native
Didit mengarahkan pengguna kembali ke aplikasi native hanya melalui pengalihan HTTPS. Didit tidak menerima skema URL kustom.- iOS: jadikan pengalihan sebagai domain terkait, dengan
webcredentialsdiapple-app-site-associationAnda. - Android: jadikan pengalihan sebagai App Link, dengan
assetlinks.jsonAnda. - Daftarkan setiap URL pengalihan di bawah Authentication > Security and sessions, seperti callback web.
PUT native-apps/ pada Authentication management API.
Didit kemudian mencantumkan aplikasi tersebut di apple-app-site-association dan assetlinks.json yang disajikannya pada origin yang digunakan untuk login.
MANAGEMENT_BASE adalah alamat API manajemen aplikasi Anda, dan kunci API dengan scope authentication pada write dapat melakukan panggilan tersebut.
Panggilan ini menggantikan kedua daftar, jadi kirim keduanya:
Panduan cepat iOS dan Android menunjukkan implementasi di sisi aplikasi.
Hubungkan verifikasi identitas dan pemantauan transaksi
Setiap orang memiliki satu nilaivendor_data, di dalam token dan sesi mereka.
Gunakan sebagai vendor_data saat Anda membuat sesi verifikasi atau mengirimkan transaksi, dan konsol menampilkan login, verifikasi, dan transaksi untuk orang yang sama.
- Untuk memverifikasi orang saat pendaftaran atau memverifikasi ulang sebelum pencairan dana tanpa membangun alur verifikasi, gunakan identitas terverifikasi.
- Event login diteruskan secara otomatis ke aturan event dan tampilan deteksi penipuan. Jangan kirim event
auth.loginAnda sendiri untuk login yang sama. - Login yang berhasil tidak pernah menyetujui verifikasi atau transaksi: tangani keputusan setiap produk secara terpisah.
Menerima event login
Daftarkan tujuan webhook ke tipeauth.* yang Anda butuhkan, misalnya auth.new_device atau auth.account_locked.
Lakukan deduplikasi berdasarkan auth_event.event_id, dan verifikasi tanda tangannya seperti pada setiap webhook Didit.
Lihat event dan webhook untuk setiap tipe beserta payload-nya.
Pindahkan pengguna yang sudah ada
Jika pengguna Anda sudah memiliki akun di platform identitas lain atau di database Anda sendiri, impor mereka sebelum Anda mengalihkan proses masuk. Impor hash kata sandi mereka jika sumbernya menyediakannya, pertahankan tautan akun sosial mereka, dan simpan ID pengguna Anda sebagaiexternal_id, yang akan menjadi vendor_data.
Tidak ada yang berubah bagi mereka sampai Anda mengalihkan aplikasi Anda ke Didit.
Daftar periksa peluncuran produksi
- Autentikasi diaktifkan untuk aplikasi Live Anda di halaman Products.
- URL pengalihan produksi
https://dan origin yang diizinkan sudah didaftarkan pada aplikasi Live. Aplikasi Live tidak menerima alamathttp://. - Setiap metode masuk sosial menggunakan ID klien dan rahasia aplikasi Anda sendiri: kredensial uji Didit hanya berfungsi di sandbox.
- Konfigurasi produksi Anda memiliki kunci Live yang dapat dipublikasikan (
pk_live_) dan penerbit Live Anda. - Kebijakan MFA, masa berlaku sesi, batas waktu tidak aktif, panjang kata sandi, dan kebijakan pendaftaran sudah sesuai dengan yang Anda inginkan. Lihat pengaturan aplikasi.
- Perlindungan bot diaktifkan, dengan pemeriksaan kata sandi yang bocor.
- Backend Anda memverifikasi setiap token akses, dan memanggil
GET /session/sebelum tindakan sensitif. - Merek, teks halaman, serta tautan ke syarat dan ketentuan dan kebijakan privasi Anda sudah diatur. Jika Anda berencana menggunakan domain kustom, aktifkan sebelum pengguna mulai menambahkan kunci sandi.
- Tujuan webhook Anda berlangganan tipe
auth.*yang Anda tangani. - Anda telah menguji pendaftaran, masuk kembali, pembatalan, lupa kata sandi, MFA, kedaluwarsa sesi, keluar, dan sesi yang dicabut pada aplikasi Live.