Domínio personalizado
Sirva o início de sessão a partir do seu próprio domínio em vez do host predefinido da plataforma.
Nota de plano: Os domínios personalizados estão disponíveis a partir do plano Essential. Consulte Planos e add-ons. Nos níveis inferiores, o início de sessão é servido a partir do host predefinido da plataforma.
Nota: Um domínio personalizado não se configura na Admin Console. A configuração decorre no portal separado através do qual a sua instância é gerida. Esta página explica o que um domínio personalizado altera e o que deve preparar antes da configuração.
Por predefinição, o seu tenant é alcançado num host gerido pela plataforma. Com um domínio personalizado, os seus utilizadores iniciam sessão num nome de host que lhe pertence, por exemplo auth.yourcompany.com, pelo que as páginas de início de sessão, as ligações nos e-mails da plataforma e os endpoints OIDC usam todos o seu próprio domínio. Isto mantém a experiência coerente com o resto do seu serviço.
O que preparar
| Elemento | Detalhes |
|---|---|
| Um nome de host dedicado | Um subdomínio usado apenas para o início de sessão, como auth.yourcompany.com. Não reutilize o nome de host de um site já existente. |
| Acesso à zona DNS | São publicados dois registos para o nome de host: um CNAME, que encaminha o tráfego para a plataforma, e um registo TXT, que prova que o domínio lhe pertence. Os nomes de host e os valores exatos são apresentados durante a configuração. |
| Um certificado TLS (opcional) | Apenas se quiser usar um certificado próprio em vez de um certificado gerido. Tenha à mão a cadeia de certificados PEM completa e a chave privada correspondente. O certificado tem de cobrir o nome de host e não pode estar expirado. |
Como decorre a configuração
Os passos acontecem por uma ordem fixa:
- Domínio registado. O nome de host é registado para a sua instância.
- Propriedade verificada. Publica os registos TXT e CNAME junto do seu fornecedor de DNS. A verificação é bem-sucedida assim que os registos se tenham propagado, o que normalmente demora alguns minutos.
- Certificado escolhido. Ou é emitido e renovado automaticamente um certificado gerido, ou é fornecido o seu próprio certificado com a respetiva chave privada.
- Domínio ativado. O domínio é ligado no edge e o início de sessão passa para ele. A ativação demora um momento e pode interromper brevemente sessões ativas.
Depois da ativação
- As páginas de início de sessão, os pedidos de multifator, o ecrã de consentimento e o portal do utilizador final são servidos a partir do seu domínio.
- O issuer OIDC e todos os endpoints usam o novo nome de host. As aplicações que leem o documento de discovery adotam-no automaticamente; tudo o que tenha URLs de endpoints fixados no código tem de ser atualizado.
- As ligações nos e-mails da plataforma apontam para o novo nome de host.
- Mantenha os registos DNS enquanto o domínio estiver em uso. Removê-los quebra o início de sessão.
Resolução de problemas
- A verificação da propriedade não fica concluída. As alterações de DNS podem demorar alguns minutos, por vezes mais, a propagar-se. Confirme que o host e o valor do registo correspondem exatamente ao que a configuração apresenta, sem caracteres a mais.
- Conflito no CNAME. Assegure-se de que não existe qualquer registo A ou AAAA para o mesmo nome de host.
- Certificado recusado. No modo certificado próprio, o certificado tem de ser uma cadeia PEM válida, corresponder à chave privada, cobrir o nome de host (CN ou SAN) e não estar expirado.
- O início de sessão continua a usar o host antigo. A ativação é o último passo e é independente da verificação. Confirme que o domínio aparece como ativo antes de transferir os seus utilizadores.