fix(security, core): Auth-Pflicht für Ingest-APIs, 500er-Ursachen beheben, Agenten-Workflow

Sicherheit
- install_db.php war ohne Authentifizierung erreichbar und setzte bei jedem
  Aufruf das Admin-Passwort auf einen fest im Code stehenden Wert zurück.
  Jetzt Auth-Pflicht; ein Konto wird nur bei leerer Benutzertabelle angelegt.
- Stored XSS im Bugtracker-Detail-Modal: Titel, Beschreibung, Fehlermeldung,
  Stacktrace und Kommentare gingen ungefiltert durch innerHTML.
- report.php, projects.php und das Veröffentlichen von Releases verlangen jetzt
  zwingend ein Token. Publish war zuvor völlig ungeschützt.
- CSRF-Token in allen Formularen, Session-Regenerierung nach Login,
  Drosselung fehlgeschlagener Anmeldeversuche.
- Zugangsdaten aus der Versionskontrolle entfernt (Serverdaten.txt,
  config.php, .htpasswd, deploy_config.json). Historie enthält sie weiterhin,
  Rotation erforderlich (siehe docs/UPGRADE.md).
- Token-Validierung nur noch über SHA-256-Hash; expires_at wird ausgewertet.

Behobene 500er
- Audit::log() war in index.php weder eingebunden noch importiert. Jeder
  Klick auf "Aktivierung freigeben" endete in einem Fatal Error.
- Derselbe benannte PDO-Platzhalter mehrfach je Statement (:id in
  revokeToken/deleteToken, :q siebenfach in der Volltextsuche). Bei
  EMULATE_PREPARES=false ist das nicht zulässig und warf HY093.
- Migration 005 nutzte dynamisches SQL, dessen Semikolons in String-Literalen
  vom alten explode(';')-Installer als Statement-Ende gelesen wurden. Sie
  schlug still fehl, wodurch push_id/target_agent/tags dauerhaft fehlten.
- Monitor-Umbenennung ohne Transaktion, verschachtelte Transaktionen im
  RateLimiter.

Funktionale Korrekturen
- Der Watchdog-Evaluator fehlte vollständig: Monitor-Zustände änderten sich nur
  beim Eintreffen eines Heartbeats, ein ausgefallenes System blieb dauerhaft
  "up". Erster Lauf auf dem Produktivsystem: 7 von 10 Monitoren waren
  tatsächlich seit über einem Tag nicht erreichbar.
- Das Feld "os" fehlte im Monitor-Dialog, wurde aber gespeichert und löschte
  damit bei jedem Speichern das Betriebssystem.
- Der Resolve-Dialog existierte im HTML nicht; der Button war funktionslos.
- Versionsvergleich erfolgte lexikografisch, wodurch 1.9.0 als neuer galt
  als 1.10.0.
- Schreiboperationen meldeten Erfolg auch für nicht existierende IDs.
- Post/Redirect/Get gegen doppelte Einträge beim Neuladen.

Neue Struktur
- src/bootstrap.php mit PSR-4-Autoloader ersetzt die require-Ketten.
- Core: Config, Http, Csrf, ApiAuth, Logger, Migrator, ErrorReporter.
- Migrator mit zeichenweisem SQL-Parser, dc_migrations und Baseline-Verfahren,
  damit bestehende Installationen keine Beispieldaten zurückbekommen.

Agenten-Workflow
- Claim/Lease: Items werden exklusiv übernommen, damit nicht zwei Agenten am
  selben Problem arbeiten. action=next holt und reserviert in einem Zug.
- Idempotenz über client_ref, Deduplizierung auch für Feature Requests,
  Erkennung von Regressionen, automatische Eskalation des Schweregrads.
- Strukturierter Code-Kontext (repo_url, commit_sha, file_path, line_no).
- Delta-Abfragen über updated_since, Pagination, Bulk-Update.
- Beim Veröffentlichen eines Releases schließen sich Items mit passendem
  resolved_in_build selbst.
- Ausgehende Webhooks mit HMAC-Signatur, /api/health, /api/openapi.json.
- Unbehandelte Fehler meldet die Plattform in ihren eigenen Bugtracker.

WebUI
- Serverseitige Filterung mit Pagination statt Rendern aller Datensätze.
- Migrations-Schranke, Evaluator-Warnung, Übersicht aktiver Agenten.

Zeitstempel liegen in der Datenbank durchgängig in UTC und werden für die
Anzeige in die App-Zeitzone umgerechnet.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Deploymentcenter Bot
2026-08-07 16:17:36 +02:00
co-authored by Claude Opus 5
parent a21536f495
commit e7fbc85db4
59 changed files with 8506 additions and 2410 deletions
+214
View File
@@ -0,0 +1,214 @@
<?php
declare(strict_types=1);
namespace Deploymentcenter\Modules\Notify;
use Deploymentcenter\Core\Config;
use Deploymentcenter\Core\Logger;
use PDO;
/**
* Ausgehende Webhooks.
*
* Ereignisgesteuerte Benachrichtigung statt Polling: Agenten und Chat-Kanaele
* (Telegram, Matrix, n8n, ...) koennen sich registrieren und werden bei neuen
* oder kritischen Items sowie bei Watchdog-Zustandswechseln informiert.
*
* Jede Zustellung traegt eine HMAC-SHA256-Signatur im Header X-DC-Signature,
* damit der Empfaenger die Echtheit pruefen kann:
* signature = hex(hmac_sha256(secret, timestamp . '.' . body))
* Der Header X-DC-Timestamp enthaelt den zugehoerigen Unix-Zeitstempel.
*/
final class WebhookDispatcher
{
/** Bekannte Ereignisnamen. */
public const EVENTS = [
'bug.created',
'bug.critical',
'bug.resolved',
'feature.created',
'monitor.down',
'monitor.recovered',
'release.published',
];
private const TIMEOUT_SECONDS = 4;
private const MAX_TARGETS = 10;
/** Verhindert, dass eine Kette von Ereignissen einen Request blockiert. */
private static int $dispatchedThisRequest = 0;
public static function dispatch(PDO $db, string $event, array $payload): void
{
if (self::$dispatchedThisRequest >= self::MAX_TARGETS) {
return;
}
$targets = self::targetsFor($db, $event, $payload['project_slug'] ?? null);
if ($targets === []) {
return;
}
$body = [
'event' => $event,
'timestamp' => gmdate('c'),
'source' => (string)Config::get('app.url', ''),
'data' => $payload,
];
$json = json_encode($body, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
if ($json === false) {
Logger::warning('Webhook-Payload nicht kodierbar', ['event' => $event]);
return;
}
foreach ($targets as $target) {
if (self::$dispatchedThisRequest >= self::MAX_TARGETS) {
break;
}
self::$dispatchedThisRequest++;
self::deliver($db, $target, $json);
}
}
/**
* @return list<array<string,mixed>>
*/
private static function targetsFor(PDO $db, string $event, $projectSlug): array
{
try {
$stmt = $db->prepare('
SELECT id, name, url, secret, events, project_slug
FROM dc_webhooks
WHERE enabled = 1
AND (project_slug IS NULL OR project_slug = :slug)
LIMIT 25
');
$stmt->execute([':slug' => is_string($projectSlug) ? $projectSlug : '']);
$rows = $stmt->fetchAll() ?: [];
} catch (\Throwable $e) {
// Tabelle fehlt (Migration noch nicht gelaufen) - kein Grund zu scheitern.
return [];
}
$matching = [];
foreach ($rows as $row) {
$subscribed = array_map('trim', explode(',', (string)$row['events']));
if (in_array($event, $subscribed, true) || in_array('*', $subscribed, true)) {
$matching[] = $row;
}
}
return $matching;
}
private static function deliver(PDO $db, array $target, string $json): void
{
$secret = (string)($target['secret'] ?? '');
if ($secret === '') {
$secret = (string)Config::get('security.webhook_key', '');
}
$timestamp = (string)time();
$signature = $secret !== ''
? hash_hmac('sha256', $timestamp . '.' . $json, $secret)
: '';
$headers = [
'Content-Type: application/json',
'User-Agent: Deploymentcenter-Webhook/1.0',
'X-DC-Timestamp: ' . $timestamp,
];
if ($signature !== '') {
$headers[] = 'X-DC-Signature: sha256=' . $signature;
}
[$ok, $status, $error] = self::post((string)$target['url'], $json, $headers);
self::recordResult($db, (int)$target['id'], $ok, $status, $error);
}
/**
* @param list<string> $headers
* @return array{0:bool,1:int,2:?string}
*/
private static function post(string $url, string $json, array $headers): array
{
if (!preg_match('#^https?://#i', $url)) {
return [false, 0, 'Ungueltige URL'];
}
if (function_exists('curl_init')) {
$ch = curl_init($url);
if ($ch === false) {
return [false, 0, 'curl_init fehlgeschlagen'];
}
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $json,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => self::TIMEOUT_SECONDS,
CURLOPT_CONNECTTIMEOUT => 2,
CURLOPT_FOLLOWLOCATION => false,
CURLOPT_SSL_VERIFYPEER => true,
CURLOPT_SSL_VERIFYHOST => 2,
]);
$response = curl_exec($ch);
$status = (int)curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$error = $response === false ? curl_error($ch) : null;
curl_close($ch);
return [$status >= 200 && $status < 300, $status, $error];
}
$context = stream_context_create([
'http' => [
'method' => 'POST',
'header' => implode("\r\n", $headers),
'content' => $json,
'timeout' => self::TIMEOUT_SECONDS,
'ignore_errors' => true,
],
]);
$result = @file_get_contents($url, false, $context);
$status = 0;
if (isset($http_response_header[0]) && preg_match('#\s(\d{3})\s#', $http_response_header[0], $m) === 1) {
$status = (int)$m[1];
}
return [
$result !== false && $status >= 200 && $status < 300,
$status,
$result === false ? 'Anfrage fehlgeschlagen' : null,
];
}
private static function recordResult(PDO $db, int $webhookId, bool $ok, int $status, ?string $error): void
{
try {
$stmt = $db->prepare('
UPDATE dc_webhooks
SET last_status = :status,
last_error = :error,
last_fired_at = UTC_TIMESTAMP(),
failure_count = IF(:ok = 1, 0, failure_count + 1),
enabled = IF(:ok2 = 1, enabled, IF(failure_count + 1 >= 20, 0, enabled))
WHERE id = :id
');
$stmt->execute([
':status' => $ok ? 'ok (' . $status . ')' : 'failed (' . $status . ')',
':error' => $error !== null ? mb_substr($error, 0, 500) : null,
':ok' => $ok ? 1 : 0,
':ok2' => $ok ? 1 : 0,
':id' => $webhookId,
]);
} catch (\Throwable $e) {
Logger::warning('Webhook-Ergebnis nicht gespeichert', ['id' => $webhookId]);
}
}
}