Override a username 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.
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, an Okta 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.
The following are recommendations for creating usernames:
- 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: firstname.lastname@example.org, email@example.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.
- In the Admin Console, go to Directory > Profile Editor.
- Select Mappings for the app, directory, or IDP.
- Choose the mapping direction App to Okta.
- Click Override with mapping.
- Select an attribute or enter an expression to create the Okta username.
- Click Save Mappings and Apply updates now.