CKTIS / HTML
Het nonce-attribuut
Het nonce-attribuut bevat een tekstuele cryptografische waarde die wordt gebruikt door Content Security Policy (CSP). De eigenschap element.nonce maakt deze beschikbaar voor scripts, ook wanneer de browser de attribuutwaarde verbergt.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
nonce="value"; element.nonce; element.nonce = valuenonce staat voor een cryptografische waarde die één keer wordt gebruikt en die Content Security Policy (CSP) kan gebruiken om te beslissen of een resource mag worden opgehaald. Het attribuut alleen definieert geen beveiligingsbeleid.
Maak onderscheid tussen het HTML-attribuut nonce en de DOM-eigenschap element.nonce. Als je het attribuut instelt, wordt de interne waarde [[CryptographicNonce]] bijgewerkt. De eigenschap uitlezen geeft die waarde terug, maar een waarde toewijzen aan de eigenschap werkt het attribuut niet bij.
Wanneer een element verbonden raakt met een browsecontext en de CSP-lijst een via een HTTP-header geleverde policy bevat, maakt de browser het niet-lege attribuut leeg en behoudt daarbij de interne nonce-waarde. Dit beperkt lekken via CSS-selectors; scripts kunnen element.nonce nog steeds uitlezen. Daarom is getAttribute('nonce') geen betrouwbare manier om de huidige nonce-waarde uit te lezen.
Het voorbeeld laat het verschil tussen attribuut en eigenschap zien bij een niet-verbonden element. De vaste waarden zijn alleen bedoeld ter demonstratie, niet om inhoud te beveiligen.
Voorbeelden
const element = document.createElement('script');
element.setAttribute('nonce', 'demo-only');
console.log(element.nonce);
element.nonce = 'changed-demo-only';
console.log(element.nonce);
console.log(element.getAttribute('nonce'));Resultaat
demo-only changed-demo-only demo-only
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.