utilisateur : revokeSignInSessions

  • Article

Espace de noms: microsoft.graph

Invalide tous les jetons d’actualisation émis pour les applications d’un utilisateur (ainsi que les cookies de session dans le navigateur d’un utilisateur), en réinitialisant la propriété utilisateur signInSessionsValidFromDateTime à la date-heure actuelle. En règle générale, cette opération est effectuée (par l’utilisateur ou un administrateur) si l’utilisateur a un appareil perdu ou volé. Cette opération empêche l’accès aux données de l’organization par le biais d’applications sur l’appareil en obligeant l’utilisateur à se reconnecter à toutes les applications qu’il a précédemment autorisées, indépendamment de l’appareil.

Si l’application tente d’échanger un jeton d’accès délégué pour cet utilisateur à l’aide d’un jeton d’actualisation invalidé, l’application obtient une erreur. Si cela se produit, l’application doit acquérir un nouveau jeton d’actualisation en effectuant une requête au point de terminaison d’autorisation, ce qui force l’utilisateur à se connecter.

Remarque

Après avoir appelé revokeSignInSessions, il peut y avoir un petit délai de quelques minutes avant que les jetons soient révoqués.

Cette API ne révoque pas les sessions de connexion pour les utilisateurs externes, car les utilisateurs externes se connectent via leur locataire d’origine.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) User.RevokeSessions.All Directory.ReadWrite.All, User.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application User.RevokeSessions.All Non disponible.

Requête HTTP

POST /me/revokeSignInSessions
POST /users/{id | userPrincipalName}/revokeSignInSessions

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json

Corps de la demande

Cette opération n’a pas de contenu de requête.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse de la série 2xx.

Exemple

L’exemple ci-après montre comment appeler cette API.

Demande

POST https://graph.microsoft.com/v1.0/me/revokeSignInSessions

Réponse

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Edm.Boolean",
    "value": true
}