TopLogic - the automated application engine
  • Releases
  • Dokumentation
  • Github
  • Discord
  1. Home
  2. Releases
  3. TL_8.0.0-alpha7
  4. #29088

8.0.0-alpha7
TopLogic Release

2026-07-30

enhancement

critical
#29088
Modellbasierte Zugriffsrechte
#29108
Lightweight UI definition layer (TL Views) based on React UI-Components
major
#28694
Beschreibung von Modellteilen als formatierter Text (Rich Text)
#28708
Standard-Selektion in (Baum-)Tabellen und Grids per TL-Script berechenbar machen
#29102
Füge das Modul „com.top_logic.layout.react“ für die React/SSE-Integration hinzu
#29221
Automatische Bestimmung möglicher Berechtigungskonfigurationen
#29349
XML-Parse-Funktionen für TL-Script über XMLImporter
#29374
TL-Script: gzip()
#29389
Code-Completion für Variablen ($) im TL-Script-Editor
#29396
Conversation display for TL Views: object-list element, file chips, card panels
#29399
Info-Service-Meldungen: unten statt oben anzeigen und beim Überfahren mit der Maus fixieren
#29400
Introduce a first-class application "operation mode" service (OperationMode enum + ApplicationModeService)
minor
#29085
Neu einloggen bei Session Timeout anstatt Redirect zur Login-Seite
#29089
TL-Script-Funktionen log() und info() um wählbaren Meldungs-Level (INFO, WARN, ERROR) erweitern
#29195
Probleme mit HTML-Attributen und TL-Script
#29306
TL-Skript: Die Funktion „dateFormat()“ sollte eine explizite Zeitzone akzeptieren, um Kalenderwerte verlustfrei zu formatieren
#29382
Expose a public classpath-driven Workspace.getAppPaths overload
#29385
App archetype should scaffold a standard git-ignored local-credentials overlay (tl_config) by default
#29392
Transaktionsabbruch bei Nicht-2xx Response
#29398
Login-Maske: Statt "Name" besser "Benutzername"

defect

major
#29383
Dead SOCKET_APPENDER (Chainsaw, localhost:4445) in default logging config can stall logging and abort operations under load
#29384
TL-Script resetSequence/generateSequenceId build a different sequence id than SequenceDefaultProvider (suffix/context order), so they cannot reset a provider-managed sequence with a dynamic context
#29394
Editable tables in the React UI: generalized row-set bindings for tabular editing in forms
#29410
Attribut filename der Structured-Text-Bildablage case-sensitive (binär) speichern
#29419
Verständliche Fehlermeldungen bei Speichervorgängen und Rückmeldungen zur Formularvalidierung in der React-Darstellungsschicht
minor
#28816
Referenzwertige Attribute erzeugen Fehler nur bei SingleSelection
#29359
Unsinniger Tooltip bei einigen Hauptreitern
#29360
Sporadische Fehlermeldung im Log: "mainLayout" ist null.
#29361
Invalide Datenbankdefinition für Tag
#29363
Fehlende Validierung von Dialogen bei GOTOs zu Dialogen von unsichtbaren Parents
#29380
Kontextabhängige Auto-Nummerierung schlägt fehl, wenn Kontext und nummeriertes Objekt in einer Transaktion erzeugt werden
#29381
Doppelklick in Grafikkomponente funktioniert nicht zuverlässig
#29390
Teilbaum-Auswahl endet zu früh, wenn die unterste Ebene vom Ebenen-Filter nicht mitgezählt wird
#29393
URL-Routing der React-View-Schicht defekt: ForwardingReactContext delegiert getRouteManager() nicht
#29401
Bilder in einem Bild-Drop-Feld können nicht über das Browser-Kontextmenü kopiert/gespeichert werden
#29402
Baum-Selektion geht bei Aktualisierung der Ansicht (invalidate) verloren
#29412
Unzuverlässiger Test „TestDynamicComponentService.testIncrementalUpdates“: Überprüft das asynchrone WatchService-Ereignis nach einer festen Wartezeit von 10 ms
#29416
Anzeige des Änderungslogs schlägt fehl, wenn parallel Änderungen committet werden
#29420
FlowDiagram: Fehlerfall im row-wise Sub-Grid: subGridCols=2 und subGridStartCol=1
#29426
FlowDiagram: Text in PDF-eingebettetem Diagramm ist nicht selektierbar

task

major
#29407
Security-Scan: npm-Abhängigkeiten der React-Module aktualisieren
#29408
Security-Scan: httpcore5 anheben; pdfbox-/azure-Findings bewerten
minor
#29415
Das Repository CLAUDE.md verschlanken und die Leitfäden für Entwickler in Kompetenzbeschreibungen und FAQ-Artikel zusammenfassen
enhancement

critical

#29088

Modellbasierte Zugriffsrechte

MigrationModelAccessRightsSecurity

Derzeit erfolgt die Verwaltung der Zugriffsrechte in TopLogic auf Basis von Ansichten: Die Konfiguration „PersBoundComp“ legt fest, welche Rollen welche Befehlsgruppen in welchen Ansichten ausführen dürfen (CompoundSecurityLayout). Während die Rollenzuweisungen auf Modellinstanzen bereits modellbasiert sind, ist die endgültige Zuordnung der Berechtigungen (Befehlsgruppe → Rollen) an die Layoutstruktur gebunden.

Für Zugriffspfade außerhalb der Benutzeroberfläche (KI-Assistenten, REST-APIs, Batch-Jobs, TL-Script) gibt es keinen natürlichen Ansichtskontext, der ausgewertet werden könnte. Dadurch ist es unmöglich, Fragen wie „Welche Benutzer können welche Modellelemente lesen/aktualisieren/erstellen?“ direkt zu beantworten.

Dieses Ticket verfolgt die Konzeption und Umsetzung einer modellbasierten Zugriffsrechtsdefinition, die:

  • Zugriffsregeln (Operation → Rollen) auf Modellelementen (Typen, Attribute, Module) statt auf Ansichten definiert
  • eine ModelAccessRights-API für programmatische Zugriffsprüfungen bereitstellt
  • es ermöglicht, dass Ansichten ihre Berechtigungen aus Regeln auf Modellebene ableiten
  • die Abwärtskompatibilität mit der bestehenden ansichtsbasierten Konfiguration gewährleistet

Die Entwicklerartikel „access-configuration“ und „access-checks“ (Modul tl-core) beschreiben das System.

Migration

Modellbasierte Zugriffsrechte sind standardmäßig in jeder Anwendung aktiv: Der neue „SecurityConfigurationService“ wird vom Framework gestartet, und jeder Modellzugriff über TL-Script (sowie die darauf aufbauende Java-API) wird anhand seiner Konfiguration überprüft. Die Konfiguration ist standardmäßigauf „deny-by-default“ eingestellt: Ein Typ ohne Zugriffsberechtigung für eine Befehlsgruppe ist für keinen rollenbasierten Benutzer zugänglich (Administratoren und Code, der in einem Systemkontext ausgeführt wird, umgehen die Prüfungen).

Eine Anwendung, die ohne weitere Maßnahmen aktualisiert wird, funktioniert daher für Administratoren weiterhin, aber normale Benutzer sehen keine Modelldaten mehr in TL-Script-basierten Ansichten, und TL-Script-basierte Änderungen schlagen fehl. Jede Anwendung muss ein <security-config> für ihr Modell bereitstellen.

1. Konfigurieren Sie die Zugriffsrechte des Anwendungsmodells

Fügen Sie eine Dienstkonfiguration für com.top_logic.model.security.SecurityConfigurationService hinzu (z. B. als eigene *.config.xml, die in der Datei metaConf.txt der Anwendung registriert ist):

{{{#!xml <config service-class="com.top_logic.model.security.SecurityConfigurationService">

<instance>
<security-config>
<-- Basis für alle Typen eines Moduls. -->
<module name="myapp">
<grant operation="Read" roles="Viewer, Editor, Manager" inherit="true"/>
<grant operation="Write" roles="Editor, Manager" inherit="true"/>
<grant operation="Create" roles="Editor, Manager" inherit="true"/>
<grant operation="Delete" roles="Manager" inherit="true"/>
</module>

<-- Verfeinerung für einen einzelnen Typ, z. B. eine benutzerdefinierte Befehlsgruppe. -->
<class name="myapp:Order">
<grant operation="Approve" roles="Manager, Approver"/>
</class>

<-- Einschränkung auf Attributebene: schränkt die Berechtigung auf Typebene ein. -->
<part name="myapp:Customer#salary">
<grant operation="Read" roles="Manager"/>
<grant operation="Write" roles="Manager"/>
</part>

<-- Eine Berechtigung ohne Rollen verweigert den Vorgang für alle. -->
<part name="myapp:Contract#secret">
<grant operation="Read"/>
</part>

<-- Ansichten ohne Domänentyp: Verwenden Sie ein Modul-Singleton als Sicherheitsobjekt. -->
<singleton name="myapp:AdminPanel">
<grant operation="Read" roles="Admin"/>
<grant operation="Write" roles="Admin"/>
</singleton>
</security-config>
</instance>

</config> }}}

Regeln:

  • „operation“ ist eine „BoundCommandGroup“: die integrierten Gruppen „Read“, „Write“, „Create“, „Delete“ sowie beliebige benutzerdefinierte Befehlsgruppen der Anwendung.
  • Typ-, Modul- und vererbte Berechtigungen sind additiv (Vereinigung der Rollen). Attributberechtigungen (<part>) schränken ein: Der Benutzer benötigt das Recht auf Typebene und eine der Rollen der Attributberechtigung. Singleton-Berechtigungen sind eigenständig.
  • „inherit=“true““ überträgt eine Berechtigung auf Untertypen (bei einer Modulberechtigung: auch auf in anderen Modulen definierte Untertypen).
  • Die referenzierten Rollen müssen in der Datenbank vorhanden sein (z. B. über InitialRolesManager deklariert), und die Rollen werden weiterhin wie bisher pro Instanz zugewiesen (hasRole-Datensätze, Rollenregeln, Sicherheits-Elternkette). Ein Rollenname, der nicht aufgelöst werden kann, wird beim Start als Konfigurationsfehler gemeldet.
  • Ausgangspunkt für die Neuprogrammierung ist das bestehende Rollenprofil der Ansichten (PersBoundComp): Die dort für eine Befehlsgruppe konfigurierten Rollen werden zu den Rollen der entsprechenden Berechtigung für den angezeigten Typ. PersBoundComp selbst bleibt unverändert und regelt weiterhin die klassische Layout-Sicherheit.

Ein vollständiges Beispiel ist die Konfiguration der Demo-Anwendung in com.top_logic.demo/src/main/webapp/WEB-INF/conf/com.top_logic.model.security.SecurityConfigurationService.config.xml; das Konzept ist in den Entwicklerartikeln „access-configuration“ (ab 8.0.0-alpha10) und „access-checks“ (ab 8.0.0-alpha12) des Moduls tl-core dokumentiert.

2. Wo die neuen Prüfungen gelten
  • Das Auslesen eines Attributs in TL-Script ($obj.get(...)) liefert den leeren Wert zurück, wenn der Benutzer das Attribut an diesem Objekt nicht lesen darf.
  • Änderungen (set, add, remove), das Anlegen (new) und das Löschen (delete) schlagen mit einer „TopLogicException“ fehl, wenn das entsprechende Recht fehlt.
  • TL-Script-basierte Modellgeneratoren filtern ihre Ergebnisse nach Lesezugriff: ListModelByExpression, ModelProviderByExpression, TreeModelByExpression, SelectionUpdaterByExpression, TableContentProvider, ForeignObjectsTemplateProvider und die Skriptkonsole.
  • copy() und die BPE-Prozessinstanziierung prüfen das CREATE-Recht.
  • Nicht geprüft werden: berechnete (abgeleitete) Attribute – diese werden mit den Rechten des Definierers ausgewertet –, Constraints, interne Framework-Skripte, Code in einem Systemkontext sowie Administratoren.
  • all() und kbQuery() geben bewusst ungefilterte Ergebnisse zurück; der Aufrufer filtert (in TL-Script mit filterSecurity(), in Java mit SearchExpression.filterSecurity(...)).
  • Ein Skript, das ohne angemeldeten Benutzer ausgeführt wird, verfügt über keinerlei Rechte. Hintergrundaufträge (Aufgaben, Stapelverarbeitung) müssen in einem Systemkontext (ThreadContext.inSystemContext(...)) ausgeführt werden oder einen Executor mit deaktivierter Sicherheit verwenden (siehe Abschnitt 6).
3. Sicherheitseltern: `getSecurityParent()` wird ersetzt

`AbstractBoundWrapper.getSecurityParent()` ist nun final und löst eine `UnsupportedOperationException` aus. Anwendungen, die den einwertigen Sicherheitselternteil überschreiben, müssen angepasst werden:

  • Entweder ` BoundObject.getSecurityParents()` überschreiben (mit Rückgabe einer Sammlung – die Sicherheitshierarchie ist nun ein DAG),
  • oder – bevorzugt – den Elternteil deklarativ im AccessManager konfigurieren:

{{{#!xml <config service-class="com.top_logic.tool.boundsec.manager.AccessManager">

<instance>
<security-parents>
<rule id="ProjectForMilestone"
inherit="true"
meta-element="myapp:Milestone"
>
<step attribute="myapp:Milestone#project"/>
</rule>
<rule id="SecRootForProject"
inherit="true"
meta-element="myapp:Project"
>
<singleton module="SecurityStructure"/>
</rule>
</security-parents>
</instance>

</config> }}}

Verhaltensänderung: Die globale Sicherheitswurzel wird nun nur noch als Fallback verwendet. Sobald Sicherheitseltern für einen Typ konfiguriert sind, wird die Wurzel nicht mehr automatisch hinzugefügt. Ein Typ, der die Wurzel in seiner Elternkette benötigt, muss sie explizit mit dem neuen <singleton> -Pfadelement benennen (wie im obigen Beispiel). Andernfalls werden Rollen, die auf der Sicherheitswurzel gewährt wurden, nicht mehr an diese Objekte vererbt.

4. Regel-IDs

Rollenregeln und Sicherheits-Elternregeln erfordern eine ID. Bestehende Konfigurationen werden durch die Migration von #29221 (AddRoleRuleId) abgedeckt; manuell hinzugefügte Regeln benötigen eine eigene ID.

5. Neue Framework-Konfiguration für Konten
  • Eine neue Rolle „PersonalProfile“ wird (in InitialRolesManager) zusammen mit einer Rollenregel deklariert, die diese jedem Benutzer für sein eigenes Konto gewährt, sowie Lese-/Schreibberechtigungen für „tl.accounts:Person“ und die entsprechende Kontaktkonfiguration in „com.top_logic.contact“. Dadurch kann ein Benutzer sein eigenes Konto und seine eigenen Kontaktdaten einsehen und bearbeiten. Anwendungen, die bereits eine Rolle mit diesem Namen definieren, müssen ihre Rolle umbenennen.
  • Das Schreiben in „tl.accounts:Person#admin“ wird für alle verweigert (Zugriff ohne Rollen), d. h., das Flag kann nicht mehr über den Modellzugriff (TL-Script, REST) gesetzt werden; es wird ausschließlich über die Kontoverwaltung geändert.
6. Benutzerdefinierter Java-Code
  • Ein „QueryExecutor“ wendet standardmäßig Sicherheitsmaßnahmen an. Interne Abfragen, die unabhängig vom aktuellen Benutzer alle Objekte einsehen müssen, müssen „QueryExecutor.disableSecurity()“ explizit aufrufen.
  • Benutzerdefinierte, in Java implementierte TL-Script-Funktionen, die das Modell lesen oder schreiben, sollten GenericMethodWithSecurity / SearchExpressionWithSecurity erweitern und usesSecurity() auswerten (Prüfung mit ModelAccessRights.getInstance()), damit sie zusammen mit dem umgebenden Ausdruck deaktiviert werden können. Einfache „GenericMethod“-Implementierungen lassen sich weiterhin kompilieren, umgehen jedoch die Modellsicherheit.
  • Programmatische Zugriffsprüfungen sind über den ModelAccessRights-Dienst verfügbar (isAllowed, isReadAllowed, isAllowedCreate, getAllowedRoles, getAccessibleTypes); die entsprechenden TL-Script-Funktionen lauten canRead, canWrite, canDelete, canCreate, canReadAttribute, canWriteAttribute, canExecute und filterSecurity.
7. Entferntes veraltetes Modulsystem und weitere Änderungen an der Java-API

Im Zuge der Überarbeitung wurde die veraltete, auf Eigenschaften basierende Service-Modul-Familie aus com.top_logic.basic.module entfernt: RuntimeModule, ConfiguredRuntimeModule, MultiRuntimeModule, RuntimeModuleProxy, ServiceManager, DefaultServiceManager sowie die Konstruktoren ManagedClass(Properties) / ManagedClass(IterableConfiguration). Ein Anwendungsdienst, der diese weiterhin verwendet, lässt sich nicht mehr kompilieren und muss auf typisierte Konfiguration umgestellt werden:

{{{#!java @ServiceDependencies({ OtherService.Module.class }) // ersetzt getDependencies() public class MyService extends ConfiguredManagedClass<MyService.Config> {

public interface Config extends ConfiguredManagedClass.Config<MyService> {
@Name("some-option") String getSomeOption(); // ein typisierter Getter pro früherer Eigenschaft
}
@CalledByReflection
public MyService(InstantiationContext context, Config config) { super(context, config); }
public static final class Module extends TypedRuntimeModule<MyService> {
public static final Module INSTANCE = new Module();
@Override public Class<MyService> getImplementation() { return MyService.class; }
}

} }}}

Die bisherige Eigenschaft <section> wird zu einem Eintrag <config service-class="..."><instance class="..." some-option="..."/></config>; eine konfigurierbare Implementierungsklasse (Eigenschaft der Klasse`ConfiguredRuntimeModule`, ` RuntimeModuleProxy) ist das Klassenattribut von `<instance>`.

Weitere durch dieses Ticket vorgenommene Änderungen:

  • Die Konstruktoren ohne Argumente / Properties von DataManager, FileSystemCache, FlexDataManagerFactory, EncryptedFlexDataManagerFactory, InitialDataSetupService und CommandApprovalService werden durch Konstruktoren vom Typ (InstantiationContext, Config) ersetzt; Unterklassen müssen diese bereitstellen.
  • BoundChecker#getRolesForCommandGroup(...) muss eine nicht-null-Sammlung zurückgeben (Collections.emptySet() anstelle von null); die Standardimplementierung von allow(...) toleriert null nicht mehr.
  • Die Konfigurationseigenschaft „disable-optimizations“ von ModelBasedSearch wurde entfernt (der Optimierer ist immer aktiviert); löschen Sie sie aus der Konfiguration des ModelBasedSearch-Dienstes einer Anwendung, da die Konfiguration andernfalls mit einer unbekannten Eigenschaft fehlschlägt.
  • RoleComputation(StorageAccessManager) wurde zu RoleComputation(Person, StorageAccessManager); ElementAccessManager erhielt die Hooks getSecurityParents(BoundObject) und canHaveRole(TLClass, BoundedRole) für Anwendungszugriffsmanager.
  • „AbstractCssClassUpdate.writeCssClassContent(...)“ ist öffentlich und abstrakt (ein „protected override“ lässt sich nicht mehr kompilieren).
  • Get Started
  • Github
  • Discord
  • Das Unternehmen hinter TopLogic
  • Softwareentwicklung heute
  • Kontakt

© Copyright – Business Operation Systems GmbH

  • top-logic.com
  • Nutzungsbedingungen
  • Impressum
  • Rechtlicher Hinweis
  • Datenschutz
  • EN
  • Login