Configuring Okta as an Identity Provider
Warning: Pivotal Single Sign-On v1.11 is no longer supported because it has reached the End of General Support (EOGS) phase as defined by the Support Lifecycle Policy. To stay up to date with the latest software and security updates, upgrade to a supported version.
This topic describes how to set up Okta as your identity provider by configuring SAML integration in both Pivotal Single Sign‑On and Okta.
Log into the SSO Operator Dashboard at
https://p-identity.YOUR-SYSTEM-DOMAINusing your User Account and Authentication (UAA) administrator credentials. In your Pivotal Application Service tile in Ops Manager, the Domain settings shows your system domain, and the Credentials tab shows the UAA Admin Credentials.
Select your plan and click Manage Identity Providers on the drop-down menu.
Click Configure SAML Service Provider.
(Optional) Select Perform signed authentication requests to enforce SSO private key signature and identity provider validation.
(Optional) Select Require signed assertions to validate the origin of signed responses.
Click Download Metadata to download the service provider metadata.
Open the downloaded service provider metadata file. You will refer to this file in the next step, when you fill in the SAML settings in Okta.
Sign in as an Okta administrator.
Navigate to your app and click the Sign On tab.
Under Settings, click Edit, and select SAML 2.0.
Click the General tab.
Under SAML Settings, click the Edit button followed by the Next button.
In the SAML Settings section:
- Enter the
AssertionConsumerService Location URLfrom your downloaded service provider metadata into Single sign on URL.
PORTAL-FQDNis the fully qualified domain name (FQDN) for your login portal. The portal FQDN uses the format
AUTH-DOMAIN.login.SYSTEM-DOMAIN. You can view the portal FQDN for a plan by logging into the SSO Operator Dashboard, clicking the name of your plan, and selecting Edit Plan.
- Enter the FQDN for your login portal into Audience URI (SP Entity ID). This value is available in the downloaded service provider metadata as the entity ID.
- Select a Name ID format.
- Select an Application username.
- Enter the
(Optional) To configure single logout:
- Click Show Advanced Settings.
- For Enable Single Logout, select Allow application to initiate single logout.
- Enter the
SingleLogoutService Location URLfrom your downloaded service provider metadata into Single Logout URL.
- Enter your
Auth Domain URLinto SP Issuer.
- Click Upload Signature Certificate to upload the signature certificate from your downloaded service provider metadata. You will need to copy the
X509Certificateinformation from the downloaded service provider metadata, and reformat it into a valid certificate file to upload.
(Optional) Under Attribute Statements (Optional), specify any attribute statements that you want to map to users in the ID token.
(Optional) Under Group Attribute Statements (Optional), specify any group attribute statements that you want to map to users in the ID token. This is a group that users belong to within Okta.
Click the Next button followed by the Finish button.
Click Identity Provider metadata to download the metadata, or copy and save the link address of the Identity Provider metadata. You will need this Okta metadata for the next step, Configure a Single Sign-On Service Provider.