Compartir a través de


Actualizar x509CertificateAuthenticationMethodConfiguration

Espacio de nombres: microsoft.graph

Actualice las propiedades del método de autenticación de certificados X.509.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Policy.ReadWrite.AuthenticationMethod No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Policy.ReadWrite.AuthenticationMethod No disponible.

Importante

En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido. El administrador de directivas de autenticación es el rol con privilegios mínimos admitido para esta operación.

Solicitud HTTP

PATCH /policies/authenticationMethodsPolicy/authenticationMethodConfigurations/x509Certificate

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

Se pueden actualizar las siguientes propiedades.

Propiedad Tipo Descripción
state authenticationMethodState Los valores posibles son: enabled, disabled. Se hereda de authenticationMethodConfiguration.
certificateUserBindings Colección x509CertificateUserBinding Define los campos del certificado X.509 que se asignan a atributos del objeto de usuario Microsoft Entra para enlazar el certificado al usuario. La prioridad del objeto determina el orden en que se lleva a cabo el enlace. Se usará el primer enlace que coincida y el resto se omitirá.
authenticationModeConfiguration x509CertificateAuthenticationModeConfiguration Define configuraciones de autenticación seguras. Esta configuración incluye el modo de autenticación predeterminado y las distintas reglas para enlaces de autenticación seguros.

Nota: La @odata.type propiedad con un valor de #microsoft.graph.x509CertificateAuthenticationMethodConfiguration debe incluirse en el cuerpo.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.

Ejemplos

Solicitud

A continuación se muestra un ejemplo de una solicitud de actualización con la siguiente configuración:

  • Habilita el método de autenticación de certificados x509 en el inquilino.
  • Configura solo un enlace de usuario entre el certificado PrincipalName y la Microsoft Entra ID propiedades onPremisesUserPrincipalName.
  • Define la autenticación multifactor como requisito.
  • Configura las reglas de enlace para el método de autenticación segura en el tipo de regla.
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
        }
    ]
}

Respuesta

HTTP/1.1 204 No Content