Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

L’attribut nonce

L’attribut nonce contient une valeur textuelle cryptographique utilisée par la Content Security Policy (CSP). La propriété element.nonce la rend accessible aux scripts, même lorsque le navigateur masque la valeur de l’attribut.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

nonce="value"; element.nonce; element.nonce = value

nonce désigne une valeur cryptographique à usage unique que la Content Security Policy (CSP) peut utiliser pour décider si elle autorise le chargement d’une ressource. L’attribut, à lui seul, ne définit pas de politique de sécurité.

Il faut distinguer l’attribut HTML nonce de la propriété DOM element.nonce. Définir l’attribut met à jour la valeur interne [[CryptographicNonce]]. Lire la propriété renvoie cette valeur, mais lui affecter une valeur ne met pas à jour l’attribut.

Lorsqu’un élément est connecté à un contexte de navigation et que la liste CSP contient une politique transmise dans un en-tête HTTP, le navigateur vide son attribut non vide tout en préservant la valeur interne du nonce. Cela limite les fuites par les sélecteurs CSS ; les scripts peuvent toujours lire element.nonce. Par conséquent, getAttribute('nonce') ne permet pas de lire de manière fiable la valeur actuelle du nonce.

L’exemple montre la différence entre l’attribut et la propriété sur un élément détaché. Les valeurs fixes servent uniquement à la démonstration, et non à sécuriser du contenu.

Exemples

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'));

Résultat

demo-only
changed-demo-only
demo-only

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources