Customizing non-UI-related text elements in the Loginapp REST API

• There are two kinds of text elements, one is used by the Loginapp REST API and one by the UI:
• Text elements displayed in the browser: see Customizing Loginapp REST UI texts and changing translations with the UI SDK
• Text elements used in the IAM server (e.g. to render email or SMS messages). This article is about these types of text elements.

To customize text elements, a set of empty language property files can be either created for all or for specific instances. Text elements in these language property files are used for non-UI-related texts (such as email, SMS, or Cronto texts that are not shown in the browser, etc.).

• Create empty property files:
• For all instances:
  Create the files strings_de.properties, strings_en.properties (and so on) in the directory ./instances/common/loginapp-texts/
• For one specific instance:
  Create the files strings_de.properties, strings_en.properties (and so on) to directory ./instances/<instance-name>/loginapp-texts/

After creating empty language property files, copy the required template texts from the original strings_*.properties files. Use resource keys (i.e. authentication.email.otp.subject) including the template text.

Do not make changes to the original strings_*.properties file, i.e. do not make any changes to the original template files as these files will be overwritten without notice during updating and installation procedures.

0. Copy texts from the original template files:
1. In the IAM installation folder, go to:
   app/loginapp/WEB-INF/classes/
2. Use a text editor to open the corresponding language file, e.g. strings_en.properties to customize English texts.
3. Find and copy the desired existing element by searching for its key (e.g. public-self-service.email.otp.body)
4. Paste the copied line into the corresponding empty string-property file and adapt the copied wording as required.
5. The changes are applied automatically after 30 seconds.

0. Adding new languages requires:
1. Adding a new string_*.properties with the 2-letter country code.
2. Adding the new language in the Config Editor under Loginapp >> Language Settings in the list of Valid Languages.

Note that depending on the used feature set, there may be other points in the configuration where the new language must be added (e.g. language choice in user registration self-service or user management in the Adminapp).

• Changing text elements
• Loginapp REST UI text changes: Customizing Loginapp REST UI texts and changing translations with the UI SDK