Map application attributes on the Provisioning page

Although Universal Directory (UD) maintains a single source of truth for attributes, you can define additional mappings in the Provisioning page of each provisioning-enabled app. Application-based attribute mapping provides these benefits:

  • Individual mapping – map a single attribute in its own window.
  • Support for fixed-list attributes – use a menu or list to map a fixed-list attribute.
  • A sample value appears automatically – when you view or make a change to a mapping, the value for the current user displays automatically in the Okta to app direction; the value for the first app user displays automatically in the app to Okta direction.
  • Warnings – warnings appear when required fields are not mapped.
  • Field sorting – required and mapped fields are shown above optional fields that are not mapped.
  1. In the Admin Console, go to ApplicationsApplications.
  2. Select an application in the application list.
  3. Click the Provisioning tab and select one of these options in the Settings list:
    • To App — Select To App to map attributes from Okta to the application.
    • To Okta — Select To Okta to map attributes from the application to Okta.
  1. Scroll down to the Attribute Mappings section.
  2. Optional. Click Show Unmapped Attributes to display unmapped attributes.
  3. Click the edit icon to add or modify attribute settings.
  4. In the Attribute value list, select one of these options:
    • Same value for all users — Enter a value that will be added into the text field of all users.
    • Map from Okta Profile — Select a field from the Okta profile to map to.
    • Expression — Use the Okta Expression Language to define the mapping. When defining mappings that use reference or enum data types, ensure that the evaluated values are within the sets defined by the assigned app. Application assignments fail when these values do not match. These are the available data types:
      • string — a chain of zero or more unicode characters (letters, digits, and/or punctuation marks)
      • number — floating-point decimal in Java's 64-bit Double format.
      • boolean — stores true, false, or null data values.
      • integer — whole numbers in 64-bit Java's Long format.
      • reference — strings whose values belong within a specific set, defined by the application.
      • array of string — sequential collection of strings.
      • array of number — sequential collection of numbers.
      • array of integer — sequential collection of integers.
      • array of reference — sequential collection of reference strings.
      • enum — Defines an enumerated list of values, and supports all data types except boolean. This is an Early Access feature. To enable it, please contact Okta Support.
  1. Select one of these options for Apply on:
    • Create — Select this option to apply mapping when the user profile is created.
    • Create and update — Select this option to apply mapping when the user profile is created or updated.
  1. Click Save.
  2. Optional. Click Force Sync to immediately apply new or updated mappings that you have saved.