Providing a Certificate for Your TLS Termination Point

Page last updated:

This topic describes how to configure Transport Layer Security (TLS) termination for HTTP traffic in VMware Tanzu Application Service for VMs (TAS for VMs) with a TLS certificate, as part of the process of configuring TAS for VMs for deployment.

Configure TLS Termination

When you deploy Ops Manager, you must configure the TLS termination for HTTP traffic in your TAS for VMs configuration. You can terminate TLS at all of these points:

  • Load balancer
  • Load balancer and the Gorouter
  • The Gorouter

To choose and configure the TLS termination option for your deployment, see TLS Termination Options for HTTP Routing in Securing Traffic into TAS for VMs.

Note: If you are using HAProxy in a TAS for VMs deployment, you can choose to terminate SSL/TLS at HAProxy in addition to any of the SSL/TLS termination options above. For more information, see Configuring SSL/TLS Termination at HAProxy.

Obtain TLS Certificates

To secure traffic into Ops Manager, you must obtain at least one TLS certificate. For general certificate requirements for deploying Ops Manager, see Certificate Requirements in Securing Traffic into TAS for VMs.

For additional IaaS-specific certificate requirements:

Create a Wildcard Certificate for Ops Manager Deployments

This section describes how to create or generate a certificate for your TAS for VMs environment. If you are deploying to a production environment, you should obtain a certificate from a trusted Certificate Authority (CA).

For internal development or testing environments, you have two options for creating a required TLS certificates:

  • You can create a self-signed certificate, or
  • You can have TAS for VMs generate the certificate for you.

To create a certificate, you can use a wide variety of tools including OpenSSL, Java’s keytool, Adobe Reader, and Apple’s Keychain to generate a Certificate Signing Request (CSR).

In either case for either self-signed or trusted single certificates, apply these rules when creating the CSR:

  • Specify your registered wildcard domain as the Common Name, where DOMAIN is your registered wildcard domain. For example, *.DOMAIN.com.

  • VMware recommends using a split domain configuration that separates the domains for apps and sys components. To use a split domain configuration, enter these values in the Subject Alternative Name of the certificate, where DOMAIN is your registered wildcard domain:

    • *.apps.DOMAIN.com
    • *.sys.DOMAIN.com
    • *.login.sys.DOMAIN.com
    • *.uaa.sys.DOMAIN.com
  • If you are using a single domain configuration, use these values as the Subject Alternative Name of the certificate, where DOMAIN is your registered wildcard domain:

    • *.login.sys.DOMAIN.com
    • *.uaa.sys.DOMAIN.com

      Note: TLS certificates generated for wildcard DNS records only work for a single domain name component or component fragment. For example, a certificate generated for *.DOMAIN.com does not work for *.apps.DOMAIN.com and *.sys.DOMAIN.com. The certificate must have both *.apps.DOMAIN.com and *.sys.DOMAIN.com attributed to it.

Generate an RSA Certificate in TAS for VMs

To generate an RSA certificate in TAS for VMs:

  1. Navigate to the Ops Manager Installation Dashboard.

  2. Click the TAS for VMs tile.

  3. Select Networking.

  4. Under Certificate and private keys for the Gorouter and HAProxy:

    1. Under Certificate and private key, click Change.
    2. Click Generate RSA Certificate to populate the Certificate and private key fields with RSA certificate and private key information.
  5. VMware recommends using a split domain configuration that separates the domains for apps and sys components. To use a split domain configuration, enter these following domains for the certificate, where DOMAIN is your registered wildcard domain:

    • *.DOMAIN.com
    • *.apps.DOMAIN.com
    • *.sys.DOMAIN.com
    • *.login.sys.DOMAIN.com
    • *.uaa.sys.DOMAIN.com

    At the top of the pop-up window is a teal checkmark and the words 'Generate RSA Certificate'. In the upper-right corner is a gray circle with a white X in the middle. Below 'Generate RSA Certificate' is a field labeled 'Example: *.app.domain.com, *.system.domain.com, *.my.webapp.com, *.domain.com, my.webapp.com, domain.com', with a red asterisk to denote that it is a required field. The field contains the text '*.apps.EXAMPLE.com, *.system.EXAMPLE.com'. Below this field are two buttons, a gray rectangular button labeled 'Cancel' and a blue rectangular button labeled 'Save'.