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: Konfigurationsreferenz

Alles, womit sich der Request Shield (exp_request_shield) konfigurieren lässt, an einer Stelle - wo seine Konfiguration liegt, die Konstanten in config.php, requestshield.ini, der Cronjob-Teil, die Dateien auf der…

Download as PDF

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

On this page

This page is a translation. Read the English original

Request Shield: Konfigurationsreferenz

Diese Seite führt alles auf, was den Request Shield konfiguriert (die Erweiterung exp_request_shield, die die Bibliothek request-shield mitbringt): die wenigen Einstellungen außerhalb der Regeldateien, das Format der Regeldateien, jede Regelzeile und jeden set-Schlüssel mit seiner Vorgabe und jede Regel, die die Erweiterung für Exponential mitliefert. Sie ist zum Nachschlagen gedacht. Ausgearbeitete Beispiele zum Kopieren stehen im Kochbuch, die Installation in der Anleitung.

Die Tabellen folgen request-shield 0.4.0, der Version, die exp_request_shield 0.0.1.x mitbringt. Auf dem Server gibt php extension/exp_request_shield/bin/request-shield vocabulary die Regelwörter der installierten Version aus.

Inhalt

  1. Wo die Konfiguration liegt
  2. Die Hauptregeldatei und die Konstanten
  3. requestshield.ini und der Cronjob-Teil
  4. Dateien auf der Platte
  5. Das Format der Regeldateien
  6. In welcher Reihenfolge eine Anfrage geprüft wird
  7. Jede Regelzeile
  8. Jeder set-Schlüssel
  9. Die mitgelieferten Exponential-Regeln
  10. Die eingebauten Regelsätze
  11. Die expect-Zeile
  12. Die Logzeile
  13. Die eigenen Anfragen der Installation
  14. Verwandte Seiten

Wo die Konfiguration liegt

Der Shield läuft, bevor der Kernel startet, und liest deshalb nie eine INI-Datei. Seine Konfiguration liegt hier:

WoWas es konfiguriertWer es ändert
Die Regeldateien (settings/request-shield/*.rules)alles, was der Shield entscheidet: Hosts, Pfade, Methoden, Budgets, die Browserprüfung, das Log, den ModusSie, auf dem Server; den Modus auch in der Administration
Konstanten in config.phpwelche Regeldatei, welche Verzeichnisse, Shield ausgeschaltetSie, vor der Hook-Zeile
var/request-shield/PAUSEDder Shield pausiert, solange die Datei existiertPausieren / Einschalten in der Administration, oder touch / löschen
settings/override/requestshield.ini.append.phpnur die Seiten der Administration (Zeitraum der Übersicht, Seitengröße des Logs)Sie
settings/override/cronjob.ini.append.phpwann der tägliche Cronjob-Teil requestshield läuftSie

Die Hauptregeldatei und die Konstanten

Der Shield liest eine Hauptregeldatei, die die anderen einbindet. Es ist die erste von:

ReihenfolgeDateiWann
1die Datei aus EXP_REQUEST_SHIELD_RULESdie Konstante ist in config.php vor der Hook-Zeile definiert
2settings/request-shield/request-shield.rulesdie Website hat eine eigene Datei (empfohlen)
3extension/exp_request_shield/rules/request-shield.rulesdie Vorgabe der Erweiterung, die jedes Update ersetzt

php extension/exp_request_shield/bin/request-shield rules gibt die verwendete Datei aus und woher sie kommt; der Einrichtungskasten der Übersicht sagt dasselbe.

Die Konstanten, in config.php vor der Hook-Zeile definiert, nur wenn die Vorgabe nicht passt:

KonstanteVorgabeWirkung
EXP_REQUEST_SHIELD_RULESsiehe obendie Hauptregeldatei, ein absoluter Pfad
EXP_REQUEST_SHIELD_ROOTzwei Ebenen über der Erweiterungdas Wurzelverzeichnis der Installation
EXP_REQUEST_SHIELD_VAR<root>/var/request-shieldwo die übersetzten Einstellungen (cache/), PAUSED, die Sicherungen der Moduswechsel und der Schlüssel für eigene Anfragen (cache/self.key) liegen
EXP_REQUEST_SHIELD_DISABLEDnicht definierttrue: der Hook tut gar nichts (Velocity nach einer Änderung neu starten)
// config.php, über der Hook-Zeile: eine Regeldatei außerhalb der Installation
define( 'EXP_REQUEST_SHIELD_RULES', '/etc/exponential/www.example.org/request-shield.rules' );

if ( is_file( __DIR__ . '/extension/exp_request_shield/bootstrap/hook.php' ) )
    require __DIR__ . '/extension/exp_request_shield/bootstrap/hook.php';

requestshield.ini und der Cronjob-Teil

requestshield.ini enthält nur Einstellungen der Seiten in der Administration. Überschreiben Sie sie in settings/override/requestshield.ini.append.php:

[AdminSettings]VorgabeWirkung
DashboardHours24die Stunden, die die Übersicht zusammenfasst und zeichnet, 1 bis 168
DashboardRecent15die neuesten Logzeilen auf der Übersicht
LogHours[]1, 6, 24, 72, 168die Zeiträume, die die Logseite anbietet
LogPageSize50Logzeilen pro Seite
ShowRuleTextenabledden Text der Regeldateien auf der Regelseite zeigen (disabled blendet ihn aus, etwa wenn eine Regeldatei Büroadressen nennt)

Die Erweiterung bringt außerdem den Cronjob-Teil requestshield mit, täglich um 04:23 (CrontabSchedule_requestshield=23 4 * * * in ihrer cronjob.ini.append.php). Er führt request-shield feeds update aus (die öffentlichen Sperrlisten, die die Regeln mit feed nennen) und request-shield crawlers update (die Adresslisten, die Suchmaschinen und KI-Crawler veröffentlichen), damit Sperrlisten und Crawler-Prüfung aktuell bleiben. Lassen Sie ihn als Benutzer der Website laufen; der Crontab-Installer des Kernels schreibt ihn in dessen Crontab. Bis zum ersten Lauf entscheiden feed-Regeln nichts.

Dateien auf der Platte

PfadWasGeschrieben von
extension/exp_request_shield/lib/requestshield/die Bibliothek (und php74/, dieselben Dateien für PHP 7.4)dem Paket
extension/exp_request_shield/rules/die mitgelieferten Regeldateiendem Paket, von jedem Update ersetzt
settings/request-shield/die Hauptregeldatei der Website und ihre Kopien der exponential*.rulesIhnen, oder dem ersten Moduswechsel in der Administration
var/request-shield/cache/die übersetzten Einstellungen; self.key, der Schlüssel der eigenen Anfragendem Shield
var/request-shield/store/Zähler (ohne APCu), das Geheimnis des Pass-Cookies, Listen, Feeds, Statistikendem Shield (Pfad aus set store-dir)
var/request-shield/log/shield.logeine Zeile pro Entscheidung, rotiert bei log-max-sizedem Shield (Pfad aus set log)
var/request-shield/backup/die vorige Regeldatei jedes Moduswechselsder Administration
var/request-shield/PAUSEDpausiert den Shield, solange sie existiertIhnen, oder Pausieren
var/log/requestshield.logjeder Schalter in der Administration, mit dem Login des Benutzersder Administration

Ganz var/request-shield/ muss für den Benutzer beschreibbar sein, unter dem das PHP der Website läuft, und darf nie vom Webserver ausgeliefert werden (ein Standard-Virtual-Host von Exponential verweigert var/ außer den Speicherpfaden, die er absichtlich ausliefert). Dateien legt der Shield mit 0600 an, Verzeichnisse mit 0700, sofern set file-mode und set dir-mode nichts anderes sagen. Rufen Sie die Kommandozeile als Benutzer der Website auf (sudo -u <Webbenutzer> php extension/exp_request_shield/bin/request-shield ...), sonst kann die Website Dateien von root nicht lesen.

Das Format der Regeldateien

ids SITE                                          # die Regel-IDs dieser Datei beginnen mit SITE-
version 2026-11-15.1                              # von check und auf der Regelseite angezeigt

include exponential-admin-uri.rules               # eine weitere Datei, relativ zu dieser

[SITE-OLD] block /old/**                          # eine Regel mit ID; der Kommentar ist ihre Beschreibung
expect GET /old/page   404                        # ein Beispiel, entschieden von "request-shield test"
expect GET /oldies     answered                   # knapp daneben: muss durchgehen
  • Eine Regel pro Zeile: ein Wort, dann Werte, durch Leerzeichen getrennt. # beginnt einen Kommentar am Zeilenanfang oder nach einem Leerzeichen (\# ist ein #). Der Kommentar nach einer Regel ist ihre Beschreibung, gezeigt auf den Regelseiten und wenn ein Beispiel fehlschlägt.

  • [ID] vor einer Regel gibt ihr einen Namen: Buchstaben, Ziffern, -, _, .. Das Log, trace und die Übersicht nennen die Regel so (rule=SITE-OLD). Eine Regel ohne ID heißt nach Datei und Zeile (request-shield.rules:12). Eine doppelte ID ist ein Fehler. [ID@n] ist eine Revision; als Verweis (unblock [SCAN-BACKUP@1]) nennt sie die Revision, die Sie geprüft haben, und check warnt, wenn ein Update der Bibliothek diese Regel ändert.

  • ids <PRÄFIX> [required] oben in der Datei: jede ID der Datei muss mit <PRÄFIX>- beginnen; required macht eine ID für jede Regel zur Pflicht.

  • include <Datei oder Muster> liest weitere Dateien, relativ zur einbindenden Datei. Ein Include darf sein Verzeichnis nicht mit .. verlassen: deshalb liegen neben der Hauptdatei der Website Kopien der exponential*.rules. include @name liest einen eingebauten Satz (@wordpress, @tracking, ...).

  • Pfade sind einfache Muster, verglichen mit dem Pfad ohne Query:

    MusterTrifftTrifft nicht
    /wp-admin/**/wp-admin, /wp-admin/x/y.php/wp-adminx
    /page/*/page/about (* bleibt in einem Segment)/page/a/b
    *.sql/dump.sql, /a/b/dump.sql (ohne führenden /: überall)/dump.sqlx
    **/admin/**/admin, /shop/admin/x (in jedem Verzeichnis)/administrator
    /file?.txt/file1.txt (? ist ein Zeichen)/file12.txt

    regex schaltet den Rest der Zeile auf reguläre Ausdrücke ohne Begrenzer um (block regex (?i)^/(phpmyadmin|adminer)); (?i) ignoriert Groß- und Kleinschreibung. Jedes Muster wird beim Lesen der Dateien übersetzt; ein kaputtes ist dann ein Fehler, nie ein stiller Fehltreffer. URI-Siteaccesses stehen vor dem Pfad (/ger/content/search): schreiben Sie **/content/search oder einen Ausdruck mit (/[a-z0-9_]+)? davor, wo es darauf ankommt.

  • none als erster Wert leert eine Liste zuerst, Vorgaben eingeschlossen (exempt none 192.0.2.1).

  • match <Pfade> { ... } fasst die Regeln eines Bereichs zusammen: darin gelten Regeln nur für diese Pfade, und ein limit zählt nur die Anfragen dort. match regex ... { } nimmt einen regulären Ausdruck.

  • site <Namen> { ... } fügt Regeln für einzelne Websites hinzu (Hostnamen, *.example.org, default). Die Website wählt der Servername des Webservers (set site-from server-name, die Vorgabe), sodass ein Besucher nicht mit einem Host-Header die Regeln einer anderen Website wählen kann. Nach dem ersten site-Block dürfen nur weitere site-Blöcke, include, ids und version folgen, und serverweite Zeilen (trust, store-dir, secret, ban, feed, set recheck ...) dürfen nicht darin stehen. Verwenden Sie in einer Datei mit site-Blöcken absolute Pfade für store-dir und log.

  • Spätere Zeilen gewinnen bei set-Schlüsseln: Schreiben Sie die eigenen Einstellungen der Website nach das include der mitgelieferten Regeln, die selbst einen Modus, einen Speicher und ein Log setzen.

  • Änderungen brauchen keinen Neustart. Jeder Server bemerkt eine geänderte Regeldatei innerhalb von recheck Sekunden (Vorgabe 10) und übersetzt sie neu. Eine fehlerhafte Datei legt die Website nie lahm: die letzten guten Einstellungen bleiben in Kraft (beim allerersten Übersetzen lässt der Shield alles durch), und das Fehlerlog von PHP nennt einmal pro Minute Datei und Zeile.

In welcher Reihenfolge eine Anfrage geprüft wird

request-shield trace <main.rules> "GET https://www.example.org/pfad" zeigt diese Schritte für eine Anfrage, jeden mit seinem Ergebnis; die erste Abweisung beendet die Anfrage:

#SchrittRegelzeilen, die darüber entscheiden
1Ausgesperrtdeny, die Sperrliste
2Öffentliche Listenfeed
3Gebanntban
4Art der Anfragemethod
5Größeset max-uri, max-query-parameters, max-header-bytes
6Verschleierte Adresseeingebaut: Kodierungen, .., Pfade aus dem Verzeichnis der Website heraus
7Name der Websitehost
8Adressen, die nur Angreifer aufrufenblock, unblock, die eingebauten Scanner-Pfade
9Wohin Formulare gesendet werden dürfenallow
10Woher Formulare kommenpost-origin
11Bereiche für bestimmte Besucherrestrict
12Bekannte Crawlercrawlers, crawler
13Bekannte Parameterquery
14Angriffsmusterblock query, block header, @attacks
15Darf ein Cache die Antwort behalten?cache-path, cache-query, cache-ignore
16Tempo (eine Zeile pro Budget)limit, no-limit
17Browserprüfungchallenge, challenge-exempt, api-path

Eine exempt-Adresse überspringt die Budgets und die Browserprüfung, blockierte Pfade und Angriffsmuster weisen sie aber weiter ab. Eine Anfrage mit gültiger X-Exp-Self-Signatur (eine eigene Anfrage der Installation) überspringt den Shield ganz.

Jede Regelzeile

Die Vorgaben sind die der Bibliothek; wo die mitgelieferten Exponential-Regeln etwas anderes setzen, sagt es die Spalte „Mitgeliefert“.

ZeileVorgabeMitgeliefertWirkung
host <Namen>jeder Hostnicht gesetzt: in der Datei der Website eintragendie Hostnamen der Website; eine Anfrage für einen anderen Namen bekommt 404
trust <Adressen oder Netze>niemandnicht gesetztwer X-Forwarded-For, -Proto und -Host senden darf: Load Balancer, Reverse Proxy oder CDN. Von allen anderen werden diese Header entfernt, bevor die Website läuft. X-Forwarded-For wird von rechts nach links gelesen, bis zur ersten Adresse, für die kein vertrauenswürdiger Proxy bürgt
method <METHODEN>GET HEAD POST OPTIONSergänzt PUT PATCH DELETE (Admin-Regeln)die überhaupt erlaubten Methoden; jede andere: 405
allow <METHODEN> <Pfade>überallEXP-POST, EXP-ADMIN-POST, EXP-ADMIN-SPAdiese Methoden nur an diesen Pfaden, sonst 405. Mehrere allow-Zeilen für eine Methode addieren sich
restrict <Pfade> to <Adressen oder Netze>offenSITE-DASH (/rs/**)nur diese Adressen dürfen die Pfade öffnen, andere 403. Im Beobachtungsmodus weist ein restrict niemanden ab
block <Pfade>die eingebauten Scanner- und Devtools-PfadeEXP-SYSVIEW, EXP-MODULES, EXP-INTERNAL, EXP-INI, EXP-VIEWPARAMS404, bevor die Website die Anfrage sieht
unblock <Muster> / unblock [ID] / unblock @satznimmt eine Sperre zurück: ein Muster, eine Regel, einen ganzen Satz
unblock [<ID>] at <Pfade> [for <Adressen>]EXP-SYSVIEW-OK, EXP-DOWNLOAD, EXP-ADMIN-SYSeine Sperre nur an einigen Pfaden aufgehoben (und nur für einige Adressen)
block query|header <Name>|headers|anywhere <Ausdruck>@attacksein Angriffsmuster in der Query oder den Headern: 403. Die Werte werden vorher dekodiert und normalisiert. Formularinhalte werden nicht angesehen
query <Name> <Typ> ... [at <Pfade>]EXP-SEARCH-Q, EXP-ADMIN-Qdie Query-Parameter, die die Website nimmt, mit ihren Typen: int, number, word, id, list, text, any oder /Ausdruck/; * für jeden Namen. Nur text-Werte und unbekannte Parameter werden auf Angriffe geprüft
query strictausmonitor (EXP-STRICT)jeder Parameter, den keine query-Zeile nennt: 404
query drop [at <Pfade>]ausunbekannte Parameter werden stattdessen entfernt, die Anfrage geht ohne sie weiter (GET und HEAD)
cache-path <Pfade>anywas ein Cache behalten darf
cache-query <Namen>anynone (EXP-CACHE-Q)die Parameter, die eine zwischengespeicherte Adresse haben darf; eine Anfrage mit anderen wird beantwortet, aber nie behalten (allow-uncached)
cache-ignore <Namen> / cache-ignore @trackingParameter, die kein Cache-Schlüssel enthält, vor Cache und Website entfernt
limit <Name> <n>/<Einheit> [challenge-at <n>] [on-demand] [on-exceeded challenge] [at <Pfade>]requests 600/minno-limit requests; EXP-PACE, EXP-IMAGES, EXP-SEARCHESein Budget pro Besucher (eine IPv4-Adresse oder ein IPv6-/64). Einheiten s, sec, min, hour, day, auch 20/10s. Über challenge-at die Browserprüfung; über dem Limit 429 mit Retry-After, oder mit on-exceeded challenge die Prüfung, nach der der Zähler neu beginnt. at <Pfade> oder ein match-Block: nur Anfragen dort zählen. Jedes Budget braucht einen eigenen Namen
no-limit <Name>requestsschaltet ein Budget ab, auch das vorgegebene
challenge [<METHODEN>] <Pfade> [max-age <Dauer>]EXP-LOGIN, EXP-FORMS, EXP-ADMIN-CHECKdort immer die Browserprüfung, einmal pro Pass; max-age 15m: ein Pass aus den letzten 15 Minuten. Mit Methoden davor nur diese (challenge POST **: jedes gesendete Formular)
challenge-exempt <Pfade>dort nie die Browserprüfung (Feeds, Webhooks, APIs für Programme); Budgets über ihrem Limit antworten dann mit 429
api-path <Pfade>EXP-API, EXP-ADMIN-BGeine Prüfung kommt dort als JSON (429 mit dem Header Request-Shield-Challenge), nie als Seite. Anfragen, die JSON verlangen oder Hintergrundabrufe einer Seite sind, bekommen ohnehin JSON
post-origin same [missing check|allow|refuse] [except <Pfade>]ausEXP-ORIGIN, EXP-ORIGIN-XFormulare (POST, PUT, PATCH, DELETE) nur von den eigenen Seiten der Website: Origin, sonst Referer; eine andere Website 403; keiner der Header: die Browserprüfung (missing check, die Vorgabe)
post-origin except <Pfade>EXP-ORIGIN-Xausgenommene Pfade (Rückrufe von Zahlungsanbietern, Webhooks)
backend <Pfade>EXP-ADMIN-AREAder Bereich der Redakteure, in der Statistik getrennt gezählt
exempt <Adressen oder Netze> [until <Tag>[T<hh:mm>]]127.0.0.1 ::1nie gezählt und nie geprüft; für blockierte Pfade und Angriffsmuster weiter abgewiesen
deny <Adressen oder Netze> [until <Tag>[T<hh:mm>]]403 vor jeder anderen Prüfung
feed <Name> [<URL> | from <Datei>] deny|check|count|ban-signal <n> [at <Pfade>]spamhaus-drop deny, feodo denyeine öffentliche Sperrliste, vom Cronjob-Teil abgerufen; über den site-Blöcken
ban after <n> <Signal> in <Zeit> for <Zeit>monitor (EXP-BAN: 10 Abweisungen in 10 Minuten, 1 Stunde)ein Besucher über <n> Signalen (refusals, limits, checks oder der Name eines Budgets) bekommt eine Weile nur noch 429; wiederholte Banns wachsen (ban-growth, ban-max)
crawlers <Art> allow|check|blockallowalle vier Arten allowwas geprüfte Crawler bekommen, nach Art: search, ai-search, ai-user, ai-training. allow: nie die Browserprüfung (nur die Budgets, mit einer Pause beantwortet); check: wie jeder Besucher; block: 403
crawler <ID> allow|check|blockdasselbe für einen Crawler (CRAWL-GPTBOT, ...)
crawler <Art> ua /<Muster>/ [dns <Suffixe>] [ranges <Listen>]ein eigener Crawler, geprüft per DNS oder Adressliste
monitor <Regel>EXP-BAN, EXP-STRICTvor block, restrict, allow, limit, challenge, ban, feed, query strict: die Regel wird protokolliert, wie sie entschiede (monitor-...), aber nicht durchgesetzt
replace [<ID>] <Regel>tauscht eine Regel in einer Zeile aus und behält ihre ID und ihre Zählung im Log. Schreiben Sie den Ersatz vollständig: eine Regel aus einem match-Block braucht ihr at <Pfade> (oder einen eigenen match-Block), sonst zählt sie überall
expect ...etwa 150ein Beispiel für request-shield test, siehe unten
match <Pfade> { ... } / site <Namen> { ... }siehe das Format
ids, version, includesiehe das Format
dashboard-access "<Prinzipal>"|* sha256:<Hash> [until <Tag>]wer die eigenen Seiten der Bibliothek unter /rs mit einem Token öffnen darf (request-shield access-token); in einer Datei aufbewahren, die nur der Eigentümer lesen kann
stats-group "<Name>" <Websites>, stats-skip <Pfade>Statistik pro Kunde; Pfade, die nicht gezählt werden, wenn sie durchgehen
plugin <Klasse> [from <Datei>]ein Plugin, das von jeder Entscheidung erfährt
set <Schlüssel> <Wert>siehe jeder set-Schlüssel

Jeder set-Schlüssel

${NAME} in einem Wert ist eine Umgebungsvariable, ${NAME:-vorgabe} mit einer Vorgabe.

SchlüsselVorgabeMitgeliefertWirkung
modeenforceenforceoff (nichts wird entschieden), monitor (alles protokolliert, wie es entschieden würde, niemand abgewiesen), enforce, strict (enforce, und die als strict markierten Regeln)
recheck10 (Sekunden)wie oft die Regeldateien auf Änderungen geprüft werden; 0: bei jeder Anfrage
storeautowo die Zähler liegen: auto (APCu, wenn nutzbar, sonst Dateien), apcu, file, memory. file unter Velocity und bei mehreren PHP-FPM-Pools, damit alle Worker einen Zähler teilen
store-dir.request-shield/store neben der Hauptdateivar/request-shield/storeZähler ohne APCu, das Geheimnis, Listen, Feeds, Statistiken. Relativ zur Regeldatei
secretin store-dir erzeugtder Schlüssel des Pass-Cookies, mindestens 32 Zeichen. Mehrere Server hinter einem Load Balancer brauchen denselben: set secret ${SHIELD_SECRET}
pass-ttl1h2h (Admin-Host: 8h)wie lange eine gelöste Browserprüfung gilt
solution-ttl5mwie lange eine Lösung brauchen darf
difficulty-min, difficulty-max50000, 500000der Aufwand der Browserprüfung; verdoppelt sich pro Lösung innerhalb einer Stunde, bis zum Maximum
cookie, solution-cookiersp, rssdie Cookie-Namen
bind-user-agentonder Pass gilt nur für den Browser, in dem er gelöst wurde
debug-headeroffon: jede Antwort trägt X-RS: <Entscheidung>; rule=<ID> (zum Testen; danach wieder ausschalten)
strip-untrusted-forwardedonentfernt X-Forwarded-* aus $_SERVER, wenn der Absender nicht vertrauenswürdig ist
search-enginesonoff: kein Crawler wird erkannt
crawler-verifybothranges (nur die veröffentlichten Adresslisten, kein DNS während der Anfrage), dns, both
dns-lookups30 pro MinuteDNS-Abfragen zur Prüfung von Crawlern, für alle Anfragen zusammen; 0: keine
app-challengeoffon: die Website darf die Prüfung mit dem Antwort-Header X-RS-Check: 1 anfordern
ipv6-prefix64das IPv6-Präfix, unter dem ein Besucher gezählt wird
max-uri, max-query-parameters, max-header-bytes4096, 64, 16384Größengrenzen; darüber wird die Anfrage abgewiesen, bevor die Website läuft
languageautodie Sprache der eigenen Seiten des Shields: die Browsersprache des Besuchers, sofern es Texte dafür gibt (Englisch und Deutsch eingebaut), oder ein Code
text.<Schlüssel>, text.<Sprache>.<Schlüssel>eigene Texte für die Prüfseite und die Fehlerseiten (set text.de.title Einen Moment, bitte)
homekeine/wohin die eigenen Seiten des Shields verlinken, „Zur Startseite“
challenge-logoein Schildeine eigene SVG-Datei in der Mitte der Prüfseite
error-pagedie Seite des Shieldseine eigene Seite für einen Status: set error-page 404 errors/404.html, 4xx für alle; Platzhalter {status} {title} {text} {wait} {home} {lang} {reference}
widget-path, widget-difficultyaus, 25000die Browserprüfung im Formular, gelöst, während der Besucher tippt
logkeinevar/request-shield/log/shield.logdie Logdatei; ohne sie bleibt das Diagramm der Übersicht leer
log-levelstopflagstop: abgewiesen, gebremst, geprüft; flag: auch ungecacht durchgelassene Anfragen (unbekannte Parameter, POSTs) und gelöste Prüfungen; all: jede Anfrage (nur kurz); off
log-ipmaskedmasked: das Netz des Besuchers (IPv4 /24, IPv6 /48), nie die Adresse einer Person; full: die Adresse (personenbezogene Daten: in der Datenschutzerklärung nennen)
log-max-size10Mdanach eine Rotation nach shield.log.1
file-mode, dir-mode0600, 0700die Rechte dessen, was der Shield schreibt; für eine Gruppe: 0640 / 02750
statsoffoffdie Statistik der Bibliothek unter /rs/stats/ (on, oder Teile)
dashboard-path/rswo die eigenen Seiten der Bibliothek liegen
dashboard-session8hwie lange eine Token-Anmeldung an diesen Seiten gilt
api, api-write, api-originson, off, keineapi offdie JSON-API unter /rs/api/v1
live, live-keepoff, 1hdie Live-Ansicht mit vollen Adressen (APCu oder Dateien)
lists-dir<store-dir>/listswo allow.rules und deny.rules der Kommandozeile liegen
feeds-max-age3deine ältere abgerufene Sperrliste wird nicht verwendet
ban-growth, ban-max, ban-keep2, 1d, memoryjeder Bann innerhalb eines Tages so viel mal länger, höchstens so lang; file: Banns überstehen einen Neustart von APCu
site-fromserver-namewelcher Name einen site-Block wählt: der Servername des Webservers, oder host (der Host-Header)
cache-unknown-queryuncachedein Parameter, den cache-query nicht nennt: uncached oder hit-only
http-cache, http-cache-*offder eigene HTTP-Cache der Bibliothek; Exponential-Websites verwenden stattdessen den HTTP-Cache des Kernels
stats-hours, stats-days, stats-months, stats-flush, stats-hosts, stats-depth, stats-slow, stats-path, crawler-log*Einzelheiten der Statistik

Die eigene Referenz der Bibliothek erklärt jeden ausführlicher (auf Englisch): settings.

Die mitgelieferten Exponential-Regeln

Die vorgegebene Hauptdatei bindet exponential-admin-uri.rules ein, die exponential.rules einbindet. Jede Regel hat eine ID; ändern Sie eine in der Hauptdatei der Website mit replace [ID] ..., nehmen Sie sie mit unblock [ID] oder no-limit <Name> zurück, und bearbeiten Sie nie die Kopien, damit sie sich auffrischen lassen.

Das Frontend (exponential.rules):

IDRegelWas sie tut
(Einstellungen)include @tracking @attacks @devtools, set pass-ttl 2h, set home /Marketing-Parameter bekannt, Angriffsmuster abgewiesen, Build-Dateien und Debug-Seiten abgewiesen
EXP-SYSVIEWblock regex (?i)/content/view(/|$)/content/view/..., Seiten nach Knotennummer, 404 im Frontend
EXP-SYSVIEW-OKunblock [EXP-SYSVIEW] at **/content/view/sitemap/* **/content/view/tagcloud/*Sitemap und Schlagwortwolke bleiben offen
EXP-MODULESblock regex (?i)^(/(ger|eng))?/(setup|class|section|role|...|pdf)(/|$)Admin-Module, 404 im Frontend; nennen Sie Ihre URI-Siteaccesses statt ger|eng
EXP-INTERNALblock regex ^/(settings|kernel|lib|bin|autoload|cronjobs|update|tests|doc|var/[^/]+/(cache|log))(/|$)die eigenen Verzeichnisse der Installation
EXP-INIblock *.ini *.ini.append *.ini.append.php *.tplEinstellungen und Template-Quellen, überall
EXP-DOWNLOADunblock [SCAN-BACKUP@1] at **/content/download/** /var/*/storage/**hochgeladene Archive (.zip, .sql ...) bleiben herunterladbar
EXP-VIEWPARAMSblock regex (?i)/\((offset|limit|year|month|day)\)/(?![0-9]{1,6}(/|$))View-Parameter müssen Zahlen mit bis zu 6 Stellen sein
EXP-POSTallow POST **/user/login **/content/action ... /api/**POST nur, wo Exponential ein Formular nimmt; ergänzen Sie die Module Ihrer Erweiterungen
EXP-LOGINchallenge **/user/login **/user/register **/user/forgotpassword **/user/password/** max-age 15mAnmeldung und Registrierung: zuerst die Browserprüfung
EXP-FORMSchallenge **/content/action **/content/tipafriend/** **/comment/add/** **/newsletter/subscribe/** max-age 30mKontaktformulare, Kommentare, Newsletter
EXP-ORIGINpost-origin sameFormulare nur von den eigenen Seiten der Website
EXP-ORIGIN-Xpost-origin except **/paypal/notify_url/** **/xrowpaypal/notify/**Rückrufe von Zahlungsanbietern
EXP-APIapi-path **/ezjscore/** /api/**ezjscore-Aufrufe und die REST-API bekommen die Prüfung als JSON
EXP-SEARCHESlimit searches 10/min on-exceeded challenge (in match regex (?i)/content/(advanced)?search(/|$))zehn Suchen pro Minute, dann die Prüfung
EXP-SEARCH-Qquery SearchText text ... SearchDate /-1|[1-5]/ ...die Parameter des Suchformulars mit ihren Typen
EXP-CACHE-Qcache-query noneein Cache behält nur Adressen ohne Query
EXP-SEARCH-CHECKchallenge **/content/search **/content/advancedsearch max-age 1hauskommentiert: nehmen Sie das # weg, solange die Suche angegriffen wird
EXP-PACElimit pages 300/min challenge-at 120 on-exceeded challenge at regex ^(?!...images...)das Tempo: die Prüfung ab 120 Seiten pro Minute und erneut ab 300, Bildadressen ausgenommen
EXP-IMAGESlimit images 3000/min on-exceeded challenge at regex ^(...content/image/|/index_image.php|...storage/images...)bei Bedarf erzeugte Bild-Aliase: 3000 pro Minute
EXP-BANmonitor ban after 10 refusals in 10m for 1hein Scanner eine Stunde von der Website fern; nur beobachtet
EXP-STRICTmonitor query strictunbekannte Query-Parameter: 404; nur beobachtet

Die Administration als /admin (exponential-admin-uri.rules): EXP-ADMIN-BG (api-path /admin/user/megamenu/**), die method-Zeile mit PUT PATCH DELETE, EXP-ADMIN-SPA (allow PUT PATCH DELETE /admin/explayouts_ui_api/**, der Layout-Editor), und in match /admin/**: EXP-ADMIN-SYS (System-URLs und Admin-Module offen), EXP-ADMIN-POST (allow POST), EXP-ADMIN-CHECK (challenge: die Browserprüfung einmal pro Pass), EXP-ADMIN-AREA (backend), EXP-ADMIN-Q (query * text) und das auskommentierte EXP-ADMIN-NET (restrict to <Büro>).

Die Administration auf einem eigenen Host (exponential-admin-host.rules): dasselbe als EXP-AH-*-Regeln in site admin.example.org { ... }, mit set pass-ttl 8h für Redakteure.

Die vorgegebene Hauptdatei (request-shield.rules): SITE-ADMIN-* für die übrigen Admin-Siteaccesses (/adminui, /editor, /admin2 bis /admin4l, /admintest_*), include @wordpress, die crawlers-Zeilen, die beiden feed-Zeilen, die Pfade unter var/request-shield/, set stats off, SITE-DASH (restrict /rs/** to 127.0.0.1 ::1) und set api off.

Die eingebauten Regelsätze

SatzIDsGelesen
scannersSCAN-HIDDEN, SCAN-BACKUP, SCAN-TEST, SCAN-DBTOOL, SCAN-CGI, SCAN-CONFIG, SCAN-SECRETS, SCAN-KEYSimmer (unblock @scanners nimmt sie zurück)
devtoolsDEV-BUILD, DEV-APPCONFIG, DEV-DEBUG, DEV-APIDOCS, DEV-SOURCEimmer
crawlersCRAWL-GOOGLE, CRAWL-GPTBOT, ...immer: die bekannten Crawler und ihre Adresslisten
@wordpressWP-FOLDERS, WP-SCRIPTSinclude @wordpress: /wp-admin, /wp-login.php, xmlrpc.php ... 404
@trackingTRACK-UTM, TRACK-GOOGLE, TRACK-META, ...include @tracking: utm_*, gclid, fbclid ... sind bekannte Parameter
@attacksATK-SQL-*, ATK-XSS-*, ATK-LFI, ATK-JNDI, ...include @attacks: Angriffsmuster in Query und Headern, 403

Die expect-Zeile

expect <METHODE> <Adresse> <Ergebnis> [by <ID>] [from <Adresse>] [with pass] [times <n>] [ua "<User-Agent>"] [header <Name>:<Wert>]...
TeilBedeutung
<Adresse>ein Pfad mit Query, oder eine volle URL, wenn der Host zählt (https://admin.example.org/...), kodiert wie von einem Browser gesendet
passesbeantwortet, und ein Cache darf es behalten
uncachedbeantwortet, nie behalten
answeredeines von beiden: die Website antwortet (für knappe Fälle, die nicht abgewiesen werden dürfen)
checkdie Browserprüfung (Seite oder JSON)
json-checkdie Prüfung nur als JSON
403, 404, 405, 429 ...mit diesem Status abgewiesen
by <ID>die Regel, die entscheiden muss; ohne Angabe die letzte Regel mit ID über der Zeile in derselben Datei
from <Adresse>die Adresse des Besuchers; Vorgabe 198.51.100.7
with passder Besucher hat eine gelöste Prüfung
times <n>n-mal hintereinander gesendet; das Ergebnis ist das der letzten
ua "...", header Name:Wertein User-Agent, zusätzliche Header (mehrere erlaubt)

php extension/exp_request_shield/bin/request-shield test <main.rules> entscheidet jedes Beispiel mit einem frischen Speicher im Arbeitsspeicher: nichts wird gezählt, protokolliert oder gesendet. Als monitor markierte Regeln und set mode monitor werden wie durchgesetzt getestet, sodass die Beispiele vor dem Einschalten einer Regel geschrieben werden können (--as-written testet sie so, wie sie sind). --only=<ID> testet eine Regel; --junit=<Datei> schreibt einen Bericht für CI. Rückgabewert 0: alle bestanden; 1: eines schlägt fehl; 2: ein Fehler in den Dateien.

Die Logzeile

2026-11-15T10:32:48+00:00 198.51.100.0/24 challenge 429 "always" rule=EXP-LOGIN "GET https://www.example.org/user/login" "Mozilla/5.0 ..."
2026-11-15T10:34:33+00:00 203.0.113.0/24 reject 404 "blocked path" rule=EXP-MODULES "GET https://www.example.org/setup/info" "curl/8.5"
2026-11-15T10:35:02+00:00 198.51.100.0/24 allow-uncached 200 "challenge solved" "GET https://www.example.org/user/login" "Mozilla/5.0 ..."

Die Felder: Zeit, das Netz des Besuchers (oder die Adresse mit log-ip full), die Entscheidung, der Status, der Grund, dann wahlweise rule=, claimed= (ein Crawler-Name, der nicht bestätigt wurde), wait= (Sekunden einer Pause), ref= (die Referenz auf der Fehlerseite), die Anfrage mit voller Adresse und der User-Agent.

EntscheidungBedeutungGruppe auf der Übersicht
rejectabgewiesen (403, 404, 405, 414 ...)Abgewiesen
throttleeine Pause, 429 mit Retry-After (ein Budget über dem Limit, ein Bann)Abgewiesen
challengedie Browserprüfung wurde gesendet (429 ist der Status der Prüfseite; ein echter Browser löst sie selbst)Browserprüfung
allow-uncacheddurchgelassen, aber kein Cache darf es behalten (POSTs, unbekannte Parameter, eine gelöste Prüfung)Sonstige
monitor-...was eine beobachtete Regel oder der Beobachtungsmodus getan hätte; der Besucher kam durchBeobachtet (Monitor)

Die eigenen Anfragen der Installation

Seit exp_request_shield 0.0.1.5 tragen Anfragen, die die Installation an ihre eigenen Seiten schickt (Setup > Vorladen, die Adressprüfung nach einem Upgrade, statisches Veröffentlichen), eine Signatur und passieren den Shield, bevor er läuft:

  • Der Header ist X-Exp-Self: <Unix-Zeit>.<Signatur>, die Signatur ein HMAC-SHA256 über Zeit, Methode, Host (ohne Port) und Pfad mit Query, erstellt mit var/request-shield/cache/self.key (64 Hexadezimalzeichen, nur für den Benutzer der Website lesbar, bei der ersten Verwendung angelegt).
  • Sie gilt 120 Sekunden und nur für die Adresse und Methode, für die sie erstellt wurde. Die Anfragen aller anderen werden wie immer entschieden; der Schlüssel verlässt den Server nie.
  • PHP-Code der Installation erzeugt eine mit expRequestShield::selfHeader( $url, $method ), das die Headerzeile zurückgibt oder null (kein Schlüssel, oder eine Adresse ohne Host). Die Klasse braucht nichts vom Kernel. Siehe das Kochbuch.
  • Der Vorwärmer des Kernels (expPreloadRunner) und die Prüfung nach dem Upgrade senden ihn, sobald die Erweiterung installiert ist (Exponential 6.0.15 ab dem 14.11.2026).

Verwandte Seiten

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