Zeige QuelltextÄltere VersionenLinks hierherNach oben Letzte ÄnderungenPer E-Mail sendenDruckenPermalink × Inhaltsverzeichnis Upgrade auf Shibboleth IdP 4.x Upgrade von 3.4.6 oder 3.4.7 Upgrade von 3.4.1 - 3.4.5 Schritt 1: Update auf IdP 3.4.7 Schritt 2: Upgrade von 3.4.7 auf 4.0.x Neuinstallation bei IdP 3.3.x oder älter Mitpflegen der Konfiguration Auslagern von Secrets (optional) Aktualisierung des Verschlüsselungsalgorithmus Deprecation Warnings ab 4.x attribute-resolver.xml attribute-filter.xml Upgrades innerhalb der Produktlinie IdP 4.x Upgrade-Anleitung mit manueller Tomcat-Installation Dies ist eine alte Version des Dokuments! Upgrade auf Shibboleth IdP 4.x Laut der Shibboleth-Dokumentation soll der IdP 4.0 direkt auf einen funktionsfähigen IdP Version 3.4.6 oder 3.4.7 installiert werden! Man erhält kein fehlerfrei funktionierendes System, wenn man die Version 4.x separat installiert und die Konfiguration der alten Version einfach in die neue Installation hineinkopiert. Es ist natürlich möglich, die geprüften Inhalte in eine Neuinstallation zu übertragen. Vorgehen in Abhängigkeit Ihrer IdP-VersionWir empfehlen, je nach dem, welche 3er-Version Sie betreiben, unterschiedliche Wege zu gehen, die unten dokumentiert sind: Upgrade von 3.4.6 / 3.4.7 Upgrade von 3.4.1 - 3.4.5 Neuinstallation bei 3.3.x oder älter Upgrade von 3.4.6 oder 3.4.7 Die IdP-Versionen 3.4.6 und 3.4.7 sind beide upgradefähig. Die groben Schritte: Datensicherung von idp.home und Datenbank Systemanforderungen prüfen: Java 11 und Tomcat 9+ (bzw. Jetty 9.4+) Release Notes studieren neue Version herunterladen und entpacken den Installer (./bin/install.sh) aufrufen und den IdP - wie bei den vorherigen Updates ins gewohnte Verzeichnis installieren. Unter Linux ist außerdem zu beachten, dass beim Upgrade die Schreib-/Leseberechtigungen korrekt gesetzt werden (Parameter -Didp.conf.filemode=644 beim Aufruf von ./bin/install.sh). die Datei ./war/idp.war neu bauen mit ./bin/build.sh Was geschieht mit den Änderungen am eigenen IdP? Dateien im Ordner idp.home/system werden (schon immer) bei Upgrades überschrieben. Dies war nie der Ort für eigene Anpassungen - sollten Sie doch Anpassungen vorgenommen haben, übertragen Sie sie bitte an die entsprechenden Stellen in den anderen Ordnern. Dateien in folgenden Ordnern werden bei Upgrades nicht überschrieben: ./conf, ./views, ./messages und ./edit-webapp. Hier sollten Sie also Ihre Konfigurationen, Views oder Templates untergebracht haben. Attribute Resolver erst später umbauenDa die IdP-Version 4.1 voraussichtlich etliche Konfigurationsänderungen mit sich bringen wird ([1], [2]), empfehlen wir, nach einem Upgrade von 3.4.6 bzw. 3.4.7 auf 4.0.1 die alte conf/attribute-resolver.xml beizubehalten. Den Umbau der Syntax und das Einbeziehen der neuen Attribute Registry sollten Sie dann später vornehmen. Upgrade von 3.4.1 - 3.4.5 In den letzten 3.4.x-Releases wurden bereits alle Syntax- und Konfigurationsparameter-Änderungen als veraltet bemängelt, die in Version 4.0 nicht mehr möglich sind. Mit einer entsprechend mitgepflegten, laufenden IdP 3.4.6-Installation ist das Upgrade auf 4.0 möglich. Je nach dem, welche genaue IdP-Version Sie betreiben, sollten Sie abwägen, welchen Weg Sie gehen möchten. Ab Version 3.4.2 war die Datei conf/attribute-resolver.xml anzupassen. Dies war der aufwändigste Schritt. Wenn Sie ihn schon hinter sich haben, ist es sicher weniger Aufwand, dem Upgradepfad zu folgen. Schritt 1: Update auf IdP 3.4.7 Daher bringen Sie Ihren IdP bitte zunächst auf die Version 3.4.7: Hinweise zum Upgrade innerhalb der IdP v3 Produktlinie Auf der Seite finden Sie auch einen Überblick über die Konfigurationsänderungen, die im IdP v3.4.7 laufen müssen. Beobachten Sie das idp-process.log und bereinigen Sie alle Deprecation Warnings. Schritt 2: Upgrade von 3.4.7 auf 4.0.x Ab hier gehen Sie vor, wie im Abschnitt Upgrade von 3.4.6 oder 3.4.7 beschrieben. Neuinstallation bei IdP 3.3.x oder älter Wir empfehlen IdP-Betreiber*innen, die noch Shibboleth 3.3.x oder älter haben, eine Neuinstallation des IdP 4.0.1 nach unserem Tutorial durchzuführen. Der Aufwand, alle Änderungen der 3.4.er-Versionen nachzupflegen, ist nicht ganz gering und fehleranfällig. Zudem haben Sie auf einem neuen System die aktuellen Konfigurationsdateien mit den jetzt gesetzten Standardeinstellungen und Konfigurationsparametern. Das neue Produktivsystem sollte am Ende dieselbe EntityId wie das alte Produktivsystem haben. Hier finden Sie eine Schritt-für-Schritt-Anleitung für die Migration des IdP im laufenden Betrieb. Mitpflegen der Konfiguration Auslagern von Secrets (optional) In einer Neuinstallation von Shibboleth IdP 4.x werden IdP-interne Secrets in der separaten Datei secrets.properties gespeichert. Informationen wie LDAP-Bind- oder Datenbank-Credentials sind durch die Zugangsbeschränkungen dieser neuen Datei besser geschützt. Wir empfehlen, das auch bei aktualisierten IdPs nachzuziehen und die entsprechenden Informationen aus idp.properties, ldap.properties oder global.xml auszulagern. Verlinken Sie die neue Datei als zusätzliche Konfigurationsdatei ganz oben in idp.properties, hier an letzter Stelle: conf/idp.properties idp.additionalProperties=/conf/ldap.properties, /conf/saml-nameid.properties, /conf/services.properties, /conf/authn/duo.properties, /credentials/secrets.properties Erstellen Sie die neue Datei /opt/shibboleth-idp/credentials/secrets.properties mit folgenden Parametern (und ggf. weiteren aus Ihrer IdP-Konfiguration): /opt/shiboleth-idp/credentials/secrets.properties # Access to internal AES encryption key idp.sealer.storePassword = <YOUR-SECRET-HERE> idp.sealer.keyPassword = <YOUR-SECRET-HERE> # Default access to LDAP authn and attribute stores. idp.authn.LDAP.bindDNCredential = <YOUR-LDAP-BIND-CREDENTIAL-HERE> idp.attribute.resolver.LDAP.bindDNCredential = %{idp.authn.LDAP.bindDNCredential:undefined} # Salt used to generate persistent/pairwise IDs, must be kept secret idp.persistentId.salt = <YOUR-VERY-LONG-HASH-HERE> # Access to MySQL database mysql.password = <YOUR-MYQSL-PASSWORD-HERE> Schützen Sie die Datei:root@idp:~# chown root:tomcat /opt/shibboleth-idp/credentials/secrets.properties root@idp:~# chmod 640 /opt/shibboleth-idp/credentials/secrets.properties Aktualisierung des Verschlüsselungsalgorithmus Ein von 3.4.x aktualisierter Shibboleth-IdP verhält sich in Bezug auf den gewählten Verschlüsselungsalgorithmus so wie vor dem Upgrade. Der Algorithmus, der bisher zum Einsatz kam, gilt jedoch nicht mehr als sicher. Bitte schauen Sie sich die unter Konfiguration des Verschlüsselungsalgorithmus gezeigten Möglichkeiten an. Wir zeigen dort einen empfohlenen Weg mit dem neueren Algorithmus AES-GCM und Ausnahmen für SPs, die den Algorithmus noch nicht kennen. Deprecation Warnings ab 4.x Direkt nach der Aktualisierung auf einen 4.xer IdP erscheinen im Log neue Deprecation Warnings. Wir empfehlen, sie über die Minor Updates hin gleich zu bearbeiten. Hier finden Sie fortlaufend die Einstellungen, die ab 4.x abgekündigt sind. attribute-resolver.xml Das XML-Attribute failfastInitialize, das zuvor unterhalb des ConnectionPool konfiguriert wurde, wird jetzt direkt beim DataConnector eingestellt. conf/attribute-resolver.xml <DataConnector id="myLDAP" xsi:type="LDAPDirectory" ldapURL="%{idp.attribute.resolver.LDAP.ldapURL}" baseDN="%{idp.attribute.resolver.LDAP.baseDN}" principal="%{idp.attribute.resolver.LDAP.bindDN}" principalCredential="%{idp.attribute.resolver.LDAP.bindDNCredential}" useStartTLS="%{idp.attribute.resolver.LDAP.useStartTLS:true}" connectTimeout="%{idp.attribute.resolver.LDAP.connectTimeout}" trustFile="%{idp.attribute.resolver.LDAP.trustCertificates}" responseTimeout="%{idp.attribute.resolver.LDAP.responseTimeout}" failFastInitialize="%{idp.pool.LDAP.failFastInitialize:false}"> <FilterTemplate> <![CDATA[ %{idp.attribute.resolver.LDAP.searchFilter} ]]> </FilterTemplate> <ConnectionPool minPoolSize="%{idp.pool.LDAP.minSize:3}" maxPoolSize="%{idp.pool.LDAP.maxSize:10}" blockWaitTime="%{idp.pool.LDAP.blockWaitTime:PT3S}" validatePeriodically="%{idp.pool.LDAP.validatePeriodically:true}" validateTimerPeriod="%{idp.pool.LDAP.validatePeriod:PT5M}" expirationTime="%{idp.pool.LDAP.idleTime:PT10M}"/> </DataConnector> attribute-filter.xml Das XML-Element ignoreCase wird ersetzt durch caseSensitive. Um die gleiche Aussage zu erhalten, geben Sie statt ignoreCase='true' jetzt caseSensitive='false' ein. Ein Beispiel: conf/attribute-resolver.xml <AttributeFilterPolicy id="LibraryTermsToAnyone"> <PolicyRequirementRule xsi:type="ANY" /> <AttributeRule attributeID="eduPersonEntitlement"> <PermitValueRule xsi:type="Value" value="urn:mace:dir:entitlement:common-lib-terms"/> </AttributeRule> <AttributeRule attributeID="eduPersonScopedAffiliation"> <PermitValueRule xsi:type="OR"> <Rule xsi:type="Value" value="member" caseSensitive="false"/> <Rule xsi:type="Value" value="library-walk-in" caseSensitive="false"/> </PermitValueRule> </AttributeRule> </AttributeFilterPolicy> Upgrades innerhalb der Produktlinie IdP 4.x Laut Shibboleth-Wiki werden die Minor- oder Patch-Updates - genau wie bereits im IdP 3.x - jeweils über die laufende IdP-Version drüber installiert: Sie laden dazu die neueste IdP-Version herunter und entpacken sie. Dann führen Sie das Installationsskript erneut aus. Wichtig ist, dass Sie als Zielverzeichnis das Verzeichnis der laufenden Installation angeben, z.B. /opt/shibboleth-idp unter Linux. Unter Linux ist außerdem zu beachten, dass beim Upgrade die Schreib-/Leseberechtigungen korrekt gesetzt werden (Parameter -Didp.conf.filemode=644 beim Aufruf von ./bin/install.sh). Upgrade-Anleitung mit manueller Tomcat-Installation Die Kollegen von der Charité Berlin haben eine Anleitung für Ubuntu 18.04 verfasst, in der sie den Tomcat9 manuell installieren: Vielen Dank an Mario Severing für's Teilen! Upgrade von Tomcat8 auf Tomcat9 und von Shibboleth 3.4.x auf 4.x Upgrade des manuell installierten Tomcat9 auf eine neuere Version Zuletzt geändert: vor 3 Jahren Anmelden