Programma Les 66 van 156 · Content Security Policy en framing
Content Security Policy en framing

Nonces, hashes en report-only

Waarom dit ertoe doetBijna elke echte site heeft een paar eigen inline scripts. Als de enige manier om ze werkend te houden 'unsafe-inline' is, stopt CSP volledig met het beschermen tegen injecties. Nonces en hashes laten je scripts binnen en houden geïnjecteerde scripts buiten. Report-only mode laat je een policy inschakelen zonder iets te breken voor bezoekers op dag één.

Stel je een concert voor waar de polsband van elke avond een andere kleur heeft, wat alleen aan het personeel een uur voor de deuren openen wordt verteld. Een vervalste polsband van vorige week is nutteloos. Een nonce is de polsband van vanavond voor je inline scripts.

Nonces

Nonce: kort voor "number used once". Een nieuwe willekeurige waarde die de server maakt voor elke reactie, zet in de header als 'nonce-VALUE', en ook schrijft in elk van zijn eigen inline script tags als nonce="VALUE".

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

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

Een aanvaller die een script tag injecteert kent de waarde van dit antwoord niet, dus wordt hun script geweigerd. Drie regels zorgen ervoor dat dit zo is:

  • Unpredictable: tenminste 128 bits van een beveiligde willekeurige bron, zoals Python's secrets.token_urlsafe(16).
  • Vers elke respons: nooit een vaste waarde in een config file, en wees voorzichtig met page caches die dezelfde nonce aan iedereen zouden geven.
  • Alleen op je eigen tags: een template dat de nonce toevoegt aan elke script tag, inclusief die gebouwd uit gebruikersinput, geeft het polsbandje aan de aanvaller.

Deze site doet het met django-csp: elk inline script in de templates is geschreven als <script nonce="{{ request.csp_nonce }}">, en het pakket zet de bijbehorende waarde in de header.

Hashes

Hash bron: 'sha256-BASE64', de SHA-256 vingerafdruk van de exacte tekst binnen een script tag. Als de tekst overeenkomt, wordt het uitgevoerd. Handig voor statische pagina's waar niets een nonce per respons kan toevoegen.

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

Elk byte telt: een extra spatie of nieuwe regel geeft een andere hash. Hashes en nonces dekken alleen inline <script> blokken, niet onclick= attributen (een zelden gebruikt trefwoord, 'unsafe-hashes', kan één gehashte handler toestaan, maar het verplaatsen is schoner). Verplaats handlers naar je script met addEventListener.

Waarom 'unsafe-inline' soms wordt achtergelaten

Wanneer een nonce of hash wordt vermeld, negeren browsers die deze begrijpen ignore 'unsafe-inline'. Zeer oude browsers begrijpen geen nonces, dus ze vallen terug op 'unsafe-inline' en de site werkt daar nog steeds. Dat is waarom het beleid van floati.life beide vermeldt. Zonder een nonce of hash laat 'unsafe-inline' elk geïnjecteerd script draaien.

Eén stap verder is 'strict-dynamic': een script waar je vertrouwde met een nonce kan extra scripts laden, en browsers die dit ondersteunen negeren dan host lijsten. Het is geschikt voor grote apps die code on the fly laden. (De practice checker modelleert dit niet.)

Veilig uitrollen: report-only

Content-Security-Policy-Report-Only: een tweede header met dezelfde syntaxis. De browser blokkeert niets, maar rapporteert wat het would zou hebben geblokkeerd, in de console en, als je dat vraagt, naar een adres op je 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 noemt een endpoint uit de Reporting-Endpoints header. Oudere handleidingen gebruiken report-uri https://...; veel sites sturen beide, en browsers die report-to begrijpen negeren report-uri. Een verstandige uitrol: stuur het nieuwe beleid een week of twee als report-only, los op wat het rapporteert, en schakel het dan over naar de enforcing header. Je kunt een enforcing policy en een strengere report-only naast elkaar sturen.

Privacynotitie: een rapport bevat het paginadres en het geblokkeerde adres. Pagineadressen kunnen persoonlijke gegevens bevatten in hun query strings, dus stuur rapporten naar je eigen server, bewaar ze kort en nooit naar een externe analyticsdienst.

Een veelvoorkomende misvatting: "report-only beschermt bezoekers terwijl ik test". Het beschermt niemand. Het is een meetinstrument. Laat een policy niet maandenlang in report-only staan.

In andere talen
// 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));

Samenvatting

  • A nonce is een verse, onvoorspelbare waarde per respons die jouw eigen inline scripts markeert.
  • A hash staat één exact inline script toe; elke wijziging in de tekst heeft een nieuwe hash nodig.
  • 'unsafe-inline' wordt genegeerd wanneer een nonce of hash wordt vermeld, en is gevaarlijk wanneer er geen wordt vermeld.
  • Roll out met Content-Security-Policy-Report-Only, en dwing het daarna af; houd rapporten op je eigen server.

Een probleem ontdekt in deze les? Meld het · Vraag naar deze les

Deze oefening opent binnenkort

Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.