Skip to content

Translation

The CEP selects translations based on users' preferred language settings. If the preferred language is not configured, the CEP will choose the next available language matching the user's preferred language. If none of the preferred languages is available, the CEP will fallback to the translation configured with the parameter CEP_DEFAULT_LANGUAGE.

All translation phrases of the CEP can be modified.

By utilizing the XLIFF standard, you can leverage different editors to make edits to the translation files. If you want to modify specific phrases, you can perform partial modifications for each message, overwriting only the desired phrase. Additionally, if you prefer to work on a separate file, you can make a copy of the original translation file and apply all the necessary modifications to it. This flexibility allows you to have fine-grained control over the translation process.

Some translation phrases in the CEP include placeholders that are replaced with environment-related authentication method names. These placeholders can be used in any translation phrase. Additionally, there are special placeholders available in certain translation phrases. These special placeholders allow the configuration of specific device names without altering the translation phrase itself. This provides a convenient way to customize device names with the parameter CEP_DEVICE_NAMES without modifying the original translation phrase.

You can also use the translation phrases editor to make modifications to the translation phrases. We highly recommend using the interface instead of making manual modifications to the XLIFF files.

Authentication Method Names From Advanced Authentication
%method_name_ldap%
%method_name_hotp%
%method_name_totp%
%method_name_bt%
%method_name_card%
%method_name_email%
%method_name_epassword%
%method_name_epassword_l%
%method_name_password%
%method_name_finger%
%method_name_flexotp%
%method_name_oauth%
%method_name_secquest%
%method_name_secquest_l%
%method_name_smartphone%
%method_name_u2f%
%method_name_sms%
%method_name_voice%
%method_name_fido2%
%method_name_webauth%
%method_name_winhello%
Device Names
%totp_token_name%
%totp_token_name_p%
%hotp_token_name%
%hotp_token_name_p%
%smartphone_device_name%
%smartphone_device_name_p%
%u2f_token_name%
%u2f_token_name_p%
%fido2_token_name%
%fido2_token_name_p%
Copy original translation from the running container
docker cp cep:/var/www/html/translations/base/messages.de.xlf messages.de.xlf
docker cp cep:/var/www/html/translations/base/messages.en.xlf messages.en.xlf
docker-compose.yml
version: "3.5"
services:
  cep:
    image: registry.example.com/aaf/MY-cep:latest
    container_name: cep
    volumes:
      - aaf_webd-config:/etc/nginx/certs:ro
      - ${PWD}/custom-translation:/var/www/html/translations/custom
    restart: unless-stopped
    ports:
      - "8443:443"
    env_file:
      - language.env
      - base.env
volumes:
 aaf_webd-config:
   external: true
language.env
CEP_ENABLED_LANGUAGES=["en", "de", "fr", "es"]
CEP_DEFAULT_LANGUAGE=en
Example of partial translation: custom-translation/messages.en.xlf
<?xml version="1.0" encoding="utf-8"?>
<xliff xmlns="urn:oasis:names:tc:xliff:document:1.2" version="1.2">
  <file source-language="en" target-language="en" datatype="plaintext">
    <body>
        <trans-unit id="6Zl_y9H" resname="controller.login.index.title">
            <source>controller.login.index.title</source>
            <target>Authenticator Enrollment Portal</target>
        </trans-unit>
        <trans-unit id=".CQbuzv" resname="controller.enroll.pin.description">
            <source>controller.enroll.pin.description</source>
            <target><![CDATA[<p>The %method_name_password% method is a password that is not connected to your corporate directory. This can be a %method_name_password% or a simple password but must be at least %len% characters. This %method_name_password% is separate from any RSA PIN.</p>]]></target>
        </trans-unit>
    </body>
  </file>
</xliff>
Example of partial translation: custom-translation/messages.de.xlf
<?xml version="1.0" encoding="utf-8"?>
<xliff xmlns="urn:oasis:names:tc:xliff:document:1.2" version="1.2">
  <file source-language="en" target-language="en" datatype="plaintext">
    <body>
        <trans-unit id="6Zl_y9H" resname="controller.login.index.title">
            <source>controller.login.index.title</source>
            <target>Authenticator Enrollment Portal</target>
        </trans-unit>
        <trans-unit id=".CQbuzv" resname="controller.enroll.pin.description">
            <source>controller.enroll.pin.description</source>
            <target state="translated"><![CDATA[<p>Diese %method_name_password% ist nicht mit Ihrem Verzeichnispasswort verknüpft. Die %method_name_password% kann ein simples Kennwort sein, welches aber aus mindestens %len% Zeichen bestehen muss.</p>]]></target>
        </trans-unit>
    </body>
  </file>
</xliff>