major
#29529
Stellvertreter als explizite Sicherheitsaktion im Einstellungsdialog der TL Views benennen (mit Passwortbestätigung, auch für die Passwortänderung)
Ziel
Folgemaßnahme zu #29525, bei der der Kontobereich der App-Leiste als Kernansicht der Ebene „com.top_logic.layout.view“ angeboten wird. Was ein Nutzer dort für sein eigenes Konto festlegt, sind die Sprache, das Design, die Startseite, die Zeitzone, das Land und die Zwei-Faktor-Authentifizierung. Die Benennung eines Stellvertreters – also einer Person, die während der Abwesenheit des Nutzers mit genau den Rechten dieses Kontos handelt – gehört nicht dazu, obwohl die Engine dieses Konzept schon so lange unterstützt, wie es Konten gibt.
Der aktuelle Stand
Das Modell sieht es vor. Jedes tl.accounts:Person besitzt eine representativeGroup, eine tl.accounts:RepresentativeGroup, die zusammen mit dem Konto erstellt wird und deren Mitglieder die Stellvertreter dieses Kontos sind. BoundedRole gewährt diesen Mitgliedern die Rollen des Kontos, für das sie einspringen; somit ist die Mitgliedschaft in dieser Gruppe das, was die Rechte tatsächlich delegiert. Umgekehrt gibt „Person#deputyFor“ an, für welche Konten man einspringt.
Die klassische Benutzeroberfläche bietet dies an. Der Konto-Editor zeigt dem Benutzer die Mitglieder der Gruppe über com.top_logic.layout.formeditor.accounts an .„RepresentativeField“, ein Formular-Editor-Element, das das Fremdattribut „RepresentativeGroup#members“ übernimmt und es mit „Stellvertreter“ beschriftet; der Ansprechpartner-Editor tut dies manuell (EditPersonContactComponent.PARAM_REPRESENTATIVES, angewendet durch ContactApplyHandler).
Die Ansichtsebene tut dies nicht. settings-tabs.view.xml enthält die Zeitzone und das Land auf der Registerkarte „Konto“ sowie den zweiten Faktor auf der Registerkarte „Sicherheit“, und das Kontomenü enthält die Einstellungen für die Ein-Klick-Entscheidung. Nirgendwo in dieser Ebene wird die Vertretergruppe erreicht. „admin/access-control/accounts.view.xml“ bietet einem Administrator die Referenz „representativeGroup“ und „deputyFor“ an – die Gruppe als Objekt, nicht die darin enthaltenen Personen –, sodass selbst dort die Stellvertreter eines Kontos nicht namentlich genannt werden können.
Lösung
Eine explizite Aktion, kein Formularfeld. Die Benennung eines Stellvertreters überträgt alle Rollen, die das Konto innehat; daher wird dies nicht als weiteres Feld im Kontoformular eingegeben. Sie wird in die Registerkarte „Sicherheit“ des Einstellungsdialogs neben der Passwortänderung und der Zwei-Faktor-Authentifizierung integriert: Eine Statuszeile nennt die aktuellen Stellvertreter (oder gibt an, dass keiner benannt ist), eine zweite Zeile – die nur angezeigt wird, wenn etwas zu melden ist – nennt die Konten, für die der Benutzer einspringt, und eine Schaltfläche „Stellvertreter benennen“ („Stellvertreter benennen“) öffnet einen eigenen Dialog. Die Zeilen werden bei Änderungen aktualisiert, ohne den Dialog neu zu öffnen: Die Gruppe befindet sich auf einem eigenen Kanal, und ein Kanal beobachtet das Objekt, das sie enthält.
Der Stellvertreter-Dialog (deputies.view.xml) ist an die Vertretergruppe des Kontos gebunden. Er erläutert die Konsequenz in einfachen Worten, bietet ein Mehrfachauswahlfeld über „RepresentativeGroup#members“ an – die Kandidaten sind diejenigen, die das Modell vorschlägt, d. h. die Options-Annotation des Kontaktmoduls (jedes Konto außer dem Eigentümer), die eine Anwendung durch ihr eigenes Modell-Overlay weiter eingrenzt – und wird über einen Befehl in der Schaltflächenleiste angewendet: Identitätsprüfung (siehe unten), Bestätigung, anschließend die Änderung innerhalb einer Transaktion, dann schließt sich der Dialog. Beide Prüfungen finden außerhalb der Transaktion statt.
Identitätsprüfung als wiederverwendbare Schutzmaßnahme. Die Ansichtsebene erhält <verify-identity/> (VerifyIdentityAction), eine unterbrechbare Aktion, die wie <confirm> in eine Befehlskette eingefügt wird. Sie stellt sicher, dass die Person am Bildschirm der Kontoinhaber ist, so wie die Sitzung eingerichtet wurde:
- Eine über einen externen Identitätsanbieter (OpenID Connect via pac4j) angemeldete Sitzung wird an diesen Anbieter zurückgeleitet. Ein Dialog im Hauptfenster bietet die eigene Schaltfläche der Anmeldemethode an; er öffnet die Anmeldung des Anbieters in einem zweiten Browserfenster mit der URL zur erneuten Authentifizierung der Anmeldemethode (LoginMethod#getReauthenticationUrl). Der Anbieter authentifiziert den Benutzer erneut (max_age=0, prompt=login), der Callback kehrt in derselben HTTP-Sitzung mit einem Einmal-Token (ExternalAuthenticationServlet.VERIFICATION_PARAM), und das Servlet – ohne sich anzumelden, da die Sitzung bereits besteht – schließt die unter diesem Token registrierte „PendingIdentityVerification“ ab (IdentityVerifications, sitzungsgebunden, zehn Minuten, an das erwartete Konto gebunden): Der Dialog im Hauptfenster schließt sich von selbst, und die Abfolge wird in diesem Fenster fortgesetzt. Das zweite Fenster ist ein Fenster der Seite, die es geöffnet hat; daher schließt die Bestätigungsseite es; sollte ein Browser sich weigern, es zu schließen, zeigt die Seite an, dass die Identität bestätigt wurde und das Fenster geschlossen werden kann. Was die Kette nach der Bestätigung tut – die Passwortänderung, der Bestätigungsdialog der Stellvertreter – läuft in dem Fenster ab, das die Anfrage gestellt hat; ein Fehler wird dort wie der Fehler eines beliebigen Befehls angezeigt, und die Anfrage, die die Bestätigung ausgelöst hat, liefert nur die Antwort zur Identität. Ein anderer Benutzer, ein abgelaufenes oder unbekanntes Token lassen die Kette in der Warteschlange stehen; die Ergebnisseite im zweiten Fenster weist darauf hin.
- Bei jeder anderen Sitzung wird in einem kleinen Dialogfeld (PasswordPromptDialogControl) nach dem Passwort gefragt, das über das AuthenticationDevice des Kontos überprüft wird – dieselbe Überprüfung, die auch bei der Anmeldung erfolgt, sodass LDAP-Konten anhand des Verzeichnisses verifiziert werden. Bei einem falschen Passwort bleibt das Dialogfeld mit der Fehlermeldung unter dem leeren Eingabefeld geöffnet.
- Ist keines davon verfügbar – kein Sitzungskonto, das anonyme Konto, ein headless-Kontext –, bricht die Kette ab: Die Schutzfunktion schlägt fehl (geschlossen).
Optionaler Titel und Meldung benennen, was bestätigt wird. Die Sicherheitsprüfung schützt auch die freiwillige Passwortänderung (change-password.view.xml); die erzwungene Passwortänderung nach einer Anmeldung mit einem abgelaufenen Passwort behält ihren Ablauf bei, da das Konto sich gerade erst authentifiziert hat.
Nur ein Passwort, das von der Anwendung verwaltet wird, kann geändert werden. Ein Konto, das von einem Gerät authentifiziert wurde, das das Passwort an anderer Stelle speichert – einem Verzeichnisdienst, einem Identitätsanbieter –, kann es hier nicht ändern; daher bietet der Einstellungsdialog „Passwort ändern“ nur dort an, wo dies möglich ist: Die TL-Script-Funktion `accountPasswordChangeAllowed`() (AccountFunctions, die das Gerät des Kontos nach „allowPwdChange()“ abfragt) steuert die Schaltfläche über die generische <visible-if> -Regel, und „ChangePasswordApplyAction“ lehnt ein solches Konto mit einer eigenen Meldung ab, bevor das Gerät um Eingaben gebeten wird. Ein über den Einstellungsdialog geändertes Passwort schließt den Dialog, sobald es übernommen wurde.
pac4j. Für jeden konfigurierten OpenID-Connect-Client registriert die Anwendung einen abgeleiteten Client namens <client>-reauthentication mit denselben Einstellungen sowie max_age=0 und prompt=login, sodass bei gewöhnlichen Anmeldungen das Single Sign-On erhalten bleibt; Die Anmeldemethode antwortet nur für die von ihr aufgebaute Sitzung auf eine Reauthentifizierungs-URL und verwirft das gespeicherte pac4j-Profil, sodass der Sicherheitsfilter zum Anbieter weitergeleitet wird. Der Callback-Filter behält die Sitzung bei (renewSession=false): Eine Anmeldung erstellt anschließend eine eigene Sitzung, eine Bestätigung gehört zur laufenden Sitzung. Die Anmelde-URL wählt ihren Client anhand des Parameters aus, den der Sicherheitsfilter ausliest (force_client).
React-Ebene, keine Modelländerung. Die repräsentative Gruppe, ihre Mitglieder und die Optionsbeschränkung bleiben unverändert. Die umgekehrte Richtung („du vertrittst“) wird in der Ansicht berechnet, indem abgefragt wird, zu welchen Konten der Benutzer als Mitglied der repräsentativen Gruppe gehört; sie ist also nicht auf die Ableitung von `deputyFor` angewiesen, die nur das Kontaktmodul bereitstellt. Die React-Demo erhält das pac4j-Modul und eine Keycloak-Client-Konfiguration, die über die Umgebung überschrieben werden kann.
Der Lesezugriff auf Konten ist eine Entscheidung der Anwendung. Jeder Wert, den eine Ansicht berechnet, wird anhand des Lesezugriffs gefiltert, und die Engine gewährt einem Konto Lesezugriff nur auf sein eigenes Konto (PersonalProfile), sodass ein Benutzer, der kein Administrator ist, weder die repräsentative Gruppe noch die anderen Konten sieht. Die React-Demo gewährt jedem Mitglied ihrer Benutzergruppe Lesezugriff auf alle Konten und Gruppen (Rolle „demo.react.AccountReader“, gewährt durch Rollenregeln in „demoReactConf.config.xml“); eine Anwendung entscheidet selbst, ob und welche Konten ein Benutzer sehen darf.
Unterwegs behoben
- TLObjectOverlay, der Bearbeitungspuffer eines Ansichtsformulars, antwortete auf jede Rückreferenzabfrage (tReferers) mit „nichts“, sodass ein Optionsausdruck, der vom bearbeiteten Objekt rückwärts navigierte – der den Eigentümer ausschließende Filter des Kontaktmoduls bei RepresentativeGroup#members –, nichts filterte und das Konto als seinen eigenen Stellvertreter anbot. Das Overlay antwortet nun auf Rückverweise von dem Objekt, für das es steht.
- WithTransactionAction meldete nicht, dass seine verschachtelten Aktionen den Formularzustand anwenden, sodass ein als <with-transaction><store-form-state/></with-transaction> geschriebener Formularbefehl – darunter das Speichern des Einstellungsdialogs – die Regel verlor, die ihn deaktiviert hält, solange das Formular ungültig ist.
- ReactButtonControl kann sein Navigationsziel in einem eigenen Browserfenster öffnen; ReactWindowReplay.inWindow ist die gemeinsame Methode, um von einem Thread aus, der einen anderen bedient, auf ein Fenster einzuwirken.
- Der aus dem Einstellungsdialog geöffnete Dialog zum Ändern des Passworts blieb nach der Passwortänderung geöffnet.
Beobachtet, nicht geändert
- TL-Script-Referrer, die in einem <derived-channel> ausgewertet werden, werden durch den Lesezugriff auf das Basisobjekt gefiltert: Ein Benutzer, der lediglich Mitglied einer Gruppe ist, kann nicht von der Gruppe zu deren Eigentümer navigieren, während „all(...)“ und „forward get(...)“ nicht gefiltert werden.
- Eine von einem anderen Benutzer beim Anbieter durchgeführte erneute Authentifizierung hat keinen Einfluss auf die Anwendungssitzung, sondern wechselt die providerinterne Single-Sign-On-Sitzung auf diesen Benutzer; das Abmelden aus der Anwendung beendet die Sitzung des Anbieters nicht.
- Ein Konto, das sich weder per Passwort noch über einen externen Anbieter authentifiziert, kann die Schutzbarriere nicht passieren.
Außerhalb des Geltungsbereichs
Befugnisübertragung, die auf einen bestimmten Zeitraum beschränkt ist, sowie der Wechsel in die Sitzung eines anderen Kontos. Bei diesem Ticket geht es um die Benennung der Stellvertreter des eigenen Kontos aus dem Kontobereich heraus, wobei die Engine die entsprechenden Rechte bereits daraus ableitet.