Loheide-eu-mitarbeiterplatt.../docs/SECURITY.md
Friederich Loheide d91570f118
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 7m25s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 6m46s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 7m52s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 8m5s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 10m33s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 10m53s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 9m1s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 8m49s
CI / Bekannte Sicherheitslücken in Paketen (pull_request) Successful in 54s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m4s
Dateien nur mit Anmeldung, nur Microsoft-Login, mehrere Titelbilder (0.47.0)
- /uploads nur über das Portal: UploadController prüft Sitzung bzw. App-Token;
  frei nur die Dateien der Anmeldeseite (Logos, Symbole, Anmeldehintergrund,
  Stylesheet, Schrift); public/uploads/.htaccess leitet alles an index.php
  (Migration schreibt sie, da der Ordner vor dem Updater geschützt ist);
  Systemzustand prüft die Regel; nginx-Hinweis in docs/SECURITY.md
- Passwort-Anmeldung abschaltbar (PasswordLogin): Login-Formular, Passwort
  vergessen, App-Token und /api/v1/config; nur mit verknüpftem Konto
  abschaltbar, automatische Rückkehr ohne nutzbaren Dienst, Notausgang
  INHAUS_PASSWORD_LOGIN
- Titelbilder: profile_covers (bis 12), zufällig je Seitenaufruf
- ImageCompressor: Uploads im Backend (SafeUpload) und WordPress-Import auf
  ≤ 2400 px komprimiert, Format bleibt

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-28 17:26:15 +00:00

103 lines
6.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Sicherheit – Betrieb und Hinweise
Stand: Sicherheitsaudit zu Version 0.29.0. Hier steht, was Inhaus selbst absichert und was
beim Betrieb auf dem Server zu beachten ist.
## Was Inhaus absichert
- **Anmeldung:**
- Deaktivierte Konten werden sofort abgemeldet. Sitzungen, „Angemeldet bleiben“, App-Zugänge
und Push-Abos verlieren dabei ihre Gültigkeit.
- Passwortwechsel beendet andere Sitzungen und App-Zugänge.
- „Passwort vergessen“ verrät nicht, ob es ein Konto gibt, und ist begrenzt.
- Konten, die sich nur über einen Anmeldedienst (Entra, OIDC, SAML, LDAP) anmelden, bekommen
darüber kein lokales Passwort.
- **Verknüpfen per E-Mail:** Konten mit Passwort oder Backend-Rechten werden nur verknüpft, wenn
der Anbieter die Adresse bestätigt hat, also bei Entra, bei OIDC mit `email_verified` oder mit
der Einstellung „E-Mail-Adressen dieses Anbieters sind geprüft“.
- **Rechte:**
- Wer keinen Vollzugriff hat, vergibt nur Rollen und Rechte, die er selbst hat.
- Konten mit Vollzugriff bearbeitet nur, wer selbst Vollzugriff hat.
- „Als Person anmelden“ wird protokolliert; das Protokoll nennt auch, wer tatsächlich gehandelt hat.
- **Profil:**
- E-Mail, Abteilung und Standort ändert nur die Administration.
- Abteilung und Standort steuern Zielgruppen. Sie lassen sich unter „Profilfelder → Selbst
pflegen“ bewusst freigeben.
- **Sichtbarkeit:** Suche, API und Datei-Downloads zeigen nur, was die Person auf der Seite sieht.
Blöcke für andere Zielgruppen zählen nicht.
- **Uploads:**
- Dateinamen und Endungen erzeugt der Server aus dem geprüften Inhalt.
- SVG-Dateien werden bereinigt.
- Bilder haben höchstens 50 Megapixel.
- ZIP-Archive (Plugins, Updates) sind in Größe und Anzahl der Dateien begrenzt.
- **Ausgehende Anfragen:** Web-Push geht nur an die Push-Dienste der Browser. WordPress-Import und
Plugin-Updates erreichen keine internen Adressen, auch nicht über Weiterleitungen.
- **Gespeicherte Zugangsdaten** (SMTP, LDAP, OIDC, OpenNIT) gehen nur an das Ziel, für das sie
eingetragen wurden. Ändert sich Server oder Adresse, müssen sie neu eingegeben werden.
- **Reichweite von Beiträgen** wird anonym gezählt: je Person und Beitrag nur ein nicht umkehrbarer
Schlüssel. Wer ein Herz gegeben hat, sieht nur die Redaktion der Kategorie.
- **App-Anmeldung über den Browser** gibt nur einen Einmal-Code zurück, der ohne den geheimen
Prüfwert der App wertlos ist (PKCE), und leitet nur an `inhaus://` zurück.
- **KI-Assistent** (Leichte Sprache) ist ausgeschaltet, bis die Administration ihn einrichtet (Anthropic, OpenAI bzw.
kompatibel, oder Ollama im eigenen Netz). Der Schlüssel liegt verschlüsselt in der Datenbank und gilt nur für das
eingetragene Ziel. OpenAI-kompatible Dienste nur über HTTPS an öffentliche Adressen; Ollama darf im eigenen Netz
laufen, aber nie an Link-Local-/Metadaten-Adressen; Weiterleitungen werden nicht verfolgt. Übertragen wird nur der Text, den alle Lesenden
sehen, und nur auf Knopfdruck der Redaktion; jede Anfrage steht im Protokoll. „Vorlesen“ nutzt die Sprachausgabe
des Geräts, dabei verlässt nichts das Portal.
- **HTTP-Header:** `X-Frame-Options`, `X-Content-Type-Options`, `Referrer-Policy`,
`Permissions-Policy`, eine Basis-CSP und HSTS bei HTTPS. Das Sitzungs-Cookie ist bei HTTPS
automatisch `Secure`.
- **Fehlerprotokoll:** Unter „Systemzustand → Letzte Fehler“ stehen die letzten Fehler, jeweils
mit betroffener Adresse.
## Auf dem Server
### Webserver
`public/` ist der Webroot. Liegt die Installation im Webroot des Hosters, leitet die mitgelieferte
`.htaccess` nach `public/` um und sperrt die internen Ordner. Diese Datei wird bei Updates nicht
überschrieben; ältere Installationen übernehmen die neue Fassung also nur von Hand.
Hochgeladene Dateien (`public/uploads` – Bilder, Titelbilder, Profilbilder, Mediathek …) sind **nur mit
Anmeldung** abrufbar (ab 0.47.0). Der Webserver liefert dort nichts direkt aus, sondern reicht jede
Anfrage an `index.php` weiter; das Portal prüft Sitzung bzw. App-Token und liefert die Datei mit
sicheren Headern aus. Ohne Anmeldung gibt es nur, was die Anmeldeseite braucht: Logos, App-Symbol,
Favicons, Hintergrundbild, Stylesheet und eigene Schrift des veröffentlichten Erscheinungsbilds.
Unter Apache übernimmt das `public/uploads/.htaccess` (schreibt das Portal selbst, Voraussetzung:
`AllowOverride All` und `mod_rewrite`; ohne `mod_rewrite` wird dort gar nichts ausgeliefert).
„Systemzustand → Sicherheit“ zeigt, ob die Regel vorhanden ist. Für **nginx**:
```nginx
location ^~ /uploads/ {
# nie direkt ausliefern – das Portal prüft die Anmeldung
rewrite ^ /index.php last;
}
```
Für **Caddy**: `/uploads/*` ebenfalls an `php_fastcgi` bzw. `index.php` geben, keinen `file_server`.
### Hinter einem Reverse-Proxy
`TRUSTED_PROXIES=<IP des Proxys>` in der `.env` eintragen (oder `*`, wenn nur der Proxy den Server
erreicht). Sonst sehen alle Anfragen gleich aus: Begrenzungen treffen dann alle gemeinsam,
HTTPS wird nicht erkannt.
### Cronjob
Die Zeile unter „Systemzustand → Hintergrundaufgaben“ jede Minute ausführen lassen. Ohne Cron laufen
Hintergrundaufgaben nur nach normalen Seitenaufrufen.
## Empfehlungen, die außerhalb von Inhaus liegen
- **Signierte Updates:** Update-Archive werden über HTTPS geladen und auf Unversehrtheit geprüft, aber
nicht signiert. Empfehlung: Releases auf dem Update-Server mit Ed25519 signieren und den
öffentlichen Schlüssel in Inhaus hinterlegen. Das braucht eine Änderung am Update-Server.
- **Plugin-Updates:** Für eigene Plugins in der Update-Antwort `sha256` angeben.
- **SAML:** Die Anmeldung ist gegen Fälschung abgesichert (signierte Antworten, einmalige Anfragen).
Das „Unterschieben“ einer fremden Anmeldung, also Login-CSRF, lässt sich bei SAML wegen
SameSite-Cookies nicht vollständig verhindern. Das Risiko ist gering.
- **Kunden-Plugins** laufen mit vollen Rechten. Nur Plugins aus vertrauenswürdiger Quelle installieren.
Plugin-Routen brauchen selbst `auth`, das vom Generator erzeugte Gerüst macht das.
- **Mediathek:** Alt-Text und Bildunterschrift können alle Redakteurinnen und Redakteure gemeinsam
pflegen; das ist so gewollt.