Map app attributes on the Provisioning page
Although Universal Directory (UD) maintains a single source of truth for attributes, you can define more mappings on 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 change a mapping, a sample value is displayed for the 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 aren't mapped.
- Field sorting: Required and mapped fields are shown above optional fields that aren't mapped.
- In the Admin Console, go to .
- Select an app from the list.
- 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 app.
- To Okta: Select To Okta to map attributes from the app to Okta.
- Scroll down to the Attribute Mappings section.
- Optional. Click Show Unmapped Attributes to display unmapped attributes.
- Click the edit icon beside an attribute to add or modify the attribute's settings.
- In the Attribute value list, select one of these options:
- Same value for all users: Enter the value to use for this attribute for 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. App assignments fail when these values don't match. The following data types are available:
- string: A chain of zero or more Unicode characters (letters, digits, and/or punctuation marks).
- number: A 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 app.
- array of string: A sequential collection of strings.
- array of number: A sequential collection of numbers.
- array of integer: A sequential collection of integers.
- array of reference: A 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.
- Select one of these options for Apply on:
- Create: Apply the mapping when the user profile is created.
- Create and update: Apply the mapping when the user profile is created or updated.
- Click Save.
- Optional. Click Force Sync to immediately apply new or updated mappings that you saved.