- Nivel de aplicación
- Nivel del Tenant
El
login_url debe apuntar a una ruta de la aplicación que termine redirigiendo al endpoint /authorize de Auth0, por ejemplo, https://mycompany.org/login. Tenga en cuenta que debe usar https y no puede apuntar a localhost. login_url puede incluir parámetros de consulta y un fragmento de URI.
De acuerdo con la especificación de inicio de sesión iniciado por terceros de OIDC, el parámetro iss, que contiene el identificador del emisor, se añadirá a login_url como parámetro de consulta antes de redirigir.
URI dinámicas de inicio de sesión con marcadores de posición de metadatos
initiate_login_uri a nivel de aplicación para incluir marcadores de posición de metadatos. Estos marcadores de posición se resuelven dinámicamente en tiempo de ejecución.
Marcadores de posición compatibles
| Marcador de posición | Origen | Ejemplo |
|---|---|---|
{custom_domain.metadata.KEY} | Metadatos del dominio personalizado usado en la solicitud | https://{custom_domain.metadata.public_app_host}/login |
{organization.metadata.KEY} | Metadatos de la Organización asociada a la solicitud | https://{organization.metadata.public_login_host}/login |
public_ (por ejemplo, public_app_host). Ambos tipos de marcadores de posición pueden combinarse en el mismo URI si la solicitud incluye tanto un dominio personalizado como un contexto de Organización.
Para consultar la lista completa de reglas de validación y restricciones, lee Marcadores de posición de URL de dominio personalizado.
Los marcadores de posición de metadatos solo se admiten en
initiate_login_uri a nivel de la aplicación, no en default_redirection_uri a nivel del inquilino.Comportamiento de reserva
default_redirection_uri a nivel de inquilino si no puede resolverse un marcador de posición. Por ejemplo, si la Organización es desconocida o la clave de metadatos no existe. Si default_redirection_uri tampoco está configurado, Auth0 muestra una página de error. Recomendamos configurar un default_redirection_uri a nivel de inquilino como alternativa de reserva confiable.
Escenarios de redirección de la ruta predeterminada de inicio de sesión
Los usuarios guardan la página de inicio de sesión en marcadores
https://{yourDomain}/authorize con un conjunto de parámetros obligatorios. Auth0 luego redirige a los usuarios finales a una página https://{yourDomain}/login, con una URL similar a esta:
https://{yourDomain}/login?state=g6Fo2SBjNTRyanlVa3ZqeHN4d1htTnh&...
El parámetro state apunta a un registro de una base de datos interna donde hacemos seguimiento del estado de la transacción de autorización. Cuando la transacción se completa, o después de que transcurre un tiempo determinado, el registro se elimina de la base de datos interna.
Si usa Organizaciones y el usuario final guarda en marcadores la pantalla de inicio de sesión de la organización, Auth0 también incluye el parámetro organization cuando redirige al usuario a la ruta de inicio de sesión predeterminada.
A veces, los usuarios guardan la página de inicio de sesión en marcadores y, cuando acceden a la URL /login guardada, el registro de la transacción ya no existe y Auth0 no puede continuar con el flujo de inicio de sesión. En ese caso, Auth0 redirigirá a la URL predeterminada del cliente si está configurada, o a la URL del nivel de inquilino en caso contrario. Si no se establece ninguna URL de inicio de sesión predeterminada, Auth0 mostrará una página de error.
Flujo completo de restablecimiento de contraseña
/post-password-change permite redirigir a los usuarios de regreso a una aplicación específica. Cuando se especifica client_id y está configurado el URI de inicio de sesión de la aplicación, los usuarios verán un botón que los llevará de regreso a la aplicación después de completar el restablecimiento de la contraseña.
Flujo completo de verificación del correo electrónico
Invitar a miembros de una organización
https://myapp.com/login, el enlace enviado en la invitación por correo electrónico que recibe el usuario final será: https://myapp.com/login?invitation={invitation_ticket_id}&organization={organization_id}&organization_name={organization_name}.
Por lo tanto, la ruta de su aplicación debe aceptar los parámetros invitation y organization a través de la cadena de consulta. Para iniciar la transacción de aceptación de la invitación, debe reenviar ambos parámetros junto con el usuario final al endpoint /authorize de Auth0.
Si un usuario accede a https://{yourDomain}/authorize con las cookies desactivadas en su navegador, Auth0 redirige al usuario al URI de inicio de sesión de la aplicación. Si el URI de inicio de sesión de la aplicación no está configurado, la redirección se envía al URI de inicio de sesión del inquilino.
Devolver al usuario a la página de inicio de sesión puede provocar un bucle de redirección. Para evitar este problema, utilice una página de destino para comprobar si las cookies están disponibles; si están desactivadas, advierta al usuario que debe activarlas si desea continuar.