--- title: "Configuring the user attributes for certificate authentication using the CLI" slug: "configuring-the-user-attributes-for-certificate-authentication-using-the-cli-1" tags: ["File Protect (FX)", "Malware Analysis (AX)", "IAM", "Email Security - Cloud", "Network Security (NX)", "Email Security — Server", "Central Management System", "Helix Enterprise", "Endpoint Security (HX)", "Product Usage", "Install and Get Started", "Helix", "Intelligent Virtual Execution "] updated: 2026-09-01T19:03:12Z published: 2026-09-01T19:03:12Z canonical: "docs.trellix.com/configuring-the-user-attributes-for-certificate-authentication-using-the-cli-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring the user attributes for certificate authentication using the CLI Use the CLI commands in this section to configure the user attributes for certificate authentication. ### Note Use the` no aaa authentication certificate username `command to reset the certificate field for the username to use the default` x509-cert-san-upn `attribute. To configure the user attributes for certificate authentication: 1. Go to CLI configuration mode. ``` hostname > enable hostname # configure terminal ``` 2. Specify the name of the entry for the subject field in the certificate. ``` hostname (config) # aaa authentication certificate username x509-cert-subject ``` 3. Specify an entry for the Common Name (CN) from the DN attribute that is associated in a certificate. ``` hostname (config) # aaa authentication certificate username x509-cert-subject-cn ``` 4. Specify an email address in the Subject Alternative Name (SAN) field of the certificate. You are allowed to have multiple subfields for SAN. ``` hostname (config) # aaa authentication certificate username x509-cert-san-email ``` 5. Specify the user name of the email address without the domain name in the certificate. ``` hostname (config) # aaa authentication certificate username x509-cert-san-email-username ``` 6. Specify the User Principal Name (UPN) that is encoded in the "Other Name" field of the SAN field in the certificate. ``` hostname (config) # aaa authentication certificate username x509-cert-san-upn ``` 7. Specify the user name of the UPN attribute without the domain name in the certificate. ``` hostname (config) # aaa authentication certificate username x509-cert-san-upn-username ``` 8. Verify the configuration of the certificate-based authentication settings. ``` hostname (config) # show aaa authentication certificate ``` ``` Certificate based authentication settings: ``` ```  Web Policy                     : required ``` ``` Certificate field for username : x509-cert-subject-cn ``` ```  CA certificate bundle          : client-cert-auth ``` ```  OCSP enabled                   : no ``` ```  Default OCSP URL               : http://10.3.13.219:80 ``` ```  OCSP override responder        : no ``` ```  Basic constraints must present : no ``` ```  No CRL file is configured. ``` 9. Save your changes. ``` hostname (config) # write memory ``` :