TemporaryAccessPassMethods auflisten
Namespace: microsoft.graph
Ruft eine Liste der temporaryAccessPassAuthenticationMethod-Objekte eines Benutzers und deren Eigenschaften ab. Diese API gibt nur ein einzelnes Objekt in der Auflistung zurück, da ein Benutzer nur über eine temporäre Zugriffspassmethode verfügen kann.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungen, die für sich selbst handeln
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | UserAuthenticationMethod.Read | UserAuthenticationMethod.ReadWrite, UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Nicht unterstützt | Nicht unterstützt |
Berechtigungen, die auf andere Benutzer reagieren
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | UserAuthenticationMethod.Read.All | UserAuthenticationMethod.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | UserAuthenticationMethod.Read.All | UserAuthenticationMethod.ReadWrite.All |
Wichtig
In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten, in denen der angemeldete Benutzer auf einen anderen Benutzer agiert, muss ihm 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.
- Globaler Leser
- Authentifizierungsadministrator
- Privilegierter Authentifizierungsadministrator
HTTP-Anforderung
Rufen Sie Details zu Ihrer eigenen TAP-Authentifizierungsmethode (Temporary Access Pass) ab.
GET /me/authentication/temporaryAccessPassMethods
Rufen Sie Details zur Authentifizierungsmethode für den temporären Zugriffspass (Temporary Access Pass, TAP) eines anderen Benutzers ab.
GET /users/{id | userPrincipalName}/authentication/temporaryAccessPassMethods
Optionale Abfrageparameter
Diese Methode unterstützt keine optionalen Abfrageparameter zum Anpassen der Antwort.
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Anforderung
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 200 OK
Antwortcode und eine Auflistung von temporaryAccessPassAuthenticationMethod-Objekten im Antworttext zurück. Dieser Aufruf gibt nur ein einzelnes Objekt zurück, da nur eine temporaryAccessPassAuthenticationMethod für Benutzer festgelegt werden kann.
Beispiele
Anforderung
GET https://graph.microsoft.com/v1.0/users/071cc716-8147-4397-a5ba-b2105951cc0b/authentication/temporaryAccessPassMethods
Antwort
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('071cc716-8147-4397-a5ba-b2105951cc0b')/authentication/temporaryAccessPassMethods",
"value": [
{
"id": "bdaede67-61e0-4349-9347-d2d6afd84009",
"temporaryAccessPass": null,
"createdDateTime": "2022-06-06T16:43:04.6438213Z",
"startDateTime": "2022-06-06T16:48:03.027Z",
"lifetimeInMinutes": 60,
"isUsableOnce": false,
"isUsable": false,
"methodUsabilityReason": "NotYetValid"
}
]
}