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
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>
82 lines
3.7 KiB
PHP
82 lines
3.7 KiB
PHP
<?php
|
|
// Waehrend eines Updates antwortet der Waechter mit einer Wartungsseite.
|
|
require_once __DIR__ . '/../updater/guard.php';
|
|
|
|
/**
|
|
* OpenAPI 3.0 Spezifikation der REST-API (zum Import in Postman/Swagger).
|
|
* GET /api/openapi.php
|
|
*/
|
|
header('Content-Type: application/json; charset=utf-8');
|
|
|
|
$scheme = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
|
|
$host = $_SERVER['HTTP_HOST'] ?? 'localhost';
|
|
$base = $scheme . '://' . $host . rtrim(dirname($_SERVER['SCRIPT_NAME']), '/');
|
|
|
|
$spec = [
|
|
'openapi' => '3.0.3',
|
|
'info' => [
|
|
'title' => 'UniFi Voucher Tool API',
|
|
'version' => '1.0.0',
|
|
'description' => 'REST-API zum Erstellen und Abrufen von WLAN-Vouchers. Authentifizierung per API-Schlüssel (Authorization: Bearer … oder X-API-Key).',
|
|
'license' => ['name' => 'MIT', 'url' => 'https://git.loheide.cloud/friloo/Unifi-Voucher-Tool/src/branch/main/LICENSE'],
|
|
'contact' => ['name' => 'Loheide.eu', 'url' => 'https://loheide.eu'],
|
|
],
|
|
'servers' => [['url' => $base]],
|
|
'components' => [
|
|
'securitySchemes' => [
|
|
'bearerAuth' => ['type' => 'http', 'scheme' => 'bearer'],
|
|
'apiKeyAuth' => ['type' => 'apiKey', 'in' => 'header', 'name' => 'X-API-Key'],
|
|
],
|
|
],
|
|
'security' => [['bearerAuth' => []], ['apiKeyAuth' => []]],
|
|
'paths' => [
|
|
'/sites.php' => [
|
|
'get' => [
|
|
'summary' => 'Aktive Sites auflisten',
|
|
'description' => 'Erfordert Scope read.',
|
|
'responses' => ['200' => ['description' => 'Liste der Sites']],
|
|
],
|
|
],
|
|
'/vouchers.php' => [
|
|
'get' => [
|
|
'summary' => 'Voucher einer Site auflisten',
|
|
'description' => 'Erfordert Scope read.',
|
|
'parameters' => [[
|
|
'name' => 'site_id', 'in' => 'query', 'required' => true,
|
|
'schema' => ['type' => 'integer'],
|
|
]],
|
|
'responses' => ['200' => ['description' => 'Liste der Voucher']],
|
|
],
|
|
'post' => [
|
|
'summary' => 'Voucher erstellen',
|
|
'description' => 'Erfordert Scope write.',
|
|
'requestBody' => [
|
|
'required' => true,
|
|
'content' => ['application/json' => ['schema' => [
|
|
'type' => 'object',
|
|
'required' => ['site_id', 'name'],
|
|
'properties' => [
|
|
'site_id' => ['type' => 'integer'],
|
|
'name' => ['type' => 'string'],
|
|
'max_uses' => ['type' => 'integer', 'default' => 1],
|
|
'expire_minutes' => ['type' => 'integer', 'default' => 480],
|
|
'qos' => ['type' => 'object', 'properties' => [
|
|
'down' => ['type' => 'integer', 'description' => 'Download kbit/s'],
|
|
'up' => ['type' => 'integer', 'description' => 'Upload kbit/s'],
|
|
'quota_mb' => ['type' => 'integer', 'description' => 'Datenkontingent MB'],
|
|
]],
|
|
],
|
|
]]],
|
|
],
|
|
'responses' => [
|
|
'201' => ['description' => 'Voucher erstellt'],
|
|
'401' => ['description' => 'Nicht authentifiziert'],
|
|
'403' => ['description' => 'Fehlender Scope'],
|
|
'429' => ['description' => 'Rate-Limit überschritten'],
|
|
],
|
|
],
|
|
],
|
|
],
|
|
];
|
|
|
|
echo json_encode($spec, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT);
|