CKTIS / HTML
Atribút nonce
Atribút nonce obsahuje textovú kryptografickú hodnotu používanú zásadami Content Security Policy (CSP). Vlastnosť element.nonce ju sprístupňuje skriptom, aj keď prehliadač hodnotu atribútu skryje.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
nonce="value"; element.nonce; element.nonce = valuenonce označuje kryptografickú hodnotu použitú raz, ktorú môžu zásady Content Security Policy (CSP) využiť pri rozhodovaní, či povoliť načítanie zdroja. Samotný atribút bezpečnostnú politiku nedefinuje.
Rozlišujte medzi atribútom HTML nonce a vlastnosťou DOM element.nonce. Nastavenie atribútu aktualizuje internú hodnotu [[CryptographicNonce]]. Prečítanie vlastnosti túto hodnotu vráti, priradenie hodnoty vlastnosti však atribút neaktualizuje.
Keď sa prvok pripojí ku kontextu prehliadania a zoznam CSP obsahuje politiku doručenú v hlavičke HTTP, prehliadač vyprázdni jeho neprázdny atribút a zároveň zachová internú hodnotu nonce. Tým obmedzuje úniky cez selektory CSS; skripty môžu element.nonce naďalej čítať. getAttribute('nonce') preto nie je spoľahlivý spôsob, ako prečítať aktuálnu hodnotu nonce.
Príklad ukazuje rozdiel medzi atribútom a vlastnosťou na odpojenom prvku. Pevné hodnoty slúžia iba na ukážku, nie na zabezpečenie obsahu.
Príklady
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'));Výsledok
demo-only changed-demo-only demo-only
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.