Langsung ke konten utama
Quickstart ini membuat Didit Authentication berfungsi secara menyeluruh dalam sekitar 10 menit. Anda mendaftarkan URL callback di aplikasi sandbox, mengaktifkan metode masuk, mempersilakan pengguna masuk melalui halaman masuk yang di-hosting, memverifikasi token akses di server Anda, dan melihat proses masuk tersebut di konsol.

Prasyarat

  • Akun Didit dengan aplikasi sandbox. Membuat akun itu gratis, dan Autentikasi diaktifkan pada setiap aplikasi sandbox.
  • Node.js 20 atau yang lebih baru, serta aplikasi web yang dapat Anda jalankan di http://localhost:3000.

Langkah-langkah

1

Buka aplikasi Sandbox Anda

Di Business Console, gunakan pengalih aplikasi untuk memilih aplikasi Sandbox Anda, lalu buka Authentication.Aplikasi Sandbox menerima callback http://localhost dan kredensial uji Didit untuk sign-in sosial, dan tidak pernah ditagih. Sebaliknya, aplikasi Live mengaktifkan Authentication dari halaman Products: lihat siapkan aplikasi Anda.
2

Daftarkan callback dan origin Anda

Buka Authentication > Security and sessions > Redirect URLs and allowed origins, lalu tambahkan:Didit hanya mengembalikan pengguna ke redirect URL yang sudah Anda daftarkan, karakter demi karakter. Allowed origin memungkinkan browser menukar kode dengan origin Didit untuk aplikasi Anda.
Kartu Redirect URLs and allowed origins di Didit Business Console, di samping allowlist dan blocklist serta URL sign-in

Redirect URLs and allowed origins, di bawah Authentication > Security and sessions.

3

Aktifkan metode sign-in

Buka Authentication > Sign-in methods lalu aktifkan Email code. Aplikasi baru dimulai dengan semua metode nonaktif, dan halaman sign-in yang di-hosting hanya menawarkan metode yang Anda aktifkan.Tambahkan Passkeys juga jika Anda mau, atau metode sign-in sosial dengan kredensial uji Didit, yang berfungsi di Sandbox tanpa aplikasi milik Anda sendiri. Setiap metode dijelaskan di metode sign-in.
Halaman Sign-in methods di Didit Business Console, dengan kartu halaman sign-in yang di-hosting, metode tanpa kata sandi dan dengan kata sandi, serta pratinjau langsung halaman yang di-hosting

Authentication > Sign-in methods, dengan pratinjau langsung halaman sign-in yang di-hosting.

4

Salin kunci yang dapat dipublikasikan

Buka Authentication > Developers lalu salin Publishable key. Di aplikasi Sandbox, kunci ini diawali dengan pk_test_.Kunci yang dapat dipublikasikan bersifat publik dan mengidentifikasi origin sign-in Didit aplikasi Anda. Jangan pernah memasukkan Secret key ke dalam kode browser atau seluler.
5

Pasang SDK dan sign-in

auth.ts
Klik tombol Anda: halaman sign-in yang di-hosting meminta alamat email dan mengirim kode enam digit. Masukkan kode, dan Didit mengembalikan Anda ke callback, yang menukar kode sekali pakai dengan token untuk sesi tersebut. Sign-in pertama dengan alamat yang belum punya akun akan membuat akun, karena kebijakan pendaftaran default mengizinkan siapa pun untuk mendaftar.
Halaman sign-in yang di-hosting di ponsel, dengan tombol passkey serta kolom email dan kata sandi

Halaman sign-in yang di-hosting di ponsel. Hanya menampilkan metode yang Anda aktifkan.

6

Verifikasi token di server Anda

Kirim token akses dari auth.getToken() ke backend Anda dalam header Authorization, lalu verifikasi di sana pada setiap permintaan yang dilindungi:
server.ts
verifyToken memeriksa tanda tangan ES256 terhadap kunci yang dipublikasikan penerbit Anda, serta penerbit dan masa berlakunya. Token akses berlaku paling lama 5 menit, dan auth.getToken() memperbaruinya untuk Anda. Bahasa lain memverifikasi token yang sama dengan SDK server atau pustaka JWT apa pun, sebagaimana ditunjukkan di token dan JWKS.
7

Lihat sign-in di konsol

Buka Authentication > Sign-ins. Sign-in Anda tercantum beserta hasil, metode, perangkat, lokasi, dan risikonya, di samping contoh sign-in yang sudah ada di setiap sandbox. Pengguna muncul di bawah Users.
Halaman Sign-ins di Didit Business Console, menampilkan percobaan sign-in dengan status, pengguna, metode, perangkat, lokasi, risiko, dan waktu

Authentication > Sign-ins: setiap percobaan, dengan filter untuk status, metode, dan risiko.

Untuk menerima aktivitas sign-in di server Anda, berlangganan tujuan webhook untuk menerima auth.signup dan auth.login. Lihat event dan webhook.

Sebelum masuk produksi

  1. Aktifkan Authentication untuk aplikasi Live Anda di halaman Products.
  2. Daftarkan URL redirect dan origin https:// produksi Anda di sana: aplikasi Live hanya menerima https://.
  3. Ganti kredensial uji Didit untuk login sosial dengan client ID dan secret aplikasi Anda sendiri.
  4. Salin kunci publikasi Live (pk_live_) ke konfigurasi produksi Anda.
  5. Ikuti daftar periksa peluncuran.

Langkah selanjutnya

Panduan integrasi

Layar yang di-hosting atau layar Anda sendiri, penyimpanan token, sesi, step-up, dan pemecahan masalah.

React dan Next.js

Komponen, hook, cookie HttpOnly, dan auth() di server.

iOS, Android, React Native dan Flutter

Login native menggunakan browser sistem, passkey, dan penyimpanan yang dilindungi.

Perlindungan bot

Aktifkan kebijakan yang menghentikan bot dan pengambilalihan akun.
Terakhir diubah pada 22 November 2026