Installing Single Sign-On
This topic explains how to install Single Sign-On (SSO) for Pivotal Cloud Foundry (PCF).
Note: If you are upgrading to this version of SSO, you must update the definitions of any BOSH Add-On’s for PCF you are using to include the Xenial stemcell. See Update Add-ons to Run with Xenial Stemcell below.
From Pivotal Network, select a Single Sign-On tile version and download the product release file.
From the Ops Manager Installation Dashboard, select the Import a Product button to upload the product file.
Click the plus sign icon next to the uploaded product to add this product to your staging area.
Click on the Single Sign-On tile to enter any configurations.
Note: The SSO Identity Service Broker is deployed as a PCF application 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 PAS network.
In the Ops Manager Dashboard, do the following to complete the installation:
- 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.
- Click Apply Changes.
- 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.
If required, do the following to update the stemcell for SSO:
- Download the stemcell from Pivotal Network.
- In the Ops Manager, click Stemcell Library.
Click Import Stemcell, and then select the stemcell you downloaded from Pivotal Network.
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:
The Single Sign-On service 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 the Single Sign-On service, you must ensure your Application Security Group allows access to the load balancer(s) 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 application security groups, see Understanding Application Security Groups.
SSO v1.7.1 and later requires a Xenial stemcell. If you are using any of the following BOSH add-ons with your PCF deployment, you must update the add-on definition to include the Xenial stemcell before you deploy SSO v1.7.1+:
- File Integrity Monitoring for PCF Add-on. For update instructions, see Updating FIM Add-on for PCF to Run with Xenial Stemcells.
- ClamAV for PCF Add-on. For update instructions, see Updating ClamAV Add-on for PCF to Run with Xenial Stemcells.
- IPsec for PCF Add-on. For update instructions, see Updating IPsec Add-on for PCF to Run with Xenial Stemcells.