# Dominio propio

Ofrezca el inicio de sesión desde su propio dominio en lugar del host predeterminado de la plataforma.

Requires: customDomain

> **Nota sobre el plan:** Los dominios propios están disponibles a partir del plan Essential. Consulte [Planes y add-ons](https://dts-identity.com/es/docs/getting-started/plans-and-addons.md). En los niveles inferiores, el inicio de sesión se sirve desde el host predeterminado de la plataforma.

> **Nota:** Un dominio propio no se configura en la Admin Console. La configuración se realiza en el portal independiente desde el que se gestiona su instancia. Esta página explica qué cambia un dominio propio y qué debe preparar antes de la configuración.

De forma predeterminada, su tenant es accesible en un host gestionado por la plataforma. Con un **dominio propio**, sus usuarios inician sesión en un nombre de host de su propiedad, por ejemplo `auth.yourcompany.com`, de modo que las páginas de inicio de sesión, los enlaces de los correos de la plataforma y los endpoints OIDC utilizan todos su propio dominio. Así la experiencia se mantiene coherente con el resto de su servicio.

## Qué debe preparar

| Elemento | Detalles |
|---|---|
| **Un nombre de host dedicado** | Un subdominio utilizado únicamente para el inicio de sesión, como `auth.yourcompany.com`. No reutilice el nombre de host de un sitio web existente. |
| **Acceso a la zona DNS** | Para el nombre de host se publican dos registros: un **CNAME** que encamina el tráfico hacia la plataforma y un registro **TXT** que demuestra que el dominio es suyo. Los nombres de host y los valores exactos se muestran durante la configuración. |
| **Un certificado TLS (opcional)** | Solo si desea utilizar su propio certificado en lugar de uno gestionado. Tenga preparada la cadena PEM completa del certificado y la clave privada correspondiente. El certificado debe cubrir el nombre de host y no puede estar caducado. |

## Cómo se desarrolla la configuración

Los pasos ocurren en un orden fijo:

1. **Dominio registrado.** El nombre de host queda registrado para su instancia.
2. **Propiedad verificada.** Usted publica los registros TXT y CNAME en su proveedor de DNS. La verificación se completa una vez que los registros se han propagado, lo que suele tardar unos minutos.
3. **Certificado elegido.** O se emite y renueva automáticamente un certificado gestionado, o usted aporta su propio certificado y su clave privada.
4. **Dominio activado.** El dominio se integra en el edge y el inicio de sesión se conmuta a él. La activación tarda un momento y puede interrumpir brevemente las sesiones activas.

## Después de la activación

- Las páginas de inicio de sesión, las solicitudes multifactor, la pantalla de consentimiento y el portal de usuario final se sirven desde su dominio.
- El issuer OIDC y todos los endpoints utilizan el nuevo nombre de host. Las aplicaciones que leen el [documento de discovery](https://dts-identity.com/es/docs/quickstarts.md) lo adoptan automáticamente; todo lo que tenga URLs de endpoint fijas en el código debe actualizarse.
- Los enlaces de los correos de la plataforma apuntan al nuevo nombre de host.
- Mantenga los registros DNS mientras el dominio esté en uso. Si se eliminan, el inicio de sesión deja de funcionar.

## Solución de problemas

- **La verificación de propiedad no se completa.** Los cambios de DNS pueden tardar unos minutos, a veces más, en propagarse. Compruebe que el host y el valor del registro coinciden exactamente con lo que muestra la configuración, sin caracteres adicionales.
- **Conflicto de CNAME.** Asegúrese de que no exista ningún registro A o AAAA para el mismo nombre de host.
- **Certificado rechazado.** En el modo *certificado propio*, el certificado debe ser una cadena PEM válida, coincidir con la clave privada, cubrir el nombre de host (CN o SAN) y no estar caducado.
- **El inicio de sesión sigue utilizando el host antiguo.** La activación es el último paso y es independiente de la verificación. Confirme que el dominio aparece como activo antes de conmutar a sus usuarios.

## Véase también

- [Apariencia](https://dts-identity.com/es/docs/branding/appearance.md)
- [Visión general de Marca](https://dts-identity.com/es/docs/branding.md)
