You can customize certificate revocation checking, and you can specify where vCenter Single Sign-On looks for information about revoked certificates.

Before you begin

  • Verify that your environment uses Platform Services Controller version 6.5, and that you use vCenter Server version 6.0 or later. Platform Services Controller version 6.0 Update 2 supports smart card authentication, but the setup procedure is different.

  • Verify that an enterprise Public Key Infrastructure (PKI) is set up in your environment, and that certificates meet the following requirements:

    • A User Principal Name (UPN) must correspond to an Active Directory account in the Subject Alternative Name (SAN) extension.

    • The certificate must specify Client Authentication in the Application Policy or Enhanced Key Usage field or the browser does not show the certificate.

  • Verify that the Platform Services Controller Web interface certificate is trusted by the end user’s workstation. Otherwise, the browser does not attempt the authentication.

  • Add an Active Directory identity source to vCenter Single Sign-On.

  • Assign the vCenter Server Administrator role to one or more users in the Active Directory identity source. Those users can then perform management tasks because they can authenticate and they have vCenter Server administrator privileges.

    Note:

    The administrator of the vCenter Single Sign-On domain, administrator@vsphere.local by default, cannot perform smart card authentication.

About this task

You can customize the behavior by using the Platform Services Controller Web interface or by using the sso-config script. The settings that you select depend in part on what the CA supports.

  • If revocation checking is disabled, vCenter Single Sign-On ignores any CRL or OCSP settings. vCenter Single Sign-On does not perform checks on any certificates.

  • If revocation checking is enabled, the recommended setup depends on the PKI setup.

    OCSP only

    If the issuing CA supports an OCSP responder, enable OCSP and disable CRL as failover for OCSP.

    CRL only

    If the issuing CA does not support OSCP, enable CRL checking and disable OSCP checking.

    Both OSCP and CRL

    If the issuing CA supports both an OCSP responder and a CRL, vCenter Single Sign-On checks the OCSP responder first. If the responder returns an unknown status or is not available, vCenter Single Sign-On checks the CRL. For this case, enable both OCSP checking and CRL checking, and enable CRL as failover for OCSP.

  • If revocation checking is enabled, advanced users can specify the following additional settings.

    OSCP URL

    By default, vCenter Single Sign-On checks the location of the OCSP responder that is defined in the certificate being validated. You can explicitly specify a location if the Authority Information Access extension is absent from the certificate or if you want to override it.

    Use CRL from certificate

    By default, vCenter Single Sign-On checks the location of the CRL that is defined in the certificate being validated. Disable this option if the CRL Distribution Point extension is absent from the certificate or if you want to override the default.

    CRL location

    Use this property if you disable Use CRL from certificate and you want to specify a location (file or HTTP URL) where the CRL is located.

You can further limit which certificates vCenter Single Sign-On accepts by adding a certificate policy.

Procedure

  1. From a Web browser, connect to the vSphere Web Client or the Platform Services Controller.

    Option

    Description

    vSphere Web Client

    https://vc_hostname_or_IP/vsphere-client

    Platform Services Controller

    https://psc_hostname_or_IP/psc

    In an embedded deployment, the Platform Services Controller host name or IP address is the same as the vCenter Server host name or IP address.

  2. Specify the user name and password for administrator@vsphere.local or another member of the vCenter Single Sign-On Administrators group.

    If you specified a different domain during installation, log in as administrator@mydomain.

  3. Navigate to the vCenter Single Sign-On configuration UI.

    Option

    Description

    vSphere Web Client

    1. From the Home menu, select Administration.

    2. Under Single Sign-On, click Configuration.

    Platform Services Controller

    Click Single Sign-On and click Configuration.

  4. Click Certificate Revocation Settings and enable or disable revocation checking.
  5. If certificate policies are in effect in your environment, you can add a policy in the Certificate policies accepted pane.