Loheide-eu-mitarbeiterplatt.../docs/SECURITY.md
Friederich Loheide 268742983a
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 7m17s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 7m28s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 6m32s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 6m48s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 8m51s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 8m52s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 7m31s
CI / Bekannte Sicherheitslücken in Paketen (pull_request) Successful in 52s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 7m51s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m22s
KI-Assistent: OpenAI und Ollama als Anbieter (0.35.0)
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-27 13:57:37 +00:00

99 lines
5.8 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.
Der Ordner `public/uploads` darf **nie Code ausführen** und muss Dateien mit sicheren Headern
ausliefern. Unter Apache übernimmt das `public/uploads/.htaccess`; Voraussetzung sind
`AllowOverride All` und `mod_headers`. Für **nginx**:
```nginx
location ^~ /uploads/ {
location ~* \.(php[0-9]?|phtml|phar)$ { deny all; }
add_header Content-Security-Policy "default-src 'none'; img-src 'self' data:; style-src 'unsafe-inline'; font-src 'self'; sandbox" always;
add_header X-Content-Type-Options "nosniff" always;
try_files $uri =404;
}
```
Für **Caddy** gilt dasselbe sinngemäß: kein `php_fastcgi` unter `/uploads/` und die beiden Header setzen.
### 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.