--- title: "Installation" manual: "HTTP Guard" version: "0.1.4" permalink: "https://docs.typo3.org/permalink/netresearch/nr-http-guard:installation@0.1.4" source: "Installation/Index.rst" rendered: "2026-10-18T14:31:43+00:00" --- # Installation {#installation} Nach Installation und Aktivierung schützt die Extension bestehende Aufrufe über die registrierte `RequestFactory` von TYPO3 automatisch. Der Standardmodus `enforce` sperrt private Adressen, Loopback, Cloud-Metadatenziele und besondere Netze, auch bei URLs aus Benutzereingaben, Importen oder externen Daten. Dafür sind weder Änderungen an der Anwendung noch eine Endpoint-Konfiguration erforderlich. ## Mit Composer {#installation-composer} Die veröffentlichte 0.1-Reihe aus [Packagist](https://packagist.org/packages/netresearch/nr-http-guard) installieren: **Installation im TYPO3-Projekt** ```bash composer require netresearch/nr-http-guard:^0.1 vendor/bin/typo3 cache:flush vendor/bin/typo3 http-guard:config-check vendor/bin/typo3 http-guard:doctor ``` Composer registriert die Extension automatisch. Nach dem Neuaufbau der Caches gilt für gewöhnliche RequestFactory-Aufrufe der geschützte Standardmodus. Version 0.1.4 ist eine Alpha-Version zur Evaluierung. Die aufgelösten Dependencies sind vor dem Deployment mit [Voraussetzungen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:installation-requirements@0.1.4) abzugleichen. Die Extension benötigt kein zusätzliches `netresearch/http-guard`. ## Klassisch ohne Composer {#installation-classic} `nr_http_guard` aus dem [TYPO3 Extension Repository](https://extensions.typo3.org/extension/nr_http_guard) installieren. Anschließend die Extension im Extension Manager aktivieren und die Caches neu aufbauen. Der Standardmodus schützt öffentliche Anfragen ohne eigene Policy-Konfiguration. Das TER-Paket enthält die Extension-Dateien direkt auf der Archivebene. Die Quellarchive aus den [GitHub-Releases](https://github.com/netresearch/typo3_http_guard/releases) enthalten einen Ordner `nr-http-guard/`. Beide Archive enthalten kein zusätzliches Vendor-Verzeichnis. Die offizielle TYPO3-Installation stellt Guzzle, PSR-Komponenten und Symfony bereit. 1. Eine unterstützte klassische TYPO3-Version installieren oder bereitstellen. Die geprüften offiziellen Archive 13.4.36 und 14.3.8 enthalten Guzzle 8.2.0, Promises 3.0.2 und PSR-7 3.1.0 innerhalb der erlaubten Bereiche. 1. Die Extension aus dem TER installieren oder das dort heruntergeladene ZIP im Extension Manager importieren. Für eine manuelle Installation aus einem GitHub-Release das Quellarchiv entpacken und den **Inhalt** seines Ordners `nr-http-guard/` nach `typo3conf/ext/nr_http_guard/` kopieren. Die `composer.json` der Extension muss direkt in diesem Zielordner liegen. Anschließend die Extension im Extension Manager aktivieren. 1. System- und Dependency-Injection-Caches neu aufbauen. Das mitgelieferte `composer.json` bleibt dabei erhalten: TYPO3 benötigt seine Metadaten auch ohne eine Composer-Projektinstallation und registriert beide enthaltenen PHP-Namespaces selbst. 1. Die Diagnose ausführen. Für öffentliche Anfragen ist keine eigene Policy erforderlich; interne Integrationen benötigen ausdrücklich gebundene Endpoint-Clients. Für klassische Projekte lautet der CLI-Einstieg im Regelfall `typo3/sysext/core/bin/typo3`. Der Pfad hängt von der Core-Verknüpfung des Projekts ab. **Diagnose einer klassischen Installation** ```bash php typo3/sysext/core/bin/typo3 cache:flush php typo3/sysext/core/bin/typo3 http-guard:config-check php typo3/sysext/core/bin/typo3 http-guard:doctor ``` Die offiziellen Anleitungen erläutern die [klassische TYPO3-Installation mit Archiven](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/Administration/Installation/ClassicMode/TarballZip.html) und das auch klassisch benötigte [composer.json einer Extension](https://docs.typo3.org/m/typo3/reference-coreapi/14.3/en-us/ExtensionArchitecture/FileStructure/ComposerJson.html#ext-composer-json-classic-compatible). ## Voraussetzungen {#installation-requirements} Composer unterstützt TYPO3 `^13.4.36 || ^14.3.8` und PHP `^8.2`. PHP muss zusätzlich die Anforderungen des eingesetzten Core erfüllen. Kompatible Updates innerhalb dieser Bereiche benötigen keine neue HTTP-Guard-Version. Die Laufzeitprüfung kontrolliert die echte Core-Elternklasse und die SDK-Fähigkeiten; inkompatible APIs werden vor einem nativen Sendeversuch abgelehnt. | Guzzle | Promises | PSR-7 | | --- | --- | --- | | `^7.15.2` | `^2.5.1` | `^2.13.0` | | `^8.2` | `^3.0.2` | `^3.1` | Diese Untergrenzen stellen die benötigten Transport-APIs bereit. Composer muss einen kompatiblen vollständigen Dependency-Graph innerhalb der unterstützten Hauptversionen auflösen. Jede Transfer-Lease darf höchstens ein natives Handle erzeugen. Verdeckte SDK-Wiederholungen können die Policyprüfung pro Versuch dadurch nicht umgehen. Die festen Core-/SDK-Fixtures dokumentieren reproduzierbare Prüfungen mit konkreten Versionen. Sie begrenzen nicht die installierbaren Dependencies. Die aktuellen Kompatibilitätsprüfungen stehen unter [Lokale Prüfungen](https://docs.typo3.org/permalink/netresearch/nr-http-guard:development-unit@0.1.4). Die historische Kernmatrix deckt PHP 8.2–8.5 ab; künftig kompatible PHP-Versionen sind erlaubt, aber damit noch nicht als geprüft ausgewiesen. Die klassischen Extension-Metadaten erlauben TYPO3 13.4.36–14.3.99 und PHP 8.2.0–8.99.99. Die klassische TYPO3-Obergrenze ist enger als die Composer-Bereiche und bezieht sich derzeit auf die LTS-Zweige 13.4/14.3. Die zusammenhängende TER-Spanne kann die getrennte Core-14-Untergrenze nicht ausdrücken: Die Laufzeitprüfung lehnt Core 14.0–14.2 sowie 14.3-Patches vor 14.3.8 ab. Die Core-Anforderungen an PHP und dieselben Laufzeitprüfungen gelten auch dort. Der kontrollierte Transport benötigt `ext-curl`, die Funktion `curl_multi_exec` und funktional mindestens libcurl 7.59.0. Die libcurl-Untergrenze bestätigt keinen Sicherheitsstand. Betriebssystem- und PHP-Sicherheitsupdates sind nach den Hinweisen des jeweiligen Herstellers zu installieren. Der Prozess benötigt Zugriff auf seine kontrollierten DNS-Server oder ausdrücklich konfigurierte statische Hosteinträge. > [!WARNING] > Prozessvariablen für HTTP-, HTTPS-, ALL- oder NO_PROXY werden unabhängig > von ihrer Groß-/Kleinschreibung konservativ abgelehnt. Dies gilt auch für > `NO_PROXY=*`. Ein Unternehmensproxy benötigt einen gesondert > qualifizierten Adapter; diese Version enthält keinen Proxybetrieb. ## Installation prüfen {#installation-check} `config-check` prüft die Schemafelder und meldet die Policyrevision. `doctor` prüft den Modus, die Registry, Core-/SDK-Versionen, cURL-Fähigkeiten und Proxyvariablen. Beide Befehle senden kein Ziel-HTTP. Exitcode 0 von `doctor` bestätigt den unterstützten geschützten Modus. Exitcode 2 kennzeichnet einen ausdrücklich ungeschützten Modus; Exitcode 3 eine ungültige Konfiguration oder eine nicht unterstützte Fähigkeit. Details stehen unter [Diagnosebefehle](https://docs.typo3.org/permalink/netresearch/nr-http-guard:operations-diagnostics@0.1.4). Nach Aktivierung ist zunächst ein kontrolliertes öffentliches Ziel zu prüfen, dann ein verbotenes internes Ziel mit unveränderten TCP-/HTTP-Zählern am Ziel. Die Projektprüfung muss den tatsächlich verwendeten RequestFactory- oder gebundenen Client aufrufen. Ein erfolgreicher Diagnosebefehl beweist keinen beliebigen SDK-Pfad. ## Updates und Deinstallation {#installation-update} Der Dependency-Lock des Projekts wird innerhalb der unterstützten Bereiche aktualisiert. Ein kompatibles Patch- oder Minor-Update benötigt keine neue Extension-Version. Änderungen an Extension und Adressregeln werden geprüft, wenn diese Komponenten aktualisiert werden. Nach jeder Policy- oder Paketänderung sind Caches neu aufzubauen und langlebige Worker neu zu starten. Bereits erzeugte Clients behalten ihren unveränderlichen Konfigurationsstand bis zum Austausch. Vor einer Deinstallation müssen gebundene Clients und Service-Aliases im Projekt angepasst werden. Nach Deaktivierung entfällt die zusätzliche Kontrolle des TYPO3-HTTP-Pfads. Deployment- und Rollback-Schritte stehen unter [Einführung im Betreiberprojekt](https://docs.typo3.org/permalink/netresearch/nr-http-guard:operations-rollout@0.1.4) und [Rollback](https://docs.typo3.org/permalink/netresearch/nr-http-guard:operations-rollback@0.1.4).