Freigeben über


Aktualisieren von x509CertificateAuthenticationMethodConfiguration

Namespace: microsoft.graph

Aktualisieren Sie die Eigenschaften der X.509-Zertifikatauthentifizierungsmethode.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

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

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Der Authentifizierungsrichtlinienadministrator ist die Rolle mit den geringsten Berechtigungen, die für diesen Vorgang unterstützt wird.

HTTP-Anforderung

PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/x509Certificate

Anforderungsheader

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

Anforderungstext

Die folgenden Eigenschaften können aktualisiert werden.

Eigenschaft Typ Beschreibung
state authenticationMethodState Die möglichen Werte sind: enabled, disabled. Geerbt von authenticationMethodConfiguration.
certificateUserBindings x509CertificateUserBinding-Auflistung Definiert Felder im X.509-Zertifikat, die Attributen des Microsoft Entra-Benutzerobjekts zugeordnet sind, um das Zertifikat an den Benutzer zu binden. Die Priorität des Objekts bestimmt die Reihenfolge, in der die Bindung ausgeführt wird. Die erste Bindung, die übereinstimmt, wird verwendet, und der Rest wird ignoriert.
authenticationModeConfiguration x509CertificateAuthenticationModeConfiguration Definiert sichere Authentifizierungskonfigurationen. Diese Konfiguration umfasst den Standardauthentifizierungsmodus und die verschiedenen Regeln für starke Authentifizierungsbindungen.

Anmerkung: Die @odata.type -Eigenschaft mit dem Wert muss #microsoft.graph.x509CertificateAuthenticationMethodConfiguration in den Text eingeschlossen werden.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Es gibt nichts im Antworttext zurück.

Beispiele

Anforderung

Es folgt ein Beispiel für eine Updateanforderung mit den folgenden Einstellungen:

  • Aktiviert die x509-Zertifikatauthentifizierungsmethode im Mandanten.
  • Konfiguriert nur eine Benutzerbindung zwischen den Eigenschaften PrincipalName und Microsoft Entra ID onPremisesUserPrincipalName .
  • Definiert die mehrstufige Authentifizierung als Anforderung.
  • Konfiguriert die Bindungsregeln für die sichere Authentifizierungsmethode für den Regeltyp.
PATCH https://graph.microsoft.com/v1.0/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/x509Certificate
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.x509CertificateAuthenticationMethodConfiguration",
    "id": "X509Certificate",
    "state": "enabled",
    "certificateUserBindings": [
        {
            "x509CertificateField": "PrincipalName",
            "userProperty": "onPremisesUserPrincipalName",
            "priority": 1
        }
    ],
    "authenticationModeConfiguration": {
        "x509CertificateAuthenticationDefaultMode": "x509CertificateMultiFactor",
        "rules": [
            {
                "x509CertificateRuleType": "issuerSubject",
                "identifier": "CN=ContosoCA,DC=Contoso,DC=org ",
                "x509CertificateAuthenticationMode": "x509CertificateMultiFactor"
            },
            {
                "x509CertificateRuleType": "policyOID",
                "identifier": "1.2.3.4",
                "x509CertificateAuthenticationMode": "x509CertificateMultiFactor"
            }
        ]
    },
    "includeTargets": [
        {
            "targetType": "group",
            "id": "all_users",
            "isRegistrationRequired": false
        }
    ]
}

Antwort

HTTP/1.1 204 No Content