Please see below for how Learnster user attributes are mapped with SCIM Schema attributes. Further down, you can also see how Azure AD user attributes are mapped with SCIM and Learnster attributes.
Learnster User to SCIM User Mapping
Learnster maps Learnster's User attributes to urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.
Learnster User | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User |
User primary email | userName |
Unique user identifier (SSO) | userName |
Is user active | active |
Full name | displayName |
Title | title |
Secondary email | emails[type eq "work"].value |
First name | name.givenName |
Last Name | name.familyName |
Office | addresses[type eq "work"].formatted |
User address street | addresses[type eq "work"].streetAddress |
User address city | addresses[type eq "work"].locality |
User address postal code | addresses[type eq "work"].postalCode |
Country | addresses[type eq "work"].country |
Phone number | phoneNumbers[type eq "work"].value |
Phone number | phoneNumbers[type eq "mobile"].value |
SCIM external id | externalId |
Company | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization |
Direct Manager | urn:ietf:params:scim:schemas:extension:enterprise:2.0:manager |
“phoneNumbers[type eq "work"].value” and “phoneNumbers[type eq "mobile"].value” are arrays in SCIM and can hold multiple numbers. Learnster supports only one phone number per user. If an array with more than one number is provided by SCIM, Learnster will use the first number in the array `phoneNumbers` array.
Learnster Tag to SCIM Group Mapping
Learnster maps Tags in Learnser to urn:ietf:params:scim:schemas:core:2.0:Group.
Learnster Tag | urn:ietf:params:scim:schemas:core:2.0:Group |
Tag name (A numbered suffix is automatically added to the tag name if it already exists to avoid conflicts) | displayName |
SCIM external id | externalId |
Members (as users in Learnser) are automatically tagged with the tag | members |
Azure Active Directory User to Learnster User Mapping
Please see below for how Azure Active Directory User attributes are mapped to Learnster User attributes.
Azure Active Directory User | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User | Learnster User |
userPrincipalName | userName | Username (user primary email if username isn't enabled) |
userPrincipalName | userName | Unique user identifier (SSO) |
Switch([IsSoftDeleted], , "False", "True", "True", "False") | active | Is user active |
displayName | displayName | Full name |
jobTitle | title | Title |
emails[type eq "work"].value | User primary email | |
preferredLanguage | preferredLanguage | Not used |
givenName | name.givenName | First name |
surname | name.familyName | Last Name |
Join(" ", [givenName], [surname]) | name.formatted | Not used |
physicalDeliveryOfficeName | addresses[type eq "work"].formatted | Office |
streetAddress | addresses[type eq "work"].streetAddress | User address street |
city | addresses[type eq "work"].locality | User address city |
state | addresses[type eq "work"].region | Not used |
postalCode | addresses[type eq "work"].postalCode | User address postal code |
country | addresses[type eq "work"].country | Country |
telephoneNumber | phoneNumbers[type eq "work"].value | Phone number |
mobile | phoneNumbers[type eq "mobile"].value | Phone number |
facsimileTelephoneNumber | phoneNumbers[type eq "fax"].value | Not used |
mailNickname | externalId | SCIM external id |
employeeId | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber | Not used |
companyName | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization | Company |
department | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department | Not used |
manager | urn:ietf:params:scim:schemas:extension:enterprise:2.0:manager | Direct Manager |
“phoneNumbers[type eq "work"].value” and “phoneNumbers[type eq "mobile"].value” are arrays in SCIM and can hold multiple numbers. Learnster supports only one phone number per user. If an array with more than one number is provided by SCIM, Learnster will use the first number in the array `phoneNumbers` array.
Azure Active Directory Group to Learnster Tag Mapping
Groups in Active Directory are mapped as Tags in Learnster. This means that if you choose to provision user groups in AD, these groups will be automatically created as tags in Learnster and groups members will be automatically tagged with the mapped group tag.
Azure Active Directory Group | urn:ietf:params:scim:schemas:core:2.0:Group | Learnster Tag |
displayName | displayName | Tag name (A numbered suffix is automatically added to the tag name if it already exists to avoid conflicts) |
objectId | externalId | SCIM external id |
members | members | Members (as users in Learnster) are automatically tagged with the tag |
Teams in Learnster
Since urn:ietf:params:scim:schemas:core:2.0:Group is mapped to Tags in Learnster (see above) there is currently no support for setting up Teams in Learnster via SCIM.
You can instead send in one (or many) tag(s) using SCIM and use Automation rules to assign the correct team!