Langsung ke konten utama
Panduan ini menjelaskan bagaimana integrasi Autentikasi Didit di lingkungan produksi tersusun, mulai dari pengalihan pertama hingga daftar periksa peluncuran produksi. Mulailah dengan panduan cepat jika Anda belum pernah mengautentikasi seseorang, dan gunakan panduan cepat platform untuk kode setiap SDK.

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 adalah sign_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.
  1. Verifikasi token akses di setiap permintaan. Periksa tanda tangan ES256 terhadap JWKS penerbit Anda, lalu iss, aud, exp dan typ: at+jwt, dan tolak token yang nilai act-nya bukan null, kecuali rute tersebut menerima agen AI. Lihat verifikasi token di server Anda.
  2. 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.
  3. 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 approved dan dibaca langsung oleh backend Anda. Lihat step-up sebelum tindakan sensitif.
  4. Ambil vendor_data dari 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.
Tampilan Active sessions di Didit Business Console, berisi daftar sesi yang sedang aktif beserta perangkat, lokasi, waktu mulai, aktivitas terakhir, waktu berakhir, dan tombol Revoke

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 webcredentials di apple-app-site-association Anda.
  • Android: jadikan pengalihan sebagai App Link, dengan assetlinks.json Anda.
  • Daftarkan setiap URL pengalihan di bawah Authentication > Security and sessions, seperti callback web.
Untuk passkey di aplikasi Anda, daftarkan aplikasi yang berbagi passkey aplikasi Anda dengan 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 nilai vendor_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.login Anda sendiri untuk login yang sama.
  • Login yang berhasil tidak pernah menyetujui verifikasi atau transaksi: tangani keputusan setiap produk secara terpisah.
Lihat mempertahankan satu orang yang sama di seluruh produk.

Menerima event login

Daftarkan tujuan webhook ke tipe auth.* 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 sebagai external_id, yang akan menjadi vendor_data. Tidak ada yang berubah bagi mereka sampai Anda mengalihkan aplikasi Anda ke Didit.

Daftar periksa peluncuran produksi

  1. Autentikasi diaktifkan untuk aplikasi Live Anda di halaman Products.
  2. URL pengalihan produksi https:// dan origin yang diizinkan sudah didaftarkan pada aplikasi Live. Aplikasi Live tidak menerima alamat http://.
  3. Setiap metode masuk sosial menggunakan ID klien dan rahasia aplikasi Anda sendiri: kredensial uji Didit hanya berfungsi di sandbox.
  4. Konfigurasi produksi Anda memiliki kunci Live yang dapat dipublikasikan (pk_live_) dan penerbit Live Anda.
  5. Kebijakan MFA, masa berlaku sesi, batas waktu tidak aktif, panjang kata sandi, dan kebijakan pendaftaran sudah sesuai dengan yang Anda inginkan. Lihat pengaturan aplikasi.
  6. Perlindungan bot diaktifkan, dengan pemeriksaan kata sandi yang bocor.
  7. Backend Anda memverifikasi setiap token akses, dan memanggil GET /session/ sebelum tindakan sensitif.
  8. 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.
  9. Tujuan webhook Anda berlangganan tipe auth.* yang Anda tangani.
  10. Anda telah menguji pendaftaran, masuk kembali, pembatalan, lupa kata sandi, MFA, kedaluwarsa sesi, keluar, dan sesi yang dicabut pada aplikasi Live.

Pemecahan Masalah

Terakhir diubah pada 22 November 2026