Universal Messenger 7.46.0

Das Release 7.46.0 Build 1810 wurde im Juni 2022 veröffentlicht. Dieses Release umfasst:

Neues Loginattribut login_name
Neuer Standard für Login-Modus
Login-Modus ldap wird ab Release 7.48 nicht mehr unterstützt
Integration Multitenancy-Plugin
Änderung der Systemvoraussetzungen: Tomcat 10 offiziell unterstützt
Anpassungen am Installer
Fehlerkorrekturen

Neues Loginattribut login_name

Ab Release 7.46 wird der Universal Messenger bei einer Neuinstallation standardmäßig mit dem neuen Attribut login_name ausgeliefert, welches künftig statt des uid-Attributes den Loginnamen für Backoffice-User aufnehmen soll.

In cmsbs-conf/cmsbs.properties wird das neue Attribut jetzt wie folgt aktiviert:

cmsbs.gui.loginAttr = "login_name"

In cmsbs-conf/additional.attributes wird das login_name-Attribut wie folgt definiert:

login_name.title.de = Loginname
login_name.title.en = Login name
login_name.type = STRING
login_name.isUnique = true
login_name.allowEmpty = true
login_name.dbSize = 96
login_name.isPrimary = true
additional.attributes[] = login_name

grp.std_intern.members[] = "login_name"

Die notwendige Primärtabellenspalte user.p_login_name wird automatisch beim UM-Start angelegt. Ein separater Migrationsschritt ist dazu nicht mehr erforderlich. Beim ersten Start erfolgt außerdem eine automatische Übernahme der Loginnamen aus uid für alle Admin-Einträge. Dazu wird sinngemäß folgendes SQL-Statement ausgeführt:

UPDATE users SET p_login_name=sid
    WHERE p_login_name IS NULL AND p_cmsbs_isadmin=1

Besonderheiten beim UM-Update

Wird eine bestehende UM-Installation aktualisiert, ohne dabei cmsbs-conf/cmsbs.properties bzw. cmsbs-conf/additional.attributes zu ersetzen, ändert sich nichts am Verhalten.

UM-Installationen in Docker-Umgebung

Wird der UM in einer typischen Docker-Umgebung betrieben, ist zu beachten, dass bei jedem Neubau des Docker-Images die mitgelieferten Konfigurationsdateien cmsbs-conf/cmsbs.properties und cmsbs-conf/additional.attributes verwendet werden, so dass – wie oben beschrieben – das neue Loginattribut durch das UM-Update automatisch aktiviert wird.

Alle Einstellungen lassen sich durch entsprechende Eintragungen in den projektspezifischen Konfigurationsdateien so anpassen, dass das alte Verhalten erhalten bleibt.

cmsbs-conf/conf.d/no-login_name.properties:

cmsbs-conf/conf.d/no-login_name.attributes:

Neuer Standard für Login-Modus

Der Universal Messenger kann Backoffice-User auf verschiedenen Wegen authentifizieren. Dazu wird die Einstellung cmsbs.gui.login verwendet, welche den Login-Modus festlegt.

Seit Release 7.46 wird bei neuen Installationen der Login-Modus default aktiviert:

cmsbs.gui.login = default

In diesem Modus stehen die folgenden Quellen zur User-Authentifizierung zur Verfügung:

Single Sign-On via OpenID Connect
Passwort-basierter Login gegen LDAP bzw. Active Directory
Passwort-basierter Login gegen die interne User-Verwaltung
Passwort-basierter Login gegen in der Konfigurationsdatei festgelegte Userdaten.

Jede dieser vier Quellen kann einzeln per Konfigurationsoption aktiviert oder deaktiviert werden. Versucht ein Nutzer, sich im Backoffice anzumelden, werden die aktivierten Login-Methoden in der hier dargestellten Reihenfolge angesprochen. Sobald der Login mit einer der Methoden gelingt, wird die Nutzersitzung entsprechend gestartet und der Login ist abgeschlossen. Schlägt auch die letzte der aktivierten Methoden fehl, ist der Login insgesamt fehlgeschlagen.

Die Konfiguration für den Login-Modus default erfolgt in der Datei cmsbs-conf/conf.d/guilogin.js, die vom Installer initial angelegt wird. Anders als in einigen der anderen Konfigurationsdateien, liegt diese Datei im JavaScript-Format vor und muss entsprechend der JavaScript-Syntax bearbeitet werden.

cmsbs-conf/conf.d/guilogin.js:

Für weitere Details siehe Handbuch für Enwickler.

Der Login-Modus ldap wird ab dem Release 7.48 nicht mehr unterstützt werden.

Installationen, in denen dieser Modus noch verwendet wird, sollten möglichst schon im Zuge dieses Updates auf den oben beschriebenen neuen Modus default umgestellt werden.

Besonderheiten beim UM-Update

Wird eine bestehende UM-Installation aktualisiert, ohne dabei cmsbs-conf/cmsbs.properties zu ersetzen, ändert sich nichts am Verhalten.

UM-Installationen in Docker-Umgebung

Wird der UM in einer typischen Docker-Umgebung betrieben, ist zu beachten, dass bei jedem Neubau des Docker-Images die mitgelieferte Konfigurationsdatei cmsbs-conf/cmsbs.properties verwendet wird, so dass – wie oben beschrieben – der neue Login-Modus durch das UM-Update automatisch aktiviert wird.

Diese Einstellung lässt sich durch eine entsprechende Eintragung in einer projektspezifischen Konfigurationsdateien so anpassen, dass das alte Verhalten erhalten bleibt.

cmsbs-conf/conf.d/login.properties:

Integration Multitenancy-Plugin

Mit dem Release 7.46 wurden die Funktionen des Multitenancy-Plugins in den Standardfunktionsumfang des UM integriert. Künftig wird das Multitenancy-Plugin also auch für Multi-Mandanten-Systeme nicht mehr benötigt, sofern auf den oben beschriebenen Login-Modus default umgeschaltet und die neue Multitenancy-Funktion in cmsbs-conf/conf.d/guilogin.js aktiviert wird.

cmsbs-conf/conf.d/guilogin.js:

Für weitere Details siehe Handbuch für Entwickler.

Änderung der Systemvoraussetzungen

Tomcat 10 wird nun offiziell unterstützt; siehe auch Handbuch zur Installation.

Beim Umstieg von Tomcat 8 oder 9 auf 10 muss jedoch die Kontextdefinition erweitert werden: Ab Tomcat 10 muss die Kontextdatei das <Loader jakartaConverter="TOMCAT" />-Element enthalten. Beispiel:

Anpassungen am Installer

Unter Tomcat ist die Option “server.xml durch eine minimale Version ersetzen” entfallen.

Ebenfalls unter Tomcat muss nun ausgewählt werden, ob die Installation in einen Tomcat 7.0, 8.5, 9.0 oder 10.0 erfolgen soll.

Fehlerkorrekturen

Ein Fehler, der unter bestimmten Umständen dazu geführt hat, dass unter Newsletter / Newsletter senden Newsletterentwürfe angezeigt wurden, die für den betreffenden User nicht sichtbar sein sollten, wurde korrigiert.