# Dominio personalizzato

Pubblicare l'accesso sul proprio dominio anziché sull'host predefinito della piattaforma.

Requires: customDomain

> **Nota sul piano:** i domini personalizzati sono disponibili a partire dal piano Essential. Vedere [Piani e add-on](https://dts-identity.com/it/docs/getting-started/plans-and-addons.md). Nei livelli inferiori l'accesso viene pubblicato sull'host predefinito della piattaforma.

> **Nota:** un dominio personalizzato non si configura nella Admin Console. La configurazione avviene nel portale separato da cui viene gestita l'istanza. Questa pagina spiega che cosa cambia con un dominio personalizzato e che cosa preparare prima della configurazione.

Per impostazione predefinita il tenant è raggiungibile su un host gestito dalla piattaforma. Con un **dominio personalizzato** gli utenti accedono su un nome host di proprietà dell'organizzazione, per esempio `auth.yourcompany.com`, così le pagine di accesso, i link nelle email della piattaforma e gli endpoint OIDC utilizzano tutti il dominio proprio. In questo modo l'esperienza resta coerente con il resto del servizio.

## Che cosa preparare

| Elemento | Dettagli |
|---|---|
| **Un nome host dedicato** | Un sottodominio usato soltanto per l'accesso, come `auth.yourcompany.com`. Non riutilizzare il nome host di un sito web esistente. |
| **L'accesso alla zona DNS** | Per il nome host vengono pubblicati due record: un **CNAME** che instrada il traffico verso la piattaforma e un record **TXT** che dimostra la proprietà del dominio. I nomi host e i valori esatti vengono mostrati durante la configurazione. |
| **Un certificato TLS (facoltativo)** | Serve solo se si desidera utilizzare un certificato proprio anziché uno gestito. Occorre tenere pronta la catena di certificati PEM completa e la chiave privata corrispondente. Il certificato deve coprire il nome host e non deve essere scaduto. |

## Come procede la configurazione

I passaggi si susseguono in un ordine prestabilito:

1. **Dominio registrato.** Il nome host viene registrato per l'istanza.
2. **Proprietà verificata.** Occorre pubblicare i record TXT e CNAME presso il proprio provider DNS. La verifica riesce una volta che i record si sono propagati, cosa che di norma richiede pochi minuti.
3. **Certificato scelto.** Viene emesso e rinnovato automaticamente un certificato gestito, oppure si forniscono il proprio certificato e la relativa chiave privata.
4. **Dominio attivato.** Il dominio viene collegato all'edge e l'accesso viene commutato su di esso. L'attivazione richiede qualche istante e può interrompere brevemente le sessioni attive.

## Dopo l'attivazione

- Le pagine di accesso, le richieste di autenticazione a più fattori, la schermata di consenso e il portale dell'utente finale vengono pubblicati sul dominio proprio.
- L'issuer OIDC e tutti gli endpoint utilizzano il nuovo nome host. Le applicazioni che leggono il [documento di discovery](https://dts-identity.com/it/docs/quickstarts.md) lo recepiscono automaticamente; tutto ciò che contiene URL degli endpoint codificati in modo fisso va aggiornato.
- I link nelle email della piattaforma rimandano al nuovo nome host.
- I record DNS vanno mantenuti per tutto il tempo in cui il dominio è in uso. La loro rimozione compromette l'accesso.

## Risoluzione dei problemi

- **La verifica della proprietà non si completa.** Le modifiche DNS possono richiedere alcuni minuti, a volte di più, per propagarsi. Conviene verificare che host e valore del record corrispondano esattamente a quanto mostrato dalla configurazione, senza caratteri aggiuntivi.
- **Conflitto di CNAME.** Assicurarsi che per lo stesso nome host non esista alcun record A o AAAA.
- **Certificato rifiutato.** In modalità *certificato proprio*, il certificato deve essere una catena PEM valida, corrispondere alla chiave privata, coprire il nome host (CN o SAN) e non essere scaduto.
- **L'accesso passa ancora dall'host precedente.** L'attivazione è l'ultimo passaggio ed è separata dalla verifica. Conviene accertarsi che il dominio risulti attivo prima di trasferirvi gli utenti.

## Vedere anche

- [Aspetto](https://dts-identity.com/it/docs/branding/appearance.md)
- [Panoramica del Branding](https://dts-identity.com/it/docs/branding.md)
