Skip to Content

Dominio personalizzato

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

RequirescustomDomain

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

ElementoDettagli
Un nome host dedicatoUn sottodominio usato soltanto per l'accesso, come auth.yourcompany.com. Non riutilizzare il nome host di un sito web esistente.
L'accesso alla zona DNSPer 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 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

In questa pagina