Selbst-Updater neu gebaut, Diagnoseseiten abgesichert #18

Merged
friloo merged 1 commit from feature/self-updater into main 2026-09-25 19:50:32 +00:00
Owner

Punkt 2: Diagnoseseiten

  • cron_test.php entfernt. Ohne jede Anmeldung erreichbar; es meldete Schritt für Schritt, ob Config und Datenbank laden, gab bei Fehlern $e->getMessage() aus (also potenziell Hostnamen und Zugangsdaten aus PDO-Meldungen) und listete die Spalten der vouchers-Tabelle.
  • test.php verweigert ohne config.php die Auskunft. Die Anmeldeprüfung lag bisher innerhalb von if (file_exists(config.php)) — auf einer frisch entpackten, noch nicht eingerichteten Installation lief die Diagnoseseite also ohne Anmeldung.

Selbst-Updater

Der bisherige Updater lud ein ZIP und entpackte es ungeprüft über die Produktion. Vollständig ersetzt:

Datei Aufgabe
Version.php Release-Version als Konstante, Commit-SHA in storage/.version
Progress.php Fortschritt mit eigenem Fehlerzustand (pct = -1) und Verfallszeit
Maintenance.php Wartungsmarkierung mit Ablauf, räumt sich beim Prüfen selbst auf
ProxyClient.php nur HTTPS, Zertifikatsprüfung an, begrenzte Weiterleitungen
Updater.php Prüfsumme, ZIP-Slip-Schutz, geschützte Pfade, atomares Schreiben
AutoMigrate.php zieht Migrationen beim ersten Seitenaufruf nach
guard.php Wartungs-Wächter für die Einstiegsseiten
Changelog.php zerlegt CHANGELOG.md, rendert Markdown ohne unsichere Links

Sicherheitseigenschaften

  • ZIP-Slip zweistufig: Eintragsnamen vorab ablehnen (absolute Pfade, Laufwerksbuchstaben, .., Null-Bytes), nach dem Schreiben den aufgelösten Pfad prüfen und alles außerhalb sofort löschen
  • Geschützte Pfade (config.php, uploads/, vendor/, updater/storage/, …) werden nie überschrieben
  • Atomar je Datei: erst daneben schreiben, dann umbenennen — ein Abbruch hinterlässt sonst eine halbe PHP-Datei
  • Nie löschen: eine im neuen Stand fehlende Datei bleibt liegen
  • Prüfsumme gegen den Kopf X-Content-Sha256 des Dienstes
  • Selbstheilender Wartungsmodus, im finally immer abgebaut
  • Nur Administratoren, alle schreibenden Endpunkte mit CSRF-Token
  • Auto-Migration nur bei geändertem Fingerabdruck, mit Sperre gegen Parallellauf, Fehler werden protokolliert statt geworfen

Oberfläche

Seite „Aktualisierung" mit Stand, Kanal, Suche, Fortschrittsbalken, Migrationsliste und Versionsgeschichte. Fehlt changelog_preview in der Antwort, bleibt es bei „neue Fassung verfügbar" — kein leerer Kasten, kein erfundener Ersatztext. Commit-Texte werden nirgends angezeigt.

Der Datenschutzhinweis steht dauerhaft neben der Schaltfläche „Nach Updates suchen", nicht in einem Dialog, und nennt genau die drei Dinge, die tatsächlich übertragen werden.

Geprüft

Gegen den echten Dienst (https://update.loheide.cloud/unifivouchertool) in einer Wegwerf-Kopie:

  • check mit altem Stand → has_update, versions_behind: 1, fehlendes changelog_preview korrekt als „nichts zu berichten"
  • voller installUpdate-Durchlauf → {"success":true,"sha":"3a5b951…","migrations":0}, Version gespeichert, Fortschritt 100 %/done, Wartungsmodus aus, Staging und ZIP aufgeräumt
  • Fehlerfall (absichtlich scheiternde Migration) → pct = -1/error, Wartungsmodus trotzdem abgebaut, Version nicht vorgerückt, config.php und uploads/ unangetastet
  • Wartungsmodus im Browser: index.php und admin/* → 503 mit Fortschritt, api/* → JSON, Anmeldung, Health-Check und die Update-Seite bleiben erreichbar

Automatisiert: 18 neue Tests (SHA lesen/schreiben inkl. Ablehnung ungültiger Werte, Wartungsmodus mit Selbstheilung, Fortschritt inkl. Fehlerzustand, ZIP mit ../evil legt nichts außerhalb an, geschützte Pfade, Migrationszähler, Changelog-Auswertung) → 93 Tests, 243 Assertions. PHPStan prüft jetzt den gesamten updater/-Ordner und ist sauber.

Screenshots neu erzeugt, CHANGELOG.md angelegt, Version auf 3.0.0.

🤖 Generated with Claude Code

## Punkt 2: Diagnoseseiten - **`cron_test.php` entfernt.** Ohne jede Anmeldung erreichbar; es meldete Schritt für Schritt, ob Config und Datenbank laden, gab bei Fehlern `$e->getMessage()` aus (also potenziell Hostnamen und Zugangsdaten aus PDO-Meldungen) und listete die Spalten der `vouchers`-Tabelle. - **`test.php` verweigert ohne `config.php` die Auskunft.** Die Anmeldeprüfung lag bisher *innerhalb* von `if (file_exists(config.php))` — auf einer frisch entpackten, noch nicht eingerichteten Installation lief die Diagnoseseite also ohne Anmeldung. ## Selbst-Updater Der bisherige Updater lud ein ZIP und entpackte es ungeprüft über die Produktion. Vollständig ersetzt: | Datei | Aufgabe | |---|---| | `Version.php` | Release-Version als Konstante, Commit-SHA in `storage/.version` | | `Progress.php` | Fortschritt mit eigenem Fehlerzustand (`pct = -1`) und Verfallszeit | | `Maintenance.php` | Wartungsmarkierung mit Ablauf, räumt sich beim Prüfen selbst auf | | `ProxyClient.php` | nur HTTPS, Zertifikatsprüfung an, begrenzte Weiterleitungen | | `Updater.php` | Prüfsumme, ZIP-Slip-Schutz, geschützte Pfade, atomares Schreiben | | `AutoMigrate.php` | zieht Migrationen beim ersten Seitenaufruf nach | | `guard.php` | Wartungs-Wächter für die Einstiegsseiten | | `Changelog.php` | zerlegt `CHANGELOG.md`, rendert Markdown ohne unsichere Links | ### Sicherheitseigenschaften - **ZIP-Slip zweistufig:** Eintragsnamen vorab ablehnen (absolute Pfade, Laufwerksbuchstaben, `..`, Null-Bytes), nach dem Schreiben den aufgelösten Pfad prüfen und alles außerhalb sofort löschen - **Geschützte Pfade** (`config.php`, `uploads/`, `vendor/`, `updater/storage/`, …) werden nie überschrieben - **Atomar je Datei:** erst daneben schreiben, dann umbenennen — ein Abbruch hinterlässt sonst eine halbe PHP-Datei - **Nie löschen:** eine im neuen Stand fehlende Datei bleibt liegen - **Prüfsumme** gegen den Kopf `X-Content-Sha256` des Dienstes - **Selbstheilender Wartungsmodus**, im `finally` immer abgebaut - **Nur Administratoren**, alle schreibenden Endpunkte mit CSRF-Token - **Auto-Migration** nur bei geändertem Fingerabdruck, mit Sperre gegen Parallellauf, Fehler werden protokolliert statt geworfen ### Oberfläche Seite „Aktualisierung" mit Stand, Kanal, Suche, Fortschrittsbalken, Migrationsliste und Versionsgeschichte. Fehlt `changelog_preview` in der Antwort, bleibt es bei „neue Fassung verfügbar" — kein leerer Kasten, kein erfundener Ersatztext. Commit-Texte werden nirgends angezeigt. Der **Datenschutzhinweis** steht dauerhaft neben der Schaltfläche „Nach Updates suchen", nicht in einem Dialog, und nennt genau die drei Dinge, die tatsächlich übertragen werden. ## Geprüft **Gegen den echten Dienst** (`https://update.loheide.cloud/unifivouchertool`) in einer Wegwerf-Kopie: - `check` mit altem Stand → `has_update`, `versions_behind: 1`, fehlendes `changelog_preview` korrekt als „nichts zu berichten" - voller `installUpdate`-Durchlauf → `{"success":true,"sha":"3a5b951…","migrations":0}`, Version gespeichert, Fortschritt 100 %/`done`, Wartungsmodus aus, Staging und ZIP aufgeräumt - Fehlerfall (absichtlich scheiternde Migration) → `pct = -1`/`error`, Wartungsmodus trotzdem abgebaut, Version **nicht** vorgerückt, `config.php` und `uploads/` unangetastet - Wartungsmodus im Browser: `index.php` und `admin/*` → 503 mit Fortschritt, `api/*` → JSON, Anmeldung, Health-Check und die Update-Seite bleiben erreichbar **Automatisiert:** 18 neue Tests (SHA lesen/schreiben inkl. Ablehnung ungültiger Werte, Wartungsmodus mit Selbstheilung, Fortschritt inkl. Fehlerzustand, ZIP mit `../evil` legt nichts außerhalb an, geschützte Pfade, Migrationszähler, Changelog-Auswertung) → **93 Tests, 243 Assertions**. PHPStan prüft jetzt den gesamten `updater/`-Ordner und ist sauber. Screenshots neu erzeugt, `CHANGELOG.md` angelegt, Version auf 3.0.0. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
friloo added 1 commit 2026-09-25 19:50:26 +00:00
Selbst-Updater neu gebaut, Diagnoseseiten abgesichert
Some checks failed
CI / PHP Lint-1 (push) Successful in 43s
CI / PHP Lint (push) Successful in 45s
CI / PHP Lint (pull_request) Successful in 38s
CI / Unit Tests & Static Analysis (push) Failing after 43s
CI / PHP Lint-1 (pull_request) Successful in 40s
CI / Unit Tests & Static Analysis (pull_request) Failing after 41s
25b8c51362
Aktualisierung per Klick im Administrationsbereich, ohne Zugang zum
Server. Der bisherige Updater lud ein ZIP und entpackte es ungeprüft über
die Produktion; das ist vollständig ersetzt.

Neu in updater/:

- Version: Release-Version als Konstante, installierter Commit-SHA in
  storage/.version (Datei, nicht Datenbank - der Updater muss den Stand
  auch bei hängender Datenbank lesen können)
- Progress: Fortschrittsdatei mit eigenem Fehlerzustand (pct = -1) und
  Verfallszeit, damit ein abgestürzter Lauf den nächsten nicht blockiert
- Maintenance: Wartungsmarkierung mit Ablauf, die sich beim Prüfen selbst
  aufräumt
- ProxyClient: nur HTTPS, Zertifikatsprüfung an, begrenzte
  Weiterleitungen, 503 mirror_pending/not_released als Bitte um Geduld
- Updater: Prüfsumme gegen X-Content-Sha256, zweistufiger ZIP-Slip-Schutz,
  geschützte Pfade, atomares Schreiben je Datei, nie löschen
- AutoMigrate: zieht Migrationen beim ersten Seitenaufruf nach, nur bei
  geändertem Fingerabdruck und mit Sperre gegen Parallellauf
- guard.php: Wartungs-Wächter für die Einstiegsseiten, JSON für die
  Schnittstellen; ausgenommen bleiben Update-Seite, Anmeldung und
  Health-Check
- Changelog: zerlegt CHANGELOG.md und rendert Markdown ohne unsichere Links

Oberfläche: Seite "Aktualisierung" mit Stand, Kanal, Suche, Fortschritt,
Migrationsliste und Versionsgeschichte. Der Datenschutzhinweis steht
dauerhaft neben der Schaltfläche, nicht in einem Dialog.

Fehlt changelog_preview in der Antwort, bleibt es bei "neue Fassung
verfügbar" - kein leerer Kasten, kein erfundener Ersatztext. Commit-Texte
werden nirgends angezeigt.

Außerdem (Punkt 2 der Liste):

- cron_test.php entfernt: ohne jede Anmeldung erreichbar, meldete
  Datenbankfehler samt Meldung und die Spalten der vouchers-Tabelle
- test.php verweigert ohne config.php die Auskunft; bisher lief die
  Diagnose auf einer frisch entpackten Installation ohne Anmeldung

PHPStan prüft jetzt den gesamten updater/-Ordner. 18 neue Tests
(93 Tests, 243 Assertions), Ablauf gegen den echten Update-Dienst
durchgespielt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
friloo merged commit e4d5948214 into main 2026-09-25 19:50:32 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: friloo/Unifi-Voucher-Tool#18
No description provided.