Use of translation parameter on HTTP authenticator

This document is written for PhenixID Server.

This document describes how the parameter 'translation' can be used on authenticators.

The reader should have some basic knowledge about PhenixID Server.

Make sure to have a backup of the files being edited.

Description

The parameter 'translation' can be used on authenticators, to add customized text to login templates.

This document will show an example of how this can be done.

Templates are located in:
<PhenixIDinstallationdirectory>/mods/com.phenixidentity~auth-http~<version>/templates

Language files are located in:
<PhenixIDinstallationdirectory>/mods/com.phenixidentity~auth-http~<version>/web/res/lang

Make sure to have a backup of the files being edited.

Configuration

Login to the Configuration portal, click the tab 'Advanced', click on the pencil next to 'Authentication - HTTP' and find the authenticator that should have customized text. Add the parameter 'translation' according to the example below.

{
    "alias" : "238160c4-7fdf-42e4-8705-26f5911792bc",
    "name" : "PostUidAndPassword",
    "configuration" : {
      "pipeID" : "2a1537c4-e537-49b5-9e5b-921c053e7c0b",
      "successURL" : "/selfservice/",
      "translationKey" : "login.messages.information.body.enduser",
      "headingtranslationKey" : "login.messages.information.header.enduser",
      "title" : "login.messages.information.title.enduser",
      "allowLanguageChange" : "true",
      "translation" : [
                "SelfServiceLogin",
                "MFALogin"
        ]
    }
  }

Click Stage Changes and Commit Changes.

We can now use the value 'SelfServiceLogin', in the templates. For this example we will use login.template.

Add the value accordingly:

<div class="col-xs-6 col-md-6">
    <div id="signin-wrapper">
        {{#login.messages.generalerror}}
            <div class="alert alert-danger">
                {{login.messages.generalerror}}
            </div>
        {{/login.messages.generalerror}}
	{{SelfServiceLogin}}
        <input class="form-control" id="username" placeholder="{{login.messages.username}}" required="" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false" name="username" type="text">
        <input class="form-control" placeholder="{{login.messages.password}}" autocomplete="off" required="" name="password" type="password">
        <input class="form-control securitycode" placeholder="Security code" autocomplete="off" name="securitycode" type="input">
        {{#enable_ot}}
            <div class="form-group">
                <div class="checkbox">

When this is done we can add our customized text to the desired language file (strings.xml):

<!-- User name & password template general -->
    <string name="SelfServiceLogin">Enter username and password to login.</string>
    <string name="login.messages.heading">Please sign in</string>
    <string name="login.messages.username">Username</string>
    <string name="login.messages.password">Password</string>
    <string name="login.messages.signin">Sign in</string>

Changes in the language files require a restart of the service.

The result after the changes should look like this: