kundencenter/docs/sicherheit-und-bedrohungsmodell.md
Claude (KI) 03cf2b00c4 Öffentliche Statusseite mit Wartungs- und Vorfallverwaltung (#23)
- 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>
2026-10-06 13:32:19 +02:00

11 KiB
Raw Permalink Blame History

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 (owner genau 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).