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

# Pagine di accesso personalizzate, email di accesso e dominio di autenticazione personalizzato

> Rendi tue le pagine di accesso e le email di Didit: il tuo brand, testi in cinque lingue, link a termini e privacy e il tuo dominio di accesso.

Le pagine di accesso ospitate di Didit Authentication e le email di accesso usano il tuo brand, lo stesso del flusso di verifica.
Puoi impostare i testi delle pagine e i link legali per Authentication, e puoi spostare l'accesso sul tuo dominio, ad esempio `auth.example.com`.

Gestiscilo nella console in **Authentication > Branding and emails**, dove viene mostrata un'anteprima in tempo reale della pagina di accesso ospitata in modalità chiara e scura.

![La pagina Branding and emails della Didit Business Console per un'applicazione sandbox, con il brand impostato in Customization, i testi della pagina e un'anteprima della pagina ospitata](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, con un'anteprima della pagina ospitata.

## Il tuo brand

Il logo, il colore del brand, lo sfondo, il raggio degli angoli e il font provengono dalle impostazioni **Customization** della tua applicazione nella console, e le pagine ospitate e le email li seguono.
Scegli **Edit in Customization** per modificarli: una modifica aggiorna contemporaneamente il flusso di verifica e le pagine di accesso.

* Le pagine seguono la modalità chiara o scura del dispositivo della persona, e il colore del brand viene adattato agli sfondi scuri.
* Le pagine mostrano il nome della tua applicazione.
* Con il piano Free, le pagine ospitate mostrano il badge **Secured by Didit**.

![Pagina di accesso ospitata di Didit per un'applicazione sandbox, in modalità chiara e scura, con il pulsante passkey e i campi email e password](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 pagina di accesso ospitata segue la modalità chiara o scura del dispositivo della persona.

## Testi della pagina e link legali

| Campo | Limite | Dove appare |
| - | - | - |
| **Titolo di accesso** | 120 caratteri | Il titolo della pagina di accesso. |
| **Sottotitolo** | 160 caratteri | La riga sotto il titolo. |
| **Titolo di registrazione** | 120 caratteri | Il titolo della pagina di registrazione. |
| **URL dei termini di servizio** | 500 caratteri | Un link nelle pagine. Se impostato, il modulo di registrazione chiede alla persona di accettare i termini. |
| **URL dell'informativa sulla privacy** | 500 caratteri | Un link nelle pagine, accanto ai termini. |

Le pagine ospitate sono tradotte in inglese, spagnolo, francese, tedesco e giapponese e scelgono la lingua in base alla lingua del browser della persona o a `ui_locales` nell'URL di accesso.
Imposta i tuoi testi per ogni lingua: una lingua senza un tuo testo mantiene il testo predefinito tradotto da Didit.

Tramite API, `PATCH branding/` sull'[API di gestione dell'autenticazione](https://docs.didit.me/it/authentication/set-up-by-api.md) imposta gli stessi campi:

```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 testo inviato come vuoto torna al valore predefinito.

## Email di accesso

La vista delle email di **Branding and emails** elenca le email di accesso della tua applicazione, con un'anteprima di ciascuna e **Send a test**:

| Email | Inviata quando |
| - | - |
| Codice via email | Una persona accede o si registra con un codice via email. |
| Link magico | Una persona richiede un link di accesso. |
| Reimpostazione della password | Una persona avvia la procedura [password dimenticata](https://docs.didit.me/it/authentication/sign-in-methods.md#password-dimenticata-e-reimpostazione). |
| Accesso da nuovo dispositivo | Una persona accede da un nuovo dispositivo. |
| Invito | Invii a una persona un invito a registrarsi, con la policy di registrazione `invited`. |
| Invito all'organizzazione | Invii a una persona un invito a una delle tue [organizzazioni](https://docs.didit.me/it/authentication/organizations.md#inviti). |
| Agente approvato, accesso dell'agente terminato | L'[agente AI](https://docs.didit.me/it/authentication/agent-access.md) di una persona ottiene o perde l'accesso. |

Ogni email è contrassegnata come **Attiva** o **Disattiva** per la tua applicazione.
Le email vengono inviate dal tuo dominio email verificato, se ne hai configurato uno in Customization, altrimenti da `Didit <no-reply@didit.me>`.

## Dominio personalizzato

Per impostazione predefinita, la tua applicazione consente alle persone di effettuare l'accesso su `https://<slug>.auth.didit.me`.
Un dominio personalizzato sposta le pagine ospitate, l'API di runtime e l'emittente dei token su un sottodominio di tua proprietà, come `auth.example.com`.
I domini personalizzati sono pensati per le applicazioni in produzione: un'applicazione sandbox consente sempre alle persone di effettuare l'accesso sul proprio dominio Didit.

> [!WARNING]
>
> Le passkey appartengono al dominio su cui le persone effettuano l'accesso.
> Attivare un dominio personalizzato significa che le passkey esistenti devono essere registrate di nuovo, quindi aggiungi il tuo dominio prima che le persone inizino ad aggiungere passkey.

### Configurazione

1. In **Custom domain**, inserisci **Your domain**, ad esempio `auth.example.com`, e scegli **Add domain**. Usa un sottodominio: un CNAME non può trovarsi alla radice del tuo dominio.
2. Crea il record DNS mostrato dalla console: un `CNAME` dal tuo dominio all'host Didit della tua applicazione.
3. Scegli **Check DNS now**. Un nuovo record può impiegare fino a un'ora per comparire. Quando Didit lo trova, emette un certificato per il tuo dominio, che si rinnova automaticamente.
4. Quando il dominio mostra **Verified**, scegli **Use this domain** per renderlo l'origine di accesso della tua applicazione.

| Stato | Significato |
| - | - |
| In attesa del DNS | Didit non ha ancora trovato il record `CNAME`. |
| Certificato in fase di emissione | Il record c'è e il certificato è in fase di emissione. |
| Verificato | Il tuo dominio serve le pagine ospitate. Non è l'origine di accesso finché non lo attivi. |
| Attivo | Il tuo dominio è l'origine di accesso e l'emittente. |
| Non trovato | La verifica non è riuscita. Correggi il record e verifica di nuovo. |

Tramite API, `PUT domain/` con `{"domain": "auth.example.com"}` lo aggiunge, `POST domain/verify/` lo verifica, `POST domain/activate/` lo attiva e `DELETE domain/` lo rimuove.

### Cosa cambia quando lo attivi

* **L'emittente.** I nuovi token indicano il tuo dominio in `iss`, e discovery e JWKS passano a quel dominio. Aggiorna l'emittente che il tuo backend verifica, oppure accetta entrambi gli emittenti finché i token più vecchi non scadono. Vedi [token e JWKS](https://docs.didit.me/it/authentication/tokens-and-jwks.md).
* **La chiave pubblicabile.** Codifica l'emittente, quindi cambia: copia la nuova chiave da **Authentication > Developers** nella tua app.
* **Sessioni e token** sul vecchio dominio terminano entro 5 minuti.
* **Le passkey** devono essere registrate di nuovo sul nuovo dominio.
* **Gli URL di reindirizzamento, le impostazioni e le persone registrate** restano invariati.

Conserva la chiave pubblicabile in un'unica impostazione della tua app, così il passaggio richiede una sola modifica.


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