Skip to main content

Synchronise your users using SCIM

Appaloosa allows you to synchronise your user directory with identify provider supporting SCIM like Microsoft Entra, Okta ...

Written by Jeremy Bodokh

Appaloosa is compatible with SCIM to synchronise your user directory and keep the users on Appaloosa updated at all time.

If you need to read more about SCIM you can find the official documentation here

Appaloosa currently supports both users and groups synchronisation. Each time a user is created, updated or removed from your user directory, it will be synced on Appaloosa according to the synchronisation rules defined in your identity provider.

To configure the SCIM integration, head to Settings on Appaloosa, then Integrations where you'll find the SCIM endpoint url and your company SCIM token to use with your identity provider.

We support all the identity provider compatible with SCIM v2 like Microsoft Entra, Okta and more...

Here is the list of mandatory attributes that y our SCIM server needs to send to Appaloosa, we provide an example with Entra:

Attributes names for SSO

Entra Attributes Name

userName

userPrincipalName

name.givenName

givenName

name.familyName

surname

externalId

mailNickname

active

Switch([IsSoftDeleted], , “False”, “true”, “True”, “false”)

nickName

objectId

phoneNumbers[type eq "work"].value

telephoneNumber

You can sync up to two phone numbers, one work number and one mobile number.

On Entra, you should only need to add the line "nickName" everything else should be already configured by default.

Also we support up to 5 extra custom attributes that can be sent and save to Appaloosa:

  • urn:ietf:params:scim:schemas:extension:appaloosa:User:custom_attribute1

  • urn:ietf:params:scim:schemas:extension:appaloosa:User:custom_attribute2

  • urn:ietf:params:scim:schemas:extension:appaloosa:User:custom_attribute3

  • urn:ietf:params:scim:schemas:extension:appaloosa:User:custom_attribute4

  • urn:ietf:params:scim:schemas:extension:appaloosa:User:custom_attribute5

These attributes can be used in your configurations with these wildcards:

  • @@user_scim_custom_attribute1@@

  • @@user_scim_custom_attribute2@@

  • @@user_scim_custom_attribute3@@

  • @@user_scim_custom_attribute4@@

  • @@user_scim_custom_attribute5@@

Did this answer your question?