> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# cierre de sesión de OIDC

> Cierre la sesión de un usuario mediante el endpoint de cierre de sesión compatible con OIDC y, opcionalmente, rediríjalo a un URI posterior al cierre de sesión.

<div id="endpoint">
  ## Endpoint
</div>

`GET /oidc/logout`

Use este endpoint para cerrar la sesión de un usuario. Si desea redirigir al usuario a una URL específica después del cierre de sesión, configure esa URL en el parámetro `post_logout_redirect_uri`. La URL debe incluirse en la lista correspondiente de `Allowed Logout URLs`:

* Si se incluye el parámetro `id_token_hint`:
  * Cuando se incluye el parámetro `client_id`, el servidor usa la URL del claim `aud` en `id_token_hint` para seleccionar cuál de las `Allowed Logout URLs` de la aplicación especificada por `client_id` debe usar.
  * Cuando NO se incluye el parámetro `client_id`, el servidor usa la URL del claim `aud` en `id_token_hint` para seleccionar cuál de las `Allowed Logout URLs` a nivel del inquilino debe usar.
* Si no se incluye el parámetro `id_token_hint`:
  * Si se incluye el parámetro `client_id`, la URL de `post_logout_redirect_uri` debe figurar en el conjunto de `Allowed Logout URLs` a nivel de la aplicación.
  * Si NO se incluye el parámetro `client_id`, la URL de `post_logout_redirect_uri` debe figurar en el conjunto de `Allowed Logout URLs` a nivel del inquilino.
  * Si se incluye el parámetro `client_id` y NO se establece la URL de `post_logout_redirect_uri`, el servidor redirige al usuario a la primera de las `Allowed Logout URLs` configuradas en Auth0 Dashboard.

Para obtener más información, consulte [Cerrar la sesión de usuarios en Auth0 con el endpoint de OIDC](https://auth0.com/docs/authenticate/login/logout/log-users-out-of-auth0).

<div id="remarks">
  ### Observaciones
</div>

* Cerrar la sesión del usuario en su proveedor de identidad social no es una práctica habitual, así que piense en la experiencia del usuario antes de usar el parámetro de cadena de consulta `federated` con proveedores de identidad sociales.
* Si proporciona tanto `id_token_hint` como `logout_hint`, el valor de `logout_hint` debe coincidir con el claim `sid` de `id_token_hint`.
* Si proporciona tanto `id_token_hint` como `client_id`, el valor de `client_id` debe coincidir con el claim `aud` de `id_token_hint`.
* Si no se proporciona `id_token_hint`, se solicitará el consentimiento del usuario, a menos que se proporcione un `logout_hint` que coincida con el ID de sesión del usuario.
* El método HTTP `POST` también es compatible con esta solicitud. Al usar `POST`, los parámetros de la solicitud deben incluirse en el cuerpo de la solicitud como parámetros de formulario en lugar de en la cadena de consulta. El parámetro `federated` requiere un valor de `true` o `false`.
* Esto se ajusta a la [especificación de cierre de sesión iniciado por RP de OIDC](https://openid.net/specs/openid-connect-rpinitiated-1_0.html).

<div id="learn-more">
  ### Más información
</div>

* [cierre de sesión](https://auth0.com/docs/authenticate/login/logout)
* [Use el endpoint de OIDC para cerrar la sesión de los usuarios en Auth0](https://auth0.com/docs/authenticate/login/logout/log-users-out-of-auth0)
* [Especificación de cierre de sesión iniciado por el RP de OIDC](https://openid.net/specs/openid-connect-rpinitiated-1_0.html)

<div id="query-parameters">
  ## Parámetros de consulta
</div>

<ParamField query="id_token_hint" type="string">
  \[Recomendado] ID Token emitido previamente para el usuario. Se utiliza para indicar qué usuario debe cerrar la sesión.
</ParamField>

<ParamField query="logout_hint" type="string">
  Valor `sid` (ID de sesión) opcional para indicar qué usuario debe cerrar la sesión. Debe proporcionarse cuando `id_token_hint` no esté disponible.
</ParamField>

<ParamField query="post_logout_redirect_uri" type="string">
  URL a la que se redirige al usuario después de cerrar la sesión.
</ParamField>

<ParamField query="client_id" type="string">
  El `client_id` de tu aplicación.
</ParamField>

<ParamField query="federated" type="string">
  Agrega este parámetro de cadena de consulta para cerrar la sesión del usuario en su proveedor de identidad: `https://YOUR_DOMAIN/oidc/logout?federated`.
</ParamField>

<ParamField query="state" type="string">
  Un valor opaco que la aplicación agrega a la solicitud inicial y que el servidor de autorización incluye al redirigir de regreso a `post_logout_redirect_uri`.
</ParamField>

<ParamField query="ui_locales" type="string">
  Lista de configuraciones regionales separadas por espacios que se usa para restringir la lista de idiomas de la solicitud. La primera configuración regional de la lista debe coincidir con la configuración regional habilitada en tu inquilino.
</ParamField>

<div id="response-messages">
  ## Mensajes de respuesta
</div>

| Estado | Descripción                                                              |
| ------ | ------------------------------------------------------------------------ |
| 200    | Sesión cerrada correctamente                                             |
| 400    | Solicitud incorrecta, posiblemente porque faltan parámetros obligatorios |