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

Content Security Policy für Autoren von Erweiterungen

Was eine Content Security Policy für Templates und Skripte bedeutet - die Modi, warum Inline-Code scheitert, das Muster mit Data-Attributen, csp_nonce() und seine Grenzen, und wie Sie Verstöße finden.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/extension-development/part-3-extension-developer/content-security-policy-for-extensions.md

On this page

This page is a translation. Read the English original

Content Security Policy für Autoren von Erweiterungen

Teil 3, Kapitel 32. Eine Content Security Policy (CSP) sagt dem Browser, welche Skripte und Styles eine Seite ausführen darf. Eine strenge Richtlinie verhindert, dass eingeschleuste Skripte ausgeführt werden, selbst wenn ein Template vergessen hat, etwas zu maskieren. Exponential sendet eine solche Richtlinie aus site.ini [ContentSecurityPolicy]; die vollständige Referenz ist Content Security Policy. Dieses Kapitel enthält, was ein Autor von Erweiterungen wissen muss.

Die Richtlinie

EinstellungBedeutung
Modedisabled, report-only (der Browser meldet, blockiert aber nichts), enforce (der Browser blockiert), auto
Directives[]die Richtlinie: script-src 'self', style-src 'self', default-src 'self' und die übrigen
Nonce, NonceDirectives[]eine Nonce pro Anfrage für Skripte, die inline stehen müssen
ReportURIwohin Berichte gehen

auto bedeutet report-only auf Siteaccesses der Administration und ausgeschaltet überall sonst; Installationen können die Richtlinie durchsetzen, und die Administration der Referenzinstallation läuft mit Mode=enforce. Schreiben Sie Ihre Erweiterung für eine durchgesetzte Richtlinie: Dann funktioniert sie überall.

Was unter script-src 'self' scheitert

In einem TemplateWarum es scheitertStattdessen
<script>doSomething();</script>Inline-Skripteine Datei in design/<design>/javascript/, geladen über design.ini oder ezscript_require
<button onclick="...">Inline-Event-Handlerdata-*-Attribut + addEventListener in Ihrer Datei
<a href="javascript:...">javascript:-URLeine Schaltfläche mit einem Data-Attribut
setTimeout( "code", 100 ), eval(), new Function()Auswertung von Zeichenkettenechte Funktionen
style="color:red", <style>Inline-Style unter style-src 'self'eine Klasse in Ihrem Stylesheet

Diese Regeln gelten im eigenen Code der Administration: Ihre Templates enthalten kein <style>, kein style="", keine Inline-Skripte, und ein Test lässt den Build fehlschlagen, wenn eines auftaucht (Admin-Seiten im admin4-Stil).

Das Muster mit Data-Attributen

Template:

<button type="button" class="a4-btn" data-mysite-greet="{$name|wash}">{'Greet'|i18n( 'extension/mysite_hello' )}</button>
<output data-mysite-greeting></output>

Skript (design/standard/javascript/mysite_hello.js):

document.addEventListener( 'click', function ( e ) {
    var button = e.target.closest( '[data-mysite-greet]' );
    if ( !button )
        return;
    var out = document.querySelector( '[data-mysite-greeting]' );
    if ( out )
        out.textContent = 'Hello, ' + button.getAttribute( 'data-mysite-greet' ) + '!';
} );

Ein einziger Listener auf dem Dokument behandelt jede Schaltfläche, auch solche, die später hinzukommen. Daten gelangen über maskierte Attribute vom Template zum Skript; das Skript schreibt mit textContent. Viele Erweiterungen dieses Projekts wurden auf dieses Muster umgestellt; Teil 4 zeigt echte Beispiele vorher und nachher (CSP: Event-Handler-Attribute zu Data-Attributen).

Die Nonce, für den seltenen Fall

Wenn ein Skript wirklich inline stehen muss, kann die Richtlinie eine Nonce tragen, und das Template gibt sie aus:

<script nonce="{csp_nonce()}">...</script>

csp_nonce() gibt eine leere Zeichenkette zurück, wenn die Richtlinie keine Nonce hat. Geben Sie sie nie innerhalb eines {cache-block}, eines im View-Cache gespeicherten Templates oder eines statischen Caches aus: Die zwischengespeicherte Kopie würde die Nonce einer anderen Anfrage tragen und blockiert werden. Eine Datei ist fast immer die bessere Lösung.

Verstöße finden

  • Die Entwicklerkonsole des Browsers nennt jedes blockierte Skript, jeden blockierten Handler und Style.
  • Mit einer ReportURI werden Berichte gesammelt; auf der Referenzinstallation werden sie in var/log/csp.log geschrieben.
  • Testen Sie die Seiten Ihrer Erweiterung vor dem Release in einem Siteaccess, dessen Mode auf enforce steht.

Verwandte Seiten

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.

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