Programma Lezione 66 di 156 · Content Security Policy e framing
Content Security Policy e framing

Nonce, hash e report-only

Perché è importante Quasi ogni sito vero ha qualche script inline suo. Se l'unico modo per farli funzionare è 'unsafe-inline', la CSP smette del tutto di proteggere dall'iniezione. Nonce e hash fanno entrare i tuoi script e tengono fuori quelli iniettati. La modalità report-only ti permette di attivare una policy senza rompere niente per i visitatori il primo giorno.

Immagina un concerto in cui il braccialetto di ogni sera ha un colore diverso, comunicato solo al personale un'ora prima dell'apertura delle porte. Un braccialetto falso della settimana scorsa non serve a niente. Un nonce è il braccialetto di stasera per i tuoi script inline.

Nonce

Nonce: abbreviazione di "number used once", numero usato una volta. Un nuovo valore casuale che il server crea per ogni risposta, mette nell'intestazione come 'nonce-VALUE', e scrive anche in ciascuno dei propri tag di script inline come nonce="VALUE".

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

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

Chi attacca e inietta un tag script non conosce il valore di questa risposta, quindi il suo script viene rifiutato. Tre regole lo rendono vero:

  • Imprevedibile: almeno 128 bit da una sorgente casuale sicura, come secrets.token_urlsafe(16) di Python.
  • Nuovo a ogni risposta: mai un valore fisso in un file di configurazione, e attenzione alle cache delle pagine che servirebbero lo stesso nonce a tutti.
  • Solo sui tuoi tag: un template che aggiunge il nonce a qualsiasi tag script, compresi quelli costruiti dall'input degli utenti, consegna il braccialetto a chi attacca.

Questo sito lo fa con django-csp: ogni script inline nei template è scritto come <script nonce="{{ request.csp_nonce }}">, e il pacchetto mette il valore corrispondente nell'intestazione.

Hash

Sorgente hash: 'sha256-BASE64', l'impronta SHA-256 del testo esatto dentro un tag script. Se il testo coincide, gira. Utile per le pagine statiche dove niente può aggiungere un nonce per ogni risposta.

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

Ogni byte conta: uno spazio o un a capo in più dà un hash diverso. Hash e nonce coprono solo i blocchi inline <script>, non gli attributi onclick= (una parola chiave poco usata, 'unsafe-hashes', può permettere un gestore con hash, ma spostarlo è più pulito). Sposta i gestori nel tuo script con addEventListener.

Perché a volte 'unsafe-inline' viene lasciato

Quando è elencato un nonce o un hash, i browser che li capiscono ignorano 'unsafe-inline'. I browser molto vecchi non capiscono i nonce, quindi ripiegano su 'unsafe-inline' e il sito funziona comunque lì. Ecco perché la policy di floati.life li elenca entrambi. Senza un nonce o un hash, però, 'unsafe-inline' fa girare ogni script iniettato.

Un passo oltre c'è 'strict-dynamic': uno script di cui ti sei fidato con un nonce può caricare altri script, e i browser che lo supportano a quel punto ignorano gli elenchi di host. È adatto alle grandi app che caricano codice al volo. (Il controllore di esercitazione non lo modella.)

Introdurla con sicurezza: report-only

Content-Security-Policy-Report-Only: una seconda intestazione con la stessa sintassi. Il browser non blocca niente, ma segnala ciò che avrebbe bloccato, nella console e, se lo chiedi, a un indirizzo sul tuo 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 nomina un endpoint dell'intestazione Reporting-Endpoints. Le guide più vecchie usano report-uri https://...; molti siti li inviano entrambi, e i browser che capiscono report-to ignorano report-uri. Un'introduzione sensata: invia la nuova policy come report-only per una settimana o due, correggi ciò che segnala, poi passala all'intestazione che applica le regole. Puoi inviare insieme una policy applicata e una report-only più rigida.

Nota sulla privacy: una segnalazione include l'indirizzo della pagina e l'indirizzo bloccato. Gli indirizzi delle pagine possono portare dati personali nelle loro query string, quindi invia le segnalazioni al tuo server, tienile poco tempo, e mai a un servizio di statistiche esterno.

Un equivoco comune: "report-only protegge i visitatori mentre faccio le prove". Non protegge nessuno. È uno strumento di misura. Non lasciare una policy in report-only per mesi.

In altri linguaggi
// 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));

Riepilogo

  • Un nonce è un valore nuovo e impossibile da indovinare per ogni risposta, che segna i tuoi script inline.
  • Un hash permette uno script inline esatto; qualsiasi modifica al suo testo richiede un nuovo hash.
  • 'unsafe-inline' viene ignorato quando è elencato un nonce o un hash, ed è pericoloso quando non lo è.
  • Introducila con Content-Security-Policy-Report-Only, poi applicala; tieni le segnalazioni sul tuo server.

Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione

Questo esercizio si apre presto

Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.