API Walkthrough
Introduction
This walk-through explains the basic functionality of the IdH service. It demonstrates how to link and unlink multiple user identities to a local user identity via the IdH server's RESTful interface.
Linking multiple user identities /link
/link
To link multiple user identities within the connected LDAP directory the service exposes the /link
endpoint. This endpoint expects an HTTP POST
request with a JSON formatted list of multiple user identities in the SCIM schema as input.
The specification of the SCIM schema can be found here RFC 7643.
Default configuration requires authentication at the endpoint, either HTTP Basic or OpenId Connect. For HTTP Basic please have a look at the Configuration section. For OpenId Connect please have a look at the INDIGO-DataCloud OpenId Connect provider IAM.
The response of the POST call can be used for unlinking the provided identities again.
/link
/link
An example link call might look like the following, with the users.scim
user data shown below.
curl -v -k -u restadmin:restadmin -X POST https://localhost/link -H "Content-Type: application/scim+json" -d@users.scim
user.scim
Unlinking multiple user identities /unlink
/unlink
To unlink multiple user identities within the connected LDAP directory the service exposes the /unlink
endpoint. This endpoint expects an HTTP POST
request with a JSON formatted list of multiple user identities in the SCIM schema as input.
The user identity objects need to include the extended meta-data and group information of the linking output explained in the previous section.
The specification of the SCIM schema can be found here RFC 7643.
Default configuration requires authentication at the endpoint, either HTTP Basic or OpenId Connect. For HTTP Basic please have a look at the Configuration section. For OpenId Connect please have a look at the INDIGO-DataCloud OpenId Connect provider IAM.
/unlink
/unlink
An example unlink call might look like the following, with the users.scim
user data shown below.
curl -v -k -u restadmin:restadmin -X POST https://localhost/unlink -H "Content-Type: application/scim+json" -d@users.scim
user.scim
Last updated