x509CertificateAuthenticationMethodConfiguration を更新する

  • [アーティクル]

名前空間: microsoft.graph

X.509 証明書認証方法のプロパティを更新します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Policy.ReadWrite.AuthenticationMethod 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Policy.ReadWrite.AuthenticationMethod 注意事項なし。

委任されたシナリオの場合、管理者には少なくとも認証ポリシー管理者Microsoft Entraロールが必要です。

HTTP 要求

PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/x509Certificate

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Content-Type application/json. 必須です。

要求本文

次のプロパティを更新できます。

プロパティ 型 説明
state authenticationMethodState 使用可能な値は、 enabled、 disabledです。 authenticationMethodConfiguration から継承されます。
certificateUserBindings x509CertificateUserBinding コレクション 証明書をユーザーにバインドするために、Microsoft Entra ユーザー オブジェクトの属性にマップする X.509 証明書のフィールドを定義します。 オブジェクトの 優先順位 によって、バインドが実行される順序が決まります。一致する最初のバインドが使用され、残りのバインドは無視されます。
authenticationModeConfiguration x509CertificateAuthenticationModeConfiguration 強力な認証構成を定義します。 この構成には、既定の認証モードと、強力な認証バインドに関するさまざまな規則が含まれます。

メモ：の値#microsoft.graph.x509CertificateAuthenticationMethodConfigurationを持つプロパティは@odata.type、本文に含まれている必要があります。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。 応答本文では何も返されません。

例

要求

次の設定を使用した更新要求の例を次に示します。

  • テナントで x509 証明書認証方法を有効にします。
  • 証明書 PrincipalName と onPremisesUserPrincipalName プロパティのMicrosoft Entra IDの間に 1 つのユーザー バインドのみを構成します。
  • 多要素認証を要件として定義します。
  • 規則の種類に対して強力な認証方法のバインド規則を構成します。
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
        }
    ]
}

応答

HTTP/1.1 204 No Content