enhancement
major
minor
major
minor
major
#29564
SecurityConfigurationService: Eine Anwendung kann einer Berechtigung eines Framework-Typs keine Rolle hinzufügen – eine „ <class> “-Berechtigung ist nach Operation indiziert und ersetzt den früheren Eintrag, wodurch die Rollen des Frameworks stillschweigend widerrufen werden.
Betrifft 8.0.0-SNAPSHOT (11.09.2026), tl-core (SecurityConfigurationService, AccessRightsConfig).
tl-element gewährt „PersonalProfile“ die Leseoperation für „tl.accounts:Person“ (personalProfileSecurity.config.xml). Eine Anwendung, deren Buchhalter jedes Konto lesen müssen (eine Arbeitsliste der Mitarbeiter ist eine Tabelle mit „Person“- Zeilen, und ein TL-Script-Ergebnis wird entsprechend den Leserechten des Lesers gefiltert), fügt Folgendes hinzu
{{{#!xml <class name="tl.accounts:Person">
<grant inherit="true" operation="Read" roles="expenses.accountant"/>
</class> }}}
Berechtigungen sind eine nach der Operation indizierte Zuordnung (AccessRightsConfig.java:27–36), sodass der Eintrag der Anwendung den des Frameworks **ersetzt**: „PersonalProfile“ verliert seine Leseberechtigung für das Konto, und ein gewöhnlicher Benutzer kann sein eigenes Konto nicht mehr einsehen. Es erfolgt keine Warnung. Die Anwendung muss die Rollen des Frameworks wiederholen (roles="PersonalProfile, expenses.accountant") und bindet dadurch das Wissen über die Sicherheitskonfiguration eines anderen Moduls fest ein.
Erwartet: Entweder werden die Rollenlisten der Berechtigungen für dieselbe Operation über Konfigurationsebenen hinweg zusammengeführt (additiv, entsprechend der additiven Kombination von Typ- und Modulberechtigungen in Abschnitt 2.4.2 der Spezifikation), oder die Anweisungen zur Zusammenführung von Listen in der typisierten Konfiguration (config:operation="add" für die Rollen) für Berechtigungen unterstützt, oder die Überschreibung wird zumindest mit beiden Rollensätzen protokolliert.
Lösung
Die Berechtigungen eines Zielelements (<class>, <module>, <part>, <singleton>) sind nicht länger eine nach der Operation indizierte Zuordnung, sondern eine geordnete Liste von Zugriffsregeln, die nacheinander angewendet werden. Da Konfigurationsebenen an eine Liste angehängt werden, folgen die Einträge einer Anwendung den Einträgen des Frameworks und ersetzen diese niemals.
- <grant operation="…" roles="…" inherit="…"/> fügt der Operation die angegebenen Rollen hinzu (wie bisher; bestehende Konfigurationsdateien bleiben unverändert).
- <revoke operation="…" roles="…" inherit="…"/> entfernt die angegebenen Rollen aus der Operation. Ohne Rollen wird der gesamte Eintrag der Operation entfernt, unabhängig davon, welche Regel die Rollen beigesteuert hat: Bei einem Attribut bedeutet dies, dass das Attribut die Operation nicht mehr einschränkt und die Entscheidung der Klasse gilt; bei einem Typ wird die Operation für jede Rolle verweigert, bis eine spätere Regel sie wieder gewährt. Eine spätere Ebene kann nach einem Widerruf erneut eine Berechtigung erteilen.
- Anwendungsreihenfolge: Die Moduleinträge einer Klasse (die additive Basis) werden zuerst angewendet, dann die klasseninternen Einträge in der Reihenfolge ihrer Konfiguration. Klassen werden nach dem Prinzip „Generalisierung zuerst“ ausgewertet: Eine Klasse beginnt mit den Rollen, die ihre Supertypen weitergeben. Ein <grant inherit="true"> fügt den an Spezialisierungen weitergegebenen Rollen etwas hinzu, ein <revoke inherit="true"> entfernt etwas daraus; bei inherit="false" ist nur der exakte Typ betroffen. Attribute und Singletons kennen keine Vererbung und wenden einfach ihre Reihenfolge an.
Technisch gesehen ist `AccessRightsConfig#getGrants()` eine Liste der abstrakten `AccessRule` (Eigenschaften: operation, roles, inherit) mit den markierten Untertypen `AccessGrant ` (Gewährung) und `AccessRevoke ` (Entzug). Der `SecurityConfigurationService` erstellt seine Nachschlagetabellen, indem er die Regeln in der oben beschriebenen Reihenfolge anwendet. Die Spezifikation specs/model-based-access-rights.md (Abschnitte 2.4.1, 2.4.2) wurde entsprechend aktualisiert.
Verifizierung: TestAccessRulesConfig (tl-core) liest zwei Konfigurationsebenen ein und überprüft, ob die Regeln beider Ebenen erhalten bleiben und ob <revoke> geparst wird. TestTLScriptSecurity (tl-model-search) führt den Dienst auf einer zweiten Konfigurationsebene aus, die Rollen zur Leseberechtigung für das Projekt hinzufügt, Rollen bei einer Spezialisierung widerruft, einen Attributeintrag ohne Rollen widerruft, nach einem Widerruf erneut Berechtigungen erteilt und das Vererbungsflag in beide Richtungen überprüft; wobei sichergestellt wird, dass die ursprünglichen Rechte der ersten Ebene unverändert bleiben.
Migration
Eine Anwendung, die ein <grant> für eine Operation deklariert hat, die ein Framework-Modul bereits für denselben Typ gewährt, war darauf angewiesen, die Rollen des Frameworks zu ersetzen. Da Berechtigungen nun additiv sind, behält eine solche Anwendung die Rollen des Frameworks zusätzlich zu ihren eigenen bei. Um eine Framework-Rolle zu entfernen, fügen Sie ein <revoke operation="…" roles="…"/> in die Anwendungskonfiguration ein; um die gesamte Regelsequenz eines Typs zu ersetzen, verwenden Sie config:override="true" im <class> -Element.
Code, der AccessRightsConfig#getGrants() aufruft, erhält eine `List<AccessRule> ` anstelle eines auf ` CommandGroupReference` basierenden Schlüssels.