Lehrplan Lektion 66 von 156 · Content Security Policy und Framing
Content Security Policy und Framing

Nonces, Hashes und Report-only

Warum das wichtig istFast jede echte Seite hat ein paar eigene Inline-Skripte. Wenn der einzige Weg, sie funktionsfähig zu halten, 'unsafe-inline' ist, stoppt CSP den Schutz gegen Injections überhaupt nicht mehr. Nonces und Hashes lassen deine Skripte rein und halten injizierte draußen. Der Report-only Modus lässt dich eine Policy einschalten, ohne am ersten Tag etwas für Besucher zu zerstören.

Stell dir ein Konzert vor, bei dem das Armband jeder Nacht eine andere Farbe hat, die dem Personal erst eine Stunde vor Öffnung der Türen mitgeteilt wird. Ein gefälschtes Armband von letzter Woche ist nutzlos. Ein Nonce ist das Armband von heute für deine inline scripts.

Nonces

Nonce: Kurzform für "number used once". Ein neuer zufälliger Wert, den der Server für jede Antwort erstellt, in den Header als 'nonce-VALUE' setzt und auch in jeden seiner eigenen Inline-Script-Tags als nonce="VALUE" schreibt.

Content-Security-Policy: script-src 'self' 'nonce-4fT9qLx2Zb8wRk1e'

<script nonce="4fT9qLx2Zb8wRk1e">startShop();</script>      runs
<script>sendCookies();</script>                          blocked: no nonce

Ein Angreifer, der ein script tag einschleust, kennt den Wert dieser Antwort nicht, also wird sein script abgelehnt. Drei Regeln machen das wahr:

  • Unpredictable: mindestens 128 Bits aus einer sicheren Zufallsquelle, wie zum Beispiel Python's secrets.token_urlsafe(16).
  • Jede Antwort frisch: niemals ein fester Wert in einer config file, und sei vorsichtig mit page caches, die dieselbe nonce an jeden ausliefern würden.
  • Nur auf deinen eigenen Tags: eine Vorlage, die den Nonce zu jedem script tag, einschließlich derer, die aus Benutzereingaben erstellt wurden, übergeben und das Armband dem Angreifer aushändigen.

Diese Seite macht es mit django-csp: jedes Inline-Script in den Templates ist als <script nonce="{{ request.csp_nonce }}"> geschrieben, und das Paket setzt den passenden Wert in den Header.

Hashes

Hash-Quelle: 'sha256-BASE64', der SHA-256-Fingerabdruck des exakten Textes innerhalb eines script-Tags. Wenn der Text übereinstimmt, wird er ausgeführt. Nützlich für statische Seiten, wo nichts einen nonce pro Antwort hinzufügen kann.

import base64, hashlib
code = "startShop();"          # exactly what is between the tags
print("'sha256-" + base64.b64encode(hashlib.sha256(code.encode()).digest()).decode() + "'")

Jedes Byte zählt: ein zusätzlicher Zeilenumbruch oder ein Leerzeichen ergibt einen anderen Hash. Hashes und Nonces decken nur inline <script> Blöcke ab, nicht onclick= Attribute (ein selten genutztes Schlüsselwort, 'unsafe-hashes', kann einen gehashten Handler erlauben, aber das Verschieben ist sauberer). Verschiebe Handler in dein Skript mit addEventListener.

Warum 'unsafe-inline' manchmal beibehalten wird

Wenn ein nonce oder hash aufgelistet ist, ignorieren Browser, die diese verstehen, ignore 'unsafe-inline'. Sehr alte Browser verstehen keine nonces, also fallen sie auf 'unsafe-inline' zurück und die Seite funktioniert dort trotzdem. Deshalb listet die Richtlinie von floati.life beide auf. Ohne einen nonce oder hash lässt 'unsafe-inline' jedoch jedes injizierte Script laufen.

Ein Schritt weiter ist 'strict-dynamic': ein Skript, dem du mit einer Nonce vertraut hast, kann weitere Skripte laden, und Browser, die dies unterstützen, ignorieren dann Hostlisten. Es eignet sich für große Apps, die Code zur Laufzeit laden. (Der Practice Checker modelliert es nicht.)

Sicher ausrollen: report-only

Content-Security-Policy-Report-Only: ein zweiter Header mit der gleichen Syntax. Der Browser blockiert nichts, aber meldet, was er würde blockiert haben, in der Konsole und, wenn du es verlangst, an eine Adresse auf deinem Server.

Reporting-Endpoints: csp="https://shopd.example/csp-reports"
Content-Security-Policy-Report-Only: default-src 'self'; script-src 'self' 'nonce-...'; report-to csp

report-to benennt einen Endpunkt aus dem Reporting-Endpoints Header. Ältere Anleitungen nutzen report-uri https://...; viele Seiten senden beides, und Browser, die report-to verstehen, ignorieren report-uri. Ein vernünftiger Rollout: sende die neue Policy für eine Woche oder zwei als report-only, behebe das, was sie meldet, und schalte sie dann auf den enforcing Header um. Du kannst eine enforcing Policy und eine strengere report-only Policy nebeneinander senden.

Privatnotiz: ein Bericht enthält die Seitenadresse und die blockierte Adresse. Seitenadressen können personenbezogene Daten in ihren Query Strings enthalten, also sende Berichte an deinen eigenen Server, behalte sie kurz und niemals an einen externen Analysedienst.

A häufiges Missverständnis: "report-only schützt Besucher, während ich teste". Es schützt niemanden. Es ist ein Messwerkzeug. Lass eine Policy nicht monatelang in report-only.

In anderen Sprachen
// JavaScript (Node)
const nonce = require("crypto").randomBytes(16).toString("base64");
// Go
b := make([]byte, 16); rand.Read(b)   // crypto/rand
nonce := base64.StdEncoding.EncodeToString(b)
// PHP
$nonce = base64_encode(random_bytes(16));

Zusammenfassung

  • A nonce ist ein frischer, unvorhersehbarer Wert pro Antwort, der deine eigenen Inline-Skripte markiert.
  • A hash erlaubt ein exaktes Inline-Script; jede Änderung an seinem Text benötigt einen neuen hash.
  • 'unsafe-inline' wird ignoriert, wenn ein Nonce oder Hash aufgelistet ist, und ist gefährlich, wenn keiner vorhanden ist.
  • Roll out mit Content-Security-Policy-Report-Only, dann erzwingen; behalte Berichte auf deinem eigenen Server.

Ein Problem in dieser Lektion entdeckt? Melde es · Frage zu dieser Lektion

Diese Übung öffnet bald

Beende die vorherige Lektion, damit diese freigeschaltet wird. Der ganze Kurs ist kostenlos, kein Konto erforderlich, und du kannst diese Lektion jetzt direkt lesen.