Freigeben über


authenticationStrengthPolicy-Ressourcentyp

Namespace: microsoft.graph

Eine Sammlung von Einstellungen, die bestimmte Kombinationen von Authentifizierungsmethoden und Metadaten definieren. Die Richtlinie für die Authentifizierungsstärke definiert, wenn sie auf ein bestimmtes Szenario mithilfe des bedingten Microsoft Entra-Zugriffs 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.

Methoden

Methode Rückgabetyp Beschreibung
List authenticationStrengthPolicy-Sammlung Rufen Sie eine Liste der authenticationStrengthPolicy-Objekte und deren Eigenschaften ab.
Create authenticationStrengthPolicy Erstellen Sie ein neues benutzerdefiniertes AuthenticationStrengthPolicy-Objekt .
Get authenticationStrengthPolicy Liest die 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.
Delete 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.

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 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.
modifiedDateTime DateTimeOffset Der Zeitpunkt, zu dem diese Richtlinie zuletzt geändert wurde.
policyType authenticationStrengthPolicyType Gibt an, ob diese Richtlinie in die Microsoft Entra-ID 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

Die folgende JSON-Darstellung zeigt 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"
  ]
}