- Modul status (Migration 044): Störungen und Wartungen mit Zustand, Auswirkung, Bereich, Zeitraum und Meldungsverlauf. Öffentlich (/v1/public/status, Seite /status) nur, was das Personal veröffentlicht – nur dessen Texte, keine Kunden-/Ressourcen-/Anbieterdaten, nicht aus den internen Betriebsalarmen gespeist. Gesamtzustand aus aktiven Einträgen; angekündigte Wartungen zählen erst ab Beginn. - Verwaltung /admin/status (Support/Admin/Superadmin; Buchhaltung und Kunden nicht), Navigation. - Tests: API (Rechte, Veröffentlichung, Zustände, Abschluss, Felder) und Browser (Status- und Registrierungsseite barrierefrei, 12/12 grün). Passkeys und Berichte bleiben eigene offene Teilaufgaben. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
11 KiB
Sicherheit: Rollen, Rechte und Bedrohungsmodell
Stand: 06.10.2026, abgeleitet aus dem Code (apps/api/src/core/policy.ts, KcModule.permissions aller Module, packages/platform/src/ticketPolicy.ts). Diese Datei ist die Referenz; bei neuen Rechten bitte hier nachtragen.
1. Rollen
Personal (users.kind = 'staff', Feld staff_role): support, accounting (Buchhaltung), admin, superadmin. 2FA ist für Personal Pflicht – ohne eingerichtete 2FA ist nur die Einrichtung erreichbar (requireAuth: MFA_ENROLL_REQUIRED).
Kunden (users.kind = 'customer') haben je Organisation eine Rolle (memberships.role): owner (Inhaber), admin (Kundenmitarbeiter mit Verwaltungsrechten), member (Kundenmitarbeiter). Kundenrechte gelten immer nur für die eigene Organisation (canInOrg); Personalrechte sind global.
2. Rechte-Matrix
2.1 Personal (global)
| Recht | support | accounting | admin | superadmin |
|---|---|---|---|---|
| customers.read | ✓ | ✓ | ✓ | ✓ |
| customers.write | ✓ | ✓ | ||
| customers.impersonate („Als Kunde ansehen“) | ✓ | ✓ | ||
| users.read | ✓ | ✓ | ✓ | |
| users.write (Personal/Kundenkonten verwalten) | ✓ | ✓ | ||
| users.write_privileged (Admins anlegen, Staff-2FA/-E-Mail ändern) | ✓ | |||
| audit.read | ✓ | ✓ | ||
| jobs.read (Aufträge, Betriebsübersicht) | ✓ | ✓ | ||
| settings.write (Firma, Lizenz, Rechnungsstammdaten) | ✓ | |||
| tickets.read | ✓ | ✓ | ✓ | ✓ |
| tickets.write (antworten, zuweisen, schließen, Posteingang) | ✓ | ✓ | ✓ | |
| invoices.read | ✓ | ✓ | ✓ | ✓ |
| invoices.write (Entwurf, ausstellen, bezahlt, Storno, Abrechnungslauf) | ✓ | ✓ | ✓ | |
| products.read / products.write | ✓ / – | ✓ / – | ✓ / ✓ | ✓ / ✓ |
| domains.read / domains.write | ✓ / – | ✓ / – | ✓ / ✓ | ✓ / ✓ |
| orders.read, contracts.read | ✓ | ✓ | ✓ | ✓ |
| orders.write, orders.approve, contracts.write | ✓ | ✓ | ||
| contracts.edit (Vertragsdaten nachträglich ändern) | ✓ | |||
| resources.read / resources.write | ✓ / – | ✓ / – | ✓ / ✓ | ✓ / ✓ |
| licenses.read / licenses.write | ✓ / – | ✓ / – | ✓ / ✓ | ✓ / ✓ |
| connectors.read / connectors.write | ✓ / – | ✓ / ✓ | ||
| backup.read, backup.run / backup.secrets | ✓ / – | ✓ / ✓ | ||
| email.read / email.write (SMTP, IMAP, Vorlagen) | ✓ / – | ✓ / ✓ | ||
| discord.read / discord.write | ✓ / – | ✓ / ✓ | ||
| license.read (eigene Installationslizenz) | ✓ | ✓ |
2.2 Kunden (nur eigene Organisation)
| Recht | owner | admin | member |
|---|---|---|---|
| org.read | ✓ | ✓ | ✓ |
| org.members.read, org.members.invite | ✓ | ✓ | |
| tickets.read, tickets.create | ✓ | ✓ | ✓ |
| invoices.read (nur ausgestellte, keine Entwürfe) | ✓ | ✓ | ✓ |
| orders.read, contracts.read | ✓ | ✓ | ✓ |
| orders.create, contracts.cancel | ✓ | ✓ | |
| resources.read | ✓ | ✓ | ✓ |
resources.manage (Produktaktionen laut customer_actions, Panel-Login) |
✓ | ✓ | |
| licenses.read | ✓ | ✓ | ✓ |
| licenses.manage | ✓ | ✓ |
Interne Ticketnotizen und Rechnungsentwürfe sind für Kunden unsichtbar (404). Produktaktionen für Kunden sind zusätzlich je Produkt freigeschaltet (products.customer_actions); destruktive Aktionen bleiben Personal.
2.3 Impersonation („Als Kunde ansehen“, #35)
- Recht
customers.impersonate(admin, superadmin), Begründung Pflicht, Dauer 60 min (IMPERSONATION_MINUTES), danach automatisch beendet. - Während der Impersonation gilt die Sitzung als Kunde (
ownergenau dieser Organisation) – keine Personalrechte, keine fremden Organisationen. Oberfläche zeigt eine dauerhafte Hinweisleiste mit Grund. - Start, manuelles und automatisches Ende werden auditiert (
customer.impersonate.start/end).
2.4 Gleiche Rechte in API und Worker
Der Worker führt Aufträge aus, die die API nach der Rechteprüfung eingeplant hat. Eigene Eingänge des Workers prüfen dieselben Regeln: Discord nutzt ticketPolicy (Buchhaltung kann per Discord nicht schreiben, #110), IMAP ordnet nur mit signiertem Antwort-Bezug und aktiver Mitgliedschaft zu (#107). Geplante Lizenzmodule (#116) werden in API und Worker geprüft, sobald die Modulmatrix (#113) feststeht.
3. Bedrohungsmodell
Annahmen: Angreifer von außen ohne Konto; Kunde, der fremde Daten sehen will; kompromittiertes Kundenkonto; neugieriges/fehlerhaftes Personal mit eingeschränkter Rolle; gefälschte Eingänge aus E-Mail/Discord/Anbietern. Nicht betrachtet: Root auf dem Server (dann ist alles verloren – Backups und Schlüssel getrennt halten).
| # | Bedrohung | Maßnahme | Modul | Negativtest / Nachweis |
|---|---|---|---|---|
| T1 | Mandantentrennung: Kunde liest/ändert Daten einer fremden Organisation per ID | canInOrg bei jedem Objektzugriff, fremde IDs → 404 |
alle | API: core.test.ts „trennt Mandanten strikt“, orders/tickets-Tests; Browser: apps/e2e (fremde Organisation/Mitglieder 403/404) |
| T2 | Rechteausweitung durch eingeschränktes Personal | Rechte je Rolle zentral, users.write_privileged für Admin-Anlage/Staff-2FA/-E-Mail, Selbständerung gesperrt |
identity | API: core.test.ts (2FA-Reset für Mitarbeiter nur Superadmin), Rollen in Modultests; Discord: helpers.test.ts (Ticket-Policy) |
| T3 | Konto-Übernahme: Passwort raten | Argon2id, Sperre nach Fehlversuchen, Rate-Limits (Login 10/min, 2FA 10/min, Reset 5/10 min) | identity | core.test.ts „sperrt das Konto nach 5 Fehlversuchen“, „lehnt falsches Passwort generisch ab“ |
| T4 | Konto-Übernahme: 2FA umgehen / Code wiederverwenden | TOTP verschlüsselt, last_step verhindert Replay, Personal-2FA Pflicht, Wiederherstellungscodes gehasht |
identity | core.test.ts „speichert das TOTP-Secret nur verschlüsselt“; Browser: 2FA-Replay abgewiesen (apps/e2e) |
| T5 | CSRF | Same-Origin-Proxy, CSRF-Token-Header + Origin-Prüfung gegen KC_BASE_URL |
core/auth | core.test.ts „verlangt CSRF-Token bei schreibenden Requests“ |
| T6 | Login-/Einladungs-/Reset-Links abgegriffen | Einmal-Token, gehasht gespeichert, Ablauf; E-Mail-Änderung entwertet offene Links und beendet Sitzungen | identity | core.test.ts (E-Mail-Änderung: alte Einladung ungültig), Reset-Tests |
| T7 | Impersonation-Missbrauch | Nur admin/superadmin, Grund Pflicht, 60 min, auditiert, nur Kundenrechte | customers, core/auth | security.test.ts (Rolle, Grund, nur diese Organisation, keine Personalrechte, Audit start/end) |
| T8 | Connector-Secrets (API-Keys der Anbieter) abfließen | AES-256-GCM mit KC_SECRET_KEY, nie in Antworten/Logs, Schreiben nur connectors.write (superadmin) |
connectors | reveal.test.ts (Klartext nur auf Abruf), backup-settings.test.ts „liefert nie Geheimnisse“, Audit maskiert Geheimnisse (core.test.ts) |
| T9 | SSRF über Connector-Basis-URL | Basis-URL nur durch superadmin setzbar; Antworten werden nicht ungefiltert ausgegeben | connectors | Restrisiko: keine Sperrliste interner Adressen (127.0.0.1 ist für den Licensing-Connector legitim). Empfehlung: Allowlist pro Verbindung |
| T10 | Gefälschte Kundenmail ordnet sich einem Ticket/Kunden zu | Zuordnung nur mit HMAC-signiertem Antwort-Bezug (Message-ID) + aktive Mitgliedschaft; sonst Posteingang mit Hinweis | worker/mailbox, tickets | mailbox.test.ts (gefälschtes From/Ticketnummer, manipulierte Signatur, gesperrter Kunde) |
| T11 | Discord: fremder Nutzer liest Ticketkanal, Entknüpfte behalten Zugriff | OAuth-Verknüpfung, Kanal nur für Support-Rollen + verknüpfte aktive Mitglieder, Abgleich entfernt veraltete Freigaben | worker/discord | Policy-Unit-Test; Kanalabgleich nur live prüfbar |
| T12 | Schadhafte Dateien in Ticket-Anhängen | Typ per Dateisignatur (nur PNG/JPEG/GIF/WebP/PDF), max. 15 MB, 5 je Nachricht, Ablage außerhalb Webroot, nosniff, interne Notizen nicht für Kunden |
tickets | tickets.test.ts „Bild/PDF … falscher Typ und fremde Nachricht …“ |
| T13 | CSV-/Formel-Injection in Exporten | Textzellen mit = + - @ Tab CR neutralisiert (platform/csv), Web-Export ebenso |
invoices, audit, domains | helpers.test.ts (#77) |
| T14 | Privilegierter Backup-Auslöser | API schreibt nur eine feste Anfragedatei; systemd-Pfadauslöser führt feste Aktionen als root aus, keine Parameter | backup | backup-api.test.ts „legt Anfragen nur für feste Aktionen ab, nur einmal gleichzeitig, mit Audit“ |
| T15 | Wiederholte Webhooks/Jobs, Doppelausführung | Idempotenzschlüssel, Lease + Herzschlag, destruktive Aufträge nach Absturz → needs_review |
platform/jobs, worker | security.test.ts (Absturz: normal → retrying, destruktiv → needs_review, frischer Herzschlag unberührt) |
| T16 | Gefälschte oder alte Lizenzantwort (Edition/Grenzen erschleichen) | Signatur Pflicht (FLS1/RS256), nur Payload-Werte, Installation/Typ abgeglichen, Serverzeit ±15 min und monoton, widerrufene Schlüssel ungültig | platform/license | license.test.ts (#116) |
| T17 | Wettlauf um letzte freie Plätze (Kunden/Personal) | Zeilensperre bis Commit | platform/license | license.test.ts (parallel) |
| T18 | Rechnungsmanipulation nach Ausstellung | Statusprüfung unter Zeilensperre, Snapshots, Storno statt Änderung, Audit | invoices | invoices.test.ts (#95) |
| T19 | Audit-Protokoll verfälschen | Hash-Kette, Trigger verbieten UPDATE/DELETE, Prüfung im Restore-Test | audit | core.test.ts „führt eine intakte Hash-Kette … erkennt eine eingeschleuste Fälschung“; täglicher Restore-Test prüft die Kette |
| T21 | Selbstregistrierung: Konten ausspähen, Massenanlagen, fremde E-Mail | standardmäßig aus; Antwort immer 202 (bestehende Adresse bekommt nur eine Hinweis-Mail), Rate-Limit 5/10 min, Konto erst nach E-Mail-Bestätigung (Einmal-Token, 24 h) und – Standard – Freigabe durch Personal; Kundengrenze gilt | customers | registration.test.ts |
| T22 | Statusseite gibt interne Details preis | nur vom Personal veröffentlichte Einträge, nur deren Texte; keine Kunden-/Ressourcen-/Anbieterdaten, nicht aus Betriebsalarmen gespeist; Verfasser/Veröffentlichungsstatus nicht in der öffentlichen Ausgabe | status | status.test.ts |
| T20 | Datenverlust / Erpressung | Verschlüsselte Backups, externes Ziel, automatischer Restore-Test, Alarm | backup | backup*.test.ts, täglicher Restore-Test |
Beispielpayloads in Tests und Doku enthalten nie echte Schlüssel (Dummy-KC_SECRET_KEY, generierte Testschlüssel).
4. Offene Punkte
- T9: Allowlist für Connector-Ziele (Entscheidung: welche Hosts sind erlaubt?).
- Passkeys (#23) sind noch nicht umgesetzt. Selbstregistrierung ist vorbereitet und aus – vor dem Einschalten Pflichtfelder/Freischaltungsregel bestätigen (#36).
- Modulmatrix der Installationslizenz (#113) → dann in API und Worker durchsetzen (#116).