Content Security Policy für Ihren Code
Diese Seite ist für Anwendungsentwickler, deren Templates und Skripte unter einer Content Security Policy funktionieren müssen. Die Administration läuft unter einer solchen Richtlinie und blockiert Inline-Code, sobald sie durchgesetzt wird; öffentliche Websites können sie einschalten (Content Security Policy).
Inhalt
- Die mitgelieferte Richtlinie
- Was sie verbietet
- Wie Sie es stattdessen schreiben
- Quellen von anderen Hosts
- Ihre Seiten prüfen
Die mitgelieferte Richtlinie
site.ini [ContentSecurityPolicy]: Mode=auto (nur Bericht in den Siteaccesses der Administration, sonst aus),
Directives[] mit default-src 'self', script-src 'self', style-src 'self', img-src 'self' data: blob:,
object-src 'none', frame-ancestors 'self' und weiteren. Mit Nonce=enabled trägt die Richtlinie der
Administration eine Nonce pro Anfrage.
Was sie verbietet
| Verboten | Warum |
|---|---|
<script> mit Code in Templates | script-src 'self' erlaubt nur Skriptdateien |
Attribute onclick=, onload= ... | Inline-Handler |
javascript:-Links | Inline-Code |
<style>-Elemente, style=""-Attribute | style-src 'self' erlaubt nur Stylesheet-Dateien |
eval(), new Function() | kein unsafe-eval |
| Skripte und Schriften von anderen Hosts | nicht in der Richtlinie, sofern nicht hinzugefügt |
Wie Sie es stattdessen schreiben
| Statt | Schreiben Sie |
|---|---|
| Inline-Skript in der Seite | eine Datei design/<design>/javascript/..., ausgegeben mit {ezscript( array( 'page/expdemo_list.js' ) )} |
| Werte für ein Skript | data-*-Attribute, für HTML gewaschen, oder JSON: data-conf="{json_encode( hash( ... ) )|wash}" |
| ein Konfigurationsobjekt | <script type="application/json" id="...">, gelesen von einer Skriptdatei (Daten, kein Code) |
onclick | eine Klasse oder ein data-*-Attribut und addEventListener in der Skriptdatei |
style="width: 40%" | eine Klasse oder eine CSS-Custom-Property, die eine Stylesheet-Klasse setzt |
| Bestätigungs- und Umschaltknöpfe in der Administration | die gemeinsamen data-a4-*-Aktionen von a4_actions.js (data-a4-confirm, data-a4-toggle-checkboxes ...) |
In Admin-Designs folgen Styles außerdem den Admin-Regeln: gemeinsame Komponenten und Tokens, Modul-CSS in
stylesheets/modules/ (Styling von admin4).
Quellen von anderen Hosts
# extension/expdemo/settings/site.ini.append.php
[ContentSecurityPolicy]
AdditionalSources[]=script-src https://maps.example.org
AdditionalSources[]=connect-src https://api.example.orgAdditionalSources[] ist eine Liste, sodass Erweiterungen und Siteaccesses jeweils ihre Hosts hinzufügen können.
Ihre Seiten prüfen
- Öffnen Sie jede Seite mit der Browserkonsole: Verstöße werden dort gemeldet.
- Berichte gehen an
csp/reportund werden nachvar/log/csp.loggeschrieben. - Der Test
tests/tests/design/AdminContentSecurityPolicyTest.phpdes Kernels prüft die Templates der Admin-Design-Ketten, einschließlich der Templates aktiver Erweiterungen; eine Erweiterung mit Inline-Code fällt dort auf.
Verwandte Seiten
- Stylesheets und Skripte für Ihre Website
- Sicherheit für Anwendungen
- Standard für die Webplattform
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
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.