Pular para o conteúdo principal
As páginas de login hospedadas do Didit Authentication e os e-mails de login usam a sua marca, a mesma do seu fluxo de verificação. Você define os textos das páginas e os links legais do Authentication, e pode mover o login para o seu próprio domínio, como auth.example.com. Gerencie isso no console em Authentication > Branding and emails, que mostra uma prévia ao vivo da página de login hospedada nos modos claro e escuro.
A página Branding and emails no Didit Business Console para uma aplicação sandbox, com a marca definida em Customization, os textos da página e uma prévia da página de login hospedada

Authentication > Branding and emails, com uma prévia da página hospedada.

Sua marca

O logotipo, a cor da marca, o plano de fundo, o raio dos cantos e a fonte vêm das configurações de Personalização da sua aplicação no console, e as páginas hospedadas e os e-mails seguem essas configurações. Selecione Editar em Personalização para alterá-los: uma única alteração atualiza o fluxo de verificação e as páginas de login simultaneamente.
  • As páginas seguem o modo claro ou escuro do dispositivo da pessoa, e a cor da marca é adaptada para planos de fundo escuros.
  • As páginas exibem o nome da sua aplicação.
  • No plano Free, as páginas hospedadas exibem um selo Secured by Didit.
Página de login hospedada da Didit para uma aplicação sandbox nos modos claro e escuro, com um botão de chave de acesso e os campos de e-mail e senha

A página de login hospedada segue o modo claro ou escuro do dispositivo da pessoa.

As páginas hospedadas são traduzidas para inglês, espanhol, francês, alemão e japonês, e escolhem o idioma pelo navegador da pessoa ou pelo ui_locales na URL de login. Defina os seus próprios textos por idioma: um idioma sem texto seu mantém o padrão traduzido pelo Didit. Pela API, o PATCH branding/ na API de gestão de autenticação define os mesmos campos:
Um texto enviado vazio volta ao padrão.

E-mails de login

A visualização de e-mails de Branding and emails lista os e-mails de login da sua aplicação, com uma prévia de cada um e o botão Send a test: Cada e-mail aparece marcado como On ou Off para a sua aplicação. Os e-mails são enviados a partir do seu domínio de e-mail verificado, quando você configura um em Customization, e de Didit <no-reply@didit.me> nos demais casos.

Domínio personalizado

Por padrão, sua aplicação autentica as pessoas em https://<slug>.auth.didit.me. Um domínio personalizado move as páginas hospedadas, a API de runtime e o emissor de tokens para um subdomínio próprio, como auth.example.com. Domínios personalizados são para aplicações em produção: uma aplicação de sandbox sempre autentica as pessoas no domínio da Didit.
As passkeys pertencem ao domínio em que as pessoas fazem login. Ativar um domínio personalizado significa que as passkeys existentes precisam ser cadastradas novamente, então adicione seu domínio antes que as pessoas comecem a adicionar passkeys.

Configure

  1. Em Custom domain, digite em Your domain um valor como auth.example.com e escolha Add domain. Use um subdomínio: um CNAME não pode ficar na raiz do seu domínio.
  2. Crie o registro DNS que o console mostra: um CNAME do seu domínio para o host da Didit da sua aplicação.
  3. Escolha Check DNS now. Um registro novo pode levar até uma hora para aparecer. Quando a Didit encontrá-lo, ela emite um certificado para o seu domínio, que é renovado automaticamente.
  4. Quando o domínio mostrar Verified, escolha Use this domain para torná-lo a origem de login da sua aplicação.
Pela API, PUT domain/ com {"domain": "auth.example.com"} adiciona o domínio, POST domain/verify/ o verifica, POST domain/activate/ o ativa e DELETE domain/ o remove.

O que muda ao ativá-lo

  • O emissor. Os novos tokens informam seu domínio em iss, e o documento de descoberta e o JWKS passam a ficar nele. Atualize o emissor que o seu backend verifica ou aceite os dois emissores até que os tokens antigos expirem. Veja tokens e JWKS.
  • A chave publicável. Ela codifica o emissor, então muda: copie a nova chave em Authentication > Developers para o seu app.
  • Sessões e tokens do domínio antigo terminam em até 5 minutos.
  • As passkeys precisam ser cadastradas novamente no novo domínio.
  • As URLs de redirecionamento, as configurações e as pessoas que se cadastraram permanecem as mesmas.
Mantenha a chave publicável em uma única configuração do seu app, para que a troca seja uma única alteração.
Última modificação em 22 de novembro de 2026