AuthenticationStrengthPolicy Ressourcentyp

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.

Eine Auflistung von Einstellungen, die bestimmte Kombinationen von Authentifizierungsmethoden und Metadaten definieren. Wenn die Authentifizierungsstärkerichtlinie auf ein bestimmtes Szenario mit Microsoft Entra bedingtem Zugriff angewendet wird, definiert, welche Authentifizierungsmethoden für die Authentifizierung in diesem Szenario verwendet werden müssen. Eine Authentifizierungsstärke kann integriert oder benutzerdefiniert (vom Mandanten definiert) sein und kann die Anforderungen für die Gewährung eines MFA-Anspruchs erfüllen oder nicht.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
List AuthenticationStrengthPolicy-Auflistung Rufen Sie eine Liste der authenticationStrengthPolicy-Objekte und ihrer Eigenschaften ab.
Create AuthenticationStrengthPolicy Erstellen Sie ein neues benutzerdefiniertes authenticationStrengthPolicy-Objekt .
Get AuthenticationStrengthPolicy Lesen der Eigenschaften und Beziehungen eines authenticationStrengthPolicy-Objekts .
Update AuthenticationStrengthPolicy Aktualisieren Sie die Eigenschaften eines benutzerdefinierten authenticationStrengthPolicy-Objekts . Sie können ein integriertes authenticationStrengthPolicy-Objekt nicht aktualisieren.
Löschen Keine Löschen Sie ein benutzerdefiniertes authenticationStrengthPolicy-Objekt . Sie können ein integriertes authenticationStrengthPolicy-Objekt nicht löschen.
Auflisten der Nutzung authenticationStrengthUsage Suchen Sie alle conditionalAccessPolicies , die auf eine Authentifizierungsstärke verweisen.
Nach Methode suchen-Modus (veraltet) AuthenticationStrengthPolicy-Auflistung Suchen Sie eine authenticationStrengthPolicy nach zulässigem Modus.

Eigenschaften

Eigenschaft Typ Beschreibung
allowedCombinations AuthenticationMethodModes collection Eine Sammlung von Authentifizierungsmethodenmodi, die erforderlich sind, um diese Authentifizierungsstärke zu erfüllen.
createdDateTime DateTimeOffset Die Datum/Uhrzeit, als diese Richtlinie erstellt wurde.
description Zeichenfolge Die lesbare Beschreibung dieser Richtlinie.
displayName Zeichenfolge Der lesbare Anzeigename dieser Richtlinie.

Unterstützt $filter (eq, ne, not und in).
id Zeichenfolge Der vom System generierte Bezeichner für diesen Modus. Geerbt von entity.
modifiedDateTime DateTimeOffset Die Datum/Uhrzeit, als diese Richtlinie zuletzt geändert wurde.
policyType AuthenticationStrengthPolicyType Ein Deskriptor darüber, ob diese Richtlinie in Microsoft Entra bedingten Zugriff integriert ist oder von einem Administrator für den Mandanten erstellt wurde. Die möglichen Werte sind: builtIn, custom, unknownFutureValue.

Unterstützt $filter (eq, ne, not und in).
AnforderungenErfüllt authenticationStrengthRequirements Ein Deskriptor dazu, ob diese Authentifizierungsstärke den MFA-Anspruch bei erfolgreicher Erfüllung gewährt. Die möglichen Werte sind: none, mfa, unknownFutureValue.

Beziehungen

Beziehung Typ Beschreibung
combinationConfigurations AuthenticationCombinationConfiguration collection Einstellungen, die verwendet werden können, um die Verwendung bestimmter Typen oder Instanzen einer Authentifizierungsmethode bei der Authentifizierung mit einer angegebenen Kombination von Authentifizierungsmethoden vorzuschreiben.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.authenticationStrengthPolicy",
  "id": "String (identifier)",
  "createdDateTime": "String (timestamp)",
  "modifiedDateTime": "String (timestamp)",
  "displayName": "String",
  "description": "String",
  "policyType": "String",
  "requirementsSatisfied": "String",
  "allowedCombinations": [
    "String"
  ]
}
  • Last updated on