Single API - Well Known Configuration
Problem
To authenticate with Gladstone's Single API, you need the correct URLs and technical details. These are published in a 'Well Known' configuration, but it may not be clear where to find it or how to use it.
Resolution
- Find the Operator address of the organisation you are integrating with: the web address it uses to open GO Operator.
- Add
/identity/.well-known/openid-configurationto the end of that address.
Example:https://yourorganisation.gladstonesoftware.cloud/identity/.well-known/openid-configuration - Copy and paste the full URL into a web browser to view the Well Known configuration.
- Use the "Pretty Print" checkbox (if your browser offers one) to view the content as formatted JSON.
- Use this URL, together with your Client ID and Client Secret, for authentication and token management. If you are working with a developer, give them this URL.
Notes
- For how the Well Known configuration fits into the OAuth2 flow, see OAuth2 Authentication and Authenticating with Gladstone APIs.