Release Notes

Mit dem Release 2023.7 sind folgende intern verwendete Software aktualisiert worden.

• Apache Batik (Darstellung, Erzeugen und Manipulation von Skalierbaren Verktorgrafiken, SVG)
  von Version 1.14 auf Version 1.16
• TwelveMonkeys ImageIO (erweiterte Java-Unterstützung von Bilddateiformaten)
  von Version 3.8.2 auf Version 3.9.4

Mit der aktuellen FirstSpirit-Version die DH ARC4 Transportverschlüsselung durch ChaCha20 Transportverschlüsselung ersetzt.

X25519-ChaCha20-Poly1305 ersetzt den bisherigen Verschlüsselungs-Algorithmis DH_Arc4, da es sicherer ist und keine bekannten Schwachstellen aufweist.

Mit der aktuellen FirstSpirit-Version steht nun ein weiterer Kompressionsmodus Zstandard zur Verfügung, der in den Verbindungseinstellungen ausgewählt werden kann. Der neue Kompressionsmodus zielt darauf ab, schnelle Kompressionsgeschwindigkeiten zu bieten, während er ein hohes Kompressionsverhältnis beibehält.

Verbindungseinstellungen: Kompression

Zu weiteren Informationen siehe FirstSpirit Startseite / Bereiche der Startseite / Benutzer (→Dokumentation für Administratoren), Abschnitt Verbindungseinstellungen konfigurieren.

Die Verschlüsselung von Passwörtern umfasst jetzt auch das Passwort für konfigurierte Tomcat-Webserver.

Hinweis: Bei einem Downgrade des FirstSpirit Servers sind folgende Schritte erforderlich:

Die Konfiguration wird manuell angepasst:

• FirstSpirit Server herunterfahren.
• Vor dem Start mit der alten Version in der entsprechenden ini-Datei des Webservers das verschlüsselte Passwort durch das entschlüsselte Passwort ersetzen.

ODER

Die Verschlüsselung der Passwörter wird vor dem Herunterfahren der neuen Version deaktiviert:

• In fs-server.conf, den Wert 0 im Parameter password.encryption.active eintragen.
• Optional: Nach Abschluss des Downgrades die Verschlüsselung aktivieren

Zu weiteren Informationen siehe FirstSpirit Dokumentation für Administratoren, Password encryption.

Die Umstellung auf Jakarta EE 6.0 ist ein wesentlicher Schritt, um die Sicherheit der Webanwendungen zu gewährleisten.

Unterstützung und Zeitpunkt für Maßnahmen

Hier ist der aktuelle Plan:

• Juni 2023: Beta-Version der FirstSpirit JakartaEE-Edition ist zum Testen verfügbar (erhältlich über Support)
• August 2023: Stable Release (Version: 2023.9) mit Unterstützung für automatische Migration
• August 2024: Die Unterstützung der automatischen Migration wird mit FirstSpirit 2024.9 eingestellt

Die FirstSpirit-Installation kann betroffen sein, wenn eine der folgenden Bedingungen zutrifft:

• Die FirstSpirit-Installation wird nicht in der Crownpeak Cloud gepflegt.
• Es wird ein benutzerdefiniertes Modul verwendet, das eine WebApp-Komponente mit Code enthält, der die alte JavaEE-API verwendet, z. B. die Servlet-API.
• Es wird ein benutzerdefiniertes Modul eingesetzt, das eine WebApp-Komponente mit Abhängigkeiten enthält, die das alte JavaEE-API verwenden, z. B. Spring Boot 2.x.

Das verwendete Modul könnte betroffen sein, wenn eine der folgenden Bedingungen erfüllt ist:

• Das Modul enthält eine WebApp-Komponente mit Code, der die alte JavaEE-API verwendet, z. B. die Servlet-API.
• Das Modul enthält eine WebApp-Komponente mit Abhängigkeiten, die die alte JavaEE-API verwenden, z. B. Spring Boot 2.x.

Weitere Informationen und Updates sind in der Crownpeak Community und in den ausführlichen Jakarta FAQ zu finden.
Bei Fragen oder Feedback zur Migration wenden Sie sich bitte an den Customer Support Team.

Das Logging des FOP Moduls wurde angepasst. Anstelle des fs-wrapper.log erfolgen die Logausgaben nun in das fs-server.log. Weiterhin wurde die Anzahl der Logausgaben deutlich verringert.

In diesem Zuge werden nun auch relevante Fehler bei der PDF Erzeugung für die Generierung sichtbar. Um zu verhindern, dass sich durch diese Fehler die Anzahl der Warnungen einer entsprechenden Generierung erhöhen, werden diese Meldungen vorübergehend mit dem Log-Level INFO ausgegeben.

In einer späteren FirstSpirit-Version wird das Log-Level der Meldungen auf das Log-Level WARN erhöht werden.

Da entsprechende INFO-Ausgaben mit der bisherigen Standard-Log-Konfiguration von FirstSpirit nicht ausgegeben werden, empfehlen wir das Log-Level für die Klasse org.apache.fop auf INFO zu setzen, um evtl. vorhandene Probleme in der FOP-Generierung vorab erkennen zu können.

Dazu muss die Logging Konfiguration folgendermaßen erweitert werden:

Log4j2

<Logger name="org.apache.fop" level="INFO" additivity="false">
 <AppenderRef ref="fs"/>
</Logger>

Log4j1

log4j.logger.org.apache.fop=INFO

Die temporären Feature-Dateien werden nun automatisch nach Abschluss des Installationsvorgangs auf dem Server gelöscht (Verzeichnis <FirstSpiritROOT>/data/projects/project_<id>/features), sofern die Installation des Features über die GUI oder per Auftrag erfolgte.

Wenn Features per API installiert werden, so muss das Löschen selbst durchgeführt werden. Dafür wurde das Interface FeatureAgent (FirstSpirit Developer-API, Package de.espirit.firstspirit.feature ) um folgende Methoden erweitert. 

• getFeatureFiles() - gibt eine Liste der aktuell im Projekt vorhandenen Feature-ZIPs zurück
• deleteFeatureFile(<feature file>) - löscht das angegebene Feature-ZIP aus dem Verzeichnis <FirstSpiritROOT>/data/projects/project_<id>/features des jeweiligen Projektes

Außerdem wird bei zukünftigen Projektexporten der nicht benötigte Inhalt des Verzeichnisses <FirstSpiritROOT>/data/projects/project_<id>/features nicht mehr berücksichtigt.

Folgende Modul-Versionen für FirstSpirit Content Experience Tools werden von FirstSpirit 2023.7 unterstützt.

Mit dem aktuellen Release wurde das Session-Handling für die MicroApps verbessert.

In diesem Kontext wurden ein optionaler Parameter in der CXT Platform eingeführt. Dieser Parameter kann entweder für alle MicroApps konfiguriert werden (Datei cxt-microapps-common.properties) oder einzeln pro MicroApp.

• cxt.platform.connection-cleanup-rate
  Legt fest, wann die MicroApps ihre FS-Connection schließen (in Minuten).
  Standardwert: PT30M (30 Minuten)

Zu weiteren Informationen siehe Installation / Module / Module installieren / MicroApp Konfigurationsparameter (→Dokumentation „Content Experience Tools“).

Das Interface de.espirit.common.util.Listable (FirstSpirit Access-API, Package de.espirit.common.util) wurde um eine neue Methode toStream() erweitert.