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 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.
Erbt von entity.
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. |
Nach Methodenmodus suchen (veraltet) | authenticationStrengthPolicy-Sammlung | Suchen Sie eine authenticationStrengthPolicy im zulässigen Modus. |
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. Geerbt von entity. |
modifiedDateTime | DateTimeOffset | Der Zeitpunkt, zu dem diese Richtlinie zuletzt geändert wurde. |
policyType | authenticationStrengthPolicyType | Gibt an, ob diese Richtlinie in den bedingten Zugriff von Microsoft Entra 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"
]
}