Gérer la déconnexion
Vous devez permettre à vos utilisateurs de se déconnecter de leur session Pro Santé Connect active à travers votre applicatif.
La déconnexion, une fois initiée, s'applique à l'ensemble de la session de l'utilisateur. Pro Santé Connect invalide la session de l'utilisateur mais n'envoie pas dynamiquement l'information aux fournisseurs de services.
Pour connaître la validité d'une session le fournisseur de service doit introspecter l'access_token ou bien faire une demande de rafraîchissement du jeton.
Pro Santé Connect ne prend pas en charge la déconnexion par canal frontal et la déconnexion par canal arrière.
Fonctionnement de la déconnexion à l’initiative du FS
La déconnexion à l’initiative du fournisseur de service (FS) fait l’objet de la spécification OpenIDConnect (OIDC) suivante : https://openid.net/specs/openid-connect-rpinitiated-1_0.html
Déconnecter l’utilisateur revient à rediriger ce dernier vers l’URL de déconnexion renvoyée par le endpoint de Log out indiqué au début de cette documentation.
Les endpoints de déconnexion
| Environnement | URL du endpoint |
| Bac à sable | https://auth.bas.psc.esante.gouv.fr/auth/realms/esante-wallet/protocol/openid-connect/logout |
| Production | https://auth.esw.esante.gouv.fr/auth/realms/esante-wallet/protocol/openid-connect/logout |
Détails des flux
- Origine : FS
- Cible : PSC
- Type d'appel : redirection navigateur
Méthodes d’appel supportées :
- GET : les paramètres seront passés dans l’URL (utilisation de l'ID token)
La requête GET
| Paramètre | Obligatoire | Valeur |
| id_token_hint | Oui | L’ID_token délivré à l’utilisateur est envoyé au endpoint de déconnexion. |
| post_logout_redirect_uri | Non | Il s’agit de l’URL de déconnexion renseignée à la création de votre service. Elle doit être strictement identique à celle renseignée auprès de Pro Santé Connect. |
Lorsque l'utilisateur cliquera sur votre bouton déconnexion il sera redirigé vers la page POST_LOGOUT_REDIRECT_URI si ce paramètre est renseigné, et sa session Pro Santé Connect sera terminée.
Réponse
Si la déconnexion s’est bien déroulée, le serveur renvoie une réponse HTTP 200.