> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart Autentikasi: Login Pertama dalam 10 Menit

> Aktifkan Autentikasi Didit di aplikasi sandbox, masuk pengguna lewat halaman yang di-hosting, dan verifikasi token akses di server Anda.

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](https://business.didit.me), 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](https://docs.didit.me/id/authentication/overview.md#siapkan-aplikasi-anda).

**2. Daftarkan callback dan origin Anda**

Buka **Authentication > Security and sessions > Redirect URLs and allowed origins**, lalu tambahkan:

| Jenis | Nilai |
| - | - |
| Redirect URL | `http://localhost:3000/auth/callback` |
| Allowed origin | `http://localhost:3000` |

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-redirect-urls.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=8bf9cdacf97580097f4e8c6bd242af6f)

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](https://docs.didit.me/id/authentication/sign-in-methods.md).

![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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-in-methods.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=4f71ad0125f22dd8184ad837854ec8db)

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**

```bash theme={null}
npm install @didit-protocol/auth
```

```ts auth.ts theme={null}
import { createDiditAuth } from "@didit-protocol/auth";

export const auth = createDiditAuth({
  publishableKey: "pk_test_...",
  redirectUri: "http://localhost:3000/auth/callback",
});

// Your sign-in button
export async function onSignInClick() {
  await auth.signIn({ returnTo: "/dashboard" });
}

// Run once on http://localhost:3000/auth/callback
export async function onCallbackPage() {
  const { session, returnTo } = await auth.handleRedirectCallback();
  console.log(session.email, session.vendorData);
  window.location.replace(returnTo ?? "/");
}
```

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-phone.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=842077ff63a6dcffc50b0f0542ab07e4)

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:

```ts server.ts theme={null}
import { verifyToken } from "@didit-protocol/auth/server";

export async function authenticate(request: Request) {
  const header = request.headers.get("authorization") ?? "";
  const token = header.startsWith("Bearer ") ? header.slice(7) : "";
  try {
    const claims = await verifyToken(token, { publishableKey: process.env.DIDIT_PUBLISHABLE_KEY });
    return { personId: claims.sub, vendorData: claims.vendor_data };
  } catch {
    return null;
  }
}
```

`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](https://docs.didit.me/id/integration/server-sdks/overview.md) atau pustaka JWT apa pun, sebagaimana ditunjukkan di [token dan JWKS](https://docs.didit.me/id/authentication/tokens-and-jwks.md#verifikasi-token-di-server-anda).

**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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-ins.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=3c79b4e120c911b732d738e52d1687c8)

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

Untuk menerima aktivitas sign-in di server Anda, berlangganan [tujuan webhook](https://docs.didit.me/id/integration/webhooks.md) untuk menerima `auth.signup` dan `auth.login`. Lihat [event dan webhook](https://docs.didit.me/id/authentication/events-and-webhooks.md).

## 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](https://docs.didit.me/id/authentication/integration-guide.md#daftar-periksa-peluncuran-produksi).

## Langkah selanjutnya

> [card] [Panduan integrasi](https://docs.didit.me/id/authentication/integration-guide.md)
>
> Layar yang di-hosting atau layar Anda sendiri, penyimpanan token, sesi, step-up, dan pemecahan masalah.

> [card] [React dan Next.js](https://docs.didit.me/id/authentication/quickstarts/nextjs.md)
>
> Komponen, hook, cookie HttpOnly, dan `auth()` di server.

> [card] [iOS, Android, React Native dan Flutter](https://docs.didit.me/id/authentication/quickstarts/ios.md)
>
> Login native menggunakan browser sistem, passkey, dan penyimpanan yang dilindungi.

> [card] [Perlindungan bot](https://docs.didit.me/id/authentication/bot-protection.md)
>
> Aktifkan kebijakan yang menghentikan bot dan pengambilalihan akun.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.