Map Okta attributes to app attributes in the Profile Editor

Map Okta attributes to app attributes to make Okta the single source of truth for user data or the recipient of user data.

App integrations that use entitlement management use discovery to automatically map attributes between Okta and the downstream app. Admins can't map attributes for these integrations.

  1. In the Admin Console, go to DirectoryProfile Editor.
  2. Optional. Select Okta, Apps, Directories, or Identity Providers in the Filters list to filter the list of apps.
  3. Click Mappings for the app and select Configure User mappings if a list appears.
  4. Select one of the following tabs in the User Profile Mappings dialog box:
    • App to Okta User: Select this tab to map attributes from the app to Okta. The app contains the source attributes and Okta is the target.
    • Okta User to App: Select this tab to map the flow of attributes from Okta to the app. Okta contains the source attributes and the app is the target.
  5. Follow these steps to map attributes in the Profile Editor:
    1. Scroll down through the attribute mappings.
    2. Make sure that the required attributes are mapped. The Okta or app user profile indicates which are required.
    3. Use the dropdown menu to add attributes, or use expressions to add attributes with concatenated or transformed values. For more information about expressions, see Modify attributes with expressions.
  6. Optional. Click to set the push frequency for the attribute. See Profile Push.
  7. Optional. Click Preview to check your mappings.

    The results are color-coded to make issue identification easier. Green indicates a valid mapping or a valid mapping without a value. Red indicates an invalid mapping and an error message is provided to help you resolve the issue. If the column is empty, there's no mapping for the attribute.

  8. Click Save Mappings and Apply updates now.