Prerequisites
This guide outlines how to synchronize your application's user and group directories using SCIM v2.0. To synchronize an organization's users and groups provisioned for your application, you'll need to provide the the Entra ID app with two pieces of information:
- A SCIM URL that the SCIM server will make requests to.
- An Access Token to authenticate its endpoint requests.
Both of these are available in your SCIM Settings in the Kudoboard Integrations page.
⚠️ Please note: Before gaining access to the SCIM integration, you must be upgraded to an Enterprise plan.
Set up SCIM in Kudoboard
Login to your Kudoboard Enterprise account and select the settings cog in the top right corner and go to "Admin panel". In the navigation menu on the left side, go to "Integrations" and find the "SCIM" panel, then click on "Connect SCIM". If you don't see the option to "Connect SCIM", please contact support via scim@kudoboard.com.
Once connected, a modal will display with your SCIM URL and Access Token.
⚠️ Please note: We won't display your Access Token again after this point so please store it securely.
With the SCIM integration set up in Kudoboard, it's its time to switch over to your Entra ID environment.
Kudoboard → Entra SCIM Attributes
Kudoboard can map the following attributes:
| Kudoboard Field | Entra ID Field | Type | SCIM Namespace |
| userName | Email (userPrincipalName) | string | urn:ietf:params:scim:schemas:core:2.0:User |
| userName | ExpressionSwitch([IsSoftDeleted], ,"False","True","True","False")
|
string | urn:ietf:params:scim:schemas:core:2.0:User |
| givenName | givenName | string | urn:ietf:params:scim:schemas:core:2.0:User |
| familyName | surname | string | urn:ietf:params:scim:schemas:core:2.0:User |
| externalId | objectId | string | urn:ietf:params:scim:schemas:core:2.0:User |
| displayName | displayName | string | urn:ietf:params:scim:schemas:core:2.0:User |
| timezone | user.timezone | string | urn:ietf:params:scim:schemas:core:2.0:User |
| employeeNumber | user.employeeNumber | string | urn:ietf:params:scim:schemas:extension:enterprise: 2.0:User |
| managerValue | manager | integer | urn:ietf:params:scim:schemas:extension:enterprise: 2.0:User |
| isOrgAdmin | custom attribute or expression or empty value (you don’t have to assign org admin’s via SCIM) | boolean | urn:kudoboard:params:schemas:extension:2.0:User |
| birthDate | custom attribute or expression | string (date format - year is irrelevant but required for validation e.g. 1970-03-20) | urn:kudoboard:params:schemas:extension:2.0:User |
| hiredDate |
employeeHireDate or custom attribute or expression |
string (date format) | urn:kudoboard:params:schemas:extension:2.0:User |
Looking for something else? Find our Okta SCIM integration guide here.