Skip to main content

Custom Attribute Mapping

WOX supports Custom Attribute Mapping, which is useful setting WOX specific data when provisioning users. A typical scenario is setting user's preferred location. We can obtain the location Id and ask SCIM to populate it for all new users.

Azure AD Custom Attributes

  1. Login Azure Admin Portal. Click Azure Active Directory > Enterprise applications > WOX (or app you created for WOX SCIM)

picture 1

  1. Click Provisioning > edit attribute mapping

    picture 3

  1. Click Mappings then select Provision Azure Active Directory Users

picture 4

  1. Select Show Advanced options, then Edit attribute list for customappsso

picture 7

  1. Enter the attribute name and type. For example, if we'd like to automatically set user's preferred location when creating user, we can add the attribute "urn:ietf:params:scim:schemas:extension:wox:attributes:1.0:User:homeLocationId" and select type "integer". Tip: Use "urn:ietf:params:scim:schemas:extension:wox:attributes:1.0:User" as External Namespace, and use WOX supported attributes as external name. Concat them using ":".

picture 10

  1. After adding the attribute, you can now map it from Azure AD. Click Add New Mapping,

picture 5

  1. Select target attribute such as "urn:ietf:params:scim:schemas:extension:wox:attributes:1.0:User:homeLocationId". Select source attribute or a Constant Value.
  • A source attribute mapping

picture 6

  • A constant value mapping

picture 9

  1. Click Save


To create custom attribute mapping in Okta, login Okta as administrator.

  1. Navigate to Applications > Applications > WOX. Click Provisioning tab, then click Go to Profile Editor

picture 13

  1. Click Add attribute to add new custom attribute:

picture 12

  1. Enter attribute details. Use "urn:ietf:params:scim:schemas:extension:wox:attributes:1.0:User" as External Namespace, and use WOX supported attributes as external Name.

picture 11

  1. After creating attribute, click Mappings to edit mapping.

picture 14

Select Okta User to WOX. Set source attribute or enter an expression.

picture 15

Available WOX Attributes


All WOX custom attributes uses namespace "urn:ietf:params:scim:schemas:extension:wox:attributes:1.0:User". Supported attributes are:

  • gender (string)
  • birthday (string)
  • jobNumber (string)
  • isVip (boolean)
  • isFirstAid (boolean)
  • isFireWarden (boolean)
  • homeLocationId (integer)