---
title: "ADR-0001: Schutz des ausgehenden HTTP-Pfads, keine PHP-Firewall"
manual: "HTTP Guard"
version: "0.1.4"
permalink: "https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0001@0.1.4"
source: "Adr/ADR-0001-ScopeAndTrustBoundaries.rst"
rendered: "2026-10-18T14:31:43+00:00"
---

# ADR-0001: Schutz des ausgehenden HTTP-Pfads, keine PHP-Firewall {#adr-0001}

-   *Status:* Historischer Vorschlag (Original: Vorgeschlagen)
-   *Datum:* 2026-10-08
-   *Entscheidungsträger im Original:* Projektverantwortliche Architektur/Security; Freigabe noch ausstehend
-   *Anforderungen:* HG-001, HG-002, HG-018, HG-039, HG-042
-   *Ablösung im Original:* keine; neue Entscheidung für das vorgeschlagene Produkt
-   *Originalquelle:* [Unveränderter ADR-0001](https://github.com/netresearch/typo3_http_guard/blob/3f929ae8794ca04ab3dd25627e94d601a2db23e0/specification/adr/ADR-0001-schutzumfang-und-vertrauensgrenzen.md)

> [!NOTE]
> Dieser ADR gibt den vollständigen Vorschlag vom 2026-10-08 wieder. Status,
> ausstehende Freigaben und geplante Tests beschreiben diesen Originalstand.
> Die aktuelle Alpha-Arbeit ist vom Nutzer freigegeben. Den heutigen
> Paketaufbau beschreibt [ADR-0015: Eine installierbare Extension](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0015@0.1.4); für das aktuelle
> Sicherheitsverhalten und die ausgeführten Nachweise gelten [Schutzmodell und Grenzen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:security@0.1.4)
> und [Dokumentierte Prüfstände](https://docs.typo3.org/permalink/netresearch/nr-http-guard:verification-report@0.1.4).

## Kontext {#adr-0001-context}

Eine unzuverlässige URL kann den Server zum Zugriff auf ein internes Ziel
veranlassen. Der normale TYPO3-HTTP-Stack ist ein geeigneter gemeinsamer
Eingriffspunkt. Andere PHP-Clients und direkte Sockets existieren daneben; auch
ein pro Request ersetzter Handler kann die Middleware umgehen. Der Core stellt
keine Prozesssandbox bereit. \[S01-S03, S18\]

## Entscheidung {#adr-0001-decision}

Das Produkt schützt ausschließlich dokumentierte, geprüfte Sendewege: den
integrierten Standardstack und explizit integrierte Clients. Vor einem nicht
erlaubten Zielkontakt muss der Guard ablehnen. DNS-Anfragen an den
konfigurierten Resolver sind davon getrennt; der Guard verspricht nicht,
überhaupt keine Netzwerkpakete zu senden.

Angreifer dürfen URLs, Antworten und DNS ihrer eigenen Zonen beeinflussen.
Installierter PHP-Code, Policydateien, TLS-/Resolverkonfiguration und
Betriebssystem gehören zur vertrauenswürdigen Basis. Endpoint-Grants verhindern
versehentliche Berechtigungserweiterungen, sind aber kein Schutz gegen
bösartigen Code im selben Prozess. Der Guard ist auch keine Autorisierung für
einzelne Pfade oder Datensätze auf einem erlaubten Server.

Dokumentation und Diagnose verwenden "global" nur im Sinn des erfassten
TYPO3-Stacks. Ausgehende Firewallregeln und Dienstauthentifizierung bleiben
ergänzende Kontrollen.

## Verworfene Alternativen {#adr-0001-rejected-alternatives}

**Prozessweite Netzwerksperre in PHP:** ohne Kontrolle aller Netzwerkfunktionen
nicht erfüllbar. **Nur URL-Syntaxvalidierung:** kontrolliert weder DNS noch
tatsächliche Verbindung. **Nur Netzwerkfirewall:** wertvoll, liefert aber allein
keine fachlich getrennten Clientfreigaben.

## Konsequenzen {#adr-0001-consequences}

Das Schutzversprechen ist messbar und nicht irreführend. Nicht integrierte SDKs
bleiben eine bewusste Abdeckungslücke; ihre Migration erfordert eigene Adapter.
Der Betrieb muss beide Ebenen inventarisieren.

## Nachweis und Abnahme {#adr-0001-verification-and-acceptance}

T001, T003, T035, T074, T077. Details und erwartete Ergebnisse stehen in
[06 Tests und Abnahme](https://github.com/netresearch/typo3_http_guard/blob/3f929ae8794ca04ab3dd25627e94d601a2db23e0/specification/specs/06-verification.md). Diese Tests sind spezifiziert, nicht im Rahmen dieser
Dokumentlieferung ausgeführt.

## Anlass für Neubewertung {#adr-0001-reassessment-trigger}

Eine neue Integration oder ein erweitertes Versprechen benötigt einen eigenen
Transportnachweis. Eine künftige Prozess-/Netzwerksandbox ist ein separates
Produktziel.

## Zugehörige Dokumente {#adr-0001-related-documents}

[Produktanforderungen](https://github.com/netresearch/typo3_http_guard/blob/3f929ae8794ca04ab3dd25627e94d601a2db23e0/specification/specs/01-product-requirements.md), [Sicherheitsmodell](https://github.com/netresearch/typo3_http_guard/blob/3f929ae8794ca04ab3dd25627e94d601a2db23e0/specification/specs/02-security-model.md), [Architektur](https://github.com/netresearch/typo3_http_guard/blob/3f929ae8794ca04ab3dd25627e94d601a2db23e0/specification/specs/03-architecture.md), [Quellen S01-S23](https://github.com/netresearch/typo3_http_guard/blob/3f929ae8794ca04ab3dd25627e94d601a2db23e0/specification/specs/08-evidence-and-sources.md),
[ADR-Index](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-index@0.1.4).