Content Security Policy einrichten
Eine Content Security Policy (CSP) legt fest, welche Skripte eine Seite ausführen und mit welchen Servern sie sprechen darf. Das schützt vor eingeschleustem Code. Für den Live-Editor ist das besonders wichtig: Er hält deinen GitLab-Token im Browser, und die CSP verhindert, dass fremder Code ihn an andere Server schickt.
Easy Mode
Im Easy Mode musst du nichts tun. Ab Version 3.1.3 erzeugt die Pipeline die CSP automatisch für jede Seite. Eine eigene Richtlinie setzt du mit dem Parameter content-security-policy der CI-Komponente md-to-web.
Developer Mode
Voraussetzungen
@document-writing-tools/kernux-themeab Version 3.1.3- Ein Projekt im Developer Mode mit eigener
pages/_document.tsx - Eine
theme.config.tsx, so wie für das Layout
CSP einbinden
Erzeuge die Richtlinie mit createContentSecurityPolicy und setze sie als erstes Element in den <Head> deiner pages/_document.tsx:
Die CSP gilt nur für Elemente, die nach ihr im HTML stehen. Setze das meta-Element deshalb vor alle anderen Einträge im Head.
createContentSecurityPolicy läuft beim Build und nicht im Browser. Importiere es deshalb nur in der _document.tsx.
Was die Richtlinie erlaubt
| Bereich | Erlaubt |
|---|---|
| Skripte | Dateien der eigenen Webseite und das Skript für helles und dunkles Design |
| Verbindungen | Die eigene Webseite, die GitLab-Instanz und die Dienste aus der theme.config.tsx (Matomo, Feedback-Server) sowie die PDF-Erstellung der Selbsteinschätzung und die Standardadressen der KI-Assistenten Ollama und Mistral |
| Bilder und Videos | Die eigene Webseite, Adressen mit https: und eingebettete Bilder |
| Styles | Die eigene Webseite und Styles direkt im HTML |
| Schriften | Die eigene Webseite und eingebettete Schriften |
Das Skript für das helle und dunkle Design steht direkt im HTML. Die Richtlinie erlaubt genau dieses eine Skript über eine Prüfsumme, die beim Build entsteht. Alle anderen Skripte im HTML blockiert der Browser.
Weitere Dienste erlauben
Nutzt deine Webseite weitere Dienste, trage sie in scriptSrc für Skripte oder in connectSrc für Verbindungen ein. Die Funktion übernimmt nur die Adresse des Servers, also zum Beispiel https://converter.example.org aus https://converter.example.org/api:
Die Liste in connectSrc braucht die GitLab-Instanz nur, wenn du nicht gitlab.opencode.de nutzt. Leere Einträge ignoriert die Funktion.
Eigene Skripte direkt im HTML, zum Beispiel ein script-Tag in einer Seite, blockiert die CSP. Lege den Code als Datei in public/ ab und binde ihn mit src ein.
Entwicklung
Mit next dev erlaubt die Richtlinie zusätzlich 'unsafe-eval', weil der Entwicklungsserver Code mit eval ausführt. Im Build für die Veröffentlichung fehlt diese Ausnahme.
Ergebnis prüfen
Öffne eine Seite und die Entwicklertools des Browsers.
- Im Tab Elements steht im
<head>das meta-Element mitContent-Security-Policy. - Im Tab Console stehen keine Fehler mit
Content Security Policy. Blockiert der Browser etwas, nennt der Fehler die Adresse. Trage sie dann inscriptSrcoderconnectSrcein.
Nächste Schritte
- Live-Editor einrichten: Anmeldung und Speichern im Browser
- Eigene Blöcke im Live-Editor: eigene Komponenten im Editor