How to translate custom security questions using language resource files

How to translate custom security questions using language resource files

Objective

This article explains how to translate custom security questions in ADSelfService Plus by manually updating the appropriate language resource file.

In some cases, if the product language is set to a non-English language, adding a custom security question through the GUI may result in an error. To avoid this, you can manually add the translated questions to the appropriate language resource file in the installation directory. This ensures your custom questions display correctly for end users in the chosen language.

Prerequisites 

  • Administrative access to the ADSelfService Plus portal
  • Access to the ADSelfService Plus installation directory on the server

Steps to follow 

Step 1: Locate the language resource file  
  1. Navigate to the language resource directory. This is typically located at C:\ManageEngine\ADSelfService Plus\resources\adssp.
  2. Identify the correct language file for your configured ADSelfService Plus language. The file will be named ApplicationResources_xx_XX.properties, where xx_XX is the language code.
Refer to the table below for the language codes:
Language code
Corresponding language
ar_EG
Arabic
zh_CN
Chinese (Simplified)
da_DK
Danish
nl_NL
Dutch
en_GB
British English
en_US
American English
fi_FI
Finnish
fr_CA
Canadian French
fr_FR
French
de_DE
German
iw_IL
Hebrew
it_IT
Italian
ja_JP
Japanese
ko_KR
Korean
nb_NO
Norwegian
pl_PL
Polish
pt_BR
Brazilian Portuguese
ru_RU
Russian
es_MX
Spanish
sv_SE
Swedish
tr_TR
Turkish
 
  1. Open the relevant file using a plain text editor (e.g., Notepad or Notepad++).
 
Step 2: Add custom translated questions to the resource file  
  1. For each custom security question you want to add, insert a new entry anywhere within the file. Each entry should follow this format:
adssp.custom.questionX=Unicode_Text
Where:
adssp.custom.questionX: This is a unique key name. Replace X with a sequential number (e.g., adssp.custom.question1, adssp.custom.question2, adssp.custom.question3, and so on).
Unicode_Text: This is the actual custom security question, translated into your desired language and converted into Unicode text format.
Example: If your custom question is "What is your favorite color?" in French, and its Unicode equivalent is "Quel est votre couleur préférée?", you might add: adssp.custom.question1=Quel est votre couleur préférée?
how-to-add-custom-translation-for-admin-questions-on-language-source-file-1
  1. Save the ApplicationResources_xx_XX.properties file.
 
Step 3: Restart ADSelfService Plus server  
  1. Restart the ADSelfService Plus server for the changes to take effect.
    • If running as a service, use services.msc to stop and start the service.
    • If running as an application, exit and relaunch it.
 
Step 4: Add the custom questions in the ADSelfService Plus portal  
  1. Log in to the ADSelfService Plus portal with administrator credentials.
  2. Navigate to Configuration > Self-Service > Multi-factor Authentication.
  3. Under Authenticators Setup, click Security Question & Answer.
  4. Click the Edit Questions button.
  5. In the pop-up window, enter the key name you used in the resource file (e.g., adssp.custom.question1).
  6. Click the + symbol to add the question.
  7. Click Save.

How to reach support           

If the issue persists, contact our support team here

                  New to ADSelfService Plus?