Product Logo

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-theme ab 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:

createContentSecurityPolicy läuft beim Build und nicht im Browser. Importiere es deshalb nur in der _document.tsx.

Was die Richtlinie erlaubt

BereichErlaubt
SkripteDateien der eigenen Webseite und das Skript für helles und dunkles Design
VerbindungenDie 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 VideosDie eigene Webseite, Adressen mit https: und eingebettete Bilder
StylesDie eigene Webseite und Styles direkt im HTML
SchriftenDie 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.

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.

  1. Im Tab Elements steht im <head> das meta-Element mit Content-Security-Policy.
  2. Im Tab Console stehen keine Fehler mit Content Security Policy. Blockiert der Browser etwas, nennt der Fehler die Adresse. Trage sie dann in scriptSrc oder connectSrc ein.

Nächste Schritte