WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 = value

nonce 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.

Quellen