Saltar para o conteúdo principal
As páginas de início de sessão alojadas do Didit Authentication e os e-mails de início de sessão usam a sua marca, a mesma marca do seu fluxo de verificação. Pode definir os textos da página e as ligações legais do Authentication e transferir o início de sessão para o seu próprio domínio, como auth.example.com. Gere isto na consola, em Authentication > Branding and emails, onde é apresentada uma pré-visualização em tempo real da página de início de sessão alojada, nos modos claro e escuro.
A página Branding and emails na Didit Business Console para uma aplicação sandbox, com a marca de Customization, os textos da página e uma pré-visualização da página alojada

Authentication > Branding and emails, com uma pré-visualização da página alojada.

A sua marca

O logótipo, a cor da marca, o fundo, o raio dos cantos e o tipo de letra vêm das definições Customization da sua aplicação na consola, e as páginas alojadas e os e-mails seguem essas definições. Escolha Edit in Customization para os alterar: uma única alteração atualiza, em simultâneo, o fluxo de verificação e as páginas de início de sessão.
  • As páginas seguem o modo claro ou escuro do dispositivo da pessoa, e a cor da marca é adaptada para fundos escuros.
  • As páginas mostram o nome da sua aplicação.
  • No plano Free, as páginas alojadas mostram um selo Secured by Didit.
Página de início de sessão alojada da Didit para uma aplicação sandbox, em modo claro e escuro, com um botão de chave de acesso e campos de e-mail e palavra-passe

A página de início de sessão alojada segue o modo claro ou escuro do dispositivo da pessoa.

Textos da página e ligações legais

As páginas alojadas estão traduzidas para inglês, espanhol, francês, alemão e japonês, e escolhem o idioma a partir do navegador da pessoa ou de ui_locales no URL de início de sessão. Defina os seus próprios textos para cada idioma: um idioma sem o seu texto mantém o texto predefinido traduzido pela Didit. Através da API, PATCH branding/ na API de gestão de autenticação define os mesmos campos:
Um texto enviado vazio volta ao valor predefinido.

Emails de início de sessão

A vista de e-mails de Personalização da marca e e-mails lista os e-mails de início de sessão da sua aplicação, com uma pré-visualização de cada um e o botão Enviar um teste: Cada e-mail está marcado como Ativado ou Desativado para a sua aplicação. Os e-mails são enviados a partir do seu domínio de e-mail verificado, se tiver configurado um em Personalização, e a partir de Didit <no-reply@didit.me> nos restantes casos.

Domínio personalizado

Por predefinição, a sua aplicação permite que as pessoas iniciem sessão em https://<slug>.auth.didit.me. Um domínio personalizado move as páginas alojadas, a API em tempo de execução e o emissor de tokens para um subdomínio seu, como auth.example.com. Os domínios personalizados destinam-se a aplicações em produção: uma aplicação sandbox inicia sempre a sessão das pessoas no respetivo domínio Didit.
As passkeys pertencem ao domínio onde as pessoas iniciam sessão. Ativar um domínio personalizado significa que as passkeys existentes têm de ser registadas novamente, por isso adicione o seu domínio antes de as pessoas começarem a adicionar passkeys.

Configurar

  1. Em Custom domain, introduza Your domain, por exemplo auth.example.com, e escolha Add domain. Utilize um subdomínio: um CNAME não pode ficar na raiz do seu domínio.
  2. Crie o registo DNS que a consola mostra: um CNAME do seu domínio para o host Didit da sua aplicação.
  3. Escolha Check DNS now. Um registo novo pode demorar até uma hora a aparecer. Assim que a Didit o encontrar, emite um certificado para o seu domínio, que se renova automaticamente.
  4. Quando o domínio mostrar Verified, escolha Use this domain para o tornar a origem de início de sessão da sua aplicação.
Através da API, PUT domain/ com {"domain": "auth.example.com"} adiciona-o, POST domain/verify/ verifica-o, POST domain/activate/ ativa-o e DELETE domain/ remove-o.

O que muda ao ativar

  • O emissor. Os novos tokens indicam o seu domínio em iss, e o documento de descoberta e o JWKS passam a estar nesse domínio. Atualize o emissor que o seu backend verifica, ou aceite ambos os emissores até os tokens antigos expirarem. Consulte tokens e JWKS.
  • A chave publicável. Esta codifica o emissor, por isso muda: copie a nova chave de Authentication > Developers para a sua aplicação.
  • As sessões e os tokens no domínio antigo terminam no prazo máximo de 5 minutos.
  • As passkeys têm de ser registadas novamente no novo domínio.
  • Os URLs de redirecionamento, as definições e as pessoas que se registaram mantêm-se iguais.
Mantenha a chave publicável numa única definição da sua aplicação, para que a mudança seja uma única alteração.
Última modificação em 22 de novembro de 2026