Langsung ke konten utama
Authentication adalah fitur baru: @didit-protocol/auth-react-native bergantung pada rilis. Koordinat distribusi, versi, dan tanda tangan fungsi yang dapat dipanggil belum dikonfirmasi di sini. Jangan memasang paket tebakan atau menggunakan SDK Verifikasi Identitas sebagai SDK Authentication.

​
Persiapkan 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 sembarang diterima.
  3. Pisahkan konfigurasi sandbox dan live, termasuk penanganan callback dan kredensial yang disimpan.
  4. Pilih pemetaan orang yang stabil sebelum menghubungkan verifikasi atau pemantauan.
Konfigurasi dan uji tautan callback secara terpisah di iOS dan Android. Wrapper Authentication terpisah dari @didit-protocol/sdk-react-native, yang menangani verifikasi.

​
Terapkan alur yang di-hosting

Buka browser autentikasi sistem native dengan URL {origin}/sign-in. Sertakan state acak yang baru, tantangan PKCE S256, dan redirect_uri yang sudah Anda daftarkan. Simpan verifier hanya di aplikasi Anda untuk percobaan tersebut. Quickstart JavaScript menjelaskan protokol yang mendasarinya; di kode native, gunakan kriptografi dan penanganan URL dari platform, bukan global browser. Saat callback diterima, verifikasi state, masa berlaku transaksi, dan tujuan callback sebelum menukar kode sekali pakai di token/. Gunakan verifier asli dan redirect URI yang persis sama. Membatalkan atau menutup browser bukan login yang berhasil. Simpan refresh token di penyimpanan native 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 refresh, ganti kedua token secara bersamaan, dan hapus status khusus pengguna setelah keluar. Lihat token dan JWKS untuk kontrak permintaan dan perilaku penggunaan ulang token refresh.

​
Rilis pratinjau 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 termasuk dalam 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 hosted yang telah ditinjau untuk aplikasi yang sudah diaktifkan. Jangan mengiklankan quickstart Authentication native yang berfungsi hanya berdasarkan pemasangan paket.

​
Hubungkan verifikasi dan pemantauan

Backend Anda menurunkan vendor_data dari orang yang sudah terautentikasi. Backend membuat sesi verifikasi atau menerbitkan token pemantauan yang dibatasi lingkupnya untuk orang tersebut. Kembalikan hanya kredensial sesi atau token dengan cakupan terbatas ke aplikasi Anda; kunci API tetap berada di server. Gunakan SDK verifikasi React Native saat Anda membutuhkan Verifikasi Identitas. Ikuti pengiriman transaksi melalui SDK untuk dukungan pemantauan di platform Anda. Tangani keputusan sign-in, verifikasi, dan transaksi secara terpisah.

​
Verifikasi integrasi

Uji kembali ke aplikasi yang dimulai ulang dari kondisi berhenti total (cold start), transisi latar belakang dan latar depan, pembatalan browser, callback yang tidak cocok, penggunaan 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 bisa dilakukan di perangkat tetap belum terverifikasi sampai dijalankan di platform target.
Terakhir diubah pada 7 November 2026