Skip to main content
Version: v4.5

SCIM registration

Create SCIM Server Detail#

Endpoint#

POST /auth/realms/master/scim/servers

Request#

Headers#

Authorization: Bearer <Keyclaok admin REST API Token>

Body parameters#

ParameterTypeDescriptionRequired
baseUrlStringSCIM url exposed by SCIM Server(SP), that should follow the standard RFC ft-ietf-scim-api: System for Cross-domain Identity Management: ProtocolRequired
tokenUrlStringPlatformIAMService gets token using clientId and clientSecret from SCIM server before making the APIsRequired
Request body example#
{  "baseUrl":"https://xxxxxx.com/passportsvc/api/v1/scim/Users",  "tokenUrl":"https://xxxxxx.com/passportsvc/api/v1/oauth/token?grant_type=client_credentials&scope=scim",  "clientId":"GVNAFBRKKQVFZHPGBHMGOECSWQGBFEAG",  "clientSecret":"GYYQBMMEIKJJMKRNFFKOGFGVWDORERVXRIGFKHYCWCMDGNWKNAEJQMWVVEAUNWSD"}

Response#

Response data example#

{  "id": "d8d36582-eaa3-4739-8d95-10f966f08fb4",  "baseUrl": "https://xxxxxx.com/passportsvc/api/v1/scim/Users",  "tokenUrl": "https://xxxxxx.com/passportsvc/api/v1/oauth/token?grant_type=client_credentials&scope=scim",  "clientId": "GVNAFBRKKQVFZHPGBHMGOECSWQGBFEAG",  "clientSecret": "GYYQBMMEIKJJMKRNFFKOGFGVWDORERVXRIGFKHYCWCMDGNWKNAEJQMWVVEAUNWSD"}

Create SCIM Event Listener#

Endpoint#

POST /auth/realms/master/scim/listeners

Request#

Headers#

Authorization: Bearer <Keyclaok admin REST API Token>

Body parameters#

ParameterTypeDescriptionRequired
scimServerDetailIdStringPass the SCIM server detail id.Required
eventNameStringPass either "CREATE", "DELETE", "UPDATE"Required
realmIdStringEnter "iam".Required
Request body example#
{  "scimServerDetailId":"d6bae675-84ac-4140-939d-aa6d7e92acdd",  "eventName":"CREATE",  "realmId":"iam"}

Response#

Response data example#

{  "id": "f84b0b97-0052-40fa-9927-ab4d5d425581",  "realmId": "iam",  "scimServerDetailId": "d8d36582-eaa3-4739-8d95-10f966f08fb4",  "eventName": "CREATE"}