diff --git a/docker/nginx/default.conf b/docker/nginx/default.conf index 5d19d34..74c32aa 100644 --- a/docker/nginx/default.conf +++ b/docker/nginx/default.conf @@ -7,8 +7,13 @@ # - http://lara-und-felix.de, aber nur wenn X-Forwarded-Proto ausdrücklich "http" lautet. Fehlt der Header # (direkter Zugriff, Health-Check auf 127.0.0.1), wird nie weitergeleitet. Das verhindert Schleifen, falls ein # HTTPS-Aufruf ohne den Header ankommt. -# Nicht weitergeleitet werden: alle anderen Methoden (POST, zum Beispiel der Stripe-Webhook), die ACME-Prüfung unter -# /.well-known/acme-challenge/, dev.laraundfelix.de und alles, was nicht in der Liste steht. +# Ebenfalls nur bei ausdrücklichem X-Forwarded-Proto "http", auf genau diesen drei Hostnamen (lara-und-felix.de, +# www.lara-und-felix.de, www.laraundfelix.de): alle anderen Methoden (POST, PUT, DELETE, ...) enden hier mit 403 und +# erreichen Laravel nicht. Ein 301 wäre für sie falsch (der Client schickte den Inhalt erneut oder als GET), und über +# unverschlüsseltes HTTP sollen keine Eingaben oder Zugangsdaten ankommen. Über HTTPS (zum Beispiel der Stripe-Webhook) +# und ohne X-Forwarded-Proto (direkter Zugriff, Health-Check) ändert sich nichts. +# Nie angefasst werden: die ACME-Prüfung unter /.well-known/acme-challenge/ (jede Methode), dev.laraundfelix.de und +# alles, was nicht in der Liste steht. # Das Ziel ist fest; Pfad und Query-String bleiben über $request_uri erhalten. map $http_x_forwarded_host $luf_forwarded_host { default ""; @@ -21,13 +26,15 @@ map $luf_forwarded_host $luf_public_host { } # Schlüssel: Methode|X-Forwarded-Proto|öffentlicher Host|Pfad. Die Einträge werden der Reihe nach geprüft, der erste -# Treffer gilt: die ACME-Ausnahme steht deshalb vor den Weiterleitungen. +# Treffer gilt: die ACME-Ausnahme steht vor den Weiterleitungen (1), diese vor der Sperre für andere Methoden (2). +# Die Sperre braucht deshalb keine Methodenliste: GET und HEAD sind in den Zeilen davor bereits entschieden. map "$request_method|$http_x_forwarded_proto|$luf_public_host|$uri" $luf_canonical_redirect { default 0; "~*^[^|]*\|[^|]*\|[^|]*\|/\.well-known/acme-challenge/" 0; "~*^(GET|HEAD)\|[^|]*\|www\.lara-und-felix\.de\.?\|" 1; "~*^(GET|HEAD)\|[^|]*\|www\.laraundfelix\.de\.?\|" 1; "~*^(GET|HEAD)\|\s*http\s*(,[^|]*)?\|lara-und-felix\.de\.?\|" 1; + "~*^[^|]*\|\s*http\s*(,[^|]*)?\|(www\.lara-und-felix|www\.laraundfelix|lara-und-felix)\.de\.?\|" 2; } server { @@ -42,9 +49,12 @@ server { resolver 127.0.0.11 valid=10s ipv6=off; # Läuft vor der Auswahl der location (Rewrite-Phase des Servers), daher steckt die ACME-Ausnahme in der map oben. - if ($luf_canonical_redirect) { + if ($luf_canonical_redirect = 1) { return 301 https://lara-und-felix.de$request_uri; } + if ($luf_canonical_redirect = 2) { + return 403; + } client_max_body_size 2048m; client_body_timeout 3600s; diff --git a/docs/betrieb/DEPLOYMENT.md b/docs/betrieb/DEPLOYMENT.md index bc2035c..2885407 100644 --- a/docs/betrieb/DEPLOYMENT.md +++ b/docs/betrieb/DEPLOYMENT.md @@ -111,11 +111,12 @@ ## Kanonische Adresse und Weiterleitungen (Nginx im Shop-Container) | `https://lara-und-felix.de` | Shop | | `dev.laraundfelix.de` | Testinstanz, unverändert | | `laraundfelix.de` ohne `www` | nicht betroffen, die STRATO-Weiterleitung übernimmt | +| Jede andere Methode (`POST`, `PUT`, `DELETE` …) auf den drei Shop-Hosts, nur bei `X-Forwarded-Proto: http` | `403` im Nginx, die Anfrage erreicht Laravel nicht | - **Öffentlicher Host:** erster Wert von `X-Forwarded-Host`, sonst der `Host`-Header (ohne Port, Groß-/Kleinschreibung egal). Eine Adresse ohne Proxy (`127.0.0.1:3010`, `192.168.2.144:3011`) trifft keine Regel. - **Öffentliches Protokoll:** nur `X-Forwarded-Proto`, nie das lokale Schema. Fehlt der Header, wird `lara-und-felix.de` **nicht** weitergeleitet. Dadurch gibt es keine Schleife, falls ein HTTPS-Aufruf ohne den Header ankäme, und der Health-Check des Deploys (`http://127.0.0.1:$WEB_PORT/up`) bleibt unberührt. Die `www`-Adressen werden unabhängig vom Protokoll weitergeleitet. -- **Andere Methoden:** `POST` und alle übrigen Methoden bekommen nie ein `301`, sondern gehen wie bisher an die Anwendung (Stripe-Webhook `/stripe/webhook` ist ein `POST`). Im Repository ist keine Webhook-Adresse hinterlegt; welche Adresse im Stripe-Dashboard steht, ist [?] nicht geprüft. Sie funktioniert in jedem Fall weiter, auch wenn sie auf einen Alias-Host zeigt. -- **ACME:** `/.well-known/acme-challenge/` wird nie umgeleitet (Ausnahme zuerst in der `map`), auch nicht auf den `www`-Hosts. Der Shop beantwortet diesen Pfad selbst nicht (Laravel liefert 404); das Zertifikat holt die Synology, sie muss die Prüfung also selbst beantworten und darf sie nicht an den Shop weiterreichen. [?] Beim ersten Erneuern beobachten. +- **Andere Methoden:** Auf `lara-und-felix.de`, `www.lara-und-felix.de` und `www.laraundfelix.de` endet jede Methode außer `GET`/`HEAD` mit `403` im Nginx, **wenn** der Proxy ausdrücklich `X-Forwarded-Proto: http` setzt (erster Wert der Liste). Ein `301` wäre für sie falsch, und über unverschlüsseltes HTTP sollen keine Eingaben ankommen. Unverändert an die Anwendung gehen: alle Methoden über HTTPS (der Stripe-Webhook `/stripe/webhook` ist ein `POST` und muss als `https://` in Stripe eingetragen sein), alle Methoden ohne `X-Forwarded-Proto` (direkter Zugriff, Health-Check) und `dev.laraundfelix.de`. Im Repository ist keine Webhook-Adresse hinterlegt; welche Adresse im Stripe-Dashboard steht, ist [?] nicht geprüft. **Vor dem Aktivieren der HTTP-Regeln prüfen:** Steht dort `http://…`, würde der Webhook mit `403` abgewiesen und muss auf `https://` umgestellt werden. +- **ACME:** `/.well-known/acme-challenge/` wird nie umgeleitet oder gesperrt, für jede Methode (Ausnahme zuerst in der `map`), auch nicht auf den `www`-Hosts. Der Shop beantwortet diesen Pfad selbst nicht (Laravel liefert 404); das Zertifikat holt die Synology, sie muss die Prüfung also selbst beantworten und darf sie nicht an den Shop weiterreichen. [?] Beim ersten Erneuern beobachten. - **Signierte URLs:** `App\Http\SignedLink` signiert nur den Pfad (relative Signatur), der Host fließt nicht ein. Ein Wechsel zwischen den Alias-Hosts macht Links also nicht ungültig. Im Repository kommt kein Alias-Host vor; Stripe-Rücksprungadressen entstehen aus `route()` und damit aus `APP_URL` bzw. dem Anfrage-Host. - **Synology:** Setzt der Reverse-Proxy `X-Forwarded-Proto` nicht von selbst, dann einen eigenen Kopfzeilen-Eintrag `X-Forwarded-Proto` mit dem Wert `$scheme` anlegen. Für die Testinstanz ist belegt, dass Protokoll und Host der Synology in der Anwendung ankommen (Stand 2026-11-22: `https://dev.laraundfelix.de/verwaltung` leitet auf `https://dev.laraundfelix.de/verwaltung/login`). Für die Prod-Regeln ist das [?] nicht geprüft. - **Prüfung:** Die Fälle der Tabelle, `HEAD`, Pfad mit Query, Großschreibung, Port im Host, `X-Forwarded-Host`, `POST`/`PUT`, direkter Zugriff und ACME wurden 2026-11-22 mit Windows-nginx 1.27.5 (nicht das Alpine-Image) und `php-cgi` als Upstream durchgespielt (30 Fälle). Reihenfolge und Zusagen der Konfiguration sichert `tests/Unit/NginxConfigTest.php`. diff --git a/tests/Unit/NginxConfigTest.php b/tests/Unit/NginxConfigTest.php index a0ece8e..27ae5db 100644 --- a/tests/Unit/NginxConfigTest.php +++ b/tests/Unit/NginxConfigTest.php @@ -66,9 +66,10 @@ public function test_alias_hosts_are_redirected_to_the_fixed_canonical_domain(): { $config = $this->config(); - $this->assertStringContainsString('if ($luf_canonical_redirect) {', $config); + $this->assertStringContainsString('if ($luf_canonical_redirect = 1) {', $config); $this->assertStringContainsString('return 301 https://lara-und-felix.de$request_uri;', $config, 'Fest verdrahtetes Ziel, Pfad und Query-String aus $request_uri.'); $this->assertSame(1, preg_match_all('/^\s*return\s+30\d\s/m', $config), 'Es gibt genau eine Weiterleitung.'); + $this->assertSame(2, preg_match_all('/^\s*return\s+\d{3}\b/m', $config), 'Nur Weiterleitung und Sperre antworten selbst.'); $this->assertDoesNotMatchRegularExpression('/return\s+30\d\s+[^;]*\$(host|http_host|http_x_forwarded_host|scheme)/', $config, 'Das Ziel darf nicht aus Anfragewerten entstehen.'); } @@ -92,6 +93,40 @@ public function test_only_get_and_head_are_redirected(): void } } + /** + * @return list Zeilen der map, die andere Methoden sperren (Wert 2) + */ + private function blockRules(): array + { + return array_values(array_filter($this->redirectMap(), fn (string $line) => str_ends_with($line, '" 2;'))); + } + + public function test_other_methods_on_the_three_shop_hosts_end_at_nginx_when_proxy_says_http(): void + { + $config = $this->config(); + $rules = $this->blockRules(); + + $this->assertCount(1, $rules); + $rule = $rules[0]; + $this->assertStringStartsWith('"~*^[^|]*\|', $rule, 'Jede Methode, die nicht vorher als GET/HEAD entschieden wurde.'); + $this->assertStringContainsString('\|\s*http\s*(,[^|]*)?\|', $rule, 'Nur bei ausdrücklichem X-Forwarded-Proto http (erster Wert).'); + foreach (['www\.lara-und-felix', 'www\.laraundfelix', '(www\.lara-und-felix|www\.laraundfelix|lara-und-felix)\.de'] as $host) { + $this->assertStringContainsString($host, $rule); + } + $this->assertStringNotContainsString('dev', $rule, 'dev.laraundfelix.de bleibt unverändert.'); + $this->assertStringNotContainsString('https', $rule); + $this->assertMatchesRegularExpression('/^\s*if\s*\(\$luf_canonical_redirect = 2\)\s*\{\s*return\s+403;\s*\}/m', $config, 'Die Sperre antwortet in nginx, bevor die Anfrage Laravel erreicht.'); + $this->assertDoesNotMatchRegularExpression('/\$luf_canonical_redirect = 2\)\s*\{[^}]*(fastcgi_pass|proxy_pass)/', $config); + } + + public function test_block_rule_comes_after_acme_exception_and_the_redirects(): void + { + // nginx nimmt den ersten passenden Regex-Eintrag: Ausnahme, dann GET/HEAD-Weiterleitungen, zuletzt die Sperre. + $values = array_map(fn (string $line) => rtrim(substr($line, (int) strrpos($line, ' ') + 1), ';'), $this->redirectMap()); + + $this->assertSame(['0', '0', '1', '1', '1', '2'], $values, 'Reihenfolge: default, ACME, drei Weiterleitungen, Sperre.'); + } + public function test_acme_challenge_is_excluded_before_any_redirect_rule(): void { $acme = null; @@ -100,7 +135,7 @@ public function test_acme_challenge_is_excluded_before_any_redirect_rule(): void if ($acme === null && str_contains($line, '/\.well-known/acme-challenge/') && str_ends_with($line, '" 0;')) { $acme = $index; } - if ($firstRedirect === null && str_ends_with($line, '" 1;')) { + if ($firstRedirect === null && (str_ends_with($line, '" 1;') || str_ends_with($line, '" 2;'))) { $firstRedirect = $index; } }