---
title: "Ablehnungsgründe verstehen"
manual: "HTTP Guard"
version: "0.1.4"
permalink: "https://docs.typo3.org/permalink/netresearch/nr-http-guard:operations-reasons@0.1.4"
source: "Operations/Reasons.rst"
rendered: "2026-10-18T14:31:43+00:00"
---

# Ablehnungsgründe verstehen {#operations-reasons}

Reason-Codes sind feste technische Werte. Die folgende Zuordnung beschreibt
die Untersuchung; sie erlaubt keinen automatischen Ersatztransport.

| Code | Auslöser | Nächster Prüfschritt |
| --- | --- | --- |
| `invalid_target` | Ungültige URI, verbotene rohe Syntax, Userinfo oder Fragment. | Ursprünglichen String vor PSR-7-Erstellung untersuchen. |
| `scheme_forbidden` | Anderes Scheme als HTTP/HTTPS. | Tatsächlichen Anwendungspfad korrigieren. |
| `authority_mismatch` | Host-Header passt nicht zur kanonischen URI-Authority. | Host-/Port-Overrides im aufrufenden Code entfernen. |
| `address_forbidden` | Verbotene Adressklasse, Betreiber-Sperre oder Kandidat außerhalb eines gebundenen Netzes. | Vollständige IP-Liste und exaktes Profil prüfen. |
| `resolution_unverified` | DNS unvollständig, ungültig, leer, nicht erreichbar oder nicht überprüfbar; bei Offline-Diagnose kein statischer Eintrag. | DNS-Serverkonfiguration und statische Hostdaten prüfen. |
| `resolution_limit` | Adress-/CNAME-Grenze oder Zyklus. | DNS-Kette beheben; keine Kandidaten abschneiden. |
| `endpoint_mismatch` | Origin oder Methode entspricht nicht dem gebundenen Profil. | Servicebindung, Zielport und Methode abgleichen. |
| `grant_invalid` | Unbekannte, fremde oder abgelaufene Bindung. | Profilgültigkeit prüfen und Client korrekt neu erzeugen. |
| `transport_unsupported` | Fehlendes cURL/cURL-multi, nicht unterstützte Hauptversion oder Untergrenze, inkompatible Core-/SDK-API oder zweiter nativer Versuch derselben Lease. | `doctor`, Versionsbereiche, APIs und PHP-Funktionen prüfen. |
| `proxy_unsupported` | Explizite Proxyoption oder echte Proxy-Prozessvariable. | Deployment-Umgebung und Proxyanforderung mit Betreiber klären. |
| `option_forbidden` | Unbekannte oder unkontrollierte SDK-/Transportoption. | RequestFactory-Defaults und Requestoptionen prüfen. |
| `redirect_forbidden` | Verbotene Redirect-Origin, Downgrade oder ungültige Redirectoption. | Tatsächliche Location und Profilregeln untersuchen. |
| `configuration_invalid` | Schemafehler, widersprüchliche Registry oder Middlewareposition. | `config-check`, `doctor` und Serviceverdrahtung prüfen; fehlerhaften Deploymentstand beheben. |

Interne DNS-Fehler werden an der Resolvergrenze gegebenenfalls als
`resolution_unverified` zusammengefasst. Ein Reason-Code ist kein
vollständiger Netzwerkdiagnosebericht und enthält absichtlich keine Secrets.