> ## 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 inicio de sesión con marca propia, correos y dominio personalizado

> Personaliza las páginas y los correos de inicio de sesión de Didit con tu marca, textos en cinco idiomas, enlaces legales y tu propio dominio.

Las páginas de inicio de sesión alojadas de Didit Authentication y los correos de inicio de sesión usan tu marca, la misma que la de tu flujo de verificación.
Configuras los textos de las páginas y los enlaces legales de Authentication, y puedes trasladar el inicio de sesión a tu propio dominio, como `auth.example.com`.

Gestiónalo en la consola, en **Authentication > Branding and emails**, que muestra una vista previa en directo de la página de inicio de sesión alojada en modo claro y oscuro.

![La página Branding and emails de la Business Console de Didit para una aplicación sandbox, con la marca de Customization, los textos de la página y una vista previa de la 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, con una vista previa de la página alojada.

## Tu marca

El logotipo, el color de marca, el fondo, el radio de las esquinas y la tipografía provienen de la configuración de **Customization** de tu aplicación en la consola, y las páginas alojadas y los correos electrónicos se ajustan a esa configuración.
Elige **Edit in Customization** para cambiarlos: un solo cambio actualiza a la vez el flujo de verificación y las páginas de inicio de sesión.

* Las páginas siguen el modo claro u oscuro del dispositivo de la persona, y el color de marca se adapta a los fondos oscuros.
* Las páginas muestran el nombre de tu aplicación.
* En el plan Free, las páginas alojadas muestran una insignia **Secured by Didit**.

![Página de inicio de sesión alojada de Didit para una aplicación de sandbox en modo claro y oscuro, con un botón de clave de acceso y campos de correo electrónico y contraseña](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

La página de inicio de sesión alojada sigue el modo claro u oscuro del dispositivo de la persona.

## Textos de la página y enlaces legales

| Campo | Límite | Dónde aparece |
| - | - | - |
| **Título de inicio de sesión** | 120 caracteres | El encabezado de la página de inicio de sesión. |
| **Subtítulo** | 160 caracteres | La línea debajo del encabezado. |
| **Título de registro** | 120 caracteres | El encabezado de la página de registro. |
| **URL de los términos de servicio** | 500 caracteres | Un enlace en las páginas. Si se define, el formulario de registro pide a la persona que acepte tus términos. |
| **URL de la política de privacidad** | 500 caracteres | Un enlace en las páginas, junto a tus términos. |

Las páginas alojadas están traducidas al inglés, español, francés, alemán y japonés, y eligen el idioma según el navegador de la persona o según `ui_locales` en la URL de inicio de sesión.
Define tus propios textos por idioma: un idioma sin texto propio conserva el valor predeterminado traducido de Didit.

Mediante la API, `PATCH branding/` en la [API de gestión de autenticación](https://docs.didit.me/es/authentication/set-up-by-api.md) define los mismos 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"
  }'
```

Si envías un texto vacío, vuelve al valor predeterminado.

## Correos de inicio de sesión

La vista de **Marca y correos electrónicos** muestra los correos de inicio de sesión de tu aplicación, con una vista previa de cada uno y **Enviar una prueba**:

| Correo electrónico | Se envía cuando |
| - | - |
| Código por correo electrónico | Una persona inicia sesión o se registra con un código por correo electrónico. |
| Enlace mágico | Una persona solicita un enlace de inicio de sesión. |
| Restablecimiento de contraseña | Una persona inicia el proceso de [recuperación de contraseña](https://docs.didit.me/es/authentication/sign-in-methods.md#contraseña-olvidada-y-restablecimiento). |
| Inicio de sesión desde un dispositivo nuevo | Una persona inicia sesión desde un dispositivo nuevo. |
| Invitación | Invitas a una persona a registrarse, con la política de registro `invited`. |
| Invitación a organización | Invitas a una persona a unirse a una de tus [organizaciones](https://docs.didit.me/es/authentication/organizations.md#invitaciones). |
| Agente aprobado, Acceso del agente finalizado | A un [agente de IA](https://docs.didit.me/es/authentication/agent-access.md) de una persona se le concede o se le retira el acceso. |

Cada correo aparece como **On** u **Off** para tu aplicación.
Los correos se envían desde tu dominio de correo electrónico verificado si lo configuras en Personalización, y desde `Didit <no-reply@didit.me>` en caso contrario.

## Dominio personalizado

Por defecto, tu aplicación permite que las personas inicien sesión en `https://<slug>.auth.didit.me`.
Un dominio personalizado traslada las páginas alojadas, la API en tiempo de ejecución y el emisor de tokens a un subdominio propio, como `auth.example.com`.
Los dominios personalizados son para aplicaciones en producción: una aplicación sandbox siempre inicia la sesión de las personas en su dominio de Didit.

> [!WARNING]
>
> Las claves de acceso pertenecen al dominio en el que las personas inician sesión.
> Activar un dominio personalizado significa que las claves de acceso existentes deben volver a registrarse, así que añade tu dominio antes de que las personas empiecen a añadir claves de acceso.

### Configúralo

1. En **Custom domain**, introduce **Your domain**, por ejemplo `auth.example.com`, y elige **Add domain**. Usa un subdominio: un CNAME no puede estar en la raíz de tu dominio.
2. Crea el registro DNS que muestra la consola: un `CNAME` desde tu dominio al host de Didit de tu aplicación.
3. Elige **Check DNS now**. Un registro nuevo puede tardar hasta una hora en aparecer. Cuando Didit lo encuentra, emite un certificado para tu dominio, que se renueva automáticamente.
4. Cuando el dominio muestre **Verified**, elige **Use this domain** para convertirlo en el origen de inicio de sesión de tu aplicación.

| Estado | Significado |
| - | - |
| Esperando DNS | Didit todavía no ha encontrado el registro `CNAME`. |
| Emitiendo certificado | El registro está presente y el certificado se está emitiendo. |
| Verificado | Tu dominio sirve las páginas alojadas. No es tu origen de inicio de sesión hasta que lo actives. |
| Activo | Tu dominio es el origen de inicio de sesión y el emisor. |
| No encontrado | La comprobación falló. Corrige el registro y vuelve a comprobarlo. |

Por API, `PUT domain/` con `{"domain": "auth.example.com"}` lo añade, `POST domain/verify/` lo verifica, `POST domain/activate/` lo activa y `DELETE domain/` lo elimina.

### Qué cambia al activarlo

* **El emisor.** Los tokens nuevos incluyen tu dominio en `iss`, y el descubrimiento y el JWKS pasan a estar en él. Actualiza el valor de emisor que comprueba tu backend, o acepta ambos emisores hasta que expiren los tokens antiguos. Consulta [tokens y JWKS](https://docs.didit.me/es/authentication/tokens-and-jwks.md).
* **La clave publicable.** Codifica el emisor, así que cambia: copia la nueva clave desde **Authentication > Developers** en tu app.
* **Las sesiones y los tokens** del dominio anterior terminan en un plazo de 5 minutos.
* **Las claves de acceso** deben volver a registrarse en el nuevo dominio.
* **Las URLs de redirección, la configuración y las personas que se registraron** siguen igual.

Guarda la clave publicable en una única configuración de tu app, para que el cambio sea una sola modificación.


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