---
title: Subject DN To User Attribute Certificate Mapper
description: The Subject DN To User Attribute Certificate Mapper maps client certificates to user entries by looking for the certificate subject DN in a specified attribute of user entries.
component: pingds
version: 8.1
page_id: pingds:configref:objects-subject-dn-to-user-attribute-certificate-mapper
canonical_url: https://docs.pingidentity.com/pingds/8.1/configref/objects-subject-dn-to-user-attribute-certificate-mapper.html
section_ids:
  parent: Parent
  subject_dn_to_user_attribute_certificate_mapper_properties: Subject DN To User Attribute Certificate Mapper properties
  basic_properties: Basic properties
  enabled: enabled
  issuer-attribute: issuer-attribute
  subject-attribute: subject-attribute
  user-base-dn: user-base-dn
  advanced_properties: Advanced properties
  java-class: java-class
---

# Subject DN To User Attribute Certificate Mapper

The Subject DN To User Attribute Certificate Mapper maps client certificates to user entries by looking for the certificate subject DN in a specified attribute of user entries.

## Parent

The Subject DN To User Attribute Certificate Mapper object inherits from [Certificate Mapper](objects-certificate-mapper.html).

## Subject DN To User Attribute Certificate Mapper properties

You can use configuration expressions to set property values at startup time. For details, see [Property value substitution](expressions.html).

| Basic Properties                                                                                                                | Advanced Properties       |
| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| [enabled](#enabled) [issuer-attribute](#issuer-attribute) [subject-attribute](#subject-attribute) [user-base-dn](#user-base-dn) | [java-class](#java-class) |

### Basic properties

Use the `--advanced` option to access advanced properties.

### enabled

|                         |                                                      |
| ----------------------- | ---------------------------------------------------- |
| *Synopsis*              | Indicates whether the Certificate Mapper is enabled. |
| *Default value*         | None                                                 |
| *Allowed values*        | truefalse                                            |
| *Multi-valued*          | No                                                   |
| *Required*              | Yes                                                  |
| *Admin action required* | None                                                 |
| *Advanced*              | No                                                   |
| *Read-only*             | No                                                   |

### issuer-attribute

|                         |                                                                                                                                                                                                                          |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| *Synopsis*              | Specifies the name or OID of the attribute whose value should exactly match the certificate issuer DN.                                                                                                                   |
| *Description*           | Certificate issuer verification should be enabled whenever multiple CAs are trusted in order to prevent impersonation. In particular, it is possible for different CAs to issue certificates having the same subject DN. |
| *Default value*         | The certificate issuer DN will not be verified.                                                                                                                                                                          |
| *Allowed values*        | The name of an attribute type defined in the LDAP schema.                                                                                                                                                                |
| *Multi-valued*          | No                                                                                                                                                                                                                       |
| *Required*              | No                                                                                                                                                                                                                       |
| *Admin action required* | None                                                                                                                                                                                                                     |
| *Advanced*              | No                                                                                                                                                                                                                       |
| *Read-only*             | No                                                                                                                                                                                                                       |

### subject-attribute

|                         |                                                                                                         |
| ----------------------- | ------------------------------------------------------------------------------------------------------- |
| *Synopsis*              | Specifies the name or OID of the attribute whose value should exactly match the certificate subject DN. |
| *Default value*         | None                                                                                                    |
| *Allowed values*        | The name of an attribute type defined in the LDAP schema.                                               |
| *Multi-valued*          | No                                                                                                      |
| *Required*              | Yes                                                                                                     |
| *Admin action required* | None                                                                                                    |
| *Advanced*              | No                                                                                                      |
| *Read-only*             | No                                                                                                      |

### user-base-dn

|                         |                                                                                                                    |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------ |
| *Synopsis*              | Specifies the base DNs that should be used when performing searches to map the client certificate to a user entry. |
| *Default value*         | The server will perform the search in all public naming contexts.                                                  |
| *Allowed values*        | A valid DN.                                                                                                        |
| *Multi-valued*          | Yes                                                                                                                |
| *Required*              | No                                                                                                                 |
| *Admin action required* | None                                                                                                               |
| *Advanced*              | No                                                                                                                 |
| *Read-only*             | No                                                                                                                 |

## Advanced properties

Use the `--advanced` option to access advanced properties.

### java-class

|                         |                                                                                                                                        |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| *Synopsis*              | Specifies the fully-qualified name of the Java class that provides the Subject DN To User Attribute Certificate Mapper implementation. |
| *Default value*         | org.opends.server.extensions.SubjectDNToUserAttributeCertificateMapper                                                                 |
| *Allowed values*        | A Java class that extends or implements:- org.opends.server.api.CertificateMapper                                                      |
| *Multi-valued*          | No                                                                                                                                     |
| *Required*              | Yes                                                                                                                                    |
| *Admin action required* | The object must be disabled and re-enabled for changes to take effect.                                                                 |
| *Advanced*              | Yes                                                                                                                                    |
| *Read-only*             | No                                                                                                                                     |