Before you enable smart card authentication, you have to configure the reverse proxy on the Platform Services Controller system. If your environment uses an embedded Platform Services Controller, you perform this task on the system where both vCenter Server and Platform Services Controller run.

Before you begin

Copy the CA certificates to the Platform Services Controller system.

About this task

Reverse proxy configuration is required in vSphere 6.5 and later.

Procedure

  1. Log in to the Platform Services Controller.

    OS

    Description

    Appliance

    Log in to the appliance shell as the root user.

    Windows

    Log in to a Windows command prompt as an Administrator user.

  2. Create a trusted client CA store.

    This store will contain the trusted issuing CA's certificates for client certificate. The client here is the browser from which the smart card process prompts the end user for information.

    The following example shows how you create a certificate store on the Platform Services Controller appliance.

    For a single certificate:

    cd /usr/lib/vmware-sso/
    openssl x509 -inform PEM -in xyzCompanySmartCardSigningCA.cer > /usr/lib/vmware-sso/vmware-sts/conf/clienttrustCA.pem

    For multiple certificates:

    cd /usr/lib/vmware-sso/
    openssl x509 -inform PEM -in xyzCompanySmartCardSigningCA.cer >> /usr/lib/vmware-sso/vmware-sts/conf/clienttrustCA.pem
    Note:

    On Platform Services Controller on Windows, use C:\ProgramData\VMware\vCenterServer\runtime\VMwareSTSService\conf\ and change the command to use backward slash.

  3. Make a backup of the config.xml file that includes the reverse proxy definition, and open config.xml in an editor.

    OS

    Description

    Appliance

    /etc/vmware-rhttpproxy/config.xml

    Windows

    C:\ProgramData\VMware\vCenterServer\cfg\vmware-rhttpproxy\config.xml

  4. Make the following changes and save the file.
    <http>
    <maxConnections> 2048 </maxConnections>
    <requestClientCertificate>true</requestClientCertificate>
    <clientCertificateMaxSize>4096</clientCertificateMaxSize>
    <clientCAListFile>/usr/lib/vmware-sso/vmware-sts/conf/clienttrustCA.pem</clientCAListFile>
    </http>

    The config.xml file includes some of these elements. Uncomment, update, or add the elements as needed.

  5. Restart the service.

    OS

    Description

    Appliance

    /usr/lib/vmware-vmon/vmon-cli --restart rhttpproxy
    

    Windows

    Restart the operating system, or restart the VMware HTTP Reverse Proxy from the Service Manager.