Loheide-eu-mitarbeiterplatt.../docs/SECURITY.md
Friederich Loheide f1202bea08
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 7m50s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 7m34s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 5m45s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 5m30s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 7m7s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 7m9s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 6m8s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 6m5s
CI / Bekannte Sicherheitslücken in Paketen (pull_request) Successful in 48s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m5s
Sicherheitsupdate nach Audit (0.29.0)
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-27 11:34:54 +00:00

89 lines
4.8 KiB
Markdown
Raw 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.
- **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.