Converting Okta Usernames To Lowercase For Application Assignment
Last Updated:
Overview
Okta administrators can convert usernames to lowercase during application assignment by using the Okta Expression Language to define a custom application username format. This configuration resolves authentication failures for applications that require case-sensitive usernames or for applications where Active Directory (AD) usernames are inconsistent.
Applies To
- Okta Identity Engine (OIE)
- Okta Classic Engine
- Application Assignment
- Okta Expression Language
- Organizations with applications that require case-sensitive usernames
- Organizations with inconsistent AD usernames
Solution
Follow the steps or video below.
How does an administrator convert Okta usernames to lowercase for application assignment?
Configure the application sign-on settings to use a custom Okta Expression Language formula that converts the username to lowercase.
- Navigate to the desired application in the Okta Admin Console.
- Select the Sign On tab.
- Set the Application username format to Custom.
- Enter the following Okta Expression Language formula in the custom expression field:
String.toLowerCase(user.login)
By using the Okta Expression Language and the String.toLowerCase(user.login) expression, Okta automatically converts the username to lowercase characters when an administrator assigns a user to the application. This ensures the application meets case-sensitive requirements, even when the organization has inconsistent AD usernames.
