CKTIS / HTML
Das nonce-Attribut
Das nonce-Attribut enthält einen kryptografischen Textwert, der von der Content Security Policy (CSP) verwendet wird. Die Eigenschaft element.nonce stellt ihn Skripten auch dann bereit, wenn der Browser den Attributwert verbirgt.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
nonce="value"; element.nonce; element.nonce = valuenonce steht für einen kryptografischen Einmalwert, den die Content Security Policy (CSP) bei der Entscheidung verwenden kann, ob ein Ressourcenabruf zugelassen wird. Das Attribut allein legt keine Sicherheitsrichtlinie fest.
Unterscheide zwischen dem HTML-Attribut nonce und der DOM-Eigenschaft element.nonce. Das Setzen des Attributs aktualisiert den internen Wert [[CryptographicNonce]]. Das Auslesen der Eigenschaft gibt diesen Wert zurück, eine Zuweisung an die Eigenschaft aktualisiert jedoch nicht das Attribut.
Sobald ein Element mit einem Browsing-Kontext verbunden wird und die CSP-Liste eine über einen HTTP-Header übermittelte Richtlinie enthält, leert der Browser sein nicht leeres Attribut und bewahrt dabei den internen Nonce-Wert. Das begrenzt das Auslesen über CSS-Selektoren; Skripte können element.nonce weiterhin lesen. Deshalb ist getAttribute('nonce') keine zuverlässige Methode, um den aktuellen Nonce-Wert auszulesen.
Das Beispiel zeigt den Unterschied zwischen Attribut und Eigenschaft an einem nicht verbundenen Element. Die festen Werte dienen nur der Demonstration und nicht dazu, Inhalte zu schützen.
Beispiele
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'));Ergebnis
demo-only changed-demo-only demo-only
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.