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

# Pàgines d'inici de sessió personalitzades i domini d'autenticació propi

> Personalitza les pàgines i els correus d'inici de sessió de Didit amb la teva marca, textos en 5 idiomes, enllaços legals i domini propi.

Les pàgines d'inici de sessió allotjades de Didit Authentication i els correus d'inici de sessió fan servir la teva marca, la mateixa marca que el teu flux de verificació.
Configura els textos de les pàgines i els enllaços legals per a Authentication, i pots traslladar l'inici de sessió al teu propi domini, com ara `auth.example.com`.

Gestiona-ho a la consola, a **Authentication > Branding and emails**, que mostra una vista prèvia en directe de la pàgina d'inici de sessió allotjada en mode clar i fosc.

![La pàgina Branding and emails de la Business Console de Didit per a una aplicació de sandbox, amb la marca de Customization, els textos de la pàgina i una vista prèvia de la pàgina allotjada](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, amb una vista prèvia de la pàgina allotjada.

## La teva marca

El logotip, el color de marca, el fons, el radi dels cantons i la tipografia provenen de la configuració de **Customization** de la teva aplicació a la consola, i les pàgines allotjades i els correus electrònics s'hi ajusten.
Fes clic a **Edit in Customization** per canviar-los: un sol canvi actualitza alhora el flux de verificació i les pàgines d'inici de sessió.

* Les pàgines segueixen el mode clar o fosc del dispositiu de la persona, i el color de marca s'adapta als fons foscos.
* Les pàgines mostren el nom de la teva aplicació.
* Al pla Free, les pàgines allotjades mostren una insígnia **Secured by Didit**.

![Pàgina d'inici de sessió allotjada de Didit per a una aplicació de sandbox en mode clar i fosc, amb un botó de clau d'accés i camps de correu electrònic i contrasenya](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

La pàgina d'inici de sessió allotjada segueix el mode clar o fosc del dispositiu de la persona.

## Textos de la pàgina i enllaços legals

| Camp | Límit | On es mostra |
| - | - | - |
| **Títol d'inici de sessió** | 120 caràcters | El títol de la pàgina d'inici de sessió. |
| **Subtítol** | 160 caràcters | La línia sota el títol. |
| **Títol del registre** | 120 caràcters | El títol de la pàgina de registre. |
| **URL dels termes del servei** | 500 caràcters | Un enllaç a les pàgines. Quan està definit, el formulari de registre demana a la persona que accepti els teus termes. |
| **URL de la política de privacitat** | 500 caràcters | Un enllaç a les pàgines, al costat dels teus termes. |

Les pàgines allotjades es tradueixen a l'anglès, l'espanyol, el francès, l'alemany i el japonès, i trien l'idioma segons el navegador de la persona o segons `ui_locales` a l'URL d'inici de sessió.
Defineix els teus propis textos per idioma: un idioma sense el teu text conserva la traducció predeterminada de Didit.

Per API, `PATCH branding/` de la [API de gestió de l'autenticació](https://docs.didit.me/ca/authentication/set-up-by-api.md) defineix els mateixos camps:

```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"
  }'
```

Un text que enviïs buit torna al valor predeterminat.

## Correus d'inici de sessió

La vista de correus de **Branding and emails** enumera els correus d'inici de sessió de la teva aplicació, amb una previsualització de cadascun i **Send a test**:

| Correu | S'envia quan |
| - | - |
| Codi per correu electrònic | Una persona inicia sessió o es registra amb un codi per correu electrònic. |
| Enllaç màgic | Una persona demana un enllaç d'inici de sessió. |
| Restabliment de la contrasenya | Una persona inicia [el procés de recuperació de la contrasenya](https://docs.didit.me/ca/authentication/sign-in-methods.md#oblidar-i-restablir-la-contrasenya). |
| Inici de sessió des d'un dispositiu nou | Una persona inicia sessió des d'un dispositiu nou. |
| Invitació | Convides una persona a registrar-se, amb la política de registre `invited`. |
| Invitació a una organització | Convides una persona a una de les teves [organitzacions](https://docs.didit.me/ca/authentication/organizations.md#invitacions). |
| Agent aprovat, Accés de l'agent finalitzat | L'[agent d'IA](https://docs.didit.me/ca/authentication/agent-access.md) d'una persona obté o perd l'accés. |

Cada correu està marcat com a **On** o **Off** per a la teva aplicació.
Els correus s'envien des del teu domini de correu electrònic verificat quan n'has configurat un a Customization, i des de `Didit <no-reply@didit.me>` en cas contrari.

## Domini personalitzat

De manera predeterminada, la teva aplicació inicia la sessió dels usuaris a `https://<slug>.auth.didit.me`.
Un domini personalitzat mou les pàgines allotjades, l'API d'execució i l'emissor dels tokens a un subdomini propi, com ara `auth.example.com`.
Els dominis personalitzats són per a aplicacions en producció: una aplicació de sandbox sempre inicia la sessió dels usuaris al domini de Didit.

> [!WARNING]
>
> Les claus de pas pertanyen al domini on els usuaris inicien la sessió.
> En activar un domini personalitzat, les claus de pas existents s'han de tornar a registrar, així que afegeix el teu domini abans que els usuaris comencin a afegir claus de pas.

### Configurar-lo

1. A **Custom domain**, introdueix **Your domain**, per exemple `auth.example.com`, i tria **Add domain**. Fes servir un subdomini: un CNAME no pot anar a l'arrel del teu domini.
2. Crea el registre DNS que mostra la consola: un `CNAME` des del teu domini fins a l'host de Didit de la teva aplicació.
3. Tria **Check DNS now**. Un registre nou pot trigar fins a una hora a aparèixer. Quan Didit el trobi, emetrà un certificat per al teu domini, que es renova automàticament.
4. Quan el domini mostri **Verified**, tria **Use this domain** per convertir-lo en l'origen d'inici de sessió de la teva aplicació.

| Estat | Significat |
| - | - |
| Waiting for DNS | Didit encara no ha trobat el registre `CNAME`. |
| Issuing certificate | El registre hi és i el certificat s'està emetent. |
| Verified | El teu domini serveix les pàgines allotjades. No és el teu origen d'inici de sessió fins que l'activis. |
| Active | El teu domini és l'origen d'inici de sessió i l'emissor. |
| Not found | La comprovació ha fallat. Corregeix el registre i torna a comprovar-lo. |

Mitjançant l'API, `PUT domain/` amb `{"domain": "auth.example.com"}` l'afegeix, `POST domain/verify/` el comprova, `POST domain/activate/` l'activa i `DELETE domain/` l'elimina.

### Què canvia en activar-lo

* **L'emissor.** Els tokens nous indiquen el teu domini a `iss`, i el document de descoberta i el JWKS passen a estar-hi. Actualitza l'emissor que comprova el teu backend, o accepta tots dos emissors fins que caducin els tokens antics. Consulta [tokens i JWKS](https://docs.didit.me/ca/authentication/tokens-and-jwks.md).
* **La clau publicable.** Codifica l'emissor, així que canvia: copia la clau nova de **Authentication > Developers** a la teva aplicació.
* **Les sessions i els tokens** del domini antic caduquen en un termini de 5 minuts.
* **Les claus de pas** s'han de tornar a registrar al domini nou.
* **Les URL de redirecció, la configuració i els usuaris registrats** es mantenen igual.

Guarda la clau publicable en una sola configuració de la teva aplicació, perquè el canvi sigui una sola modificació.


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