This topic explains how to install Single Sign‑On for VMware Tanzu Application Service.


To install Single Sign‑On, you must have:

Install Single Sign‑On Using Ops Manager

  1. From VMware Tanzu Network, select a Single Sign‑On tile version and download the product release file.

  2. From the Ops Manager Installation Dashboard, select the Import a Product button to upload the product file.

  3. Click the + icon next to the uploaded product to add this product to your staging area.

  4. Click on the Single Sign‑On tile to enter any configurations.

    Note: The Single Sign‑On Identity Service Broker is deployed as an app from a BOSH errand, and has no associated BOSH VMs that require selecting a corresponding network. If you are forced to select a network during installation, select the Deployment network, also known as the VMware Tanzu Application Service for VMs network.

  5. (Optional) Click Property Configurations to set which buildpack Single Sign‑On uses when it pushes its component apps. VMware recommends the default java_buildpack_offline buildpack. Because the component apps are Java-based, you must specify a Java-compatible buildpack.

  6. In the Ops Manager Dashboard, do the following to complete the installation:

    1. If you are using Ops Manager v2.3 or later, click Review Pending Changes. For more information about this Ops Manager page, see Reviewing Pending Product Changes.
    2. Click Apply Changes.

Update Stemcell

If required, do the following to update the stemcell for Single Sign‑On:

  1. Download the stemcell from VMware Tanzu Network.
  2. In the Ops Manager, click Stemcell Library.
  3. Click Import Stemcell, and then select the stemcell you downloaded from VMware Tanzu Network.
  4. Click Save.

Update SSL and Load Balancer

You must update the SSL certificate for the domains listed below for each plan you create. Depending on your infrastructure and load balancer, you must also update your load balancer configuration for the following domains:



  • *.login.SYSTEM-DOMAIN


Configure Application Security Groups

Single Sign‑On requires the following network connections:

  • TCP connection to load balancer(s) on port 443
  • TCP and UDP connection to Domain Name Servers on port 53
  • (Optional) TCP connection to your external identity provider on port 80 or 443

To enable access to Single Sign‑On, you must ensure your ASG allows access to the load balancers and domain name servers that provide access to Cloud Controller and UAA. Optionally, you can configure access to your external identity provider to receive SAML metadata. For how to set up ASGs, see Application Security Groups.

check-circle-line exclamation-circle-line close-line
Scroll to top icon