User Provisioning with SCIM 2.0
The System for Cross-domain Identity Management (SCIM) specification is designed to make managing user identities in cloud-based applications and services easier. Its intent is to reduce the cost and complexity of user management operations by providing a common user schema and extension model, as well as binding documents to provide patterns for exchanging this schema using standard protocols.
SCIM is used by Single Sign-On (SSO) services and identity providers to manage people across a variety of tools, including Spreadly. This SCIM implementation targets version 2.0 of the protocol.
The SCIM methods are accessed over HTTP. The base URL for all calls to the SCIM API is https://spreadly.app/api/v1/scim. All SCIM methods are branches of this base URL.
A Bearer token is required to access the SCIM endpoints. You can get your SCIM secret token from Team > Members.
Attributes are the details associated with a user's account. You can view those user attributes when you open up the members list of your team. The following tables map SCIM attributes to the profile fields that Spreadly uses.
- User Provisioning with Entra-ID (Microsoft)
This is a non-complete list of supported providers. Feel free to contact us and send us your configuration guide for any other provider, missing in this list.
Manage Team members in Spreadly
SCIM is used by Single Sign-On (SSO) services and identity providers to manage people across a variety of tools, including Spreadly. This SCIM implementation targets version 2.0 of the protocol.
Accessing the SCIM API
The SCIM methods are accessed over HTTP. The base URL for all calls to the SCIM API is https://spreadly.app/api/v1/scim. All SCIM methods are branches of this base URL.
Get a secret token
A Bearer token is required to access the SCIM endpoints. You can get your SCIM secret token from Team > Members.
User attributes
Attributes are the details associated with a user's account. You can view those user attributes when you open up the members list of your team. The following tables map SCIM attributes to the profile fields that Spreadly uses.
Spreadly User Field | SCIM attribute | Required |
---|---|---|
userName | ✅ | |
First name | name[givenName] | ✅ |
Last name | name[familyName] | ✅ |
Import Key | externalId | ✅ |
Phone | phones[type eq "work"][value] | ❌ |
Mobile | phones[type eq "mobile"][value] | ❌ |
Position | title | ❌ |
Department | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User[department] | ❌ |
Division | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User[division] | ❌ |
Organization | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User[organization] | ❌ |
Street | addresses[type eq "work"][streetAddress] | ❌ |
City | addresses[type eq "work"][locality] | ❌ |
Region | addresses[type eq "work"][region] | ❌ |
Postal code | addresses[type eq "work"][postalCode] | ❌ |
Country | addresses[type eq "work"][country] | ❌ |
Language | locale | ❌ |
Custom Field 1 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField1 | ❌ |
Custom Field 2 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField2 | ❌ |
Custom Field 3 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField3 | ❌ |
Custom Field 4 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField4 | ❌ |
Custom Field 5 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField5 | ❌ |
Custom Field 6 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField6 | ❌ |
Custom Field 7 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField7 | ❌ |
Custom Field 8 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField8 | ❌ |
Custom Field 9 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField9 | ❌ |
Custom Field 10 | urn:ietf:params:scim:schemas:extension:spreadly:2.0:User:customField10 | ❌ |
Group Attributes
Spreadly Group Field | SCIM attribute | Required |
---|---|---|
Name | displayName | ✅ |
Import Key | externalId | ✅ |
Description | urn:ietf:params:scim:schemas:extension:spreadly:2.0:Group:description | ❌ |
Supported Providers
- User Provisioning with Entra-ID (Microsoft)
This is a non-complete list of supported providers. Feel free to contact us and send us your configuration guide for any other provider, missing in this list.
Updated on: 27/07/2024
Thank you!