> ## 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 início de sessão com marca e domínio personalizado

> Personalize as páginas e e-mails de início de sessão da Didit com a sua marca, textos em cinco idiomas e o seu próprio domínio.

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](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é-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](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 início de sessão alojada segue o modo claro ou escuro do dispositivo da pessoa.

## Textos da página e ligações legais

| Campo | Limite | Onde aparece |
| - | - | - |
| **Título de início de sessão** | 120 caracteres | O título da página de início de sessão. |
| **Subtítulo** | 160 caracteres | A linha por baixo do título. |
| **Título de inscrição** | 120 caracteres | O título da página de inscrição. |
| **URL dos termos de serviço** | 500 caracteres | Uma ligação nas páginas. Quando definido, o formulário de inscrição pede à pessoa que aceite os seus termos. |
| **URL da política de privacidade** | 500 caracteres | Uma ligação nas páginas, junto aos seus termos. |

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](https://docs.didit.me/pt/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 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**:

| E-mail | Enviado quando |
| - | - |
| Código por e-mail | Uma pessoa inicia sessão ou se regista com um código enviado por e-mail. |
| Ligação mágica | Uma pessoa pede uma ligação de início de sessão. |
| Redefinição da palavra-passe | Uma pessoa inicia o processo de [esqueci-me da palavra-passe](https://docs.didit.me/pt/authentication/sign-in-methods.md#recuperação-e-reposição-da-palavra-passe). |
| Início de sessão num novo dispositivo | Uma pessoa inicia sessão a partir de um novo dispositivo. |
| Convite | Convida uma pessoa a registar-se, com a política de registo `invited`. |
| Convite para organização | Convida uma pessoa para uma das suas [organizações](https://docs.didit.me/pt/authentication/organizations.md#convites). |
| Agente aprovado, Acesso do agente terminado | O [agente de IA](https://docs.didit.me/pt/authentication/agent-access.md) de uma pessoa ganha ou perde acesso. |

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.

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

| Estado | Significado |
| - | - |
| Waiting for DNS | A Didit ainda não encontrou o registo `CNAME`. |
| Issuing certificate | O registo existe e o certificado está a ser emitido. |
| Verified | O seu domínio disponibiliza as páginas alojadas. Não é a sua origem de início de sessão até o ativar. |
| Active | O seu domínio é a origem de início de sessão e o emissor. |
| Not found | A verificação falhou. Corrija o registo e verifique novamente. |

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


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