Sicherheitsdoku: Rollen-/Rechte-Matrix und Bedrohungsmodell (#9, #10)

- docs/sicherheit-und-bedrohungsmodell.md: Personal- und Kundenrechte aus
  dem Code, Impersonation, gleiche Rechte in API und Worker; 20 Bedrohungen
  mit Maßnahme, Modul und Negativtest; offene Punkte (SSRF-Allowlist,
  Passkeys, Modulmatrix).
- Neue Tests (security.test.ts): Impersonation (Rolle, Grund, nur diese
  Organisation, keine Personalrechte, Audit) und Job-Lease nach Absturz.
- Ticket-Anhänge mit X-Content-Type-Options: nosniff.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Claude (KI) 2026-10-06 12:09:43 +02:00
parent a0dd7c3940
commit 5478f564b8
3 changed files with 154 additions and 1 deletions

View file

@ -163,7 +163,8 @@ export const ticketsModule: KcModule = {
const t = await one('SELECT * FROM tickets WHERE id = ?', [id]); if (!t || !canInOrg(a.principal, t.org_id, 'tickets.read', 'tickets.read')) throw notFound();
const att = await one('SELECT ta.*, m.internal_note FROM ticket_attachments ta JOIN ticket_messages m ON m.id = ta.message_id WHERE ta.id = ? AND ta.ticket_id = ?', [attachmentId, id]);
if (!att || (att.internal_note && !staff)) throw notFound();
reply.header('content-type', att.content_type).header('content-disposition', `inline; filename="${encodeURIComponent(att.filename)}"`).header('cache-control', 'private, max-age=3600');
reply.header('content-type', att.content_type).header('content-disposition', `inline; filename="${encodeURIComponent(att.filename)}"`).header('cache-control', 'private, max-age=3600')
.header('x-content-type-options', 'nosniff'); // Typ ist serverseitig per Signatur geprüft (nur Bilder/PDF); Browser soll nicht raten
return reply.send(createReadStream(pathFor(id, att.id, att.content_type)));
});

View file

@ -0,0 +1,49 @@
import { beforeAll, describe, expect, it } from 'vitest';
import type { FastifyInstance } from 'fastify';
import { randomUUID } from 'node:crypto';
import { buildApp } from '../src/server.js';
import { one, query, run } from '../src/core/db.js';
import { recoverStale } from '../../worker/src/jobs.js';
import { call, code, login, makeUser } from './helpers.js';
let app: FastifyInstance;
beforeAll(async () => { app = await buildApp(); await app.ready(); });
async function staff(email: string, role: string) {
await makeUser({ email, kind: 'staff', staffRole: role }); const { client } = await login(app, email);
const s = (await call(app, client, 'POST', '/auth/mfa/setup')).json(); await call(app, client, 'POST', '/auth/mfa/confirm', { code: code(s.secret) }); return client;
}
describe('Impersonation „Als Kunde ansehen“ (T7)', () => {
it('nur admin/superadmin, Grund Pflicht, wirkt als Kunde genau dieser Organisation, auditiert', async () => {
const admin = await staff('imp-admin@example.com', 'admin'); const support = await staff('imp-support@example.com', 'support');
const A = (await call(app, admin, 'POST', '/admin/customers', { type: 'business', name: 'Imp A', owner: { email: 'imp-a@example.com', name: 'A' } })).json();
const B = (await call(app, admin, 'POST', '/admin/customers', { type: 'business', name: 'Imp B', owner: { email: 'imp-b@example.com', name: 'B' } })).json();
expect((await call(app, support, 'POST', `/admin/customers/${A.id}/impersonate`, { reason: 'Test' })).statusCode).toBe(403);
expect((await call(app, admin, 'POST', `/admin/customers/${A.id}/impersonate`, {})).statusCode).toBe(400);
expect((await call(app, admin, 'POST', `/admin/customers/${A.id}/impersonate`, { reason: 'Kunde bittet um Hilfe' })).statusCode).toBe(200);
const me = (await call(app, admin, 'GET', '/auth/me')).json();
expect(me.impersonating.orgId).toBe(A.id);
expect((await call(app, admin, 'GET', `/orgs/${A.id}`)).statusCode).toBe(200);
expect([403, 404]).toContain((await call(app, admin, 'GET', `/orgs/${B.id}`)).statusCode); // fremde Organisation
expect((await call(app, admin, 'GET', '/admin/customers')).statusCode).toBe(403); // keine Personalrechte während der Ansicht
expect((await call(app, admin, 'POST', '/auth/impersonate/stop')).statusCode).toBe(200);
expect((await call(app, admin, 'GET', '/admin/customers')).statusCode).toBe(200);
const actions = (await query("SELECT action FROM audit_events WHERE action LIKE 'customer.impersonate.%' AND org_id = ? ORDER BY id", [A.id])).map((r) => r.action);
expect(actions).toEqual(['customer.impersonate.start', 'customer.impersonate.end']);
});
});
describe('Job-Lease nach Absturz (T15)', () => {
it('normale Aufträge werden wieder eingeplant, destruktive gehen zur Prüfung; laufende mit frischem Herzschlag bleiben unberührt', async () => {
const ids = { normal: randomUUID(), destr: randomUUID(), fresh: randomUUID() };
await run("INSERT INTO jobs (id, type, payload, status, locked_at, lease_id, run_at) VALUES (?, 'x.lease', '{}', 'running', DATE_SUB(UTC_TIMESTAMP(3), INTERVAL 10 MINUTE), 'l1', UTC_TIMESTAMP(3))", [ids.normal]);
await run("INSERT INTO jobs (id, type, payload, status, locked_at, lease_id, run_at) VALUES (?, 'x.lease', '{\"destructive\":true}', 'running', DATE_SUB(UTC_TIMESTAMP(3), INTERVAL 10 MINUTE), 'l2', UTC_TIMESTAMP(3))", [ids.destr]);
await run("INSERT INTO jobs (id, type, payload, status, locked_at, lease_id, run_at) VALUES (?, 'x.lease', '{}', 'running', UTC_TIMESTAMP(3), 'l3', UTC_TIMESTAMP(3))", [ids.fresh]);
await recoverStale(() => undefined);
const st = async (id: string) => (await one('SELECT status, lease_id FROM jobs WHERE id = ?', [id]))!;
expect((await st(ids.normal)).status).toBe('retrying'); expect((await st(ids.normal)).lease_id).toBeNull();
expect((await st(ids.destr)).status).toBe('needs_review');
expect((await st(ids.fresh)).status).toBe('running');
await run("DELETE FROM jobs WHERE type = 'x.lease'");
});
});

View file

@ -0,0 +1,103 @@
# 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 |
| 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 (#36/#23) und Selbstregistrierung (#36) sind noch nicht umgesetzt; bei Einführung Enumeration-Schutz und Verifizierung ergänzen.
- Modulmatrix der Installationslizenz (#113) → dann in API und Worker durchsetzen (#116).