When creating a custom System for Cross-domain Identity Management (SCIM) integration, the target SCIM server might require a specific username convention, such as all lowercase characters or a specific domain suffix, that differs from the default Okta username format. Modify the application username format using Okta Expression Language (OEL) to meet these unique conditions.

• System for Cross-domain Identity Management (SCIM)
• Custom Integrations
• Okta Classic Engine
• Okta Identity Engine (OIE)

The default username format for SCIM integrations is to use the Okta Username. Depending on the SCIM server, the Okta username may not match the username that the provisioned users need to use.

The username format can be updated to satisfy specific requirements by modifying the Application username format in the Credentials Details section on the application Sign On tab. There are preset options for common scenarios, but for requirements outside those options, create a custom username format using Okta Expression Language (OEL).

For example, if a user's Okta username contains capitalized characters and the SCIM server is case-sensitive, set the format to Custom and use an expression to convert the username to lowercase to meet this requirement. The following example demonstrates this scenario using an OEL function:

1. Navigate to the application Sign On tab.
2. Locate the Credentials Details section and set the application username format to Custom.
3. Enter the required OEL expression.

4. Save the configuration.
5. Select Update now to apply the changes to existing users.