> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Domínio personalizado para KYC: configuração DNS

> Na Didit, use o seu subdomínio em vez de verify.didit.me. Adicione o domínio, crie dois registos DNS e verifique a propriedade.

Sirva o fluxo de verificação a partir do seu próprio subdomínio, por exemplo `verify.yourbrand.com` em vez de `verify.didit.me`. Os utilizadores mantêm-se no seu domínio durante todo o percurso, o que elimina a última referência visível à Didit num fluxo de [marca branca](https://docs.didit.me/pt/console/white-label.md).

> [!NOTE]
>
> O domínio personalizado faz parte da Marca branca, nos planos **Scale** e **Enterprise**. Também precisa de **acesso de escrita a Customization**. Os membros com acesso só de leitura veem a secção desativada.

> [!NOTE]
>
> Quando a sua organização deixa o Scale ou o Enterprise, incluindo uma avaliação Scale que termina sem um plano pago, o respetivo domínio personalizado é removido e as novas ligações de verificação voltam a usar o domínio da Didit. Um domínio personalizado ligado antes de 1 de novembro de 2026 mantém-se em qualquer plano. Se o eliminar, voltar a adicionar um domínio personalizado exige o Scale ou o Enterprise.

> [!NOTE]
>
> Os domínios personalizados estão disponíveis apenas em **aplicações em produção**. Uma aplicação [sandbox](https://docs.didit.me/pt/integration/sandbox-testing.md) não pode adicionar um, e as sessões sandbox usam sempre o domínio predefinido da página de verificação alojada. Mude para a sua aplicação em produção na Business Console para configurar o seu domínio.

***

## Requisitos

| Requisito | Detalhe |
| - | - |
| **Aplicação em produção** | O domínio pertence a uma aplicação em produção. As aplicações sandbox não podem configurar um domínio personalizado. |
| **Apenas subdomínio** | Utilize `verify.yourbrand.com`. Domínios raiz como `yourbrand.com` são rejeitados, e o prefixo `www.` também. |
| **Não está já em uso** | O subdomínio não pode apontar para um website ou aplicação já existente que lhe pertença. |
| **Acesso ao DNS** | Precisa de criar dois registos no seu fornecedor de DNS. |

***

## Como funciona

Introduza o seu subdomínio na Business Console. A Didit gera então dois registos DNS para adicionar no seu fornecedor:

| Registo | Finalidade |
| - | - |
| **CNAME de verificação** | Comprova que é proprietário do domínio, o que permite emitir o certificado SSL. |
| **CNAME CloudFront** | Aponta o seu subdomínio para a interface de verificação. |

Ambos os registos são obrigatórios. Quando forem resolvidos, verifique a propriedade na consola e o fluxo passa a ser disponibilizado a partir do seu domínio.

***

## Configure o seu domínio

**1. Adicione o domínio**

Aceda a **Customization > Domain**, introduza o seu subdomínio (por exemplo `verify.yourbrand.com`) e clique em **Adicionar domínio**.

A consola gera os seus registos DNS. Isto demora alguns segundos.

**2. Copie os dois registos**

A consola mostra um cartão para cada registo: **CNAME de verificação** e **CNAME CloudFront**. Cada cartão apresenta dois valores:

| Campo do cartão | Onde vai no seu fornecedor de DNS |
| - | - |
| **Nome do anfitrião** | O **nome** do registo (host) |
| **Dados/URL** | O **valor** do registo (destino) |

> [!WARNING]
>
> Não troque **Nome do anfitrião** e **Dados/URL** ao colá-los no seu fornecedor de DNS, e use o botão de copiar de cada valor. Os valores de verificação são longos e fáceis de introduzir incorretamente.

**3. Adicione os dois registos no seu fornecedor de DNS**

Crie os dois registos como `CNAME`. Adicionar apenas o registo CloudFront é o motivo mais comum pelo qual a verificação falha posteriormente.

Defina o TTL como `300` para que qualquer correção feita depois se propague em minutos e não em horas.

**4. Verifique a propriedade**

De volta à consola, clique em **Verificar domínio**. Em caso de sucesso, o painel passa a mostrar **Domínio verificado** e o botão desaparece.

Se falhar, a consola mostra uma caixa **A verificação falhou** com o motivo específico. Leia-a antes de alterar qualquer coisa, porque indica o registo em falta ou incorreto.

> [!NOTE]
>
> A propagação do DNS costuma demorar minutos, mas pode demorar até **24–48 horas**. Se a consola indicar **Alterações DNS detetadas**, os seus registos estão corretos e a propagação ainda está a terminar. Não é necessária nenhuma ação.

***

## Altere ou remova o seu domínio

Para mudar o fluxo para outro subdomínio, introduza o novo e clique em **Atualizar domínio**. A Didit emite um novo par de registos, pelo que tem de os adicionar no seu fornecedor de DNS e voltar a verificar.

Para voltar a `verify.didit.me`, limpe o campo e clique em **Remover domínio**.

> [!NOTE]
>
> Enquanto um domínio personalizado estiver configurado, não pode reativar o ecrã de início de sessão da Didit. Remova primeiro o domínio.

***

## Resolução de problemas

> [accordion] Erro 500 ou mensagem sobre outra distribuição CloudFront
>
> O seu subdomínio tem um registo `A` em conflito com o CNAME, porque um anfitrião não pode ter os dois. Elimine o registo `A` e mantenha apenas o CNAME.
>
> Se não existir nenhum registo `A`, o CNAME do CloudFront aponta para o destino errado. Compare-o carácter a carácter com o valor **Dados/URL** na consola.

> [accordion] A verificação nunca é concluída com sucesso
>
> Confirme que **ambos** os registos existem no seu fornecedor. Adicionar apenas o registo do CloudFront é a causa mais comum, porque o fluxo parece carregar enquanto o certificado nunca é emitido.
>
> A caixa **A verificação falhou** na consola indica o registo que está em falta ou incorreto.

> [accordion] O certificado nunca é emitido (Cloudflare)
>
> Defina os dois registos como **Apenas DNS**: nuvem cinzenta, com o proxy desativado. O proxy associado à nuvem laranja intercepta o pedido e impede a emissão do certificado.
>
> Os fornecedores sem interruptor de proxy, como o cPanel, não são afetados.

> [accordion] O nome do registo fica duplicado
>
> Alguns fornecedores acrescentam automaticamente a sua zona, transformando `verify.yourbrand.com` em `verify.yourbrand.com.yourbrand.com`.
>
> Nesses fornecedores, introduza o nome **relativo** em vez do nome completo que a consola apresenta: `verify` em vez de `verify.yourbrand.com`, e `_abc123.verify` em vez de `_abc123.verify.yourbrand.com`. Depois, reabra o registo guardado e confirme que o nome completo armazenado corresponde exatamente ao **Nome do anfitrião** indicado na consola.

> [accordion] Uma correção demora horas a ser aplicada
>
> Os seus registos ficam em cache durante o período do respetivo TTL. Reduza o TTL para `300` e aguarde que o valor anterior expire antes de voltar a testar.

***

## Próximos passos

* **Alinhe o resto da interface com a sua marca**: as cores, o logótipo e a tipografia estão em [Personalização](https://docs.didit.me/pt/console/white-label.md).
* **Ative o seu estilo por fluxo**: a personalização só se aplica aos fluxos com **Incluir estilo personalizado** ativado. Consulte [Marca branca](https://docs.didit.me/pt/console/white-label.md#ativar-o-estilo-personalizado-no-seu-fluxo).
* **Reveja as suas obrigações de divulgação**: um domínio personalizado oculta a marca da Didit, mas não o seu papel. Consulte as [responsabilidades de conformidade](https://docs.didit.me/pt/console/white-label.md#responsabilidades-de-conformidade-nos-fluxos-de-marca-branca).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.