Contrôle des sessions

La console liste les sessions que vos utilisateurs détiennent sur un domaine de connexion personnalisé et en révoque n'importe laquelle. Une connexion qui détient des jetons prend fin lorsque son jeton d'actualisation est révoqué, lorsque vous désactivez l'app, ou lorsque les jetons expirent.

La liste des sessions

Chaque app de connexion a dans la console une liste de ses sessions actives, sur la page des domaines personnalisés de l'app. Une ligne affiche l'identifiant de l'utilisateur, la façon dont il s'est connecté et la dernière fois que la session a été vue, avec un bouton Revoke à côté. Lister nécessite la permission users:read et révoquer nécessite users:write. La liste est tenue par app, et la page propre d'un utilisateur ne porte aucune liste de ses sessions.

Quelles connexions apparaissent

Une session de ce type n'existe que pour une connexion effectuée sur un domaine vérifié, à savoir un domaine de connexion personnalisé. Une connexion sur le domaine par défaut de Fóir, ou via l'API de jetons, émet des jetons et ne crée aucune session : elle n'apparaît donc jamais dans la liste.

Ce que fait la révocation

Révoquer une session déconnecte cet utilisateur, et son app ne peut plus en générer de jeton d'accès. La révocation déclenche un événement SESSION_REVOKED dans la même transaction, portant les identifiants de la session et de l'utilisateur, afin que vos propres systèmes puissent abandonner ce qu'ils ont mis en cache. Le même événement se déclenche quand un utilisateur se déconnecte et quand une app est désactivée.

Mettre fin aux autres connexions

La déconnexion d'un utilisateur met fin à sa session sur le domaine de connexion. Pour une connexion par jeton, envoyer le jeton d'actualisation à l'endpoint de révocation met fin à cette famille de jetons. Désactiver une app de connexion met fin d'un coup à toutes les sessions et à tous les jetons de ses utilisateurs, et l'API cesse d'honorer ses jetons d'accès sans attendre qu'ils expirent. Une réinitialisation de mot de passe met fin aux sessions et aux jetons d'actualisation de cet utilisateur.

Durées de vie

Un jeton d'accès dure 15 minutes, et un jeton d'actualisation dure 30 jours et change à chaque utilisation. Une session prend fin après 30 jours sans utilisation ou 90 jours après la première connexion, et les deux fenêtres peuvent être réglées par projet.

Lire le détail

Le guide de connexion couvre les fenêtres de session, la déconnexion et la durée de vie des jetons, et la liste des sessions de la console n'a pas de page de documentation propre.