Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Request Shield: Fehlersuche

Symptome des Request Shields mit Ursache und Abhilfe - für diese Seite nicht gelaufen, Regeln nicht lesbar, alles geht durch, Dateien von root, Redakteure bei der Browserprüfung, 429 für echte Besucher, 405 für…

Download as PDF

Address: https://doc.exponential.earth/learninminutes/exphelp/viewer/help/request-shield/troubleshooting.md

On this page

This page is a translation. Read the English original

Request Shield: Fehlersuche

Inhalt

  1. Erste Hilfe
  2. Symptome, Ursachen und Abhilfe
  3. Echte Besucher bekommen 429
  4. Formulare, die API oder der Layout-Editor bekommen 405
  5. Vorwärmer und eigene Skripte
  6. Ein Proxy, CDN oder zweiter Webserver davor
  7. Shared Hosting
  8. Herausfinden, warum eine Anfrage so entschieden wurde

Erste Hilfe

Wenn Sie den Verdacht haben, dass der Shield echte Besucher abweist, und die Website sofort funktionieren muss: Klicken Sie Pausieren auf der Übersicht, oder legen Sie auf dem Server die Datei var/request-shield/PAUSED an. Der Shield entscheidet dann ab der nächsten Anfrage nichts mehr, auf jedem Server. Finden Sie die Ursache im Protokoll, beheben Sie sie, dann Einschalten.

Symptome, Ursachen und Abhilfe

SymptomUrsacheAbhilfe
Übersicht: „Der Shield lief für diese Seite nicht“der Hook steht nicht in config.php, oder Velocity wurde nach dem Hinzufügen nicht neu gestartet, oder Velocity verwendet ein index.php älter als 6.0.15den Hook hinzufügen (der Leitfaden); ./console exp:velocity restart
„Die Regeln können nicht gelesen werden“ein Fehler in einer Regeldateibin/request-shield check <Hauptregeldatei> nennt Datei und Zeile
Im Modus enforce geht alles durch; das Fehlerlog von PHP meldet, der Shield sei gescheitert und habe die Anfrage durchgelassender Shield lässt im Fehlerfall durch: ein Speicher- oder Cache-Verzeichnis, das er nicht beschreiben kannvar/request-shield/ für den PHP-Benutzer der Website beschreibbar machen
Dateien in var/request-shield/ gehören root, die Website kann sie nicht lesendie Kommandozeile lief als rootbin/request-shield als Webbenutzer ausführen; den Eigentümer korrigieren
Eine Redakteurin oder ein Redakteur erhält in der Administration die Seite der Browserprüfungdie Administration verlangt die Browserprüfung einmal pro PassJavaScript und Cookies erlauben; für eine feste Büroadresse exempt <Adresse> in der Regeldatei
Hintergrundanfragen in der Administration scheitern mit 429eine Hintergrundanfrage ohne Pass erhält die Prüfung als JSONdie Seite lädt sich selbst neu; weitere Hintergrundpfade mit api-path nennen
Der Layout-Editor meldet „Something went wrong“, wenn Sie einen Entwurf verwerfen oder speichern (405 durch die Regel methods im Log)die Kopie der Admin-Regeln der Website ist älter als exp_request_shield 0.0.1.4 und erlaubt nur GET, HEAD, POST und OPTIONSEXP-ADMIN-SPA (oder EXP-AH-SPA bei einem eigenen Admin-Host) samt ihrer method-Zeile aus rules/exponential-admin-uri.rules (oder -host.rules) der Extension in die Kopie der Website übernehmen
Setup > Preload sites bricht nach etwa 120 Seiten mit 429 ab, oder die Prüfung nach exp:upgrade scheitert an /user/login mit 429das Tempolimit oder die Browserprüfung der Anmeldung hat die eigenen Anfragen des Servers beantwortetexp_request_shield auf 0.0.1.5 oder neuer aktualisieren: der Kernel signiert seine eigenen Anfragen (X-Exp-Self), und der Shield lässt sie durch
Echte Besucher bekommen 429die Seite der Browserprüfung (Status 429, normal: der Browser löst sie), oder ein Budget, das sich viele Besucher teilenEchte Besucher bekommen 429
Ein Formular, die REST-API oder der Layout-Editor antwortet mit 405die Methode ist dort nicht erlaubt (EXP-POST, method)Formulare, die API oder der Layout-Editor bekommen 405
Fast jede Logzeile zeigt dasselbe Netz; oder es wird nie etwas gezähltein Proxy oder CDN davor, dem die Regeln nicht vertrauen (trust)Ein Proxy, CDN oder zweiter Webserver davor
Crawler bekommen bei PDFs oder der Suche die Browserprüfungein Crawler, der nur den Namen einer Suchmaschine sendet, wird wie jeder Besucher behandelt; bestätigte Crawler bekommen nie die Prüfungnichts zu beheben; einen eigenen Crawler begrüßen Sie mit crawler <Art> ua /<Muster>/ dns <Suffixe>
Nach replace [EXP-SEARCHES] ... zählt jede Seite auf das Suchbudgetdie mitgelieferte Regel steht in einem match-Block; der Ersatz wurde ohne at geschriebenat regex (?i)/content/(advanced)?search(/|$) ergänzen (Kochbuch)
test lässt nach einem replace mitgelieferte Beispiele scheitern (expected uncached, got check by EXP-SEARCHES)die mitgelieferten Beispiele gelten den alten Zahlenso gewollt; es zählen Ihre Beispiele neben dem replace
Eine Regel aus einer neuen Version der Erweiterung fehlt auf der Website (etwa EXP-ADMIN-SPA, EXP-IMAGES)die Kopien in settings/request-shield/ werden einmal geschrieben und von keinem Update geändertmit extension/exp_request_shield/rules/ vergleichen (Kochbuch)
Ein Seiten-Alias wird abgewiesen (404 durch EXP-MODULES oder EXP-SYSVIEW)der Alias beginnt mit einem Modulnamenden Alias als Ausnahme mit einem expect-Beispiel aufnehmen (Beobachten und durchsetzen)
bin/request-shield test lässt nach dem Eintragen Ihrer Hosts fünf Beispiele mit Origin: https://www.example.org scheitern (403 durch EXP-ORIGIN)die mitgelieferten Beispiele verwenden die Dokumentationsdomain www.example.orghost www.example.org hinzufügen: eine reservierte Domain, nie die eines echten Besuchers
Das Diagramm der Übersicht ist leerdie Regeln nennen keine Protokolldatei, oder log-level offset log ...; set log-level flag
/rs/... antwortet mit 403die vorgegebene Regel SITE-DASH sperrt die eigenen Seiten der Bibliothek für alle außer dem Serversie für Ihre Adressen oder mit einem Token öffnen (dashboard.md der Extension, auf Englisch)
Eine Modus-Schaltfläche ist deaktiviertder Webserver kann die Regeldatei oder ihr Verzeichnis nicht beschreibenbeschreibbar machen, oder set mode auf dem Server ändern
Unter Velocity X-RS: allow-uncached shield error bei Abweisungeneine Bibliothek mit geänderten inneren Schritten: die Extension ist auf den einfachen Aufruf zurückgefallendie Extension aktualisieren

Echte Besucher bekommen 429

Sehen Sie zuerst die Logzeile an (Setup > Request Shield > Log, oder grep nach dem Netz der Adresse in var/request-shield/log/shield.log):

LogzeileWas geschahWas zu tun ist
challenge 429 "always" rule=EXP-LOGIN (oder EXP-FORMS, EXP-ADMIN-CHECK)die Seite der Browserprüfung wurde gesendet; ihr Status ist 429. Ein Browser mit JavaScript und Cookies löst sie in einer Sekunde und geht weiternichts. Bleibt der Besucher auf der Seite: JavaScript oder Cookies sind blockiert (ein Datenschutz-Add-on), was die Seite auch sagt
challenge 429 "pages" rule=EXP-PACEmehr als 120 Seiten pro Minute von einer Adresse: oft ein Büro, eine Schule oder ein Mobilfunknetz hinter einer IPv4-Adressedie Adresse des Büros mit exempt ausnehmen, oder ein schnelleres Tempo (Kochbuch)
challenge 429 "images" rule=EXP-IMAGESeine Seite mit Tausenden neuer Bilder (bei Bedarf erzeugte Aliase)ein größeres Bildbudget (Kochbuch)
challenge 429 "searches" rule=EXP-SEARCHESmehr als zehn Suchen pro Minutefür einen Menschen nur beim schnellen Blättern normal; erhöhen Sie das Budget, wenn die Suche billig ist
throttle 429 "banned"ein Bann (ban after ...)der Besucher hat vorher viele Abweisungen verursacht; suchen Sie diese Zeilen. Ein Bann endet von selbst (spätestens nach ban-max); die Listenseite der Bibliothek (/rs/waf/lists) kann ihn früher aufheben
derselbe Besucher wird immer wieder geprüftder Pass ist an den Browser gebunden (bind-user-agent on), oder das Geheimnis unterscheidet sich zwischen den Servernein Geheimnis auf jedem Server (mehrere Webserver)
alle bekommen gleichzeitig 429alle Besucher teilen sich eine Adresse: einem Proxy davor wird nicht vertrautein Proxy davor

Während Sie suchen, lässt Beobachten auf der Übersicht alle herein und protokolliert trotzdem, was entschieden worden wäre.

Formulare, die API oder der Layout-Editor bekommen 405

Das Log sagt reject 405 "method". Der Shield erlaubt POST nur dort, wo Exponential Formulare annimmt (EXP-POST), und PUT, PATCH und DELETE nur für die API des Layout-Editors (EXP-ADMIN-SPA).

  • Ein Formular einer eigenen Erweiterung: allow POST **/<Modul>/** (Kochbuch).
  • Die REST-API: method ... PUT PATCH DELETE und allow PUT PATCH DELETE /api/** (Kochbuch).
  • „Entwurf verwerfen“ oder „Speichern“ im Layout-Editor meldet „Something went wrong“: die Kopie der Admin-Regeln der Website ist älter als exp_request_shield 0.0.1.4; übernehmen Sie EXP-ADMIN-SPA und seine method-Zeile aus rules/exponential-admin-uri.rules der Erweiterung (oder EXP-AH-SPA aus -host.rules).

Vorwärmer und eigene Skripte

Das Tempo erlaubt 120 Seiten pro Minute und Adresse, und die Anmeldung verlangt immer die Browserprüfung, die kein Skript lösen kann. Ein eigener Crawler wird also nach 120 Seiten geprüft:

  • Setup > Vorladen, die Adressprüfung nach dem Upgrade, statisches Veröffentlichen: sie signieren ihre Anfragen (X-Exp-Self) seit exp_request_shield 0.0.1.5 mit dem Kernel ab dem 14.11.2026. Aktualisieren Sie beides.
  • Ein eigenes Skript auf derselben Installation: signieren Sie es mit expRequestShield::selfHeader() (Kochbuch).
  • Ein Werkzeug auf einem anderen Rechner (das Vorwärmen eines CDN, ein SEO-Crawler): exempt <seine Adresse> until <Tag>.
  • Eine signierte Anfrage bekommt trotzdem 429: die Signatur ist älter als zwei Minuten (eine pro Anfrage erzeugen), wurde für eine andere Adresse oder Methode erzeugt, oder das Skript kann var/request-shield/cache/self.key nicht lesen (als Benutzer der Website ausführen).

Ein Proxy, CDN oder zweiter Webserver davor

AufbauSymptom ohne AbhilfeAbhilfe
Cloudflare oder ein anderes CDNjeder Besucher scheint vom CDN zu kommen: alle teilen ein Budget und bekommen gemeinsam 429den Netzen des CDN mit trust vertrauen, oder den Webserver REMOTE_ADDR setzen lassen (mod_remoteip, nginx real_ip) (Kochbuch)
nginx vor Apache auf demselben Rechnerjede Anfrage kommt von 127.0.0.1, das ausgenommen ist: es wird nie etwas gezählt oder geprüfttrust 127.0.0.1 ::1 und X-Forwarded-For von nginx (Kochbuch)
ein Load Balancer und zwei WebserverBesucher werden auf dem anderen Server erneut geprüft; Budgets zählen doppelt so hochein secret für alle, store file in einem gemeinsamen Verzeichnis (Kochbuch)
LiteSpeed mit Cloudflarewie bei Cloudflare„Use Client IP in Header“ für vertrauenswürdige Adressen, oder trust

Der Shield glaubt X-Forwarded-For nur von einer vertrauenswürdigen Adresse; ein Besucher kann sich also nicht mit dem Header als jemand anderes ausgeben.

Shared Hosting

SymptomUrsacheAbhilfe
check meldet Stufe S0: Budgets, Banns und das Pass-Cookie sind auskein beschreibbares Verzeichnis für den Speichervar/request-shield/ für den PHP-Benutzer der Website beschreibbar machen
check meldet Stufe S1kein APCu: Zähler in Dateiennichts zu beheben; etwa 25 Mikrosekunden pro Anfrage
Das Fehlerlog von PHP meldet open_basedir restriction vom Shieldstore-dir oder log außerhalb der erlaubten Verzeichnissebeide innerhalb der Installation halten (var/request-shield/...)
Der Benutzer für das Deployment und der des Webservers können die Dateien des anderen nicht lesender Shield schreibt 0600set file-mode 0640, set dir-mode 02750, eine gemeinsame Gruppe

Herausfinden, warum eine Anfrage so entschieden wurde

Das Protokoll nennt die Regel. Um die Entscheidung Schritt für Schritt zu sehen, auf dem Server, als Webbenutzer:

php extension/exp_request_shield/bin/request-shield trace settings/request-shield/request-shield.rules "GET https://www.example.org/the/path"

Mit set debug-header on in der Regeldatei trägt jede Antwort einen Header X-RS mit der Entscheidung; schalten Sie ihn danach wieder aus.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x