CKTIS / HTML
Atribut nonce
Atribut nonce obsahuje textovou kryptografickou hodnotu používanou zásadami Content Security Policy (CSP). Vlastnost element.nonce ji zpřístupňuje skriptům, i když prohlížeč hodnotu atributu skryje.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
nonce="value"; element.nonce; element.nonce = valuenonce označuje kryptografickou hodnotu použitou jednou, kterou mohou zásady Content Security Policy (CSP) využít při rozhodování, zda povolit načtení prostředku. Samotný atribut bezpečnostní zásady nedefinuje.
Rozlišujte mezi atributem HTML nonce a vlastností DOM element.nonce. Nastavení atributu aktualizuje interní hodnotu [[CryptographicNonce]]. Přečtení vlastnosti tuto hodnotu vrátí, přiřazení hodnoty vlastnosti však atribut neaktualizuje.
Když se prvek připojí ke kontextu prohlížení a seznam CSP obsahuje zásadu předanou v hlavičce HTTP, prohlížeč vyprázdní jeho neprázdný atribut a zachová přitom interní hodnotu nonce. Tím omezuje úniky přes selektory CSS; skripty mohou element.nonce stále číst. getAttribute('nonce') proto není spolehlivý způsob, jak přečíst aktuální hodnotu nonce.
Příklad ukazuje rozdíl mezi atributem a vlastností na odpojeném prvku. Pevné hodnoty slouží pouze k demonstraci, nikoli k zabezpečení obsahu.
Pří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ýsledek
demo-only changed-demo-only demo-only
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.