Skip to main content
All CollectionsSign In Solutions VMSAccount FeaturesHosts
What are the Azure AD SCIM mappings for Traction Guest?
What are the Azure AD SCIM mappings for Traction Guest?
Reg Gray avatar
Written by Reg Gray
Updated over a week ago

This knowledge article lists the user and group mappings for Azure AD to allow you to map your Azure AD users to Traction Guest as hosts. To learn more about the SCIM integration setup, click HERE.

The sections below cover the attributes and mappings that allow you to:

  • userPrincipalName to userName

    • This mapping is used to populate the username attribute on a host

    • Mapping type: Direct

    • Source attribute: userPrincipalName

    • Target attribute: userName

  • Switch([IsSoftDeleted], , "False", "True", "True", "False") to active

    • This mapping is used to populate the active attribute on a host

    • Mapping type: Expression

    • Expression: Switch([IsSoftDeleted], , "False", "True", "True", "False")

    • Target attribute: active

  • mail to emails[type eq "work"].value

    • This mapping is used to populate the email attribute on a host

    • Mapping type: Direct

    • Source attribute: mail

    • Target attribute: emails[type eq "work"].value

  • givenName to name.givenName

    • This mapping is used to populate the first_name attribute on a host

    • Mapping type: Direct

    • Source attribute: givenName

    • Target attribute: name.givenName

  • surname to name.familyName

    • This mapping is used to populate the last_name attribute on a host

    • Mapping type: Direct

    • Source attribute: surname

    • Target attribute: name.familyName

  • telephoneNumber to phoneNumbers[type eq "work"].value

    • This mapping is used to populate the alternate_mobile attribute on a host

    • Mapping type: Direct

    • Source attribute: telephoneNumber

    • Target attribute: phoneNumbers[type eq "work].value

  • mobile to phoneNumbers[type eq "mobile"].value

    • This mapping is used to populate the mobile attribute on a host

    • Mapping type: Direct

    • Source attribute: mobile

    • Target attribute: phoneNumbers[type eq "work"].value

  • otherMails to emails[type eq "other"].value

    • This mapping is used to populate the alternate_email attribute on a host

    • Mapping type: Expression

    • Expression: Item(Split(Coalesce([otherMails], ","), ","), 1)

    • Source attribute: otherMails

    • Target attribute: emails[type eq "other"].value

  • companyName to urn:ietf:params:scim:schemas:extension:2.0:User:organization

    • This mapping is used to populate the company attribute on a host

    • Mapping type: Direct

    • Source attribute: companyName

    • Target attribute: urn:ietf:params:scim:schemas:extension:2.0:User:organization

  • department to urn:ietf:params:scim:schemas:extension:2.0:User:department

    • This mapping is used to populate the department attribute on a host

    • Mapping type: Direct

    • Source attribute: department

    • Target attribute: urn:ietf:params:scim:schemas:extension:2.0:User:department

  • For all attributes, the “Apply this mapping” setting should be set to “Always”

  • For all attributes except userPrincipalName, the “Match objects using this attribute” setting should be set to “No”. Otherwise, it will be set to “Yes”

  • For all attributes except userPrincipalName, the "Matching precedence: setting will be set to 0. Otherwise, it will be set to 1

  • displayName to displayName

    • This mapping is used to populate the name attribute on a host group

    • Mapping type: Direct

    • Source attribute: displayName

    • Target attribute: displayName

    • Match objects using this attribute: Yes

    • Matching precedence: 1

    • Apply this mapping: Always

  • members to members

    • This mapping is used to populate the hosts of a host group

    • Mapping type: Direct

    • Source attribute: members

    • Target attribute: members

    • Match objects using this attribute: No

    • Matching precedence: 0

    • Apply this mapping: Always

Did this answer your question?