Overview

The Identity Provider software contains by default US English messages.properties file(s) that contain the strings to render messages in the:

login page
user consent/terms of use page
error pages

Many deployers of the IdPv3 may want to present these pages 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 files. The servlet container will then automatically select a matching properties file based on the client's Accept-Languages header as provided by the web browser.

As of V3.3, all of these messages are packaged into a single file, system/messages/messages.properties, in V3.2 the messages were in the following three files: messages/authn-messages.properties, messages/consent-messages.properties, messages/error-messages.properties

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

The IdP will select the correct language file based on the locale of the browser without additional configuration. Note that Spring (and by extension the IdP) does not support a precedence of languages to fall back to, so the support for full i18n is constrained by that limitation.

In addition to the default use of the filenames noted above, you can freely change the message files used in conf/services.xml if you prefer that.

Translated Message Properties

These are the already completely translated versions of the messages.properties files available for download. All translations were provided by volunteers from the community. They are listed in the Translation Credits. See Contribute to the Translation Project below how you can contribute yourself.

General Installation Instructions

Download the languages your IdP should support
Copy them into the shibboleth-idp/messages directory. A software upgrade will not touch them, but you will have to manually fetch new versions as they become available.
Best watch this page (login and click on "Watch") to get informed on changes.

You should also consider merging your own customization, such as idp.logo and idp.logo.alt-text.

Important: No deployer should use the text provided for example-tou-1.text as is. You need to replace that text with one that fits your local legal framework.

Identity Provider 3.4

Language Code	Language	File Download	Last Update
de	German	messages_de.properties	2018-10-25
de_CH	German (Switzerland)	messages_de_CH.properties	2018-10-25
es	Spanish	messages_es.properties	2018-10-25
es_ES	Spanish (Spain)	messages_es_ES.properties	2018-11-01
fr	French	messages_fr.properties	2020-02-12
it	Italian	messages_it.properties	2018-11-01
ja	Japanese	messages_ja.properties	2020-02-12
nl	Dutch	messages_nl.properties	2018-10-25
pl	Polish	messages_pl.properties	2020-02-12
zh_CN	Chinese, Simplified	messages_zh_CN.properties	2020-02-12

Identity Provider 3.3

Language Code	Language	File Download
cs	Czech	messages_cs.properties
de	German	messages_de.properties
de_CH	German (Switzerland)	messages_de_CH.properties
el	Greek	messages_el.properties
es	Spanish	messages_es.properties
fr	French	messages_fr.properties
it	Italian	messages_it.properties
ja	Japanese	messages_ja.properties
nl	Dutch	messages_nl.properties
pl	Polish	messages_pl.properties

Identity Provider 3.2

Language Code	Language	File Download	File Download	File Download
cs	Czech	authn-messages_cs.properties	consent-messages_cs.properties	error-messages_cs.properties
de	German	authn-messages_de.properties	consent-messages_de.properties	error-messages_de.properties
de_CH	German (Switzerland)	authn-messages_de_CH.properties	consent-messages_de_CH.properties	error-messages_de_CH.properties
el	Greek	authn-messages_el.properties	consent-messages_el.properties	error-messages_el.properties
es	Spanish	authn-messages_es.properties	consent-messages_es.properties	error-messages_es.properties
fr	French	authn-messages_fr.properties	consent-messages_fr.properties	error-messages_fr.properties
it	Italian	authn-messages_it.properties	consent-messages_it.properties	error-messages_it.properties
ja	Japanese	authn-messages_ja.properties	consent-messages_ja.properties	error-messages_ja.properties
pl	Polish	authn-messages_pl.properties	consent-messages_pl.properties	error-messages_pl.properties
pt_BR	Brazilian Portuguese	authn-messages_pt_BR.properties	consent-messages_pt_BR.properties	error-messages_pt_BR.properties
sv	Swedish	authn-messages_sv.properties	consent-messages_sv.properties	error-messages_sv.properties

Contribute to the Translation Project

As of Identity Provider V3.1, several federation operators have started to create a translation project on the free translation service Zanata. They are available in the Shibboleth IdPv3 Translation project.

If you just want to download existing translations pick from the files listed above or ask your local federation operator.

If you want to contribute translations for other languages, please:

Go to http://zanata.org/ and create an account
The send your account name to aai@switch.ch and ask to be added as contributor/maintainer for the Shibboleth translations.

That way you'll get access to the translation project.

Once you complete (or correct something in) a translation, please notify aai@switch.ch since the Zanata tool has no built-in notification mechanism. Someone from SWITCHaai will then download the new files via the zanata-cli client, will prepend the correct license text und upload it onto this page. Downloading the file via the Zanata web interface unfortunately results in a wrong character set, not UTF-8.