You enable and configure certificate authentication from the Access Point administration console.

Prerequisites

  • Obtain the root certificate and intermediate certificates from the CA that signed the certificates presented by your users. See Obtain the Certificate Authority Certificates

  • Verify that the Access Point SAML metadata is added on the service provider and the service provider SAML metadata is copied the Access Point appliance.

  • (Optional) List of Object Identifier (OID) of valid certificate policies for certificate authentication.

  • For revocation checking, the file location of the CRL and the URL of the OCSP server.

  • (Optional) OCSP Response Signing certificate file location.

  • Consent form content, if a consent form displays before authentication.

Procedure

  1. In the admin UI Configure Manually section, click Select.
  2. In the General Settings Authentication Settings section, click Show.
  3. Click the gearbox in the X.509 Certificate line.
  4. Configure the X.509 Certificate form.

    An asterisk indicates a required text box. All other text boxes are optional.

    Option

    Description

    Enable X.509 Certificate

    Change NO to YES to enable certificate authentication.

    *Name

    Name this authentication method.

    *Root and Intermediate CA Certificates

    Click Select to select the certificate files to upload. You can select multiple root CA and intermediate CA certificates that are encoded as DER or PEM.

    CRL Cache Size

    Enter the certificate revocation list cache size. The default is 100

    Enable Cert Revocation

    Change NO to YES to enable certificate revocation checking. Revocation checking prevents users who have revoked user certificates from authenticating.

    Use CRL from Certificates

    Select the check box to use the certificate revocation list (CRL) published by the CA that issued the certificates to validate the status of a certificate, revoked or not revoked.

    CRL Location

    Enter the server file path or the local file path from which to retrieve the CRL.

    Enable OCSP Revocation

    Select the check box to use the Online Certificate Status Protocol (OCSP) certificate validation protocol to get the revocation status of a certificate.

    Use CRL in case of OCSP Failure

    If you configure both CRL and OCSP, you can select this box to fall back to using CRL if OCSP checking is not available.

    Send OCSP Nonce

    Select this check box if you want the unique identifier of the OCSP request to be sent in the response.

    OCSP URL

    If you enabled OCSP revocation, enter the OCSP server address for revocation checking.

    OCSP Responder's Signing Certificate

    Enter the path to the OCSP certificate for the responder, /path/to/file.cer.

    Enable Consent Form before Authentication

    Select this check box to include a consent form page to appear before users log in to their Workspace ONE portal using certificate authentication.

    Consent Form Content

    Type the text here that displays in the consent form.

  5. Click Save.

What to do next

When X.509 Certificate authentication is configured and Access Point appliance is set up behind a load balancer, make sure that Access Point is configured with SSL pass-through at the load balancer and not configured to terminate SSL at the load balancer. This configuration ensures that the SSL handshake is between the Access Point and the client in order to pass the certificate to Access Point.