Langsung ke konten utama
Authentication merupakan fitur baru: DiditAuth for Android bergantung pada rilis. Koordinat distribusi, versi, dan tanda tangan fungsi yang dapat dipanggil belum dikonfirmasi di sini. Jangan instal paket yang ditebak atau gunakan SDK Verifikasi Identitas sebagai SDK Authentication.

​
Siapkan aplikasi

  1. Pastikan Authentication sudah diaktifkan untuk aplikasi Didit Anda, lalu salin origin sign-in-nya (https://<slug>.auth.didit.me, atau <slug>.sandbox.auth.didit.me untuk sandbox) dari konsol.
  2. Daftarkan URL callback yang tepat dan didukung oleh aplikasi serta runtime Anda. Validasi kepemilikan app link; jangan berasumsi bahwa skema URL kustom arbitrer diterima.
  3. Pisahkan konfigurasi sandbox dan produksi, termasuk penanganan callback dan kredensial yang disimpan.
  4. Pilih pemetaan identitas orang yang stabil sebelum menghubungkan verifikasi atau pemantauan.
Gunakan tab browser sistem untuk login yang di-hosting dan validasi app link yang kembali ke aplikasi. Passkey native memerlukan domain relying party yang dikonfigurasi dan alur kredensial platform.

​
Terapkan alur yang di-hosting

Buka tab browser sistem dengan URL {origin}/sign-in. Sertakan state acak yang baru, tantangan PKCE S256, dan redirect_uri yang sudah terdaftar. Simpan verifier di aplikasi Anda hanya untuk percobaan tersebut. Panduan cepat JavaScript menjelaskan protokol dasarnya; gunakan kriptografi dan penanganan URL platform di kode native, bukan global browser. Saat callback, verifikasi state, masa berlaku transaksi, dan tujuan callback sebelum menukar kode sekali pakai di token/. Gunakan verifier asli dan URI redirect yang tepat. Membatalkan atau menutup browser bukan login yang berhasil. Simpan refresh token di penyimpanan terenkripsi yang dilindungi platform; jangan pernah di file preferensi biasa, analitik, atau log crash. Validasi sesi saat ini menggunakan GET session/ dengan Bearer token pengguna akhir. Serialisasikan proses refresh, ganti kedua token secara bersamaan, dan hapus data spesifik pengguna setelah sign-out. Lihat token dan JWKS untuk kontrak permintaan dan perilaku penggunaan ulang token refresh.

​
Pratinjau rilis SDK native

Modul Authentication native direncanakan menyediakan sign-in, akses sesi saat ini, pengambilan token, sign-out, dan step-up, dengan sinyal perangkat otomatis. Passkey native dan penyimpanan token yang dilindungi merupakan bagian dari rilis tersebut. API wrapper akan mengikuti kontrak platform yang dipublikasikan; jangan menyalin argumen konstruktor atau tanda tangan metode yang ditebak dari contoh desain. Sampai modul dirilis, nonaktifkan adapter-nya atau gunakan implementasi protokol yang di-hosting dan sudah ditinjau untuk aplikasi Anda yang telah mengaktifkan fitur tersebut. Jangan mengiklankan panduan cepat Authentication native yang berfungsi hanya berdasarkan instalasi paket.

​
Hubungkan verifikasi dan pemantauan

Backend Anda menghasilkan vendor_data berdasarkan pengguna yang sudah terautentikasi. Backend membuat sesi verifikasi atau menerbitkan token pemantauan berlingkup terbatas untuk orang tersebut. Kembalikan hanya kredensial sesi atau token berlingkup terbatas ke aplikasi Anda; kunci API tetap berada di server. Gunakan SDK verifikasi Android saat Anda membutuhkan verifikasi identitas. Ikuti pengiriman transaksi SDK untuk dukungan pemantauan di platform Anda. Perlakukan keputusan sign-in, verifikasi, dan transaksi secara terpisah.

​
Verifikasi integrasi

Uji kembali ke aplikasi yang tidak sedang berjalan, transisi background dan foreground, pembatalan browser, callback yang tidak cocok, pemutaran ulang kode, kedaluwarsa token, refresh bersamaan, MFA, logout, dan sign-in sebagai pengguna lain. Uji pendaftaran dan sign-in passkey pada perangkat yang didukung setelah rilis tersebut tersedia. Pemeriksaan yang hanya dilakukan di perangkat tetap belum terverifikasi sampai dijalankan di platform target.
Terakhir diubah pada 7 November 2026