Dominio personalizzato
Pubblicare l'accesso sul proprio dominio anziché sull'host predefinito della piattaforma.
Nota sul piano: i domini personalizzati sono disponibili a partire dal piano Essential. Vedere Piani e add-on. 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:
- Dominio registrato. Il nome host viene registrato per l'istanza.
- 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.
- Certificato scelto. Viene emesso e rinnovato automaticamente un certificato gestito, oppure si forniscono il proprio certificato e la relativa chiave privata.
- 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 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.