Release Notes

FirstSpirit verwendet mehrere Standard-Webanwendungen (fs5root, fs5webedit, fs5webmon, fs5preview, fs5staging) sowie eventuell weitere, projektlokale Webanwendungen (fs5webedit_PROJECTID und fs5preview_PROJECTID). Zur (Nutzer-)Authentifizierung verwendet FirstSpirit, wie die meisten anderen Webanwendungen auch, zufällig generierte Session-Cookies (siehe Informationen zum Einsatz von Cookies).

Viele Browser (u.a. Chrome 80) schränken seit Anfang des Jahres Cookies von Drittanbietern massiv ein. Alle Cookies, die nicht das Attribut SameSite tragen, verursachen Warnmeldungen. SameSite ist ein Standard, der Verhindern soll, dass Cookies bei sogenannten Cross-Site Requests automatisch vom Browser mitgesendet werden und bietet damit einen Schutz vor Cross-Site-Request-Forgery (CSRF). Neben diesem Sicherheitsaspekt ermöglicht das Attribut SameSite zu definieren, welche Cookies in welchem Kontext ausgelesen werden können.

Das FirstSpirit Session Cookie unterstützt das Attribut SameSite ab FirstSpirit 2020-05 mit der Möglichkeit zur Konfiguration (siehe Konfiguration servletSessionCookieSameSite). Die bisher empfohlene Standardeinstellung (SameSite-Attribut ist nicht gesetzt) kann nun in einigen Browsern folgende Logausgaben in der JavaScript-Console verursachen:

Das Cookie "FS52ID" wird bald als Cross-Site-Cookie (...) behandelt. 

Die Standardeinstellung für das Attribut SameSite wird mit FirstSpirit 2020-09 geändert auf der Standardeinstellung SameSite=Lax.

Mit dieser Einstellung wird das Session Cookie nur im First-Party-Kontext gesendet (also nur, wenn die Seite für den Cookie mit der URL im Browser übereinstimmt) und nur zusammen mit Cross-Site-Requests, die als „sicher“ angesehen werden. Dies betrifft die sicheren HTTP-Methoden (GET, HEAD, OPTIONS und TRACE) und die Top-Level-Navigation (Aktionen, die eine Änderung der URL in der Adressleiste des Browsers veranlassen, wie z. B. Links).

e-Spirit empfiehlt die Standard-Einstellungen der Konfigurationsdatei fs-server.conf beizubehalten. Die Standardeinstellung deckt in den meisten Fällen sowohl die Sicherheitsaspekte (guter Schutz vor Cross-Site-Request-Forgery) als auch die Belange des Nutzers (gute User Experience) ab.
Nur in Ausnahmefällen (z. B. FirstSpirit als eingebettete WebApp) ist eine Änderung notwendig.

Der Wert für die FirstSpirit Session Cookies kann über die Konfigurationsdatei fs-server.conf gesetzt werden, sowohl global über den Parameter servletSessionCookieSameSite als auch einzeln für bestimmte WebApp-Pfade, z. B. servletSessionCookieSameSite.fs5webmon=None für das FirstSpirit ServerMonitoring. Eine WebApp-spezifische Konfiguration überschreibt dabei die globale Einstellung servletSessionCookieSameSite für diesen WebApp-Pfad.

Bei einem Wechsel von FirstSpirit 2020-08 auf eine andere FirstSpirit-Version kann es dazu kommen, dass der FirstSpirit-Server nicht erreichbar ist. Die Webanwendungen protokollieren eine Fehlermeldung der Art

de.espirit.firstspirit.common.ConnectError: Wrong client version

In diesem Fall sollten die Webanwendungen manuell gelöscht werden. Folgende Verzeichnisse können betroffen sein:

• ~/tomcat/webapps
• ~/firstspirit/web
• ~/firstspirit/data/modules/FirstSpirit Jetty Server.JettyService/webapps

Danach kann der FirstSpirit-Server neu gestartet werden.

Benötigen Sie Unterstützung, wenden Sie sich bitte an den e-Spirit Technical Support (https://help.e-spirit.com).

In der „Änderungsansicht“ einer Seite können Änderungen, die an der Seite vorgenommen wurden, im Dialog „Änderungen anzeigen“ visualisiert werden. Dieser wird über das Icon „Differenzen anzeigen“

geöffnet:

In diesem Dialog wurde die Benutzerführung beim Wiederherstellen einer Version geändert (über die Schaltfläche „Diese Version wiederherstellen“ oder Icon

Wurde der Dialog zuvor direkt nach dem Wiederherstellen der Version geschlossen, bleibt er jetzt geöffnet, bis der Informationsdialog „Wiederherstellung war erfolgreich. Der aktuelle Stand wird jetzt geladen.“ mit „OK“ bestätigt wird:

Auf diese Weise ist es nun möglich, bei Verwendung der API (Interface ComparisonDialogOperation, Package de.espirit.firstspirit.webedit.server, FirstSpirit Developer-API) auf das Schließen des Dialogs zu warten, bis eine andere Operation durchgeführt wird.

Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2020-09 unterstützt:

* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.

Zum Hochladen und zur Auswahl von Medien im FragmentCreator wird die Komponente „FS_INDEX“ mit Modul „Media DAP“ verwendet. Mit dem aktuellen Release können für ein Upload nicht nur Dateien vom Arbeitsplatzrechner ausgewählt werden, sondern auch ganze Verzeichnisstrukturen (Ordner) inklusive enthaltener Bilder und Dateien anderer Formate.

Dazu muss der oder die gewünschten Ordner per Drag-and-drop in den Upload-Dialog gezogen werden.
Nach dem Drop werden alle in den Ordnern enthaltenen Medien im Dialog dargestellt. Auf diese Weise können die Medien markiert werden, die in der Komponente referenziert werden sollen.
Potenzielle Einschränkungen hinsichtlich Dateigröße und -format durch den Projektentwickler werden direkt berücksichtigt: Es werden nur Dateien in den Dialog übernommen, die von der Größe und vom Format her erlaubt sind.
Der Ordner-Pfad zu den hochzuladenen Medien wird unterhalb der Medien zusammen mit dem Dateinamen angezeigt.

Sind alle gewünschten Medien ausgewählt, kann der Upload mit einem Klick auf „Hochladen“ gestartet werden. Nach erfolgreichem Upload schließt sich der Upload-Dialog automatisch. Ausnahme: Im Fehlerfall bleibt der Dialog geöffnet, zeigt eine entsprechende Fehlermeldung, und die betroffenen Medien werden nicht hochgeladen.

In der Medien-Verwaltung im betreffenden FirstSpirit-Projekt werden die hochgeladenen Medien und Ordner in der Dateistruktur vom Arbeitsplatzrechner abgebildet. Leere Ordner werden jedoch nicht berücksichtigt.
Dabei werden sowohl für die Medien als auch für die Ordner jeweils die Namen der Ordner und Dateien vom Arbeitsplatzrechner verwendet.

Mit dem aktuellen Release wird die Eingabekomponente zum Umschalten zwischen zwei Zuständen CMS_INPUT_TOGGLE auch vom FragmentCreator unterstützt.

Beispiel:

<CMS_INPUT_TOGGLE name="picture_position" useLanguages="yes">
         <LANGINFOS>
           <LANGINFO lang="*" label="Picture position"/>
           <LANGINFO lang="DE" label="Ausrichtung des Bildes"/>
         </LANGINFOS>
         <OFF>
           <LANGINFO lang="*" label="Right"/>
           <LANGINFO lang="DE" label="Rechts"/>
         </OFF>
         <ON>
           <LANGINFO lang="*" label="Left"/>
           <LANGINFO lang="DE" label="Links"/>
         </ON>
</CMS_INPUT_TOGGLE>

CMS_INPUT_TOGGLE im FragmentCreator

Die verschiedenen Zustände werden dabei über die Pflicht-Tags <ON> und <OFF> abgebildet. Über das Tag <LANGINFO> muss eine Beschriftung für jeden Zustand definiert werden.

Die Radiobuttons der Komponente werden untereinander dargestellt, oben der Zustand <ON>, unten der Zustand <OFF>. Diese Reihenfolge kann nicht verändert werden.

Hinweis: Anders als im FirstSpirit ContentCreator und SiteArchitect wird im FragmentCreator nur der Typ „Radiobutton“ unterstützt (entspricht type="RADIO"). Der Parameter type wird im FragmentCreator nicht berücksichtigt, die Eingabekomponente wird immer als Radiobutton dargestellt.

Zu weiteren Informationen siehe https://docs.e-spirit.com/odfs/edocs/cxt/vorlagen/eingabekomponen/index.html.

Die für Q3-2020 geplante Freigabe des neuen Datenbank-Layers Oracle Database 19c wird verschoben und ist nun für Q4-2020 geplant.

Aktuell befindet sich der Layer Oracle Database 19c weiterhin in der EAP-Phase (Early Access-Programm). Die EAP-Phase wird intensiv in der FirstSpirit Community (https://community.e-spirit.com) begleitet. In der Community ist auch eine ausführliche Dokumentation zur Verwendung einer Oracle Database 19c mit FirstSpirit hinterlegt.

Bei einer Generierung werden aus FirstSpirit-Elementen heraus Daten erzeugt und im Dateisystem abgelegt. Im Nachgang einer (oder mehrerer) solcher Generierungen ist es oftmals erforderlich, Nachbearbeitungsschritte auf den generierten Daten durchzuführen. Beispiele dafür sind:

• Platzhalter-Medien durch Medien aus einem MAM ersetzen (gesteuert über Metadaten).
• eine Suchmaschine anhand von Metadaten trainieren, die zu den einzelnen FirstSpirit-Elementen hinterlegt sind

Mithilfe der neuen Methode getOutput() im Interface GenerationAgent (FirstSpirit Developer-API, Package de.espirit.firstspirit.scheduling.agency) kann nach einer Generierung eine Zuordnung der erzeugten Dateien zu den entsprechenden FirstSpirit-Objekten erfolgen. Diese Informationen können in einem nachgelagerten Auftragsschritt verwendet werden, um die generierten Daten zu verändern oder die Informationen zu diesen Daten an Drittsysteme weiterzuleiten.

Beispielcode (Beanshell):

import de.espirit.firstspirit.scheduling.agency.GenerationAgent;
import de.espirit.firstspirit.agency.LanguageAgent;
import de.espirit.firstspirit.scheduling.agency.FileEntry;
import de.espirit.firstspirit.access.store.IDProvider;

generationAgent = context.requireSpecialist(GenerationAgent.TYPE);
ml = context.requireSpecialist(LanguageAgent.TYPE).getMasterLanguage();
Collection<FileEntry> output = generationAgent.getOutput();
for (entry : output) {
 uid = entry.getElementUid();
 IDProvider.UidType uidType = entry.getElementUidType();
 path = entry.getPath();
 element = entry.getElement(context, false);
 context.logInfo("+ Generated: " + uid + " (" + uidType + ") = " + 
   element.getDisplayName(ml) + " at: " + path);
}

Die Methode getOutput() gibt alle Daten aus, die sich zum Zeitpunkt der Skriptausführung im Generierungsverzeichnis befinden (also potentiell veröffentlicht werden). Damit werden automatisch mehrere vorhergehende Generierungen des Auftrags berücksichtigt.

Ergänzend zur Ausgabezuordnung wurde der PermissionsAgent (FirstSpirit Developer-API, Package de.espirit.firstspirit.access.editor) eingeführt, um bestehende Zugriffs- und Ausführungsrechte für die einzelne FirstSpirit-Objekte zu ermitteln. Bei diesen Rechten handelt es sich um spezielle Benutzerrechte, die vom Vorlagenentwickler über eine projektspezifische Metadatenvorlage mithilfe der Eingabekomponente CMS_INPUT_PERMISSION vorgegeben und anschließend im Metadaten-Register der FirstSpirit-Objekte definiert werden (nicht um Redaktionsrechte, die in FirstSpirit fest definiert sind). Der PermissionsAgent berücksichtigt dabei auch die Vererbung dieser Rechte, das heißt, es werden auch Rechte ausgelesen, die von einem übergeordneten Knoten geerbt wurden.

Mithilfe der neuen Regel PROPAGATE_MEDIA_CHANGES_TO_CONTENTSTORE im Interface DeltaGeneration (FirstSpirit Developer-API, Package de.espirit.firstspirit.access.schedule) können Medien-Änderungen jetzt an Datensätze weitergeleitet werden.

Wenn die Regel benutzt wird, so hat die Freigabe eines Mediums zur Folge, dass alle Datensätze, die dieses Medium im Freigabestand referenzieren, für die Delta-Generierung als „geändert“ betrachtet werden.

Mit dem aktuellen FirstSpirit Release können auch externe Benutzer für eine Passwort-Konfigurationen im ServerManager genutzt werden. Diese Passwörter können sowohl für Skripte als auch für Remoteverbindungen verwendet werden.

Die Erweiterung betrifft alle Passwörter, die explizit im ServerManager in Remoteverbindungen oder Skript-Tasks gesetzt wurden.

• im Bereich Auftragsverwaltung - im Dialog „Skript-Eigenschaften“
  siehe Dokumentation für Administratoren - FirstSpirit ServerManager / Auftragsplanung / Serverbezogene Aktionen / Skript ausführen
• im Bereich Remote-Projekte - im Dialog „Remote-Projekt Konfiguration bearbeiten“
  siehe Dokumentation für Administratoren - FirstSpirit ServerManager / Projekteigenschaften / Remote-Projekte

Hinweis: Aus Sicherheitsgründen können Server-Administratoren für die Passwort-Konfiguration nicht verwendet werden.

Für die Erweiterung der Nutzer wurde das Passwort-Format des PasswordAgent geändert. Dies hat keine Auswirkungen auf bestehende Daten, das alte Format ist auch weiterhin lesbar. Eine neue Authentifizierung erfolgt nur, wenn das Passwort in den Konfigurationsdialogen neu eingegeben wird. Mit alten persistenten Daten, wird auch weiterhin die alte Login-Implementierung benutzt.

Hinweis: Eine Aufwärtskompatibilität ist gegeben. Nach einem Update des FirstSpirit-Servers auf die neueste Version sind alle gesetzten Passwörter weiterhin gültig. Es ist nicht notwendig, die Passwörter neu zu setzen.

Hinweis: Nach einem Downgrade des FirstSpirit-Servers auf die FirstSpirit Version 2020-08 oder älter sind neu über den PasswortAgent verschlüsselte Passwörter nicht mehr kompatibel und müssen neu gesetzt werden.

Der FirstSpirit Launcher ist digital signiert. Das Zertifikat erlaubt dem Empfänger zu prüfen, von wem das heruntergeladene Programm stammt und ob sein Code auf dem Weg vom Hersteller zum Empfänger manipuliert wurde.

Mit der aktuellen FirstSpirit-Version wird das Zertifikat des FirstSpirit Launchers aktualisiert.