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

Requires: customDomain

> **Nota de plano:** Os domínios personalizados estão disponíveis a partir do plano Essential. Consulte [Planos e add-ons](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md). 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:

1. **Domínio registado.** O nome de host é registado para a sua instância.
2. **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.
3. **Certificado escolhido.** Ou é emitido e renovado automaticamente um certificado gerido, ou é fornecido o seu próprio certificado com a respetiva chave privada.
4. **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](https://dts-identity.com/pt/docs/quickstarts.md) 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.

## Consulte também

- [Aspeto](https://dts-identity.com/pt/docs/branding/appearance.md)
- [Visão geral do Branding](https://dts-identity.com/pt/docs/branding.md)
