How to log into a SAML application with a different username than the user's Idira username

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
Announcements

Welcome Idira to LIVEcommunity!

Our community just got stronger! Explore new identity security resources, connect with experts, and discover more ways to learn and collaborate.

Meet Idira

Workforce Identity Articles
3 min read
L4 Transporter
No ratings
In some situations, a web application may require a different username than the username used to log into Idira Identity with. By default, the SAML application templates in Idira Identity will use either the user’s userprincipalname or email address as the username for logins. This article will go through several methods in Idira Identity for configuring an alternate username.
 

Steps

Method 1: Configuring User > Application Settings

  1. In the Admin Portal, go to Core Services > Users, then click the user you want to configure. Go to Application Settings and click on Add.

ka3Vy00000979RBIAY__eid=ka3Vy00000979RB&feoid=00N2J000009R3kv&refid=0EM2J000003Ycv7.png

  1. Select the web application that you want to use an alternate username for and click Save.
  2. Enter alternate username into the User Name field and click OK.

ka3Vy00000979RBIAY__eid=ka3Vy00000979RB&feoid=00N2J000009R3kv&refid=0EM2J000003Ycv8.png

You will notice the User Name for the selected web application is different than the user’s Idira username.
ka3Vy00000979RBIAY__eid=ka3Vy00000979RB&feoid=00N2J000009R3kv&refid=0EM2J000003Ycv9.png

This method can also be used to enter a predefined password unique to the end user, for non-SAML applications that uses a password for authentication.
 

Method 2: Using a username stored in Additional Attributes

Custom attributes can be created in Idira Identity by going to Settings > Customization > Additional Attributes and click Add.
ka3Vy00000979RBIAY__eid=ka3Vy00000979RB&feoid=00N2J000009R3kv&refid=0EM2J000003YcvA.png

The name must contain an underscore. Select Text for Type. Optionally select User Editable. User Editable enables the user to populate or edit this value through the User Portal > Account > Personal Profile > Additional Attributes. Click Add.
ka3Vy00000979RBIAY__eid=ka3Vy00000979RB&feoid=00N2J000009R3kv&refid=0EM2J000003YcvB.png
 

  1. To select the Additional Attribute value as a username, go to the Account Mapping section for the web application that will use an alternate username. Select Account Mapping Script.ka3Vy00000979RBIAY__eid=ka3Vy00000979RB&feoid=00N2J000009R3kv&refid=0EM2J000003YcvC.png
  2. In the script field enter: LoginUser.Username = LoginUser.Get("name of the Additional Attribute");


For example, if the Additional Attribute field name is “Alt_username” then enter: LoginUser.Username = LoginUser.Get("Alt_username");
 

  1. Click Save.


There are 2 advantages for using Additional Attributes instead of user’s Application Settings.
1. Additional Attributes are included in the Bulk import csv and

2. Additional Attributes can optionally be editable by the end user.
 

Method 3: Customizing the username with Account Mapping Script

The Account Mapping Script field can also be used to username modifications for different use cases. Below are some common examples.

/* ==== Example #1: Append a different login domain to shortname. ====
In this example, the user's AD and email domain is different than the domain used in the username.

LoginUser.Username = LoginUser.Shortname +"@differentdomain.com"

==== Example #2: Prepend the domain name to the username =====
In this example, the desired username format is domain-name\username. (For example: CYBR\john)

LoginUser.Username = "domain\\" + LoginUser.Shortname;

==== Example #3: Shortname vs samaccountname =====
If you selected Directory Service Field and entered samaccountname into the field, it would work for AD users but not for Idira Directory users. The following script for Shortname will work for both AD and Idira Directory users. This script is probably the most commonly used.

LoginUser.Username = LoginUser.Shortname;
 

Rate this article:
  • 1709 Views
  • 0 comments
  • 0 Likes
Article Dashboard
Version history
Last Updated:
‎11-05-2026 11:47 AM
Updated by: