This documentation supports the 20.08 version of Remedy Single Sign-On, which is available only to BMC Helix subscribers (SaaS).

To view an earlier version, select the version from the Product version menu.

Transforming User ID to match Login ID

During the login procedure, Remedy Single Sign-On checks that the login ID provided by an end user matches the userID available in the user store of an identity provider (IdP). In many use cases, the login ID and the userID do not match, and end users cannot login by using their login credentials. 

In such cases, transform the userID as required for an authentication method by specifying a userID transformation type.
Suppose you have a user name coming from the identity provider response and a user name specified in the Remedy AR System is CustomUserName. To configure the authentication method for end users' login, you need to transform the userID to remove the domain from the userID.

You might also need to transform a userID when you integrate Remedy SSO with BMC applications, set up an authentication method, and then change the original authentication method. The new authentication method might not provide the same userID format that was available with the original method, and you need to specify a userID transformation type for this authentication type.   


The user ID transformation options are supported for all authentication types except "Local".

To transform the userID to match the login ID

  1. In the User ID Transformation field, specify a required transformation type.

The following table lists the userID transformation options available in the UserID Transformations list:



Displays the entered userID without any transformation.

RemoveBMCDomainDisplays the userID without the suffix.

Displays the userID without the prefix <domain>.

Example: companyname\userid is transformed to userID.

RemoveEMailDomainDisplays userID without the suffix@<anyemaildomain>.

Displays userID after converting it to lower case.

Example: UserID is transformed to userid.


Displays userID after converting it to upper case.

Example: userid is transformed to USERID.

In addition to the options provided by Remedy SSO, you can create and deploy custom transformation types, see Creating User ID custom transformation types.

To specify a custom userID to match the login ID

  1. In the left navigation panel of the Add Realm or Edit Realm page, click Authentication.
  2. In the Custom Expression field, specify your value in the following format "userId + {value}".
    For example, by using the #userId + "" expression, you construct
  3. Click Save.

You can specify a custom userID ин using the predefined string functions. The list of Java string functions and their description is displayed in the following table:

strip()Returns a string whose value is this string, with all leading and trailing white space removed.
substring(int beginIndex)Returns a string that is a substring of this string. The substring begins with the character at the specified index and extends to the end of this string.
substring(int beginIndex, int endIndex)Returns a string that is a substring of this string. The substring begins at the specified beginIndex and extends to the character at index endIndex - 1.
toLowerCase()Converts all of the characters in this String to lower case.
toUpperCase()Converts all of the characters in this String to upper case.
split(String regex)Splits this string around matches of the given regular expression.
replace(String target, String replacement)Returns a string resulting from replacing all occurrences of target in this string with replacement.

The following table represents examples of using string functions.

ExpressionCurrent valueTransformed value
#userId.replace("", "")
#userid.substring(4, 9) + #userid.substring(0, 4)user1234512345user

Was this page helpful? Yes No Submitting... Thank you