| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung |
| de:shibidp:config-i18n [2020/04/16 08:51] – Silke Meyer | de:shibidp:config-i18n [2026/08/04 11:15] (aktuell) – Aktualisierung Internationalisierung, defaults Doreen Liebenau |
|---|
| | <- de:shibidp:config-zertifikate|Konfiguration der Zertifikate ^ de:shibidp:uebersicht|Überblick: Tutorial zur IdP-Inbetriebnahme ^ de:shibidp:config-logos|Logo und Favicon -> |
| ====== Internationalisierung der IdP-Webseiten ====== | ====== Internationalisierung der IdP-Webseiten ====== |
| |
| <callout type="danger" title="EU-DSGVO"> | <callout color="#ff9900" title="EU-DSGVO"> |
| Für eine [[de:shibidp3consent_dsgvo|EU-DSGVO-konforme Konfiguration des User Consent Moduls]] bieten wir eine angepasste, deutschsprachige Version der Message Properties an. | Für eine [[de:shibidp:config-consent-dsgvo|EU-DSGVO-konforme Konfiguration des User Consent Moduls]] bieten wir eine angepasste, deutschsprachige Version der Message Properties an. |
| </callout> | </callout> |
| |
| ===== Installation der deutschsprachigen System-Meldungen ===== | In früheren IdP-Versionen waren alle Texte in den ''./messages/messages.properties''-Dateien im ''conf/''-Verzeichnis zu finden. Bei einer aktuellen IdP-Neuinstallation werden Sie im ''./messages''- Verzeichnis lediglich eine leere ''messages.properties''- Datei vorfinden. |
| | |
| | ===== Das Override-Prinzip ===== |
| |
| Laden Sie aus dem [[https://wiki.shibboleth.net/confluence/display/IDP4/MessagesTranslation|Shibboleth-Wiki]] die zur jeweiligen IdP-Version passende Datei für die deutsche Übersetzung der IdP-Seiten herunter. Legen Sie sie nach ''./system/messages/messages_de.properties''. | Die [[https://codeberg.org/Shibboleth/java-identity-provider/src/branch/main/idp-conf-impl/src/main/resources/net/shibboleth/idp/messages|Defaults]] sind auf den ersten Blick im [[https://shibboleth.atlassian.net/wiki/spaces/IDP5/pages/3199501666/Configuration#Installation-Layout|Datei-Baum]] nicht sichtbar. Alle Standardtexte (Englisch, sowie vorhandene Übersetzungen) sind fest in den Programmbibliotheken des IdP einkompiliert. |
| | Die Dateien im ''conf''-Verzeichnis sind für Overrides vorgesehen. Die Datei ''messages.properties'' (Standard/Englisch) enthält initial keine Einträge. Sie dient als Überschreibungs-Datei. Erweiterungen für weitere Sprachen müssen bei Bedarf angelegt werden (z.B. ''messages_de.properties''). |
| |
| Ab jetzt sollten die IdP-Seiten auch auf Deutsch angezeigt werden. | Für Textanpassungen genügt also ein Eintrag in der Datei ''messages.properties'', bzw. ''messages_de.properties''. Ggf. muss die Datei messages_de.properties erstmalig angelegt werden. |
| | |
| | ===== Wie wird die Sprachauswahl getroffen? ===== |
| |
| ===== System-Meldungen anpassen ===== | Die Sprachauswahl passiert dynamisch bei jedem einzelnen Login-Vorgang und wird vom Webrowser der Nutzenden gesteuert. |
| | Über den „Accept-Language“-Header des Browsers kann eine sprachspezifische Message-Datei bevorzugt werden, die anstelle der Standarddatei verwendet wird. Beispielsweise würde für die deutsche Sprachumgebung eine Datei namens ''messages_de.properties'' verwendet werden. Soweit bekannt ist, beschränkt Spring dies auf eine einzige Sprachumgebung, die entweder eine Übereinstimmung aufweist oder auf die Standardeinstellung zurückgreift, was keine präferenzbasierte Auswahl zulässt. |
| Die einzelnen Meldungen auf den Seiten sollten jetzt noch in Englisch und Deutsch angepasst werden. | |
| | |
| ==== Englisch ==== | {{tag>idp5 tutorial i18n internationalisierung not-included-in-ansible}} |
| | |
| Laden Sie unsere {{:de:messages.properties|englische Beispiel-Datei}} herunter und legen Sie diese nach ''/opt/shibboleth-idp/messages/messages.properties''. | |
| | |
| öffnen Sie die Datei in einem Editor und | |
| | |
| * ersetzen Sie die Platzhalter "University XY" und "20XY" durch die korrekten Werte. | |
| * passen Sie die Nutzungsbedingungen in Absprache mit Ihrer Rechtsabteilung und/oder Datenschützern an. | |
| | |
| Hinweis: wundern Sie sich nicht, dass der deutsche Beispieltext für die Nutzungsbedingungen in der englischen Datei auftauchen. Wir haben im Moment keine englische Version und durch das Platzieren des deutschen Textes in diese Datei wird der deutsche Text jedem Webbrowser angezeigt, egal welche Sprache dieser haben möchte. Sofern Sie eine englische Version der Bedingungen haben, ersetzen Sie den deutschen Text einfach! | |
| | |
| === Deutsch === | |
| | |
| Laden Sie unsere {{:de:messages_de.properties|deutsche Beispiel-Datei}} herunter und legen Sie diese nach ''/opt/shibboleth-idp/messages/messages_de.properties'' | |
| | |
| öffnen Sie die Datei in einem Editor und ersetzen Sie die Platzhalter "Hochschule XY" und "20XY" durch die korrekten Werte. | |
| | |
| Hinweis: wundern Sie sich nicht dass hier keine Nutzungsbedingungen enthalten sind. Sollten Sie in der englischen Datei eigene Nutzungsbedingungen auf englisch eingetragen haben, müssen Sie jetzt noch Ihre Bedingungen auf Deutsch hier eintragen. | |
| | |
| Testen Sie nochmal einen Login mithilfe der DFN-Test-SP(s) und überzeugen Sie sich dass die Layout-Anpassungen wirksam geworden sind. | |
| | |
| **Weiter geht es mit der [[:de:shibidp:config-logos|Logo]]-Anpassung ** | |
| | |
| {{tag>idp4 tutorial}} | |