Personalizar páginas de error

Aprende a crear una página de error personalizada para errores de autorización.

Cuando se produce un error de autorización y la URL de callback es válida, el Servidor de autorización devuelve los parámetros error y state correspondientes a su URL de callback. Si la URL de callback no es válida, la aplicación mostrará la página de error predeterminada de Auth0.

La aplicación también puede mostrar la página de error predeterminada de Auth0 por motivos distintos de una URL de callback no válida, como los siguientes:

• Faltan parámetros obligatorios al llamar al endpoint Login de la Authentication API de Auth0.
• El usuario abre un enlace de restablecimiento de contraseña caducado (cuando se usa la experiencia de Classic Login).
• El usuario abre una página de Login guardada en marcadores y no se especifica una ruta de Login predeterminada.

​

Parámetros

Si decide configurar una página de error personalizada, el Servidor de autorización devolverá parámetros añadidos a la URL como cadena de consulta.

Parámetro	Descripción
client_id	Identificador de la aplicación de Auth0.
connection	Conexión usada en el momento del error.
lang	Idioma configurado para usar en el momento del error.
error	Código del error.
error_description	Descripción del error.
tracking	Identificador que usa Auth0 para encontrar errores en los registros internos.

Los parámetros que se muestran varían según el tipo de error y son específicos de la solicitud. Por ejemplo, si la solicitud que produjo un error no contenía un client_id, el Servidor de autorización no devolverá el parámetro client_id.

​

Mostrar una página de error personalizada

Si desea mostrar una página de error personalizada, tiene dos opciones:

1. Redirigir a los usuarios a una página de error personalizada mediante Auth0 Dashboard o Auth0 Management API.
2. Configurar Auth0 para que muestre una página de error personalizada en su nombre mediante Management API.

​

Redirigir a los usuarios a una página de error personalizada desde el Dashboard

Use el Dashboard para configurar Auth0 y redirigir a los usuarios a una página de error personalizada:

1. Vaya a Auth0 Dashboard > Tenant Settings.
2. Busque la sección Error Pages.
3. Seleccione la opción Redirect users to your own error page.
4. Introduzca la URL de la página de error que desea que vean los usuarios y seleccione Save.

​

Redirija a los usuarios a una página de error personalizada con la Management API

Use el endpoint Actualizar la configuración del tenant de la Management API. Reemplace el valor del marcador de posición {mgmtApiAccessToken} por su Token de acceso de la Management API y actualice el valor del campo url en el cuerpo JSON para que apunte a la página de error.

Valor	Descripción
MGMT_API_ACCESS_TOKEN	Token de acceso para la Management API con el scope update:tenant_settings.
show_log_link	Indica si se mostrará un enlace al error en los registros de su inquilino. Los valores válidos son true y false.
url	Ubicación de la página de error personalizada a la que quiere redirigir.

​

Mostrar una página de error personalizada

Cuando los errores se muestran dentro del widget de Classic Login (por ejemplo, un enlace de restablecimiento de contraseña vencido), no se mostrará una página de error personalizada alojada en Auth0, aunque esté configurada.

Use el endpoint Actualizar la configuración del tenant de la Management API. Reemplace el valor del marcador de posición {mgmtApiAccessToken} por su Token de acceso de la Management API y actualice el valor del campo html en el cuerpo JSON por una cadena que contenga el HTML de su página.

Puede usar la sintaxis Liquid para incluir las siguientes variables:

• {client_id}
• {connection}
• {lang}
• {error}
• {error_description}
• {tracking}

Valor	Descripción
MGMT_API_ACCESS_TOKEN	Token de acceso para la Management API con el scope update:tenant_settings.
show_log_link	Indica si se debe mostrar un enlace al error en los registros de tu inquilino. Los valores válidos son true y false.
html	HTML de la página de error personalizada que quieres mostrar.

Para evitar vulnerabilidades de XSS, sanitiza tu plantilla personalizada con los filtros escape y strip_html de Liquid.

​

Más información

• Auth0 Universal Login