Benutzer: invalidateAllRefreshTokens

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Ungültig alle Aktualisierungstoken des Benutzers, die für Anwendungen und Sitzungscookies im Browser eines Benutzers ausgegeben wurden, indem die Benutzereigenschaft refreshTokensValidFromDateTime auf die aktuelle Datums-/Uhrzeiteinstellung zurückgesetzt wird. In der Regel wird dieser Vorgang (vom Benutzer oder einem Administrator) ausgeführt, wenn der Benutzer ein verlorenes oder gestohlenes Gerät hat. Dieser Vorgang würde den Zugriff auf Daten der organization verhindern, auf die über Anwendungen auf dem Gerät zugegriffen wird, ohne dass sich der Benutzer zuerst erneut anmelden muss. Tatsächlich würde dieser Vorgang den Benutzer zwingen, sich unabhängig vom Gerät bei allen Anwendungen, denen er zuvor zugestimmt hat, erneut anzumelden.

Wenn die Anwendung als Entwickler versucht, ein delegiertes Zugriffstoken für diesen Benutzer einzulösen, indem sie ein ungültiges Aktualisierungstoken verwendet, erhält die Anwendung einen Fehler. In diesem Fall muss die Anwendung ein neues Aktualisierungstoken abrufen, indem sie eine Anforderung an den OAuth 2.0-Endpunkt /authorize sendet, wodurch der Benutzer zur Anmeldung gezwungen wird.

Wichtig

Diese API wird nicht in den Status "Allgemeine Verfügbarkeit" heraufgestuft. Es wird empfohlen, stattdessen die user:revokeSignInSessions-API zu verwenden.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ✅

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) User.RevokeSessions.All Directory.ReadWrite.All, User.ReadWrite
Delegiert (persönliches Microsoft-Konto) User.ReadWrite Nicht verfügbar.
Application User.RevokeSessions.All Nicht verfügbar.

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt:

  • Verzeichnisautoren
  • Helpdesk-Administrator
  • Authentifizierungsadministrator
  • Privileged Authentication Administrator
  • Benutzeradministrator

HTTP-Anforderung

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

Hinweis

Das Aufrufen des /me-Endpunkts erfordert einen angemeldeten Benutzer und daher eine delegierte Berechtigung. Anwendungsberechtigungen werden bei Verwendung des /me Endpunkts nicht unterstützt.

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Dieser Vorgang hat keinen Anforderungsinhalt.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen Antwortcode der Serie 2xx zurück.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/me/invalidateAllRefreshTokens

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content
  • Last updated on