Configure a Single Sign-On Service Provider
This topic describes how to add an external identity provider to your Pivotal Single Sign-On (SSO) service plan.
- Download the metadata from your Active Directory Federation Services server at the following URL:
Log in to the SSO dashboard at
https://p-identity.YOUR-SYSTEM-DOMAINas a Plan Administrator.
Select your plan and click Manage Identity Providers on the drop-down menu.
Click New Identity Provider to create a new identity provider.
To create a new identity provider, perform the following steps:
- Enter an identity provider name in Identity Provider Name.
- (Optional) Enter a description in Identity Provider Description.
- Click SAML File Metadata (optional), then click Upload Identity Provider Metadata to upload your metadata XML.
- (Optional) Under Advanced SAML Settings, click Attribute Mappings to enter the mappings.
Click Create Identity Provider.
Click Resource Permissions.
Click New Permissions Mapping and perform the following steps:
- Enter a Group Name.
- For Select Permissions, select the permissions to grant to the members of the group from the external identity provider.
Navigate to the identity provider list.
Click Group Whitelist and enter the group names from the external identity provider that should be propagated in the ID token.
Under User Attributes, map the User Schema Attribute of
to the Attribute Name value of
If you did not perform the steps to customize the SAML assertion value,
“http://schemas.xmlsoap.org/claims/Group” as the Attribute Name instead.
An attribute mapping with a customized SAML assertion value looks like this:
An attribute mapping with a non-customized SAML assertion value looks like this:
Groups now show up from the SAML assertion as claims.
You can pull these values from the user’s stored custom attributes using the
roles scope on the ID token or through the userinfo endpoint,
or map these to permissions using Resource Permissions mappings.
For more information, see the Create or Edit Resource Permissions section of