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 nonceEen 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 cspreport-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.
Deze browser blokkeert cookies voor learn.floati.life, dus lessen die je hier hebt afgerond kunnen niet in de juiste volgorde worden geopend. Sta cookies toe voor deze site en laad de pagina opnieuw.