Weisen Sie dem Benutzer ein Hardware-OATH-Token zu

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.

Weisen Sie einem Benutzer ein Hardware-OATH-Token zu, das durch ein hardwareOathTokenAuthenticationMethodDevice-Objekt dargestellt wird. Self-Service-Vorgänge werden unterstützt.

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.

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.ReadWrite UserAuthenticationMethod.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Nicht unterstützt Nicht unterstützt

Berechtigungen, die auf einen anderen Benutzer wirken

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

Wichtig

Für den delegierten Zugriff über Geschäfts-, Schul- oder Unikonten, bei denen der angemeldete Benutzer auf einen anderen Benutzer reagiert, muss ihm eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die für diesen Vorgang erforderlichen Berechtigungen gewährt. Dieser Vorgang unterstützt die folgenden integrierten Rollen, die nur die geringstmöglichen Berechtigungen gewähren:

  • Authentifizierungsadministrator
  • Privileged Authentication Administrator

Wenn Benutzer ihre Authentifizierungsmethoden selbst verwalten, werden sie vom System aufgefordert, die mehrstufige Authentifizierung (MFA) abzuschließen, wenn die letzte Authentifizierung in der aktuellen Sitzung länger als 10 Minuten zurückliegt.

HTTP-Anforderung

Weisen Sie sich selbst eine Hardware-OATH-Authentifizierungsmethode zu.

PUT /me/authentication/hardwareOathMethods/{hardwareOathAuthenticationMethodId}/device/assignTo/$ref

Weisen Sie einem anderen Benutzer eine Hardware-OATH-Authentifizierungsmethode zu.

PUT /users/{usersId}/authentication/hardwareOathMethods/{hardwareOathAuthenticationMethodId}/device/assignTo/$ref

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Benutzerobjekts an.

Sie können die folgenden Eigenschaften festlegen, wenn Sie einen Benutzer erstellen.

Eigenschaft Typ Beschreibung
odata.id Zeichenfolge Ein Link zur Benutzerentität unter Verwendung von objectId als Schlüssel. Beispiel: https://graph.microsoft.com/beta/users/{usersId}

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 204 No Content und ein user-Objekt im Antworttext zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PUT https://graph.microsoft.com/beta/users/{usersId}/authentication/hardwareOathMethods/{hardwareOathAuthenticationMethodId}/device/assignTo/$ref
Content-Type: application/json

{
    "@odata.id": "https://graph.microsoft.com/beta/users/0cadbf92-####-####-####-############"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 204 No Content
  • Last updated on