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 Sammlung von Einstellungen, die bestimmte Kombinationen von Authentifizierungsmethoden und Metadaten definieren. Die Richtlinie zur Authentifizierungsstärke definiert, wenn sie auf ein bestimmtes Szenario mit Microsoft Entra bedingten Zugriff angewendet wird, welche Authentifizierungsmethoden für die Authentifizierung in diesem Szenario verwendet werden müssen. Eine Authentifizierungsstärke kann integriert oder benutzerdefinierte (vom Mandanten definiert) sein und die Anforderungen zum Gewähren eines MFA-Anspruchs erfüllen oder nicht.

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
Auflisten von authenticationStrengthPolicies	authenticationStrengthPolicy-Sammlung	Rufen Sie eine Liste der authenticationStrengthPolicy-Objekte und deren Eigenschaften ab.
Erstellen von authenticationStrengthPolicy	authenticationStrengthPolicy	Erstellen Sie ein neues benutzerdefiniertes AuthenticationStrengthPolicy-Objekt .
Abrufen von authenticationStrengthPolicy	authenticationStrengthPolicy	Liest die Eigenschaften und Beziehungen eines authenticationStrengthPolicy-Objekts .
Aktualisieren von authenticationStrengthPolicy	authenticationStrengthPolicy	Aktualisieren Sie die Eigenschaften eines benutzerdefinierten authenticationStrengthPolicy-Objekts . Sie können ein integriertes AuthenticationStrengthPolicy-Objekt nicht aktualisieren.
Löschen von authenticationStrengthPolicy	Keine	Löschen sie ein benutzerdefiniertes authenticationStrengthPolicy-Objekt . Sie können ein integriertes AuthenticationStrengthPolicy-Objekt nicht löschen.
findByMethodMode (veraltet)	authenticationStrengthPolicy-Sammlung	Suchen Sie eine authenticationStrengthPolicy im zulässigen Modus.
Auflisten der Nutzung	authenticationStrengthUsage	Suchen Sie alle conditionalAccessPolicies , die auf eine Authentifizierungsstärke verweisen.
updateAllowedCombinations	updateAllowedCombinationsResult	Aktualisieren Sie die zulässige authenticationCombinationConfiguration für eine bestimmte authenticationStrengthPolicy.
List combinationConfigurations	authenticationCombinationConfiguration-Sammlung	Rufen Sie die authenticationCombinationConfiguration-Ressourcen aus der Navigationseigenschaft combinationConfigurations ab.
Erstellen von authenticationCombinationConfiguration	authenticationCombinationConfiguration	Erstellen Sie ein neues authenticationCombinationConfiguration-Objekt.

Eigenschaften

Eigenschaft	Typ	Beschreibung
allowedCombinations	authenticationMethodModes-Auflistung	Eine Sammlung von Authentifizierungsmethodenmodi, die verwendet werden müssen, um diese Authentifizierungsstärke zu satifizieren.
createdDateTime	DateTimeOffset	Der Zeitpunkt, an dem diese Richtlinie erstellt wurde.
description	String	Die lesbare Beschreibung dieser Richtlinie.
displayName	String	Der lesbare Anzeigename dieser Richtlinie. Unterstützt $filter (eq, ne, not und in).
id	String	Der vom System generierte Bezeichner für diesen Modus. Geerbt von entity.
modifiedDateTime	DateTimeOffset	Der Zeitpunkt, zu dem diese Richtlinie zuletzt geändert wurde.
policyType	authenticationStrengthPolicyType	Gibt an, ob diese Richtlinie in Microsoft Entra bedingten Zugriff integriert 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).
anforderungenSatisfied	authenticationStrengthRequirements	Ein Deskriptor, der angibt, ob diese Authentifizierungsstärke den MFA-Anspruch nach erfolgreicher Erfüllung gewährt. Die möglichen Werte sind: none, mfa, unknownFutureValue.

Beziehungen

Beziehung	Typ	Beschreibung
combinationConfigurations	authenticationCombinationConfiguration-Sammlung	Einstellungen, die verwendet werden können, um bei der Authentifizierung mit einer angegebenen Kombination von Authentifizierungsmethoden bestimmte Typen oder Instanzen einer Authentifizierungsmethode zu verwenden.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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