Integrating Pivotal Single Sign‑On with Your App
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 integrate Pivotal Single Sign‑On with Java and non-Java apps.
Because Single Sign‑On is based on the OAuth protocol, any app that uses Single Sign‑On must be OAuth-aware.
If you are using Java, see the Single Sign‑On Service Sample Applications repository. These are sample Spring Boot apps that demonstrate how to use Single Sign‑On Service libraries to configure the app for OAuth.
After binding the app to a Single Sign‑On service instance, you must restart the app for the new Single Sign‑On configuration to take effect.
To configure non-Java apps for OAuth, supply the following properties as environment variables to your app after you bind the app to a Single Sign‑On service instance. You can view this information on the Next Steps page of the SSO Developer Dashboard.
- App ID, also known as OAuth Client ID
- App Secret, also known as OAuth Client Secret
- OAuth Authorization URL, the endpoint for client authorization
- OAuth Token URL, the endpoint for token retrieval
To validate the token, you must verify the following:
The token is a properly signed JSON Web Token with an appropriate public key. The key can be downloaded from the Token Verification Key endpoint specified on the Next Steps page.
The value of
audin the token matches your App ID.
The value of
issuses the following pattern:
AUTH-DOMAINis the Auth Domain you entered in Create or Edit Service Plans.
The expiry time of the token,
exp, has not passed.
When you make an authorization code, password or implicit grant request, a login hint can be provided so that the end user is automatically redirected to the appropriate identity provider.
An encoded JSON string containing
origin_key tied to the origin key of an
identity provider can be provided as a login hint using
login_hint in a query
For information about login hints,
see the Authorization Code Grant
in the UAA API documentation.