13. Sicherheitshärtung für den Produktivbetrieb
Eine Standardinstallation von Exponential 6.0 ist so gebaut, dass sie ohne zusätzlichen Aufwand sicher ist: Die
Rewrite-Regeln liefern nur aufgelistete Dateien aus, Sicherheits-Header gehen mit jeder Seite hinaus, das
Sitzungs-Cookie ist HttpOnly und SameSite, die Debug-Ausgabe ist ausgeschaltet, Formulare tragen ein Token gegen
Cross-Site Request Forgery, und ein Audit-Protokoll hält fest, wer was getan hat. Dieses Kapitel geht jede dieser
Schichten durch, nennt die Einstellung, die sie steuert, und wie Sie sie prüfen, und listet auf, was ein Administrator
noch entscheiden sollte, bevor eine Site live geht: Geheimnisse in settings/override, der Administrations-Siteaccess,
Passwortregeln, Cookies nur über HTTPS, Dateiberechtigungen, Einwilligungen für Mails und das Aktuellhalten der
Installation. Es ist als Checkliste geschrieben, die Sie von oben nach unten abarbeiten können; eine einseitige
Zusammenfassung steht am Ende.
Warnung
.htaccessbremst jede Anfrage. Sind.htaccess-Dateien erlaubt (AllowOverridealles außerNone), geschweige denn genutzt, sucht Apache sie bei jeder Anfrage in jedem Verzeichnis des Pfads und liest und wertet sie aus, und die Ladezeiten der Seiten steigen drastisch (gemessen). Die einzige wirkliche Abhilfe ist, die Funktion für den virtuellen Host abzuschalten:AllowOverride Noneim virtuellen HTTPS-Host, und die Regeln in der Konfiguration des virtuellen Hosts selbst als mod_rewrite-Regeln. Das ist in Geschwindigkeitstests im Produktivbetrieb weit schneller und die Zeit für die Optimierung einer Produktivkonfiguration unbedingt wert. Stellen Sie sofort um: Übernehmen Sie die Regeln des Beispiels für einen virtuellen HTTPS-Host in Ihren virtuellen Host (mit dem statischen Cache auchstaticcache_offload.conf), setzen SieAllowOverride None, führen Sieapachectl configtestaus, laden Sie Apache neu und testen Sie die Website. Dieselben Regeln für andere Server: nginx, LiteSpeed, Caddy, IIS, Velocity (eingebaut); wohin Regeln für virtuelle Hosts in einem Control Panel gehören: Plesk, cPanel, DirectAdmin, ISPConfig. Unter LiteSpeed oder OpenLiteSpeed kann zusätzlich der Seiten-Cache des Servers anonyme Besucher und Crawler ohne PHP bedienen: Seiten-Caching mit LiteSpeed und OpenLiteSpeed.
Für die Sicht des Angreifers, Bedrohung für Bedrohung, mit dem vorgeschalteten Request Shield (seit 6.0.15 Teil der Standardinstallation) und dem, was Sie beobachten sollten, lesen Sie Sicherheitshärtung in der Hilfe; für das Administratorkonto Das Administratorpasswort ändern und Das Standard-Administratorpasswort.
Inhalt · Zurück: 12. Fehlerbehebung · Weiter: 14. Migration von der 4.x-Linie
Inhalt dieses Kapitels
- Die Schichten im Überblick
- Was der Webserver niemals ausliefern darf
- Geheimnisse in settings/override
- Debug-Ausgabe und Fehleranzeige
- Der Administrations-Siteaccess
- Passwörter und Anmeldung
- Sitzungen und Cookies
- Formular-Tokens gegen Cross-Site Request Forgery
- Sicherheits-Header und HTTPS
- Hinter einem Proxy: vertrauenswürdige Header
- Dateiberechtigungen und Eigentümer
- Velocity-spezifische Härtung
- Mail: Einwilligung und Sperrliste
- Das Audit-Protokoll
- Auf dem neuesten Stand bleiben
- Checkliste für den Livegang
- Referenzen
Einstellungen werden in Overrides geändert, niemals in den mitgelieferten Dateien:
settings/override/<file>.ini.append.php für die gesamte Installation,
settings/siteaccess/<siteaccess>/<file>.ini.append.php für einen Siteaccess. Leeren Sie nach einer Änderung den
INI-Cache (php bin/php/ezcache.php --clear-tag=ini), und starten Sie unter Velocity den Server neu oder führen Sie
exp:velocity deploy aus (Kapitel 8).
13.1 Die Schichten im Überblick
visitor
|
[ TLS, HSTS ] Velocity [HTTPSSettings] / Apache mod_ssl / nginx ssl 13.9
|
[ what may be served as a file ] .htaccess_root / Velocity's list / derived nginx block 13.2
|
[ request shield ] exp_request_shield: config.php hook, request-shield.rules 13.1
|
[ security headers ] site.ini [HTTPHeaderSettings] SecurityHeaders[], 13.9
| velocity.ini ResponseHeaders[]
[ request rules, siteaccess login ] requestrules.ini, [SiteAccessSettings] RequireUserLogin 13.5
|
[ session cookie, form token ] site.ini [Session], ezformtoken 13.7, 13.8
|
[ roles and policies ] Roles and policies in the administration 13.5
|
[ audit ] audit.ini, exp:audit 13.14
|
files on disk: owner, group, modes [FileSettings] *Permissions, chown/chmod 13.11| Schicht | Standard | Was Sie entscheiden |
|---|---|---|
| Rewrite-Regeln | strikte Liste, PHP unterhalb des Wurzelverzeichnisses abgelehnt | beibehalten; neue Regeln nach Upgrades übernehmen |
| Geheimnisse | in settings/override erzeugt | Dateimodi, Backups, niemals in der Versionsverwaltung |
| Debug-Ausgabe | aus | ausgeschaltet lassen oder nach IP beschränken |
| Admin-Siteaccess | Anmeldung erforderlich | eigener Hostname, Netzwerkbeschränkung, Request-Regeln |
| Passwörter | 10 Zeichen, bcrypt | Zeichenregeln, Sperre nach fehlgeschlagenen Anmeldungen |
| Sitzungs-Cookie | HttpOnly, SameSite=Lax, Secure über HTTPS | CookieSecure=true auf einer reinen HTTPS-Site |
| Formular-Tokens | aktiv (Setup-Assistent) | ezformtoken aktiv lassen; eigenes AJAX anpassen |
| Weitergeleitete Header | nur von 127.0.0.1 und ::1 geglaubt | Ihre Proxys in TrustedProxies[] eintragen, und nichts weiter |
| Sicherheits-Header | fünf Header auf jeder Seite | HSTS, sobald nur noch HTTPS; frame-ancestors für Redakteure |
| Audit | an | Cron, Empfänger von Warnmeldungen, Schlüssel-Backup |
| Request Shield | durchsetzend (seit 6.0.15, Hook-Zeile in config.php-RECOMMENDED) | die Regeln der Website in settings/request-shield/; nach einem Upgrade die Hook-Zeile ergänzen |
Der Request Shield ist die Erweiterung exp_request_shield, seit 6.0.15 Teil der Standardinstallation. Sie bringt
request-shield (CJW Network, MIT-Lizenz) mit und führt es über eine Hook-Zeile in config.php aus, vor dem Kernel und
vor dem frühen Ausstieg des HTTP-Caches, unter PHP-FPM und Velocity gleichermaßen. Eine neue Installation erhält die
Zeile aus config.php-RECOMMENDED; eine aktualisierte trägt sie selbst ein, da config.php nie überschrieben wird.
Setup > Request Shield zeigt, was er entscheidet; var/request-shield/PAUSED schaltet ihn sofort aus. Siehe
Request Shield und die Anleitung.
13.2 Was der Webserver niemals ausliefern darf
Das Document Root von Exponential ist das Installationsverzeichnis, daher liegen settings/, var/, vendor/, die
Kernel-Quellen und die SQLite-Datenbank darin. Die Sicherheit kommt aus dem Routing, nicht aus der
Verzeichnisstruktur: Nur eine feste Liste von Asset-Pfaden wird als Datei ausgeliefert; alles andere wird an
index.php übergeben. Die Liste ist .htaccess_root, und die drei Engines von Velocity setzen dieselbe Liste um
(Kapitel 8, Abschnitt 8.2).
Was die mitgelieferten Regeln garantieren (.htaccess_root und
doc/eng-us/specifications/6.0/security-defaults-2026-09.md, Abschnitt 4):
| Anfrage | Antwort | Regel |
|---|---|---|
eine Punktdatei oder ein Punktverzeichnis an beliebiger Stelle: /.git/config, /.env, /extension/x/.htaccess | 404 | RewriteRule (^|/)\.(?!well-known(/|$)) - [R=404,L] |
/.well-known/... | erreichbar (ACME-Challenges) | die Ausnahme derselben Regel |
eine vorhandene .php-, .phtml- oder .phar-Datei unterhalb des Wurzelverzeichnisses: /extension/x/foo.php, /var/storage/packages/.../x.php | 404 | RewriteRule ^.+/[^/]+\.(php[0-9]?|phtml|phar)$ - [R=404,L] |
/settings/site.ini, /var/site/storage/original/application/x.pdf, /composer.json | von index.php behandelt (eine Seite oder 404), niemals die Datei | nicht auf der Liste |
Paketspeicher var/storage/packages/ | nur Vorschaubilder (png, jpg, gif, webp; kein SVG, das Skripte enthalten kann) | ^var/storage/packages/.+\.(png|jpe?g|gif|webp)$ |
| gespeicherte Originale | nur Bilddateien unterhalb von storage/original/image; andere Uploads nur über content/download, das die Berechtigungen prüft | ^var/([^/]+/)?storage/original/image/.+\.(png|jpe?g|gif|webp|svg)$ |
Was Sie tun:
- Apache:
./console exp:setup:htaccess --apply(odercp .htaccess_root .htaccess) und die Sicherheitsregeln darin belassen. Löschen Sie keine Regeln, damit etwas funktioniert; suchen Sie stattdessen die Ursache. Wenn Sie eine eigene.htaccessoder eigene Virtual-Host-Regeln pflegen, vergleichen Sie sie nach jedem Upgrade mit.htaccess_rootund übernehmen Sie neue Regeln:./console exp:setup:htaccesszeigt den Diff zwischen Ihrer.htaccessund der Vorlage und endet mit 1, wenn sie abweichen, sodass eine Überwachung oder die CI eine Abweichung bemerkt (.htaccess und config.php von der Konsole aus einrichten). - nginx: Verwenden Sie den abgeleiteten Server-Block aus Kapitel 8, Abschnitt 8.6 oder eine gleichwertige Konfiguration, die die ersten beiden Regeln (Punktdateien, Skripte unterhalb des Wurzelverzeichnisses) vor jede statische Location stellt.
- Velocity: Nichts zu tun;
FollowSymlinks=disabled(der Standard) verweigert auch Dateien, die über einen symbolischen Link erreicht werden, der aus dem Document Root hinausführt. - Liefern Sie die Installation niemals mit einer generischen Konfiguration aus, etwa dem nginx-Muster „Datei
ausliefern, wenn sie existiert, sonst
index.php“ oder Caddysphp_server: Diese liefern jede vorhandene Datei aus, einschließlichsettings/*.iniund der SQLite-Datenbank.
Prüfen Sie von außen:
for p in /.git/config /.env /settings/site.ini /composer.json /kernel/classes/ezini.php /var/log/error.log; do
printf '%-32s %s\n' "$p" "$(curl -s -o /dev/null -w '%{http_code}' https://example.com$p)"
doneJede Zeile muss 404 zeigen (oder 200 mit einer Seite von Exponential, niemals den Inhalt der Datei). Sehen Sie sich
beim .ini-Pfad einmal den Body an: Er muss eine HTML-Seite sein, kein INI-Text.
13.3 Geheimnisse in settings/override
Mehrere Dateien in settings/override/ enthalten Geheimnisse. Sie werden vom Installer geschrieben oder bei der
ersten Verwendung erzeugt:
| Datei | Geheimnis | Folge bei Verlust oder Offenlegung |
|---|---|---|
site.ini.append.php | Datenbankbenutzer und -passwort ([DatabaseSettings]) | Zugriff auf die Datenbank |
audit.ini.append.php | Audit-Signaturschlüssel und Pseudonymschlüssel | mit dem Schlüssel signierte Archive lassen sich nicht mehr verifizieren; Pseudonyme lassen sich umkehren |
mailpreferences.ini.append.php | das Site-Geheimnis ([SecretSettings] TokenSecret, bei der ersten Verwendung erzeugt) | jeder Abmelde- und Präferenzlink funktioniert nicht mehr, kein Eintrag der Sperrliste greift mehr, und jeder angemeldete Benutzer wird einmal abgemeldet, weil der Passwortstempel der Sitzungen (Abschnitt 13.6) mit ihm als Schlüssel gebildet wird |
velocity.ini.append.php | [DashboardSettings] Token, falls gesetzt | Fernzugriff auf die Kennzahlen des Servers und /Q/phpinfo |
config.env.php im Wurzelverzeichnis | Maschineneinstellungen wie der Name der Umgebung | (von Git ignoriert) |
var/log/initial-admin-password | das erzeugte erste Administratorpasswort einer Kickstart- oder Konsoleninstallation | das Administratorkonto |
Was Sie tun:
- Ändern Sie das erzeugte Administratorpasswort und löschen Sie danach
var/log/initial-admin-password; der Konsolen-Installer weist darauf hin, wenn er das Passwort ausgibt. - Übernehmen Sie
settings/override/niemals in die Versionsverwaltung und kopieren Sie es nie an einen öffentlichen Ort. Machen Sie die Dateien nur für den Benutzer der Site lesbar, wo nichts anderes sie braucht (chmod 640, Eigentümer der Benutzer der Site oder root, Gruppe die Gruppe der Site). - Sichern Sie sie, als Geheimnisse, zusammen mit der Datenbank: Ohne die Audit- und Mailpräferenz-Dateien funktionieren alte Archive und Links nicht mehr.
- Kopieren Sie sie bei jedem Umzug der Installation auf einen anderen Rechner mit. Eine Kopie, die ohne
mailpreferences.ini.append.phpgestartet wird, erzeugt bei ihrer ersten Mail oder Anmeldung ein neues Site-Geheimnis, und von da an passen die alten Links und Einträge der Sperrliste nicht mehr; die Datei nachträglich hineinzukopieren hilft für das, was in der Zwischenzeit verschickt wurde, nicht. - Die Administration und
exp:inimaskieren geheime Werte, wenn sie Einstellungen anzeigen; geben Siesetup/setup(Einstellungsansichten) trotzdem nur Administratoren.
13.4 Debug-Ausgabe und Fehleranzeige
Die Debug-Ausgabe zeigt SQL, Template-Namen, Dateipfade und Zeitmessungen: nützlich in der Entwicklung, ein Geschenk für einen Angreifer im Produktivbetrieb.
settings/site.ini [DebugSettings] im Auslieferungszustand:
[DebugSettings]
DebugOutput=disabled # master switch: no debug report on pages
AlwaysLog[]=error # errors are still written to var/<site>/log/error.log
ScriptDebugOutput=disabled # command-line scripts
DebugByIP=disabled # when enabled: only the addresses in DebugIPList[] get debug
DebugIPList[]
DebugByUser=disabled # when enabled: only the users in DebugUserIDList[]
DebugRedirection=disabled
DisplayDebugWarnings=disabledsowie [TemplateSettings] Debug=disabled (keine Template-Namen im HTML).
Behalten Sie im Produktivbetrieb DebugOutput=disabled bei. Wenn Sie sich ein Problem auf der Live-Site ansehen
müssen, beschränken Sie das Debugging auf Ihre eigene Adresse und entfernen Sie den Eintrag danach wieder:
# settings/override/site.ini.append.php
[DebugSettings]
DebugOutput=enabled
DebugByIP=enabled
DebugIPList[]
DebugIPList[]=203.0.113.10
DebugIPList[]=2001:db8::/48Einträge können einzelne Adressen oder CIDR-Bereiche beider Adressfamilien sein; eine einfache IPv6-Adresse bedeutet
genau diese Adresse (siehe die Debug-Leiste, wo auch Bezeichnungen und Ablaufdaten von
Einträgen dokumentiert sind). Der Reiter Einstellungen der Debug-Leiste kann diese Werte ändern; er benötigt die
Richtlinie setup/setup.
DebugByIP vertraut der Adresse, die Exponential für den Besucher ermittelt. Seit 6.0.15 stammt diese Adresse nur
dann aus einem weitergeleiteten Header, wenn die Verbindung von einem Proxy in TrustedProxies[] kommt, und der
Header wird von rechts gelesen, sodass ein Besucher keine Adresse Ihrer Liste mehr vor den Eintrag des Proxys setzen
kann (Abschnitt 13.10). Zwei Dinge hebeln den Schutz dennoch aus: ein TrustedProxies[]-Bereich, der weiter gefasst
ist als Ihre Proxys (ein ganzes Providernetz, 0.0.0.0/0), und ein Anwendungsserver, der am Proxy vorbei erreichbar
ist. Halten Sie beides eng, und denken Sie daran, dass hinter einem Proxy, dessen REMOTE_ADDR der Proxy selbst ist,
ein Listeneintrag für die Adresse des Proxys allen die Debug-Ausgabe zeigen würde.
PHP selbst: Setzen Sie in der php.ini von PHP-FPM display_errors=Off, log_errors=On und expose_php=Off.
FrankenPHP liest keine php.ini des Rechners; Velocity liefert dafür display_errors=Off und log_errors=On in
[FrankenPHPSettings] IniOptions[] mit. Die Engine qbix führt Kommandozeilen-PHP mit der CLI-php.ini des Rechners
plus [PHPSettings] IniOptions[] aus; fügen Sie dort dasselbe hinzu, falls Ihre CLI-php.ini Fehler anzeigt:
# settings/override/velocity.ini.append.php
[PHPSettings]
IniOptions[]=display_errors=Off
IniOptions[]=log_errors=On(Ohne eine leere Zeile IniOptions[] davor werden diese an die mitgelieferte Liste angehängt.) Die eigenen
Fehlerseiten der Engine zeigen Datei, Zeile und Stacktrace eines nicht abgefangenen Fehlers nur mit ihrer Option
debug, die standardmäßig ausgeschaltet ist.
13.5 Der Administrations-Siteaccess
Die Administration ist ein eigener Siteaccess (meist admin oder der bei der Installation gewählte Name). Der
Installer schreibt [SiteAccessSettings] RequireUserLogin=true in dessen site.ini.append.php, sodass jede seiner
Seiten eine Anmeldung verlangt, und der Zugriff auf jede Funktion wird durch das Rollensystem entschieden
(setup/*, content/*, audit/* und so weiter).
Härtung darüber hinaus, von der stärksten zur einfachsten:
Geben Sie ihr einen eigenen Hostnamen (zum Beispiel
admin.example.com, zugeordnet über[SiteAccessSettings] HostMatchType) statt eines Pfads unterhalb der öffentlichen Site, damit sie als Einheit beschränkt werden kann.Beschränken Sie das Netzwerk. Mit Apache, auf dem Virtual Host der Administration:
<Location /> Require ip 203.0.113.0/24 2001:db8::/48 </Location>oder eine vorgeschaltete HTTP-Basic-Authentifizierung (
AuthType Basicmitmod_auth_basic). Mit nginx:allowunddeny. Velocity hat keine eigene HTTP-Authentifizierung; beschränken Sie den Administrations-Host mit der Firewall, einem VPN oder einem vorgeschalteten Reverse Proxy, oder betreiben Sie ihn auf einer separaten Velocity-Instanz, die an eine interne Adresse gebunden ist.Request-Regeln (
settings/requestrules.ini) entscheiden, bevor eine Modulansicht läuft: anonyme Besucher von System-URLs wie/content/view/full/123fernhalten, für eine Sektion eine Anmeldung verlangen, Anfragen aus einem Netzwerk ablehnen. Sie sind an Rollenrichtlinien gebunden, sodass Ausnahmen im Rolleneditor festgelegt werden. Siehe Request-Regeln.Minimale Rechte. Geben Sie Redakteuren die Rollen, die sie brauchen, nicht Administrator. Richtlinien, die für die Sicherheit wichtig sind:
setup/setup(Einstellungen),setup/managecache,audit/readundaudit/manage,mailpreferences/administrateundmailpreferences/export,contentfinder/searchundcontentfinder/delete(der Content Finder: Inhalte nach ID oder Pfad finden und von dort in den Papierkorb verschieben oder löschen),user/loginje Siteaccess.Der Setup-Assistent muss geschlossen bleiben. Nach der Installation enthält
settings/override/site.ini.append.phpden Eintrag[SiteAccessSettings] CheckValidity=false. Solange ertrueist (der mitgelieferte Standard), wird jede Anfrage an den Setup-Assistenten geschickt. Setzen Sie ihn auf einer Live-Site niemals zurück.
13.6 Passwörter und Anmeldung
Längen- und Zeichenregeln
settings/site.ini:
[UserSettings]
MinPasswordLength=10 # bytes; 3 when the setting is missing
GeneratePasswordLength=16
WeakPasswordCheck=enabled # refuse well-known and common passwords (since 6.0.15)
WeakPasswordFile= # more words, one per line; or WeakPasswordList[]=...
ForgotPasswordKeyLifetime=3600 # seconds a "Forgot your password?" link works; 0: until used
HashType=php_default # bcrypt today; never plaintext or the md5_* types
UpdateHash=true # re-hash older hashes at the next sign-in
[PasswordSettings] # every rule off by default
RequireLowercase=disabled
RequireUppercase=disabled
RequireDigit=disabled
RequireSymbol=disabled
MinCharacterClasses=0 # at least this many of the four kinds above
ForbidLogin=disabled # must not contain the login name
ForbidCurrentPassword=disabled
EndOtherSessions=enabled # after a change, sign the user's other sessions out
ChangeNotificationMail=enabled
StrengthMeter=enabled
GenerateButton=enabledEine vernünftige Richtlinie für den Produktivbetrieb, im Einklang mit aktuellen Empfehlungen, die Länge gegenüber Zusammensetzungsregeln bevorzugen:
# settings/override/site.ini.append.php
[UserSettings]
MinPasswordLength=15
[PasswordSettings]
ForbidLogin=enabled
ForbidCurrentPassword=enabledWarum diese Werte: NIST SP 800-63B-4 (2025) verlangt mindestens 15 Zeichen, wo ein Passwort der einzige Faktor ist,
und sagt, dass prüfende Systeme keine Zusammensetzungsregeln vorschreiben sollten, weil Regeln wie „eine Ziffer, ein
Sonderzeichen“ zu vorhersehbaren Passwörtern (Summer2026!) statt zu starken führen; die Stärkeanzeige und die
Schaltfläche „Erzeugen“ (GeneratePasswordLength=16) helfen Benutzern stattdessen, die Länge zu erreichen. Die
Regeln Require* und MinCharacterClasses gibt es für Organisationen, deren eigene Richtlinie sie vorschreibt.
MinPasswordLength zählt Bytes, sodass ein Passwort in einer Schrift mit Mehrbyte-Zeichen sie mit weniger Zeichen
erreicht. Das Anheben des Minimums sperrt niemanden aus: Bestehende Passwörter funktionieren weiter, und die Regel
greift, wenn ein Passwort das nächste Mal gesetzt wird. Dasselbe gilt für die Prüfung auf bekannte Passwörter
(WeakPasswordCheck), die derselben Empfehlung folgt: Prüfende Systeme sollten neue Passwörter mit einer Liste häufig
verwendeter und kompromittierter Werte vergleichen. Ergänzen Sie die eigenen Begriffe Ihrer Organisation mit
WeakPasswordList[] oder WeakPasswordFile.
Die Regeln gelten für jedes Formular, das ein Passwort setzt (user/password, die Registrierung, das Benutzerkonto in
content/edit und in der Administration, bin/php/resetuserpassword.php), geprüft von expPasswordPolicy
(kernel/classes/exppasswordpolicy.php).
EndOtherSessions=enabled ist das, was eine Passwortänderung nach der Übernahme eines Kontos wirksam macht. So
funktioniert es:
- Bei jeder Anmeldung erhält die Sitzung einen Passwortstempel (
eZUserPasswordStamp): einen schlüsselbasierten Hash (HMAC-SHA256) aus der Benutzer-ID und dem gespeicherten Passwort-Hash, gebildet mit einem Schlüssel, der aus dem Site-Geheimnis aus Abschnitt 13.3 abgeleitet ist. Er enthält weder das Passwort noch dessen Hash. - Bei jeder Anfrage vergleicht
eZUser::currentUser()den Stempel der Sitzung mit dem Stempel des aktuellen Hashs des Benutzers. Eine Passwortänderung ändert den Hash, sodass jede andere Sitzung dieses Benutzers (andere Browser, andere Geräte, eine von einem Angreifer kopierte Sitzung) nicht mehr passt und bei ihrer nächsten Anfrage abgemeldet wird. Das funktioniert mit jedem Session-Handler, PHPs eigene Datei-Sitzungen eingeschlossen, weil es geprüft wird, wenn die Sitzung verwendet wird. - Die Sitzung, in der das Passwort geändert wurde, bleibt angemeldet, erhält aber eine neue Sitzungs-ID, sodass jemand, der die alte ID kannte, sie nicht behält. Mit dem Datenbank-Session-Handler werden die anderen Sitzungen außerdem sofort gelöscht.
- Nicht geprüft: Sitzungen, die vor dem Upgrade auf 6.0.15 begonnen haben (sie tragen noch keinen Stempel; sie werden ab ihrer nächsten Anmeldung geprüft), und Konten ohne eigenes Passwort (LDAP-, Textdatei- und Single-Sign-on-Benutzer).
- Was Sie überraschen kann: Ein neues Site-Geheimnis (eine Kopie der Installation ohne
settings/override/mailpreferences.ini.append.php) ändert jeden Stempel, sodass alle einmal abgemeldet werden.EndOtherSessions=disabledschaltet den Stempel und die Prüfung zusammen ab.
Lassen Sie es eingeschaltet. Einzelheiten: Das eigene Passwort ändern; jeder Weg, ein Administratorpasswort zu ändern oder zurückzusetzen, und was zu tun ist, wenn sich niemand anmelden kann: Das Administratorpasswort ändern.
ChangeNotificationMail=enabled schickt dem Konto die Mail „Ihr Passwort wurde geändert“ (Kategorie
„Kontosicherheit“, die niemand abschalten kann; die Mail enthält nie das Passwort). So erfährt ein Benutzer von einer
Änderung, die er nicht selbst vorgenommen hat.
Der Demo-Modus muss ausgeschaltet sein
Die Umgebungsvariable EXP_DEMO_MODE=1 kennzeichnet eine Installation als öffentliche Demo (seit 6.0.15):
Administratorpasswörter können nicht mehr geändert oder zurückgesetzt werden, und die Installer akzeptieren ein
allgemein bekanntes Administratorpasswort. Auf einer Produktiv-Site ist das ein bekanntes Administratorpasswort, das
niemand ändern kann, deshalb:
- Stellen Sie sicher, dass kein Prozess der Site sie gesetzt hat:
grep -r EXP_DEMO_MODEüber die PHP-FPM-Pools, die Virtual Hosts, die Service-Units (die von Velocity eingeschlossen), die Crontabs und die Container-Definitionen darf nichts finden. - Die Administration zeigt, solange er aktiv ist, auf jeder Seite ein Banner Demo-Modus, und jeder Prozess, der
damit startet, schreibt eine Zeile
demo/modeinvar/log/security.logund das Audit-Ereignissystem.demo.mode. Lösen Sie bei beidem eine Warnung aus. - Er kann nicht aus Einstellungen kommen: Es gibt weder eine INI-Einstellung noch einen Anfrageparameter dafür, und
nur der exakte Wert
1zählt. Einzelheiten und Risiken: Demo-Modus.
Fehlgeschlagene Anmeldungen
[UserSettings]
MaxNumberOfFailedLogin=0 # 0: no lockout
TrustedIPList[] # addresses never locked out
ShowMessageIfExceeded=falseSetzen Sie MaxNumberOfFailedLogin (zum Beispiel auf 10), um ein Konto nach so vielen fehlgeschlagenen Versuchen zu
sperren, bis ein Administrator es entsperrt. Wägen Sie das ab: Eine Sperre erlaubt es auch jedem, ein bekanntes Konto
zu sperren. Die Warnregeln des Audits brute_force (20 Fehlschläge aus einem Netz in 5 Minuten) und
brute_force_user (10 für ein Konto in 15 Minuten) melden solche Angriffe in jedem Fall (Abschnitt 13.14).
Die Anmeldung selbst verrät nicht, welche Konten existieren: Ein unbekannter Name kostet dieselbe Hash-Berechnung wie ein falsches Passwort, und „Passwort vergessen?“ gibt für eine unbekannte Adresse dieselbe Antwort wie für eine bekannte.
13.7 Sitzungen und Cookies
settings/site.ini [Session]; die drei Cookie-Schlüssel sind in der mitgelieferten Datei auskommentiert, und ihre
Standardwerte gelten, solange sie nicht gesetzt sind. SessionTimeout und RememberMeTimeout setzt die
mitgelieferte Datei:
| Schlüssel | Standard | Bedeutung |
|---|---|---|
CookieSecure | auto | Secure, sobald die Anfrage selbst über HTTPS kam; true erzwingt es |
CookieHttponly | true | Skripte können das Sitzungs-Cookie nicht lesen |
CookieSameSite | Lax | Lax, Strict, None (nur mit Secure) oder leer |
SessionTimeout | 31104000 | Sekunden, die eine Sitzung nach ihrer letzten Nutzung dauert (360 Tage; bis Oktober 2026 259200, drei Tage) |
RememberMeTimeout | 31104000 | Sekunden, die das Sitzungs-Cookie hält, wenn Angemeldet bleiben angehakt ist (360 Tage); das Kästchen ist auf den Anmeldeformularen vorausgewählt. Leer oder 0 schaltet „Angemeldet bleiben“ ab, und das Cookie endet dann mit dem Browser |
SessionNameHandler, SessionNamePerSiteAccess | default, enabled | custom gibt jedem Siteaccess sein eigenes Sitzungs-Cookie, sodass eine Anmeldung auf der öffentlichen Site keine Anmeldung in der Administration ist |
Für eine Site, die nur über HTTPS ausgeliefert wird:
# settings/override/site.ini.append.php
[Session]
CookieSecure=true
CookieHttponly=true
CookieSameSite=Lax
SessionTimeout=28800
RememberMeTimeout=28800CookieSecure=true stellt sicher, dass das Cookie nie über einfaches HTTP gesendet wird, auch nicht bei einer
Anfrage, die fälschlicherweise ohne TLS ankommt. Verwenden Sie Strict nur, wenn keine andere Site auf Seiten
verlinkt, die eine Anmeldung voraussetzen. Ein kürzerer SessionTimeout begrenzt, wie lange eine gestohlene Sitzung
brauchbar bleibt. Verkürzen Sie RememberMeTimeout mit ihm (oder lassen Sie es leer, um „Angemeldet bleiben“
abzuschalten): Die mitgelieferte Datei verlangt, SessionTimeout mindestens so lang wie RememberMeTimeout zu
halten, weil ein gemerktes Cookie keine Sitzung zurückbringt, die der Server schon entfernt hat.
Getrennte Sitzungs-Cookies je Siteaccess:
[Session]
SessionNameHandler=custom
SessionNamePrefix=eZSESSID
SessionNamePerSiteAccess=enabledMit custom leitet der Antwort-Cache von Velocity sein Cookie „persönlich, nicht cachen“ automatisch aus
SessionNamePrefix ab.
In der eigenen Konfiguration von PHP sorgt session.use_strict_mode=1 dafür, dass PHP Sitzungs-IDs ablehnt, die es
nicht selbst erzeugt hat.
Was schiefgehen kann:
- Angemeldete Benutzer werden auf jeder Seite abgemeldet oder können sich gar nicht anmelden, hinter einem
HTTPS-Proxy mit
CookieSecure=true, wenn der Kernel die Anfrage für einfaches HTTP hält undhttp://-Weiterleitungen erzeugt: Dem Proxy wird nicht vertraut, oder er sendet keinX-Forwarded-Proto(Abschnitt 13.10). MitCookieSecure=autoführt derselbe Fehler stattdessen zu einem Cookie ohneSecure, was unauffälliger und schlimmer ist. CookieSameSite=NoneohneSecurewird von Browsern abgelehnt; der Kernel berücksichtigtNonenur zusammen mitSecure. Sie brauchenNonenur, wenn die Site innerhalb eines Frames oder über ein Cross-Site-Formular auf einer anderen Domain verwendet wird.Strictverwirft die Sitzung beim ersten Klick aus einer E-Mail oder von einer anderen Site auf eine Seite, die eine Anmeldung voraussetzt, was Benutzer als Abmeldung wahrnehmen.
13.8 Formular-Tokens gegen Cross-Site Request Forgery
Die Extension ezformtoken fügt jedem HTML-Formular ein Token je Sitzung hinzu und prüft es bei jedem POST
(extension/ezformtoken, Event-Listener request/input, response/output und session/regenerate). Ein gefälschtes
Formular auf einer anderen Site kann das Token nicht kennen. Der Setup-Assistent aktiviert sie bei jeder neuen
Installation.
- Behalten Sie sie in
[ExtensionSettings] ActiveExtensions[]. Prüfen Sie:php bin/php/console exp:ini where site.ini/ExtensionSettings/ActiveExtensions(jede Datei, die den Wert setzt, und der wirksame Wert) oder Setup > Extensions. - Eigener AJAX-Code, der POST-Anfragen sendet, muss das Token ebenfalls senden; die Skripte des Kernels und
ezjscore tun das. Die
README.rstder Extension zeigt, wie. - Ein abgelehntes Token wird mit 403 und der Seite „Formular abgelaufen“ beantwortet, und es wird kein Token ins Log geschrieben (Seite „Formular abgelaufen“).
- Eine Seite, die ein Token trägt, wird mit
Cache-Control: privategesendet, sodass kein gemeinsam genutzter Cache eine angemeldete Seite mit ihrem Token speichert. Ein Reverse Proxy darf das nicht überschreiben (Abschnitt 13.10).
13.9 Sicherheits-Header und HTTPS
Header auf jeder Seite
settings/site.ini [HTTPHeaderSettings]:
| Header | Standard |
|---|---|
X-Content-Type-Options | nosniff |
X-Frame-Options | SAMEORIGIN |
Content-Security-Policy | frame-ancestors 'self' |
Referrer-Policy | strict-origin-when-cross-origin |
Permissions-Policy | camera=(), microphone=(), payment=(), usb=() |
Strict-Transport-Security | leer (aus; wird ohnehin nur über HTTPS gesendet) |
Ein leerer Wert in einem Override lässt einen Header weg; Header-Namen und -Werte, die die Antwort aufspalten könnten, werden ignoriert. Um einem vertrauenswürdigen Redaktions-Host zu erlauben, die Administration in einen Frame einzubetten:
[HTTPHeaderSettings]
SecurityHeaders[Content-Security-Policy]=frame-ancestors 'self' https://edit.example.comSeiten, die aus dem HTTP-Cache des Kernels beantwortet werden, tragen dieselben Header.
Velocity sendet vier davon (alle außer der Content Security Policy) bei dem, was er selbst beantwortet (statische
Dateien, skalierte Bilder, seine eigenen Fehlerseiten, Weiterleitungen, 304-Antworten), über
[ServerSettings] ResponseHeaders[] und ergänzt sie bei Skriptantworten, denen sie fehlen
(ResponseHeadersOnScripts=enabled). Apache und nginx senden von sich aus bei statischen Dateien nichts
zusätzlich; fügen Sie sie dort hinzu, wenn Sie sie haben möchten (Apache mod_headers:
Header always set X-Content-Type-Options "nosniff"; nginx: add_header X-Content-Type-Options "nosniff" always;).
Eine vollständige Content Security Policy (script-src, style-src) wird aus site.ini [ContentSecurityPolicy]
gesendet: standardmäßig nur als Bericht (report-only) in der Administration, ausgeschaltet auf den Sites, deren
Designs und Extensions Inline-Skripte verwenden können. Beobachten Sie die Berichte (Browserkonsole, ReportURI),
bevor Sie sie durchsetzen, siehe Content Security Policy.
Überall HTTPS
Liefern Sie jeden Namen der Site über HTTPS aus: Velocity
[HTTPSSettings]oder die ACME-Unterstützung der Engine, Apachemod_ssl, nginxssl(Kapitel 8).Leiten Sie einfaches HTTP auf HTTPS um (Apache und nginx: Abschnitte 8.5 und 8.6). Für einzelne Teilbäume hat Exponential eigene
[SSLZoneSettings].Setzen Sie
[Session] CookieSecure=true(Abschnitt 13.7).Schalten Sie HSTS ein, beginnen Sie mit einer kurzen Dauer und erhöhen Sie sie, sobald alles funktioniert:
- Velocity:
[HTTPSSettings] HSTSMaxAge(300 im Auslieferungszustand),HSTSIncludeSubDomains,HSTSPreload; - Apache oder nginx:
SecurityHeaders[Strict-Transport-Security]=max-age=31536000insite.ini, vom Kernel nur über HTTPS gesendet.
Ein Browser merkt sich HSTS für den gesamten Zeitraum und verweigert einfaches HTTP zu diesem Host, selbst wenn Sie den Wert danach senken. Erhöhen Sie ihn erst auf ein Jahr, wenn jeder Name dauerhaft über HTTPS ausgeliefert wird.
- Velocity:
Halten Sie Zertifikate erneuert und überwacht (
exp:velocity ssl show --json,daysLeft; oder den Timer Ihres ACME-Clients).
Prüfen Sie:
curl -sI https://example.com/ | grep -i -E 'strict-transport|x-content-type|x-frame|referrer|permissions|content-security'
curl -sI https://example.com/user/login | grep -i set-cookie # Secure; HttpOnly; SameSite=Lax13.10 Hinter einem Proxy: vertrauenswürdige Header
Ein Proxy, Load Balancer oder CDN vor der Site teilt der Anwendung in Anfrage-Headern mit, was der Besucher angefragt
hat: X-Forwarded-Proto (war es HTTPS?), X-Forwarded-Host (welcher Name?) und X-Forwarded-For (von welcher
Adresse?). Das Problem ist, dass dies gewöhnliche Anfrage-Header sind: Jeder Besucher kann sie ebenfalls senden.
Blind geglaubt, erlauben sie einem Besucher, eine einfache HTTP-Anfrage wie HTTPS aussehen zu lassen, einen anderen
Hostnamen in jede absolute URL zu setzen, die die Site erzeugt, und die Adresse zu wählen, die die Anmeldesperre,
DebugByIP, die Request-Regeln, das Audit-Protokoll und das Einwilligungsprotokoll festhalten. Das Einzige, was der
Server sicher weiß, ist die Adresse der Gegenstelle, die die Verbindung geöffnet hat, REMOTE_ADDR, und deshalb
entscheidet diese.
Die Regel
Seit 6.0.15 glaubt der Kernel weitergeleiteten Headern nur, wenn REMOTE_ADDR in site.ini [HTTPHeaderSettings] TrustedProxies[] steht (lib/ezutils/classes/eztrustedproxy.php, verwendet von eZSys und vom HTTP-Cache). Der
Standard vertraut den Loopback-Adressen, die nichts außerhalb des Rechners verwenden kann:
[HTTPHeaderSettings]
TrustedProxies[]
TrustedProxies[]=127.0.0.1
TrustedProxies[]=::1- Einträge sind Adressen oder Bereiche, IPv4 und IPv6 (
192.0.2.10,10.0.0.0/8,2001:db8::/32); eine IPv4-Gegenstelle, die ein Dual-Stack-Socket als::ffff:10.0.0.5meldet, passt auf ihren IPv4-Eintrag. Hostnamen werden nicht aufgelöst, und ein Eintrag, der keine Adresse ist, wird ignoriert, sodass ein Tippfehler nichts vertraut statt etwas Unbeabsichtigtem. - Ein Override, das mit
TrustedProxies[]auf einer eigenen Zeile beginnt, ersetzt die Liste; diese Zeile allein vertraut überhaupt keinem Proxy. - Schreiben Sie Kommentare auf eigene Zeilen:
TrustedProxies[]=10.0.0.0/8 # LBist keine Adresse und wird ignoriert.
Was jeder Header dann bewirkt, und nur von einem vertrauenswürdigen Proxy:
| Header | Wirkung | Ohne vertrauenswürdigen Proxy |
|---|---|---|
X-Forwarded-Proto: https (sonst X-Forwarded-Port gleich [SiteSettings] SSLPort, sonst X-Forwarded-Server gleich SSLProxyServerName) | eZSys::isSSLNow() antwortet mit true: Absolute URLs, Weiterleitungen und CookieSecure=auto verwenden HTTPS | ignoriert; $_SERVER['HTTPS'] und der Port zählen weiterhin, sie sind die eigene Antwort des Webservers |
X-Forwarded-Host | ersetzt Host in erzeugten URLs | ignoriert; Host, dann SiteURL |
der in ClientIpByCustomHTTPHeader genannte Header (Standard false, meist X-Forwarded-For) | die Adresse des Besuchers, von rechts gelesen | REMOTE_ADDR |
Lesen von rechts, mit einem Beispiel. Ein Besucher unter 198.51.100.7 sendet einen gefälschten Header
X-Forwarded-For: 203.0.113.10 über ein CDN (173.245.48.20) an Ihren Load Balancer (10.0.0.5), der sich mit PHP
verbindet. PHP erhält REMOTE_ADDR=10.0.0.5 und X-Forwarded-For: 203.0.113.10, 198.51.100.7, 173.245.48.20. Wenn
10.0.0.0/16 und 173.245.48.0/20 vertrauenswürdig sind, beginnt der Kernel rechts: 10.0.0.5 (die Gegenstelle)
ist vertrauenswürdig, 173.245.48.20 ist vertrauenswürdig, 198.51.100.7 nicht, also ist das der Besucher. Das
gefälschte 203.0.113.10 weiter links wird nie betrachtet. Vor 6.0.15 gewann der Eintrag ganz links, und das war
genau der gefälschte. Ein Eintrag, der keine Adresse ist, beendet den Durchlauf beim letzten vertrauenswürdigen Proxy.
Header, an die Proxys anhängen (ein X-Forwarded-Proto mit http, https), werden auf dieselbe Weise gelesen: Es wird
der Wert verwendet, den der äußerste vertrauenswürdige Proxy geschrieben hat.
Welches Setup was braucht
| Ihr Setup | Was zu tun ist |
|---|---|
| Kein Proxy: Apache oder nginx mit PHP-FPM, oder Velocity direkt vor den Besuchern | Nichts. Weitergeleitete Header, die ein Besucher sendet, werden jetzt ignoriert, und genau darum geht es. |
| Ein Proxy auf demselben Rechner, der die Header setzt (nginx oder Apache vor Velocity oder PHP-FPM, Varnish, ein TLS-Terminator) | Nichts; der Standard deckt 127.0.0.1 und ::1 ab. Lassen Sie den Proxy X-Forwarded-Proto selbst setzen (Apache RequestHeader set X-Forwarded-Proto "https", nginx proxy_set_header X-Forwarded-Proto $scheme;). Ein lokaler Proxy, der den eigenen Header des Besuchers weiterreicht, würde ihn durchlassen: Wenn Sie das nicht ändern können, setzen Sie TrustedProxies[] leer. |
| Ein Proxy, Load Balancer oder CDN auf einer anderen Adresse | Tragen Sie seine Adressen oder Bereiche, und nur diese, in settings/override/site.ini.append.php ein. Hinter einem CDN und einem Load Balancer tragen Sie beide ein. Stellen Sie sicher, dass der Anwendungsserver nicht an ihnen vorbei erreichbar ist (Firewall, Security Group, Velocity Host=127.0.0.1). |
Ein Frontend, das REMOTE_ADDR selbst umschreibt (Apache mod_remoteip, nginx realip, wie bei Plesks nginx vor Apache) | Nichts in Exponential: Der Besucher ist bereits die Gegenstelle, daher bleibt ClientIpByCustomHTTPHeader auf false. |
| Sie möchten die echte Adresse des Besuchers hinter einem Proxy | ClientIpByCustomHTTPHeader=X-Forwarded-For (oder ein Header mit einer einzigen Adresse wie X-Real-IP oder CF-Connecting-IP), zusammen mit dem Proxy in TrustedProxies[]. Hinter mehreren Proxys tragen Sie alle ein. |
Ein Beispiel mit Load Balancer:
# settings/override/site.ini.append.php
[HTTPHeaderSettings]
TrustedProxies[]
# the load balancer's private subnet
TrustedProxies[]=10.0.0.0/16
ClientIpByCustomHTTPHeader=X-Forwarded-ForUnter Velocity
Velocity führt eine eigene Liste vertrauenswürdiger Proxys, Q.webserver.proxy.trusted (standardmäßig 127.0.0.1
und ::1). Setzen Sie sie in einem eigenen Snippet unter /etc/vc/conf-available/, zum Beispiel
reverse-proxy.conf:
{ "Q": { "webserver": { "proxy": {
"trusted": ["127.0.0.1", "::1", "192.0.2.10"],
"headers": { "ip": "X-Forwarded-For", "proto": "X-Forwarded-Proto", "host": "X-Forwarded-Host" }
} } } }und aktivieren Sie es mit exp:velocity conf enable reverse-proxy (ein Link in conf-enabled/, wie es a2enconf
macht); starten Sie Velocity danach neu. Bei einer Gegenstelle aus dieser Liste ermittelt es die Adresse des
Besuchers aus X-Forwarded-For (ebenfalls von rechts) und übergibt sie der Anwendung als REMOTE_ADDR, sodass
ClientIpByCustomHTTPHeader nicht nötig ist. Seit der Engine-Änderung vom 5. Oktober 2026 (Commit 380a64d,
veröffentlicht in 0.0.4.44) setzt Velocity außerdem $_SERVER['HTTPS'] und REQUEST_SCHEME aus X-Forwarded-Proto
(oder dem in Q.webserver.proxy.headers.proto genannten Header), CloudFront-Forwarded-Proto oder dem CF-Visitor
von Cloudflare, nur wenn die Verbindung von dieser Liste kommt; eine TLS-Verbindung zu Velocity ist von jedem
Client aus HTTPS. Frühere Engines lasen den Protokoll-Header von jedem Client, wo immer HTTPS konfiguriert war.
Konfigurieren Sie die Proxys vor Velocity in dessen Liste, nicht in TrustedProxies[]; der Kernel sieht den Besucher
als Gegenstelle und das HTTPS der Engine als eigene Antwort des Servers. Lassen Sie den Proxy den ursprünglichen
Host weitergeben (ProxyPreserveHost On, proxy_set_header Host $host): X-Forwarded-Host erreicht den Kernel von
der Adresse des Besuchers und wird nicht verwendet.
Was schiefgeht und woran man es erkennt
| Symptom | Ursache |
|---|---|
Absolute URLs und Weiterleitungen lauten hinter einem HTTPS-Proxy auf http://; eine Weiterleitungsschleife auf der Anmeldeseite | der Proxy steht nicht in TrustedProxies[] (oder nicht in der Liste von Velocity), oder er sendet kein X-Forwarded-Proto |
| Jeder Besucher hat dieselbe Adresse: die des Proxys (Audit, Sperre, Request-Regeln) | ClientIpByCustomHTTPHeader nicht gesetzt, oder dem Proxy wird nicht vertraut |
| Die fehlgeschlagenen Anmeldungen eines Besuchers sperren alle aus | dasselbe; wenn MaxNumberOfFailedLogin gesetzt ist, korrigieren Sie zuerst die Adresse |
| Ein Besucher kann seine Adresse oder das Schema weiterhin wählen | ein vertrauenswürdiger Bereich, der weit größer ist als Ihre Proxys, oder der Anwendungsserver ist direkt erreichbar |
Prüfen
# directly, no proxy: the header must change nothing (the redirect stays http)
curl -s -o /dev/null -w '%{redirect_url}\n' -H 'X-Forwarded-Proto: https' http://example.com/user/logoutHinter einem Proxy zeigt die Prüfung „Ist meine Adresse eingetragen?“ der Debug-Leiste REMOTE_ADDR, die Adresse, die der
Kernel verwendet, und ob der Proxy-Header gelesen wurde. Einzelheiten und weitere Beispiele (Apache mod_proxy,
nginx, Cloud-Load-Balancer, Cloudflare):
Weitergeleiteten Headern wird nur von konfigurierten Proxys vertraut.
Cachende Proxys
Lassen Sie niemals einen Proxy Antworten cachen, die ein Cookie setzen oder Cache-Control: private tragen (Seiten
angemeldeter Benutzer, Seiten mit einem Formular-Token). Purge-Tags sind standardmäßig nicht öffentlich
(httpcache.ini [HttpCacheSettings] TagHeader=disabled); nennen Sie den einen Header, den Ihr Purge-Proxy liest, nur,
wenn Sie einen haben.
13.11 Dateiberechtigungen und Eigentümer
Warum das wichtig ist: Der häufigste Weg von einem Fehler in einer PHP-Datei zu einer dauerhaften Kompromittierung
ist eine Datei, die der Angreifer schreiben kann und die der Webserver später ausführt oder ausliefert. Wenn der
PHP-Prozess nur var/ und settings/ ändern kann und der Webserver es ablehnt, irgendetwas unterhalb des
Wurzelverzeichnisses auszuführen (Abschnitt 13.2), kann eine Schwachstelle in einer Extension keinen Code einschleusen.
Grundsätze (die Vorgehensweise steht in Kapitel 8, Abschnitt 8.7):
Ein Benutzer schreibt. PHP-FPM, Velocity-Worker, Cronjobs und Konsolenskripte laufen als der Benutzer der Site (oder teilen eine Gruppe). Lassen Sie Worker niemals als root laufen (
[ServerSettings] AllowRootWorkers=disabled, der Standard).Nur was geschrieben werden muss, ist beschreibbar:
var/undsettings/(und, solange Pakete aus der Administration installiert werden,design/undextension/). Der Code (kernel/,lib/,vendor/,index.php) kann einem anderen Benutzer gehören und für den Benutzer der Site nur lesbar sein, sodass ein kompromittierter PHP-Prozess ihn nicht ändern kann.Keine für alle beschreibbaren Dateien. Die mitgelieferten Werte in
[FileSettings]sind0777und0666; setzen Sie die gehärteten Werte, diesite.iniempfiehlt:# settings/override/site.ini.append.php [FileSettings] StorageDirPermissions=0770 StorageFilePermissions=0660 TemporaryPermissions=0770 LogFilePermissions=0660und korrigieren Sie vorhandene Dateien einmalig:
find var -type d -exec chmod 2770 {} +undfind var -type f -exec chmod 0660 {} +(mit der Gruppe der Site auf allem).Geheimnisse in
settings/override(Abschnitt 13.3):0640oder strenger. Seit 6.0.15 behält ein Speichern aus der Administration, der Debug-Leiste oderexp:iniModus, Eigentümer und Gruppe der Datei bei und legt eine neue Einstellungsdatei mit0640an (EZP_INI_SAVE_FILE_PERMISSIONinconfig.php); vorher machte jedes Speichern die Datei zu0666. Prüfen Sie einmal, dass keine Einstellungsdatei für alle beschreibbar geblieben ist:find settings extension/*/settings -perm -o+wdarf nichts ausgeben (Upgrade-Hinweis). INI-Cache-Dateien haben0644(EZP_INI_FILE_PERMISSION).Logs nennen Besucher: Velocity schreibt seine eigenen mit
0640in ein Verzeichnis mit0750([LogSettings] FileMode,DirMode), der Antwort-Cache mit denselben Modi.Symbolische Links aus dem Document Root hinaus werden von Velocity abgelehnt (
FollowSymlinks=disabled); mit Apache verwenden SieOptions SymLinksIfOwnerMatchstattFollowSymLinks, wenn andere Benutzer als der der Site Links anlegen könnten.TemporaryDir(/tmp/im Auslieferungszustand) wird mit jedem Benutzer des Rechners geteilt; erwägen Sie ein eigenes Verzeichnis der Site, zum Beispiel unterhalb vonvar/.
13.12 Velocity-spezifische Härtung
| Thema | Einstellung oder Maßnahme |
|---|---|
| Bind-Adresse | [ServerSettings] Host=127.0.0.1, sofern Velocity nicht direkt vor den Besuchern steht; der Server hat keine eigene HTTP-Authentifizierung |
| Vorgeschaltete Proxys | nur die Adressen in Q.webserver.proxy.trusted dürfen Adresse und Protokoll des Besuchers setzen (Abschnitt 13.10); beschränken Sie die Liste auf Ihre eigenen Proxys |
| Worker-Benutzer | User, Group auf den Benutzer der Site gesetzt; niemals root |
| Symbolische Links | FollowSymlinks=disabled |
| Dashboard und Kennzahlen | ein leeres [DashboardSettings] Token und Remote=disabled halten /Q/dashboard, /Q/stats, /Q/metrics lokal; wenn Sie ein Token setzen, erzeugen Sie ein langes zufälliges (openssl rand -hex 24) und halten Sie es geheim |
/Q/phpinfo | nur lokal; zeigt die Prozessumgebung |
Kontrollpanel /Q/panel | nur lokal, passwortgeschützt; setzen Sie das Passwort sofort auf einem Rechner, der aus dem Internet erreichbar ist; sein Speicher darf nicht für Gruppe oder andere beschreibbar sein |
| HTTPS | ein Zertifikat einer Zertifizierungsstelle, HSTS erst erhöht, wenn alles HTTPS ist (Abschnitt 13.9) |
| Konfigurationsdateien | /etc/vc/sites-available/<site>.conf hat 0600 (Zertifikatspfade, Token); belassen Sie es so |
| Antwort-Cache | persönliche Seiten werden nie gecacht; wenn Sie das Sitzungs-Cookie umbenennen, prüfen Sie, dass [CacheSettings] SkipCookies abgeleitet bleibt oder es aufführt |
| Updates | Engine-Releases beheben auch Sicherheitsprobleme (Abschnitt 13.15); exp:velocity deploy nach einem Update |
13.13 Mail: Einwilligung und Sperrliste
Seit 6.0.15 durchläuft jede Mail das Mail-Gate (expMailGate), bevor sie den Transport erreicht:
- Unverzichtbare Kategorien (
security,orders,legal,admin) gehen immer hinaus. - Optionale Kategorien gehen nur an Empfänger, die sie eingeschaltet haben, mit einer Fußzeile, einem
Abmeldelink mit einem Klick und
List-Unsubscribe-Headern; eine Mail pro Empfänger, sodass niemand andere Adressen sieht. - Mail ohne Kategorie wird gesendet und in
var/<vardir>/log/mailgate.jsonlgezählt, sodass Sie Code finden können, der eine Kategorie angeben sollte.
Was Sie für den Produktivbetrieb einrichten (Anleitung für Administratoren):
Die Tabellen existieren:
php bin/php/console exp:mail:statusmeldet fünfmalok.Die Fußzeile nennt den Absender:
mailpreferences.ini [FooterSettings] OrganisationNameundOrganisationAddress. Ohne sie geht optionale Mail ohne Postanschrift hinaus, die viele Rechtsordnungen vorschreiben.Das Site-Geheimnis in
settings/override/mailpreferences.ini.append.phpist gesichert (Abschnitt 13.3).Die Sperrliste blockiert optionale Mail an harte Bounces, Beschwerden, Anfragen „alles abbestellen“ und rechtliche Anfragen. Gespeichert wird nur ein gesalzener Hash jeder Adresse, sodass die Liste nicht gelesen werden kann. Verwalten Sie sie unter Setup > E-Mail-Einstellungen oder auf der Konsole:
php bin/php/console exp:mail:suppression check --email=<address> php bin/php/console exp:mail:suppression add --email=<address> --reason=legal --note="<no personal data>" php bin/php/console exp:mail:suppression lift --email=<address>Konfigurieren Sie den Bounce-Leser (
[BounceSettings]), damit harte Bounces automatisch hinzugefügt werden.Das Einwilligungsprotokoll hält jede Änderung der Präferenzen einer Person mit Quelle und Wortlaut fest. Es enthält Adressen und IP-Adressen: Geben Sie
mailpreferences/exportnur wenigen Personen, löschen Sie exportierte CSV-Dateien, sobald die Anfrage, die sie beantworten, erledigt ist, und lassen Sie den Cronjob-Teilmailpreferencesdie Aufbewahrungsfrist anwenden ([ConsentSettings] RetentionDays, 1095 Tage).Datenschutzanfragen:
exp:mail:preferences export --email=<address>(geschrieben mit Modus0600) undexp:mail:preferences erase --email=<address> --yes.
13.14 Das Audit-Protokoll
Das Audit hält Anmeldungen und fehlgeschlagene Anmeldungen fest, verschobene, verborgene oder entfernte Inhalte,
Änderungen an Rollen und Einstellungen, Preise, Befehle und Cronjobs sowie das, was das Audit selbst getan hat.
Es ist in jeder Installation standardmäßig eingeschaltet. Jeder Eintrag ist eine JSON-Zeile in einer Datei je
Kanal und Tag (var/<site>/log/audit/<channel>-<YYYY-MM-DD>.jsonl), und jede Zeile trägt den Hash der Zeile davor,
sodass eine geänderte, entfernte oder eingefügte Zeile auffällt.
php bin/php/console exp:audit status # enabled, directory, key, each channel intact or broken
php bin/php/console exp:audit verify # checks the hash chains
php bin/php/console exp:audit tail --channel=access --lines=20Für den Produktivbetrieb:
- Führen Sie den Cronjob-Teil aus. Er gehört zur Gruppe
frequent:php runcronjobs.php frequentalle paar Minuten, als der Benutzer der Site. Das Audit-Dashboard warnt, wenn er eine Stunde lang nicht gelaufen ist. - Legen Sie fest, wer Warnmails erhält: standardmäßig die
AdminEmailder Site; prüfen Sie es mitphp bin/php/console exp:audit alerts recipients. Die mitgelieferten Regeln umfassenbrute_force,brute_force_userundadmin_role_granted. - Sichern Sie
settings/override/audit.ini.append.phpals Geheimnis (Signatur- und Pseudonymschlüssel). - Geben Sie
audit/readnur den Rollen, die es brauchen; standardmäßig hat nur die Rolle Administratoraudit/readundaudit/manage. - Datenschutz.
[AuditPrivacySettings]legt je Feld fest, was aufbewahrt wird: Adressen auf /24 und /48 gekürzt, die Sitzung gehasht, E-Mail-Adressen gehasht, Passwörter und Tokens nie aufgezeichnet, personenbezogene Felder nachPseudonymiseAfterDays(90) pseudonymisiert. Passen Sie diese Werte an Ihre Datenschutzanforderungen an; die Abschnitte 4.12 und 6.4 der Audit-Anleitung beschreiben ein strenges Profil. - Leiten Sie es weiter an ein zentrales Log oder SIEM über eine Senke (
[AuditSink_syslog],[AuditSink_webhook]), damit ein kompromittierter Rechner seine eigene Geschichte nicht unbemerkt umschreiben kann. Führen Sieexp:audit verifyregelmäßig aus.
Vollständige Anleitung: Audit.
13.15 Auf dem neuesten Stand bleiben
- Verfolgen Sie die Releases von Exponential und jeder Extension, die Sie verwenden: Es sind Composer-Pakete,
daher listet
composer outdatedauf, was neuer ist. Lesen Sie vor dem Aktualisieren den Changelog und die Upgrade-Hinweise (Kapitel 11). - Aktualisieren Sie zuerst in einer Kopie, dann auf der Live-Site:
composer update <package>, die Datenbank-Updates, die die Release nennt,php bin/php/console exp:velocity deploy(oder Autoloads, Cache leeren und ein Neuladen von PHP-FPM von Hand). - Prüfen Sie die Dateikonsistenz nach einem Update: Setup > Upgrade-Prüfung („Überprüfe Dateikonsistenz“
vergleicht die Dateien mit der
share/filelist.md5der Release; „Überprüfe Datenbankkonsistenz“ das Schema). Eine veränderte Kernel-Datei, die Sie nicht geändert haben, verdient einen genaueren Blick. - PHP, der Datenbankserver, das Betriebssystem, die Engine von Velocity und das Binary von FrankenPHP brauchen
ebenfalls Updates. Version und Prüfsummen von FrankenPHP sind in
[FrankenPHPSettings] VersionundSha256[]festgelegt; ändern Sie sie gemeinsam. - Überprüfen Sie Ihre eigenen Extensions auf die Muster, die im Kernel behoben wurden (SQL, das aus Anfragedaten
ohne
escapeString()oder Integer-Casts gebaut wird, Shell-Befehle ohneescapeshellarg(), Ausgaben ohne Escaping); siehe die Härtungshinweise zu 6.0.13. Extensions, die von den RAD-Assistenten vor deren Korrektur erzeugt wurden, sollten neu erzeugt werden (RAD-Werkzeuge: Sicherheit). - Melden Sie eine Sicherheitslücke an
[email protected], nicht im öffentlichen Issue-Tracker (SECURITY.md).
13.16 Checkliste für den Livegang
- To do: Rewrite-Regeln:
.htaccessist eine aktuelle Kopie von.htaccess_root(oder der abgeleitete nginx-Block, oder Velocity);/.git/config,/settings/site.ini,/composer.jsonliefern nicht die Datei aus../console exp:setup:statusnennt die Vorlage. - To do:
config.phpnicht in der Versionsverwaltung; Modus0640mit der Gruppe des Webservers, wenn sie ein Passwort enthält (exp:config:setwarnt, wenn nicht);var/backup/(frühere Kopien vonconfig.php) geschützt und aufgeräumt. - To do:
settings/override/nicht in der Versionsverwaltung, als Geheimnis gesichert, Modus0640oder strenger. - To do: Das erzeugte Administratorpasswort geändert;
var/log/initial-admin-passwordgelöscht. - To do: Ein persönliches Administratorkonto pro Person;
adminals Anmeldung stillgelegt; ein getestetes Notfallverfahren (Kontohygiene). - To do:
[DebugSettings] DebugOutput=disabled; PHPdisplay_errors=Off. - To do:
[SiteAccessSettings] CheckValidity=false; die Administration auf einem eigenen Host, beschränkt per Netzwerk oder durch eine zweite Authentifizierung; Rollen nach dem Prinzip minimaler Rechte. - To do: Passwortrichtlinie festgelegt (
MinPasswordLength,[PasswordSettings]);EndOtherSessions=enabled. - To do: Demo-Modus aus:
EXP_DEMO_MODEfür keinen Prozess der Site gesetzt; kein Banner Demo-Modus, keine Zeiledemo/modeinsecurity.log(Der Demo-Modus muss ausgeschaltet sein). - To do:
[Session] CookieSecure=trueauf einer reinen HTTPS-Site;HttpOnlyundSameSiteeingeschaltet gelassen. - To do:
ezformtokenaktiv. - To do: Der Request Shield läuft: die Hook-Zeile in
config.php, Setup > Request Shield meldet nicht, dass er nicht lief, undcheckundtestbestehen fürsettings/request-shield/request-shield.rules. - To do: HTTPS auf jedem Namen; HTTP umgeleitet; HSTS erhöht, sobald stabil; Zertifikatserneuerung überwacht.
- To do: Sicherheits-Header auf Seiten vorhanden (und auf statischen Dateien, wenn Sie sie dort haben möchten).
- To do: Hinter einem Proxy:
TrustedProxies[]führt genau Ihre Proxys auf (Velocity:Q.webserver.proxy.trusted), der Proxy setztX-Forwarded-Protoselbst, der Anwendungsserver ist nicht an ihm vorbei erreichbar; diecurl-Prüfung aus 13.10 zeigt, dass ein vom Besucher selbst gesendetesX-Forwarded-Protonichts ändert. - To do: Ein Benutzer (oder eine Gruppe) schreibt
var/undsettings/; keine für alle beschreibbaren Dateien; Worker niemals als root. - To do: Velocity:
Hostwie beabsichtigt, Dashboard-Token und Panel-Passwort gesetzt oder die Ansichten lokal gehalten. - To do: Mail:
exp:mail:statusok, Fußzeile ausgefüllt, Bounce-Leser konfiguriert. - To do: Audit:
exp:audit verifyintakt, Cronjob-Gruppefrequentläuft, Empfänger der Warnmails geprüft, Schlüssel gesichert. - To do: Eine Update-Routine: wer die Releases beobachtet, wie Updates getestet werden, wer Sicherheitsmails erhält.
13.17 Referenzen
In diesem Repository:
- Sicherheitsstandards vom September 2026: Header, Sitzungs-Cookie, Anmeldung, ausgelieferte Dateien, Caching persönlicher Seiten
- Sicherheitshärtung von 6.0.13, Härtung von Datentypen und Eingaben, RAD-Werkzeuge: Sicherheit
- Request-Regeln
- Weitergeleiteten Headern wird nur von konfigurierten Proxys vertraut; Code in
lib/ezutils/classes/eztrustedproxy.phpundlib/ezutils/classes/ezsys.php - Das eigene Passwort ändern, Hinweise zur Passwortänderung von Benutzern, Seite „Formular abgelaufen“
- Die Exp-Debug-Leiste
- Audit
- E-Mail-Einstellungen: Anleitung für Administratoren, Upgrade-Hinweise
- HTTP-Cache
- Velocity: HTTP/2 und Sicherheit, HTTPS und Zertifikate, Kontrollpanel, Engines
- Installation mit einem Befehl (das erzeugte Administratorpasswort)
- Die Einstellungen:
settings/site.ini,settings/velocity.ini,settings/audit.ini,settings/requestrules.ini; die Regeln:.htaccess_root - Kapitel 8: Die Site ausliefern
Extern:
- OWASP: Top Ten, Session Management Cheat Sheet, Cross-Site Request Forgery Prevention, Authentication Cheat Sheet, Password Storage Cheat Sheet, HTTP Security Response Headers, Content Security Policy, Secure Headers Project
- NIST SP 800-63B-4, Digital Identity Guidelines: Authentication and Authenticator Management (Revision 4, die Revision 3 ablöst)
- PHP: Sicherheit, Sitzungskonfiguration, display_errors, password_hash
- MDN: Set-Cookie, Strict-Transport-Security, Content-Security-Policy
- HSTS: RFC 6797; Cookies: RFC 6265
- Apache: Sicherheitstipps, mod_headers, mod_authz_host (Require ip)
- nginx: add_header, Access-Modul (allow, deny)
- Let's Encrypt: Dokumentation
- Exponential-Velocity-Engine: https://github.com/se7enxweb/exponential-velocity (dort
docs/security.md,docs/https.md,docs/panel.md)
Inhalt · Zurück: 12. Fehlerbehebung · Weiter: 14. Migration von der 4.x-Linie
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.