Override a user name format

The username override feature overrides a previously selected Okta username format or app username format (different per app). When you implement username override, previously selected username formats no longer apply.

The following are recommendations for creating user names:

  • Construct an Okta user name by concatenating multiple imported attributes.
  • Create differently formatted user names using conditionals. For example
    • If attribute1 = A, then username should end in acme.com. Otherwise, username should end in acme-temp.com.
    • Example: john.doe@acme.com, john.doe@acme-temp.com
    • This is useful for distinguishing between different types of users (such as employees vs. contractors).
  • Construct app user names from attributes in various sources.
  • Enforce a max length by truncating.

Username override can also be used with Selective Attribute Push to continuously update app user names as user profile information changes. For example, if a user gets assigned to an app with a username of email, and that email subsequently changes, Okta can automatically update the app username to the new email. Prior to this enhancement, the user's app username had to be manually updated by unassigning and reassigning them to the app. This enhancement applies to all apps and is not limited to only apps with provisioning capabilities.

  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, directory, or identity provider and select Configure User mappings if a list appears.
  4. Select the App to Okta User tab.
  5. Click Override with mapping.
  6. Select an attribute or enter an expression to create the Okta username.
  7. Click Save Mappings and Apply updates now.