This knowledge article lists the Okta attributes and mappings that you need to provision hosts to Traction Guest via SCIM. For more information on how you can integrate SCIM with your account, click HERE.
This knowledge article covers:
Okta Attributes and Mappings for Traction Guest
First name
Display name: Given name
Variable name:
givenNameExternal name:
name.givenNameExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: Yes
Last name
Display name: Family name
Variable name:
familyNameExternal name:
name.familyNameExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: Yes
Primary email
Display name: Primary email
Variable name:
emailExternal name:
emails.^[primary==true].valueExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: Yes
Primary email type
Display name: Primary email type
Variable name:
primaryEmailTypeExternal name:
emails.^[primary==true].typeExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: No
Secondary email
Display name: Secondary email
Variable name:
secondEmailExternal name:
emails.^[primary==false].valueExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: No
Secondary email type
Display name: Secondary email type
Variable name:
secondaryEmailTypeExternal name:
emails.^[primary==false].typeExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: No
Primary phone
Display name: Primary phone
Variable name:
primaryPhoneExternal name:
phoneNumbers.^[primary==true].valueExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: No
Primary phone type
Display name: Primary phone type
Variable name:
primaryPhoneTypeExternal name:
phoneNumbers.^[primary==true].typeExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: No
Secondary phone
Display name: Secondary phone
Variable name:
mobilePhoneExternal name:
phoneNumbers.^[primary==false].valueExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: No
Secondary phone type
Display name: Secondary phone type
Variable name:
secondaryPhoneTypeExternal name:
phoneNumbers.^[primary==false].typeExternal namespace:
urn:ietf:params:scim:schemas:core:2.0:UserAttribute required: No
Organization
Display name: Organization
Variable name:
organizationExternal name:
organizaitonExternal namespace:
urn:ietf:params:scim:schemas:extension:enterprise:2.0:UserAttribute required: No
Department
Display name: Department
Variable name:
departmentExternal name:
departmentExternal namespace:
urn:ietf:params:scim:schemas:extension:enterprise:2.0:UserAttribute required: No
For mappings, there are two types:
Okta User to Your SCIM App
Your SCIM App to Okta User
Both are needed.
First name
Your SCIM App to Okta User
appuser.givenNametofirstNameApply mapping on user create only
Okta User to Your SCIM App
user.firstNametogivenNameApply mapping on user create and update
Last name
Your SCIM App to Okta User
appuser.familyNametolastNameApply mapping on user create only
Okta User to Your SCIM App
user.lastNametofamilyNameApply mapping on user create and update
Primary email
Your SCIM App to Okta User
appuser.emailtoemailApply mapping on user create only
Okta User to Your SCIM App
user.emailtoemailApply mapping on user create and update
Primary email type
Your SCIM App to Okta User
N/A
Okta User to Your SCIM App
(user.email != null && user.email != '') ? 'work' : ''toprimaryEmailTypeApply mapping on user create and update
Secondary email
Your SCIM App to Okta User
appuser.secondEmailtosecondEmailApply mapping on user create only
Okta User to Your SCIM App
user.secondEmailtosecondEmailApply mapping on user create and update
Secondary email type
Your SCIM App to Okta User
N/A
Okta User to Your SCIM App
(user.secondEmail != null && user.secondEmail != '') ? 'other' : ''tosecondaryEmailTypeApply mapping on user create and update
Primary phone
Your SCIM App to Okta User
appuser.primaryPhonetoprimaryPhoneApply mapping on user create only
Okta User to Your SCIM App
user.primaryPhonetoprimaryPhoneApply mapping on user create and update
Primary phone type
Your SCIM App to Okta User
N/A
Okta User to Your SCIM App
(user.primaryPhone != null && user.primaryPhone != '') ? 'work' : ''toprimaryPhoneTypeApply mapping on user create and update
Secondary phone
Your SCIM App to Okta User
appuser.mobilePhonetomobilePhoneApply mapping on user create only
Okta User to Your SCIM App
user.mobilePhonetomobilePhoneApply mapping on user create and update
Secondary phone type
Your SCIM App to Okta User
N/A
Okta User to Your SCIM App
(user.mobilePhone != null && user.mobilePhone != '') ? 'mobile' : ''tosecondaryPhoneTypeApply mapping on user create and update
Organization
Your SCIM App to Okta User
appuser.organizationtoorganizationApply mapping on user create only
Okta User to Your SCIM App
user.organizationtoorganizationApply mapping on user create and update
Department
Your SCIM App to Okta User
appuser.departmenttodepartmentApply mapping on user create only
Okta User to Your SCIM App
user.departmenttodepartmentApply mapping on user create and update
Note that there will be a default set of mappings, with many attributes that are not included in the above lists. While they do not have any effect on requests, as they are ignored by the server, they should be deleted.