Custom Application username Creation Skip to main content
https://support.okta.com/help/answers?id=906f0000000xzgoiao&refurl=http%3a%2f%2fsupport.okta.com%2fhelp%2fanswers
How satisfied are you with the Okta Help Center?
Thank you for your feedback!
How satisfied are you with the Okta Help Center?
1
2
3
4
5
Very Dissatisfied
Very satisfied
Enter content less than 200 characters.
Ask Search:
Michael OakesMichael Oakes 

Custom Application username Creation

Hi All,  I'm logging this as a feature request just wondering if anyone else had tried.

We have an internal application where I'm trying to customise the username to use our EmployeeNumber field from AD.

The synch from AD into the Okta profile is working and the EmployeeNumnber is listed in the Okta profile but when I try to create a custom username and reference the "employeeNumber" it can't find it.

Seems the only attributes a custom username can use are the defaults they list??  can anyone confirm this ??

Cheers

 
Best Answer chosen by Michael Oakes
Kevin TurnerKevin Turner (Okta, Inc.)
Yes this is possible if you override the application username value in the profile editor (in UD). Go to Directory, Profile Editor, select you application, and then select Map Attributes. Make sure your on the tab that is mapping attribute values from "Okta to your application". Here you will see the option to override the application username value.

Select this and map something like user.EmployeeNumber. You can then preview this lower down by selecting a user that has the EmployeeNumber already set, to make sure the value is going to be used correctly. Once confirmed select "Save mapping" and "Confirm Mapping".

On the application sign-on tab where you would normally select a username value to use, just type in some static text like "Mapped from UD" so you know how the application username got set.

And lastly, if you've already associated this application with one or more users, you'll need to unassign the application and then re-assign the application to make use of the custom application username now mapped.
 

All Answers

Raja NejemRaja Nejem (Okta, Inc.)
You can select 'AD Employee ID' from the drop down for the username format.
Michael OakesMichael Oakes
Thanks Raja,
The issue is within our Okta Profile & AD attributes we have "EmployeeNumber" not Employee ID.
Is there a way to add Employee number or have our AD Employee Number filed transfer to Employee ID somehow ?

cheers
Kevin TurnerKevin Turner (Okta, Inc.)
Yes this is possible if you override the application username value in the profile editor (in UD). Go to Directory, Profile Editor, select you application, and then select Map Attributes. Make sure your on the tab that is mapping attribute values from "Okta to your application". Here you will see the option to override the application username value.

Select this and map something like user.EmployeeNumber. You can then preview this lower down by selecting a user that has the EmployeeNumber already set, to make sure the value is going to be used correctly. Once confirmed select "Save mapping" and "Confirm Mapping".

On the application sign-on tab where you would normally select a username value to use, just type in some static text like "Mapped from UD" so you know how the application username got set.

And lastly, if you've already associated this application with one or more users, you'll need to unassign the application and then re-assign the application to make use of the custom application username now mapped.
 
This was selected as the best answer
Michael OakesMichael Oakes
brilliant - thanks and for anyone else if you want to edit the filed further youcan remove the first two characters using this...substring(user.employeeNumber, 2, 10)..eg - XX123456 becomes 123456
Randy HongRandy Hong
I am having a challenge here:  Our AD supports both three and four digit ID: say 4321 or 123 (for anyone less than 999, they use three digit ID).  OKTA is synced with our AD.  So, we some employees with four-digit and some with three-digit IDs. However, Our HR system Ultipro only supports 4 digit ID, so, for those with three-digit ID (say, 123), we make set them up 0123 as their ID in Ultipro system:
For those who have four-digit ID, we can setup SSO for Ultipro without a problem
For those who have four-digit ID, we have a problem since the ID (say 123) can't auto change to 4-digit in Ultipro
 So, the question is:  How I can add that extra 0 to the three-digit ID (123) to become 0123
Any help or suggestion is appreciatted.  

--Randy