Connecting to an external datastore identity provider
Learn how to integrate Authorization Control Plane (ACP) with an external datastore IDP.
About integration with external datastore IDPs
ACP makes it possible for you to build a custom integration with an external datastore IDP. Such integration enables you to bring your own user data or user credentials store and use the Resource Owner Password OAuth grant flow as the means to authenticate your users. Additionally, it is also possible for ACP to extend the identity context of the user using the external sources of user data.
For the integration to work, your external datastore service must expose an
implemented according to the Swagger specification
provided by Cloudentity.
Once the user tries to log in to the
application, ACP calls this endpoint to send provided credentials to
authenticate the user.
It is possible to have exactly one external datastore IDP or static (sandbox) IDP enabled for a workspace, but you can create more of them. Enabling one of the IDPs results in disabling the one that was enabled so far.
Basic access authentication
ACP integration with external datastores makes it possible to use Basic access authentication. It is a simple authentication scheme that is built into the HTTP protocol. To use it, provide your Basic Auth Username and Basic Auth Password that ACP will base-64-encode and use them when sending a request to your authentication endpoint.
- Your service exposes an endpoint to which ACP can send requests to authenticate your users.
Connect external IDP
Go to Identities > CREATE IDENTITY.
Select External IDP > Next.
Fill in all necessary fields to configure your external IDP.
Provide a display Name for your IDP.
Provide an External datastore service URL.
ACP uses this path to construct the URL of your
If you wish, enable the Authentication Context Caching.
Enable the authentication context caching, if you want to have the user’s data cached in ACP and avoid re-authenticating within one user’s session. To learn more, see the stateful authorization with ACP documentation.
If you wish, provide the credentials for Basic access authentication.
Your external datastore IDP is available for your users. They can use it to, for example, login to your ACP Admin Portal, Demo application, and more.