Iniciadores del cierre de sesión por canal secundario de OIDC
Aprenda cómo funcionan los iniciadores del cierre de sesión por canal secundario de OIDC y cómo configurarlos para sus aplicaciones.
Los iniciadores de cierre de sesión por canal secundario de OIDC le permiten cerrar de forma remota la sesión de los usuarios en sus aplicaciones en función de eventos de finalización de sesión. Los iniciadores de cierre de sesión por canal secundario de OIDC funcionan con distintos protocolos; por ejemplo, una solicitud de cierre de sesión de iniciada por el IdP (IdP-initiated) ; y no se ven afectados por las restricciones de cookies de terceros.Esta función es una extensión de la especificación estándar de cierre de sesión por canal secundario de OIDC. Puede configurarla para iniciar una solicitud de cierre de sesión por canal secundario de OIDC para eventos específicos de finalización de sesión, como un cambio de contraseña o el vencimiento de la sesión, o para todos los eventos de finalización de sesión.Los administradores pueden habilitar esta función para aplicaciones específicas con la de Auth0.
Cómo funcionan los iniciadores de cierre de sesión por canal secundario de OIDC
Los iniciadores vinculan una respuesta de cierre de sesión por canal secundario de OIDC a un evento de finalización de sesión. Capturan ese evento y lo usan para activar un token de cierre de sesión de OIDC en todas las aplicaciones asociadas a la sesión indicada.
Los iniciadores no controlan la administración de sesiones en su inquilino, incluidos los eventos de finalización de sesión.
El siguiente diagrama ilustra cómo funciona un iniciador de cierre de sesión por canal secundario de OIDC ante un evento de cambio de contraseña:
Puede configurar los iniciadores de cierre de sesión por canal secundario de OIDC para una aplicación mediante la Management API con el endpoint Update a Client.
Llame al endpoint Update a Client con los datos de configuración adecuados en la carga útil. Por ejemplo, para cerrar la sesión de una aplicación después de un evento de cambio de contraseña, proporcione lo siguiente:
La propiedad mode determina el método de configuración para habilitar los iniciadores.De forma predeterminada, se establece en custom, lo que le permite especificar qué iniciadores quiere habilitar. Si quiere que su aplicación cierre sesión cada vez que finalice la sesión del IdP, establézcala en all.La propiedad mode admite los siguientes valores:
Valor
Descripción
custom
Habilita solo los iniciadores incluidos en el arreglo selected_initiators.
all
Habilita automáticamente todos los iniciadores actuales y futuros.
Propiedad selected_initiators
La propiedad selected_initiators contiene la lista de iniciadores que se habilitarán para la aplicación indicada.La propiedad selected_initiators admite los siguientes valores:
Valor
Descripción
rp-logout
La solicitud fue iniciada por una parte confiable (RP).
idp-logout
La solicitud fue iniciada por un proveedor de identidad externo (IdP).
password-changed
La solicitud fue iniciada por un cambio de contraseña.
session-expired
La solicitud fue iniciada por el vencimiento de la sesión.
session-revoked
La solicitud fue iniciada por la eliminación de la sesión.
account-deleted
La solicitud fue iniciada por la eliminación de una cuenta.
email-identifier-changed
La solicitud fue iniciada por un cambio en el identificador de correo electrónico.
Connect cierre de sesión por canal secundario se puede configurar junto con el resto de la configuración de la aplicación. Esta función se activa automáticamente en cuanto se proporciona un URI de cierre de sesión por canal secundario.
De forma predeterminada, solo se suscribirá a los iniciadores obligatorios (rp-logout e idp-logout). Cualquier iniciador adicional, incluidos los que se agreguen en el futuro, primero debe seleccionarse para poder iniciar el cierre de sesión de su aplicación.Seleccione esta opción si desea que su aplicación cierre sesión solo para los iniciadores que seleccione.
Todos los iniciadores compatibles, incluidos los que se añadan en el futuro, se suscribirán de forma predeterminada.Seleccione esta opción si quiere que su aplicación cierre sesión cada vez que finalice la sesión del IdP.