Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel3

...

The Identity Provider software contains by default US English messages.properties file(s) that contain the strings to render messages in the various views included in the software. In addition, the built-in attribute registry rules define names and descriptions of many standardized Attributes.

Many deployers may want to present these pages this information in the local language(s) or customize/localize some strings. To translate or adapt the IdP messages and thus support multiple languages, the IdP supports translations of the corresponding properties message files. The servlet container will then automatically select a matching properties message file based on the client's Accept-Languages header as provided by the web browser. All of these messages used to be packaged into a single file, system/messages/messages.properties. Since version 4.2 they are inside the system.The attribute metadata is, by contrast, directly embedded in the various default rule files we include.

A new Git repository, java-idp-translations, has been created as the authoritative source of all of the internationalizable information for all our software products. We are willing to offer commit access to that repository to anybody willing to maintain translation(s) into any languages. Access is by public key and you can contact us at the usual places to express interest.

Within the repository, each software product is represented by a folder tree with a subdirectory for each major release version:

https://git.shibboleth.net/view/?p=java-idp-translations.git;a=tree

For example, the IdP is laid out thusly right now:

  • java-identity-provider/

    • 5/

      • messages/

      • attributes/

At the time of each release, we will incorporate any translation updates provided (copying the changed files into the actual software projects).

Notably, while message translations can generally be added to existing installs automatically during upgrades, as they’re internal, changes to attribute metadata require deployer action, as those files are created alongside the “existing” files.

Messages

As of modern IdP versions, the default message files for the IdP and its plugins are embedded inside each software project’s library jars. Any translations we obtain are also embedded in the software. In all cases, these messages can be overridden via files placed in the messages directory after installation.

The existing set of messages for various release branches can be found here:

To e.g. create a German translation of the IdP's error messages strings, copy the default (US English) messages file, to a file named messages_de.properties (see also error messages configuration) and translate/adapt the strings in the new properties file. For example, translate the string idp.title.suffix = Error to idp.title.suffix = Fehler

...

2022-11-23: Minor update applied to all files below for IdPv4.2. Filename changed for idp.logo property from dummylogo.png to placeholder-logo.png.

Language Code

Language

File Download

Last Update

cs

Czech

messages_cs.properties

2020-02-13

de

German

messages_de.properties

2020-02-13

de_CH

German (Switzerland)

messages_de_CH.properties

2020-02-13

el

Greek

messages_el.properties

2022-07-12

es

Spanish

messages_es.properties

2018-10-25

es_ES

Spanish (Spain)

messages_es_ES.properties

2018-11-01

fr

French

messages_fr.properties

2021-05-26

it

Italian

messages_it.properties

2023-03-14

ja

Japanese

messages_ja.properties

2020-02-12

nl

Dutch

messages_nl.properties

2020-02-13

pl

Polish

messages_pl.properties

2021-05-26

tr

Turkish

messages_tr.properties

2021-05-26

zh_CN

Chinese, Simplified

messages_zh_CN.properties

2020-02-14

Anchor
contribute
contribute
Contribute to the Translation Project 

...