Saltar al contenido principal

Dominio personalizado

Tu inquilino de Logto viene con un dominio gratuito predeterminado {{tenant-id}}.app.logto. Sin embargo, puedes mejorar la experiencia del usuario y el reconocimiento de marca utilizando un dominio personalizado, como auth.example.com.

Tu dominio personalizado se utiliza para varias funciones:

nota

Cambiar el dominio después de publicar tu servicio puede causar problemas porque el código de tu aplicación y las integraciones podrían seguir haciendo referencia al dominio antiguo. Para asegurar una transición sin problemas, configura tu dominio personalizado al principio durante la creación de un inquilino de Producción.

Configurar dominio personalizado en la Consola​

Para agregar un nuevo dominio personalizado en la Consola de Logto, sigue estos pasos:

  1. Navega a Console > Settings > Domains.

  2. En la sección "Custom Domain", ingresa el nombre de tu dominio y haz clic en "add domain".

    Agregar dominio

  3. Copia el valor de CNAME en la tabla y ve al proveedor de DNS de tu dominio para agregar el registro.

    Procesamiento de dominio personalizado

  4. Espera la verificación y el proceso de SSL.

    1. Verificaremos automáticamente tus registros cada 10 segundos hasta que se agregue el dominio personalizado. Solo asegúrate de que el nombre de dominio ingresado o los registros DNS sean precisos.
    2. La verificación generalmente toma unos minutos, pero puede tardar hasta 24 horas, dependiendo del proveedor de DNS. Siéntete libre de navegar fuera durante el proceso.

Solución de problemas​

Problemas con el certificado SSL

Si encuentras problemas con el certificado SSL al configurar tu dominio personalizado, puede estar relacionado con los registros CAA en tu configuración de DNS. Los registros CAA especifican qué Autoridades de Certificación (CAs) están autorizadas para emitir certificados para tu dominio.

Para solucionar y resolver problemas de certificados SSL relacionados con los registros CAA, consulta la documentación de Cloudflare sobre Registros CAA.

Error "The hostname is associated with a held zone"

Si encuentras el mensaje de error "The hostname is associated with a held zone, please contact the owner to have the hold removed" al agregar un dominio personalizado, significa que el dominio ya está en la zona de Cloudflare y está configurado en estado "Zone Hold". Consulta esta documentación de Cloudflare para más información.

Para resolver este problema, necesitarás liberar la retención de la zona. Sigue el enlace anterior para obtener instrucciones sobre cómo liberar la retención de la zona en Cloudflare.

Usar dominio personalizado​

Una vez que hayas configurado tus ajustes, tanto tu nombre de dominio personalizado como el nombre de dominio predeterminado de Logto estarán disponibles para tu inquilino. Sin embargo, se requieren ciertas configuraciones para activar tu nombre de dominio personalizado.

nota

En este artículo, asumimos que tu dominio personalizado es auth.example.com.

Dominio personalizado agregado

Actualizando el endpoint del SDK para aplicaciones​

Modifica tu código de inicialización para el SDK de Logto cambiando el nombre de dominio del endpoint.

const client = new LogtoClient({
  ...,// otras opciones
  endpoint: 'https://auth.example.com',
});

Modificando los endpoints de autenticación para otras aplicaciones​

Si tienes aplicaciones que no están utilizando el SDK de Logto, es necesario actualizar sus endpoints de autenticación.

Puedes localizar los endpoints de autenticación en la URL bien conocida:

https://auth.example.com/oidc/.well-known/openid-configuration

Actualizando el URI de callback del conector social​

El URI de callback del conector social se actualizará automáticamente si tus usuarios están utilizando el dominio personalizado. Necesitas ir a la consola de desarrolladores del proveedor social para actualizar el URI de callback.

Cuando tus usuarios estén utilizando el dominio personalizado, el URI de callback del conector social utilizará el nuevo dominio. Por lo tanto, necesitas navegar a la consola de desarrolladores del proveedor social para actualizar manualmente el URI de callback.