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).