Share via


x509CertificateAuthenticationMethodConfiguration を更新する

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

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. 必須です。

要求本文

要求本文で、更新すべきプロパティの値のみを指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。

次の表に、更新できるプロパティを示します。

プロパティ 説明
authenticationModeConfiguration x509CertificateAuthenticationModeConfiguration 強力な認証構成を定義します。 この構成には、既定の認証モードと、強力な認証バインドに関するさまざまな規則が含まれます。
certificateUserBindings x509CertificateUserBinding コレクション 証明書をユーザーにバインドするために、Microsoft Entra ユーザー オブジェクトの属性にマップする X.509 証明書のフィールドを定義します。 オブジェクトの 優先順位 によって、バインドが実行される順序が決まります。一致する最初のバインドが使用され、残りのバインドは無視されます。
issuerHintsConfiguration x509CertificateIssuerHintsConfiguration 発行者 (CA) ヒントをクライアント側に送り返して、証明書ピッカーに表示される証明書をフィルター処理するかどうかを決定します。
state authenticationMethodState 使用可能な値は、 enableddisabledです。

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

応答

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

要求

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

  • テナントで x509 証明書認証方法を有効にします。
  • 証明書 PrincipalNameonPremisesUserPrincipalName プロパティのMicrosoft Entra IDの間に 1 つのユーザー バインドのみを構成します。
  • 多要素認証を要件として定義します。
  • 規則の種類に対して強力な認証方法のバインド規則を構成します。
PATCH https://graph.microsoft.com/beta/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"
            }
        ]
    },
    "issuerHintsConfiguration": {
        "state": "disabled"
    },
    "includeTargets": [
        {
            "targetType": "group",
            "id": "all_users",
            "isRegistrationRequired": false
        }
    ]
}

応答

HTTP/1.1 204 No Content