--- title: "HTTP Guard" manual: "HTTP Guard" version: "0.1.4" permalink: "https://docs.typo3.org/permalink/netresearch/nr-http-guard:http-guard@0.1.4" source: "Index.rst" start: true rendered: "2026-10-18T12:36:31+00:00" --- # HTTP Guard {#http-guard} ![](Images/netresearch-underline.svg) Nach Installation und Aktivierung schützt HTTP Guard den standardmäßigen HTTP-Client von TYPO3, `RequestFactory`, vor Server-Side Request Forgery (SSRF). Bestehende Aufrufe über die registrierte Factory werden automatisch geprüft. Dafür sind weder Änderungen an der Anwendung noch eine eigene Policy-Konfiguration erforderlich. Wenn die Anwendung URLs aus Benutzereingaben, Importen oder externen Daten abruft, sperrt der Standardmodus `enforce` private Adressen, Loopback, Cloud-Metadatenziele und besondere Netze vor dem Verbindungsaufbau. Auch DNS-Ergebnisse und Redirects werden geprüft. Erlaubte Verbindungen werden an die geprüften IP-Adressen gebunden. Die Version 0.1.4 ist eine Alpha-Version. Sie enthält den Sicherheitskern, den TYPO3-Adapter, die Adressregeln und dieses Handbuch in **einer** Extension mit dem Schlüssel `nr_http_guard`. Für eine klassische Installation ist kein Composer-Aufruf und kein zusätzliches HTTP-Guard-Paket erforderlich. ## Installieren und aktivieren {#http-guard-start} Im Composer-Projekt die veröffentlichte 0.1-Reihe installieren und die Caches neu aufbauen: **Installation im TYPO3-Projekt** ```bash composer require netresearch/nr-http-guard:^0.1 vendor/bin/typo3 cache:flush ``` Composer registriert die Extension automatisch. Bei einer klassischen Installation `nr_http_guard` aus dem [TER](https://extensions.typo3.org/extension/nr_http_guard) installieren. Anschließend die Extension im Extension Manager aktivieren und die Caches neu aufbauen. Der Schutz ist ohne Endpoint-Konfiguration aktiv. Voraussetzungen und Diagnose stehen unter [Installation](https://docs.typo3.org/permalink/netresearch/nr-http-guard:installation@0.1.4). Interne Integrationen benötigen ein Endpoint-Profil und einen Client, der ausdrücklich an dieses Profil gebunden ist. Ein Profil allein erlaubt gewöhnlichen RequestFactory-Aufrufen keinen Zugriff auf interne Ziele. ## Weitere Schritte {#http-guard-next} **📦 Installation** Voraussetzungen prüfen und mit Composer oder aus dem TER installieren. [HTTP Guard installieren](https://docs.typo3.org/permalink/netresearch/nr-http-guard:installation@0.1.4) **⚙️ Konfiguration** Policyfelder kennenlernen und Profile für interne Endpoints einrichten. [Policies konfigurieren](https://docs.typo3.org/permalink/netresearch/nr-http-guard:configuration@0.1.4) **🚀 Client-APIs** Gebundene PSR-18-Clients und Public Fetch im eigenen Projekt verwenden. [APIs kennenlernen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:api@0.1.4) **🛠️ Betrieb** Anfragen diagnostizieren und Einführung, Änderungen und Rollback planen. [HTTP Guard betreiben](https://docs.typo3.org/permalink/netresearch/nr-http-guard:operations@0.1.4) **🔒 Sicherheit** DNS-, Transport- und Redirectprüfungen sowie die Grenzen der Abdeckung verstehen. [Sicherheitsgrenzen nachlesen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:security@0.1.4) **💻 Entwicklung** Entwicklungsumgebung einrichten und die Prüfwerkzeuge ausführen. [An HTTP Guard mitarbeiten](https://docs.typo3.org/permalink/netresearch/nr-http-guard:development@0.1.4) ## Handbuch {#http-guard-manual} - [Installation](https://docs.typo3.org/permalink/netresearch/nr-http-guard:installation-1@0.1.4) - [Konfiguration](https://docs.typo3.org/permalink/netresearch/nr-http-guard:konfiguration@0.1.4) - [Allgemeine Optionen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:allgemeine-optionen@0.1.4) - [Endpoint-Profile](https://docs.typo3.org/permalink/netresearch/nr-http-guard:endpoint-profile@0.1.4) - [Clients verwenden](https://docs.typo3.org/permalink/netresearch/nr-http-guard:clients-verwenden@0.1.4) - [Betrieb](https://docs.typo3.org/permalink/netresearch/nr-http-guard:betrieb@0.1.4) - [Ablehnungsgründe verstehen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:ablehnungsgrunde-verstehen@0.1.4) - [Schutzmodell und Grenzen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:schutzmodell-und-grenzen@0.1.4) - [Entwicklung und Tests](https://docs.typo3.org/permalink/netresearch/nr-http-guard:entwicklung-und-tests@0.1.4) - [Lizenzen und Daten](https://docs.typo3.org/permalink/netresearch/nr-http-guard:lizenzen-und-daten@0.1.4) - [Anforderungen und Sicherheitsinvarianten](https://docs.typo3.org/permalink/netresearch/nr-http-guard:anforderungen-und-sicherheitsinvarianten@0.1.4) - [Dokumentierte Prüfstände](https://docs.typo3.org/permalink/netresearch/nr-http-guard:dokumentierte-prufstande@0.1.4) - [Abhängigkeiten und Sicherheitsstand](https://docs.typo3.org/permalink/netresearch/nr-http-guard:abhangigkeiten-und-sicherheitsstand@0.1.4) - [Projektprüfung](https://docs.typo3.org/permalink/netresearch/nr-http-guard:projektprufung@0.1.4) - [Abgleich der Prüfungen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:abgleich-der-prufungen@0.1.4) - [Release-Provenance und Integrität](https://docs.typo3.org/permalink/netresearch/nr-http-guard:release-provenance-und-integritat@0.1.4) - [Architekturentscheidungen (ADRs)](https://docs.typo3.org/permalink/netresearch/nr-http-guard:architekturentscheidungen-adrs@0.1.4) - [ADR-0001: Schutz des ausgehenden HTTP-Pfads, keine PHP-Firewall](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0001-schutz-des-ausgehenden-http-pfads-keine-php-firewall@0.1.4) - [ADR-0002: Gemeinsame Bibliothek statt Vault-Abhängigkeit aller Extensions](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0002-gemeinsame-bibliothek-statt-vault-abhangigkeit-aller-extensions@0.1.4) - [ADR-0003: Zwei Middlewaregrenzen und ein kontrollierter terminaler Transport](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0003-zwei-middlewaregrenzen-und-ein-kontrollierter-terminaler-transport@0.1.4) - [ADR-0004: Enforce als Standard, Observe nur als sichtbarer Migrationsmodus](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0004-enforce-als-standard-observe-nur-als-sichtbarer-migrationsmodus@0.1.4) - [ADR-0005: Geprüfte Adressmenge unmittelbar an die Verbindung binden](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0005-geprufte-adressmenge-unmittelbar-an-die-verbindung-binden@0.1.4) - [ADR-0006: Interne Zugriffe als clientgebundene Endpoint-Grants](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0006-interne-zugriffe-als-clientgebundene-endpoint-grants@0.1.4) - [ADR-0007: Nur kontrolliertes cURL; Proxies und PHP-Streams nicht in v1](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0007-nur-kontrolliertes-curl-proxies-und-php-streams-nicht-in-v1@0.1.4) - [ADR-0008: Redirects pro Hop prüfen und Credentials an ihre Origin binden](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0008-redirects-pro-hop-prufen-und-credentials-an-ihre-origin-binden@0.1.4) - [ADR-0009: Ein kanonischer Zielparser und ein versionierter Adresskorpus](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0009-ein-kanonischer-zielparser-und-ein-versionierter-adresskorpus@0.1.4) - [ADR-0010: Adressmemoisierung erlauben, Berechtigungs- und Verbindungspooling isolieren](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0010-adressmemoisierung-erlauben-berechtigungs-und-verbindungspooling-isolieren@0.1.4) - [ADR-0011: Vault-Streaming erhalten, ohne zum PHP-Streamhandler auszuweichen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0011-vault-streaming-erhalten-ohne-zum-php-streamhandler-auszuweichen@0.1.4) - [ADR-0012: Stabile Ablehnungsgründe ohne neue Secret-Leaks](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0012-stabile-ablehnungsgrunde-ohne-neue-secret-leaks@0.1.4) - [ADR-0013: Explizite Migration statt stiller Umdeutung bestehender Allowlisten](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0013-explizite-migration-statt-stiller-umdeutung-bestehender-allowlisten@0.1.4) - [ADR-0014: Sicherheit durch Zielkontakt- und Regressionsevidenz abnehmen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0014-sicherheit-durch-zielkontakt-und-regressionsevidenz-abnehmen@0.1.4) - [ADR-0015: Eine installierbare Extension](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0015-eine-installierbare-extension@0.1.4) - [ADR-0016: Die öffentliche RequestFactory als URI-Grenze](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0016-die-offentliche-requestfactory-als-uri-grenze@0.1.4) - [ADR-0017: Kontrollierte DNS-Abfragen für den Defaultresolver](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0017-kontrollierte-dns-abfragen-fur-den-defaultresolver@0.1.4) - [ADR-0018: Eine native cURL-Handle-Erzeugung je Transferlease](https://docs.typo3.org/permalink/netresearch/nr-http-guard:adr-0018-eine-native-curl-handle-erzeugung-je-transferlease@0.1.4) - [Changelog](https://docs.typo3.org/permalink/netresearch/nr-http-guard:changelog-1@0.1.4) ## Geltungsbereich {#http-guard-scope} Die Extension ersetzt keine Netzwerk-Firewall. Sie kontrolliert den dokumentierten TYPO3-HTTP-Pfad nach ihrer Registrierung und die von ihren Factories erzeugten Clients. Eingehende PSR-15-Middleware, frühe Bootstrap-Anfragen, fremde SDK-Clients, direkte cURL-Aufrufe und eigene Socketverbindungen benötigen eine separate Integration. Die vollständige Abgrenzung steht unter [Abdeckung und Vertrauensgrenze](https://docs.typo3.org/permalink/netresearch/nr-http-guard:security-coverage@0.1.4). Die optionale nr-vault-Anpassung gehört zu einer gesonderten Migration; die globale Extension schützt Vault nicht automatisch. Das API-Kapitel verlinkt den aufgezeichneten Referenzpatch und seine historischen Nachweise unter [Optionale nr-vault-Migration](https://docs.typo3.org/permalink/netresearch/nr-http-guard:api-vault@0.1.4). Für Installation und Betrieb genügt dieses Handbuch. **\[n\] Eine Extension von Netresearch** ![](Images/netresearch-underline.svg) Professionelle TYPO3-Entwicklung, Integration und Beratung von der Netresearch DTT GmbH. [netresearch.de](https://www.netresearch.de)