x509CertificateAuthenticationMethodConfiguration resource type

Namespace: microsoft.graph

Represents the details of the Azure AD native Certificate-Based Authentication (CBA) in the tenant, including whether the authentication method is enabled or disabled and the users and groups who can register and use it.

Inherits from authenticationMethodConfiguration.


Method Return type Description
Get x509CertificateAuthenticationMethodConfiguration x509CertificateAuthenticationMethodConfiguration Read the properties and relationships of a x509CertificateAuthenticationMethodConfiguration object.
Update x509CertificateAuthenticationMethodConfiguration x509CertificateAuthenticationMethodConfiguration Update the properties of a x509CertificateAuthenticationMethodConfiguration object.
Delete x509CertificateAuthenticationMethodConfiguration None Delete the tenant-customized x509CertificateAuthenticationMethodConfiguration object and restore the default configuration.


Property Type Description
authenticationModeConfiguration x509CertificateAuthenticationModeConfiguration Defines strong authentication configurations. This configuration includes the default authentication mode and the different rules for strong authentication bindings.
certificateUserBindings x509CertificateUserBinding collection Defines fields in the X.509 certificate that map to attributes of the Azure AD user object in order to bind the certificate to the user. The priority of the object determines the order in which the binding is carried out. The first binding that matches will be used and the rest ignored.
excludeTargets excludeTarget collection Groups of users that are excluded from the policy.
id String The identifier for the authentication method policy. The value is always X509Certificate. Inherited from
state authenticationMethodState The possible values are: enabled, disabled. Inherited from authenticationMethodConfiguration.


Relationship Type Description
includeTargets authenticationMethodTarget collection A collection of groups that are enabled to use the authentication method.

JSON representation

The following is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.x509CertificateAuthenticationMethodConfiguration",
  "authenticationModeConfiguration": {
    "@odata.type": "microsoft.graph.x509CertificateAuthenticationModeConfiguration"
  "certificateUserBindings": [
      "@odata.type": "microsoft.graph.x509CertificateUserBinding"
    "excludeTargets": [
      "@odata.type": "microsoft.graph.excludeTarget"
  "id": "String (identifier)",
  "state": "String"