GET /oidc/logout
Utilisez ce point de terminaison pour déconnecter un utilisateur. Si vous souhaitez rediriger l’utilisateur vers une URL précise après la déconnexion, définissez cette URL dans le paramètre post_logout_redirect_uri. L’URL doit figurer dans la liste Allowed Logout URLs appropriée :
- Si le paramètre
id_token_hintest fourni :- Lorsque le paramètre
client_idest fourni, le serveur utilise l’URL de la revendicationauddansid_token_hintpour déterminer quelle URL de la listeAllowed Logout URLsutiliser pour l’application spécifiée parclient_id. - Lorsque le paramètre
client_idn’est PAS fourni, le serveur utilise l’URL de la revendicationauddansid_token_hintpour déterminer quelle URL de la listeAllowed Logout URLsconfigurée au niveau du locataire utiliser.
- Lorsque le paramètre
- Si le paramètre
id_token_hintn’est pas fourni :- Si le paramètre
client_idest fourni, l’URLpost_logout_redirect_uridoit figurer dans la listeAllowed Logout URLsconfigurée au niveau de l’application. - Si le paramètre
client_idn’est PAS fourni, l’URLpost_logout_redirect_uridoit figurer dans la listeAllowed Logout URLsconfigurée au niveau du locataire. - Si le paramètre
client_idest fourni et que l’URLpost_logout_redirect_urin’est PAS définie, le serveur redirige l’utilisateur vers la première URL de la listeAllowed Logout URLsdéfinie dans Auth0 Dashboard.
- Si le paramètre
Remarques
- Déconnecter l’utilisateur de son fournisseur d’identité social n’est pas une pratique courante; réfléchissez donc à l’expérience utilisateur avant d’utiliser le paramètre de requête
federatedavec des fournisseurs d’identité sociaux. - Si vous fournissez à la fois
id_token_hintetlogout_hint, la valeur delogout_hintdoit correspondre à la revendicationsiddeid_token_hint. - Si vous fournissez à la fois
id_token_hintetclient_id, la valeur declient_iddoit correspondre à la revendicationauddeid_token_hint. - Si
id_token_hintn’est pas fourni, l’utilisateur devra donner son consentement, à moins qu’unlogout_hintcorrespondant à l’ID de session de l’utilisateur ne soit fourni. - La méthode HTTP
POSTest également prise en charge pour cette requête. Lorsque vous utilisezPOST, les paramètres de la requête doivent être fournis dans le corps de la requête sous forme de paramètres de formulaire plutôt que dans la chaîne de requête. Le paramètre federated doit avoir la valeurtrueoufalse. - Cette requête est conforme à la spécification de déconnexion initiée par le RP OIDC.
En savoir plus
- Déconnexion
- Utiliser le point de terminaison OIDC pour déconnecter des utilisateurs d’Auth0
- spécification de déconnexion initiée par le RP OIDC
Paramètres
[Recommandé] ID Token précédemment émis pour l’utilisateur. Il sert à indiquer quel utilisateur déconnecter.
Valeur
sid (ID de session) facultative servant à indiquer quel utilisateur déconnecter. Elle doit être fournie lorsque id_token_hint n’est pas disponible.URL vers laquelle rediriger l’utilisateur après la déconnexion.
Le
client_id de votre application.Ajoutez ce paramètre de chaîne de requête pour déconnecter l’utilisateur de son fournisseur d’identité :
https://YOUR_DOMAIN/oidc/logout?federated.Valeur opaque que l’application ajoute à la requête initiale et que le serveur d’autorisation inclut lors de la redirection vers
post_logout_redirect_uri.Liste de paramètres régionaux séparés par des espaces utilisée pour limiter la liste des langues de la requête. Le premier paramètre régional de la liste doit correspondre au paramètre régional activé dans votre locataire.
Réponse
| Statut | Description |
|---|---|
| 200 | Déconnexion réussie |
| 400 | Requête incorrecte, possiblement en raison de l’absence de paramètres requis |