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

# Páginas de login personalizadas, e-mails de login e domínio próprio de autenticação

> Personalize as páginas e os e-mails de login hospedados pela Didit com sua marca, textos em cinco idiomas, links de termos e privacidade e seu próprio domínio.

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

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

## Textos da página e links legais

| Campo | Limite | Onde aparece |
| - | - | - |
| **Título de login** | 120 caracteres | O título da página de login. |
| **Subtítulo** | 160 caracteres | A linha abaixo do título. |
| **Título de cadastro** | 120 caracteres | O título da página de cadastro. |
| **URL dos termos de serviço** | 500 caracteres | Um link nas páginas. Quando definida, o formulário de cadastro pede que a pessoa aceite os seus termos. |
| **URL da política de privacidade** | 500 caracteres | Um link nas páginas, ao lado dos seus termos. |

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](https://docs.didit.me/pt-br/authentication/set-up-by-api.md) define os mesmos campos:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}branding/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": {
      "en": {"sign_in_title": "Welcome back", "subtitle": "Sign in to manage your account.", "sign_up_title": "Open your account"},
      "es": {"sign_in_title": "Hola de nuevo"}
    },
    "terms_url": "https://example.com/legal/terms",
    "privacy_url": "https://example.com/legal/privacy"
  }'
```

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**:

| E-mail | Enviado quando |
| - | - |
| Código por e-mail | Uma pessoa faz login ou se cadastra com um código enviado por e-mail. |
| Link mágico | Uma pessoa solicita um link de login. |
| Redefinição de senha | Uma pessoa inicia o fluxo de [recuperação de senha](https://docs.didit.me/pt-br/authentication/sign-in-methods.md#esquecimento-e-redefinição-de-senha). |
| Login em novo dispositivo | Uma pessoa faz login a partir de um novo dispositivo. |
| Convite | Você convida uma pessoa para se cadastrar, com a política de cadastro `invited`. |
| Convite de organização | Você convida uma pessoa para uma das suas [organizações](https://docs.didit.me/pt-br/authentication/organizations.md#convites). |
| Agente aprovado, Acesso do agente encerrado | O [agente de IA](https://docs.didit.me/pt-br/authentication/agent-access.md) de uma pessoa ganha ou perde acesso. |

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.

> [!WARNING]
>
> 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.

| Status | Significado |
| - | - |
| Waiting for DNS | A Didit ainda não encontrou o registro `CNAME`. |
| Issuing certificate | O registro está lá, e o certificado está sendo emitido. |
| Verified | Seu domínio disponibiliza as páginas hospedadas. Ele não é a sua origem de login até que você o ative. |
| Active | Seu domínio é a origem de login e o emissor. |
| Not found | A verificação falhou. Corrija o registro e verifique novamente. |

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](https://docs.didit.me/pt-br/authentication/tokens-and-jwks.md).
* **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.


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