> ## 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.

# Halaman Masuk Bermerek, Email Masuk & Domain Autentikasi Kustom

> Buat halaman masuk dan email Didit menjadi milik Anda: brand, teks dalam lima bahasa, tautan syarat dan privasi, serta domain masuk sendiri.

Halaman masuk yang di-hosting oleh Didit Authentication dan email untuk masuk menggunakan brand Anda, yaitu brand yang sama dengan alur verifikasi Anda.
Anda mengatur teks halaman dan tautan hukum untuk Authentication, dan Anda dapat memindahkan proses masuk ke domain Anda sendiri, misalnya `auth.example.com`.

Kelola pengaturan ini di konsol pada **Authentication > Branding and emails**, yang menampilkan pratinjau langsung halaman masuk yang di-hosting dalam mode terang dan gelap.

![Halaman Branding and emails di Didit Business Console untuk aplikasi sandbox, dengan brand dari Customization, teks halaman, dan pratinjau halaman yang di-hosting](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

Authentication > Branding and emails, dengan pratinjau halaman yang di-hosting.

## Merek Anda

Logo, warna merek, latar belakang, radius sudut, dan font berasal dari pengaturan **Customization** aplikasi Anda di konsol, dan halaman serta email yang di-hosting mengikuti pengaturan tersebut.
Pilih **Edit in Customization** untuk mengubahnya: satu perubahan langsung memperbarui alur verifikasi dan halaman masuk sekaligus.

* Halaman mengikuti mode terang atau gelap pada perangkat pengguna, dan warna merek disesuaikan untuk latar belakang gelap.
* Halaman menampilkan nama aplikasi Anda.
* Pada paket Free, halaman yang di-hosting menampilkan lencana **Secured by Didit**.

![Halaman masuk yang di-hosting dari Didit untuk aplikasi sandbox dalam mode terang dan gelap, dengan tombol passkey serta kolom email dan kata sandi](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

Halaman masuk yang di-hosting mengikuti mode terang atau gelap pada perangkat pengguna.

## Teks halaman dan tautan hukum

| Kolom | Batas | Tampil di |
| - | - | - |
| **Judul masuk** | 120 karakter | Judul halaman masuk. |
| **Subjudul** | 160 karakter | Baris di bawah judul. |
| **Judul pendaftaran** | 120 karakter | Judul halaman pendaftaran. |
| **URL ketentuan layanan** | 500 karakter | Tautan di halaman-halaman tersebut. Jika diisi, formulir pendaftaran meminta pengguna menyetujui ketentuan Anda. |
| **URL kebijakan privasi** | 500 karakter | Tautan di halaman-halaman tersebut, di samping ketentuan Anda. |

Halaman yang di-hosting tersedia dalam bahasa Inggris, Spanyol, Prancis, Jerman, dan Jepang. Bahasa dipilih berdasarkan peramban pengguna atau dari `ui_locales` pada URL masuk.
Atur teks Anda per bahasa. Bahasa yang tidak memiliki teks Anda akan tetap menggunakan teks default Didit yang sudah diterjemahkan.

Melalui API, `PATCH branding/` pada [API manajemen autentikasi](https://docs.didit.me/id/authentication/set-up-by-api.md) mengatur kolom yang sama:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}branding/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": {
      "en": {"sign_in_title": "Welcome back", "subtitle": "Sign in to manage your account.", "sign_up_title": "Open your account"},
      "es": {"sign_in_title": "Hola de nuevo"}
    },
    "terms_url": "https://example.com/legal/terms",
    "privacy_url": "https://example.com/legal/privacy"
  }'
```

Teks yang Anda kirim dalam keadaan kosong akan kembali ke teks default.

## Sign-in emails

The emails view of **Branding and emails** lists the sign-in emails of your application, with a preview of each and **Send a test**:

| Email | Sent when |
| - | - |
| Email code | A person signs in or signs up with an email code. |
| Magic link | A person asks for a sign-in link. |
| Password reset | A person starts [forgot password](https://docs.didit.me/id/authentication/sign-in-methods.md#lupa-dan-atur-ulang-kata-sandi). |
| New device sign-in | A person signs in from a new device. |
| Invitation | You invite a person to sign up, with the `invited` sign-up policy. |
| Organization invitation | You invite a person to one of your [organizations](https://docs.didit.me/id/authentication/organizations.md#undangan). |
| Agent approved, Agent access ended | A person's [AI agent](https://docs.didit.me/id/authentication/agent-access.md) gets or loses access. |

Each email is marked **On** or **Off** for your application.
Emails are sent from your verified email domain when you set one up in Customization, and from `Didit <no-reply@didit.me>` otherwise.

## Domain kustom

Secara default, aplikasi Anda memungkinkan orang masuk di `https://<slug>.auth.didit.me`.
Domain kustom memindahkan halaman yang di-hosting, API runtime, dan penerbit token ke subdomain milik Anda sendiri, misalnya `auth.example.com`.
Domain kustom hanya untuk aplikasi produksi: aplikasi sandbox selalu memungkinkan orang masuk di domain Didit.

> [!WARNING]
>
> Passkey terikat pada domain tempat orang masuk.
> Saat Anda mengaktifkan domain kustom, passkey yang sudah ada harus didaftarkan ulang, jadi tambahkan domain Anda sebelum orang mulai menambahkan passkey.

### Penyiapan

1. Di bawah **Custom domain**, masukkan **Your domain**, misalnya `auth.example.com`, lalu pilih **Add domain**. Gunakan subdomain: CNAME tidak bisa berada di domain akar Anda.
2. Buat rekaman DNS yang ditampilkan konsol: `CNAME` dari domain Anda ke host Didit aplikasi Anda.
3. Pilih **Check DNS now**. Rekaman baru bisa memerlukan waktu hingga satu jam untuk muncul. Setelah Didit menemukannya, Didit menerbitkan sertifikat untuk domain Anda, yang diperpanjang secara otomatis.
4. Saat domain menampilkan **Verified**, pilih **Use this domain** untuk menjadikannya origin masuk aplikasi Anda.

| Status | Arti |
| - | - |
| Waiting for DNS | Didit belum menemukan rekaman `CNAME`. |
| Issuing certificate | Rekaman sudah ada, dan sertifikat sedang diterbitkan. |
| Verified | Domain Anda melayani halaman yang di-hosting. Domain ini belum menjadi origin masuk sampai Anda mengaktifkannya. |
| Active | Domain Anda adalah origin masuk dan penerbit. |
| Not found | Pemeriksaan gagal. Perbaiki rekaman lalu periksa lagi. |

Melalui API, `PUT domain/` dengan `{"domain": "auth.example.com"}` menambahkannya, `POST domain/verify/` memeriksanya, `POST domain/activate/` mengaktifkannya, dan `DELETE domain/` menghapusnya.

### Yang berubah saat Anda mengaktifkannya

* **Penerbit.** Token baru menyebutkan domain Anda di `iss`, dan dokumen discovery serta JWKS berpindah ke domain tersebut. Perbarui penerbit yang diperiksa backend Anda, atau terima kedua penerbit hingga token lama kedaluwarsa. Lihat [token dan JWKS](https://docs.didit.me/id/authentication/tokens-and-jwks.md).
* **Kunci yang dapat dipublikasikan.** Kunci yang dapat dipublikasikan menyandikan penerbit, sehingga kunci ini berubah: salin kunci baru dari **Authentication > Developers** ke aplikasi Anda.
* **Sesi dan token** di bawah domain lama berakhir dalam 5 menit.
* **Passkey** harus didaftarkan ulang di domain baru.
* **URL pengalihan, pengaturan, dan pengguna yang sudah mendaftar** tetap sama.

Simpan kunci yang dapat dipublikasikan di satu pengaturan aplikasi Anda, agar peralihan hanya memerlukan satu perubahan.


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