Programme Leçon 66 sur 156 · La Content Security Policy et l'intégration en frame
La Content Security Policy et l'intégration en frame

Nonces, hashes et report-only

Pourquoi c'est important Presque chaque vrai site a quelques scripts en ligne à lui. Si le seul moyen de les garder fonctionnels est 'unsafe-inline', la CSP cesse complètement de protéger contre l'injection. Les nonces et les hashes laissent entrer tes scripts et gardent dehors ceux qui sont injectés. Le mode report-only te permet d'activer une politique sans rien casser pour les visiteurs dès le premier jour.

Imagine un concert où le bracelet de chaque soir a une couleur différente, annoncée seulement au personnel une heure avant l'ouverture des portes. Un faux bracelet de la semaine dernière ne sert à rien. Un nonce, c'est le bracelet de ce soir pour tes scripts en ligne.

Les nonces

Nonce : abréviation de « number used once » (nombre utilisé une fois). Une valeur aléatoire neuve que le serveur crée pour chaque réponse, met dans l'en-tête sous la forme 'nonce-VALUE', et écrit aussi dans chacune de ses propres balises de script en ligne sous la forme nonce="VALUE".

Content-Security-Policy: script-src 'self' 'nonce-4fT9qLx2Zb8wRk1e'

<script nonce="4fT9qLx2Zb8wRk1e">startShop();</script>      runs
<script>sendCookies();</script>                          blocked: no nonce

Un attaquant qui injecte une balise de script ne connaît pas la valeur de cette réponse, donc son script est refusé. Trois règles rendent ça vrai :

  • Imprévisible : au moins 128 bits d'une source aléatoire sûre, comme secrets.token_urlsafe(16) en Python.
  • Neuf à chaque réponse : jamais une valeur fixe dans un fichier de configuration, et attention aux caches de pages qui serviraient le même nonce à tout le monde.
  • Seulement sur tes propres balises : un template qui ajoute le nonce à n'importe quelle balise de script, y compris celles construites à partir de saisies d'utilisateurs, donne le bracelet à l'attaquant.

Ce site le fait avec django-csp : chaque script en ligne des templates est écrit <script nonce="{{ request.csp_nonce }}">, et le paquet met la valeur correspondante dans l'en-tête.

Les hashes

Source par hash : 'sha256-BASE64', l'empreinte SHA-256 du texte exact à l'intérieur d'une balise de script. Si le texte correspond, il s'exécute. Utile pour les pages statiques où rien ne peut ajouter un nonce par réponse.

import base64, hashlib
code = "startShop();"          # exactly what is between the tags
print("'sha256-" + base64.b64encode(hashlib.sha256(code.encode()).digest()).decode() + "'")

Chaque octet compte : une espace ou un saut de ligne en plus donne un hash différent. Les hashes et les nonces ne couvrent que les blocs <script> en ligne, pas les attributs onclick= (un mot-clé rarement utilisé, 'unsafe-hashes', peut autoriser un gestionnaire haché, mais le déplacer est plus propre). Déplace les gestionnaires dans ton script avec addEventListener.

Pourquoi 'unsafe-inline' est parfois laissé

Quand un nonce ou un hash est listé, les navigateurs qui les comprennent ignorent 'unsafe-inline'. Les très vieux navigateurs ne comprennent pas les nonces, donc ils se replient sur 'unsafe-inline' et le site marche encore chez eux. C'est pourquoi la politique de floati.life liste les deux. Sans nonce ni hash, en revanche, 'unsafe-inline' laisse s'exécuter chaque script injecté.

Un cran plus loin, il y a 'strict-dynamic' : un script que tu as autorisé avec un nonce peut charger d'autres scripts, et les navigateurs qui le prennent en charge ignorent alors les listes d'hôtes. Ça convient aux grosses applis qui chargent du code à la volée. (Le correcteur d'entraînement ne le modélise pas.)

Déployer sans risque : report-only

Content-Security-Policy-Report-Only : un second en-tête avec la même syntaxe. Le navigateur ne bloque rien, mais signale ce qu'il aurait bloqué, dans la console et, si tu le demandes, à une adresse sur ton serveur.

Reporting-Endpoints: csp="https://shopd.example/csp-reports"
Content-Security-Policy-Report-Only: default-src 'self'; script-src 'self' 'nonce-...'; report-to csp

report-to nomme un point de collecte de l'en-tête Reporting-Endpoints. Les guides plus anciens utilisent report-uri https://... ; beaucoup de sites envoient les deux, et les navigateurs qui comprennent report-to ignorent report-uri. Un déploiement raisonnable : envoie la nouvelle politique en report-only pendant une semaine ou deux, corrige ce qu'elle signale, puis passe-la sur l'en-tête qui l'applique. Tu peux envoyer côte à côte une politique appliquée et une politique report-only plus stricte.

Note de vie privée : un rapport contient l'adresse de la page et l'adresse bloquée. Les adresses de page peuvent porter des données personnelles dans leurs chaînes de requête, donc envoie les rapports à ton propre serveur, garde-les peu de temps, et jamais à un service de statistiques extérieur.

Une idée reçue : « le report-only protège les visiteurs pendant que je teste ». Il ne protège personne. C'est un outil de mesure. Ne laisse pas une politique en report-only pendant des mois.

Dans d'autres langages
// JavaScript (Node)
const nonce = require("crypto").randomBytes(16).toString("base64");
// Go
b := make([]byte, 16); rand.Read(b)   // crypto/rand
nonce := base64.StdEncoding.EncodeToString(b)
// PHP
$nonce = base64_encode(random_bytes(16));

Récap

  • Un nonce est une valeur neuve et impossible à deviner, par réponse, qui marque tes propres scripts en ligne.
  • Un hash autorise un script en ligne exact ; tout changement de son texte demande un nouveau hash.
  • 'unsafe-inline' est ignoré quand un nonce ou un hash est listé, et dangereux quand il n'y en a pas.
  • Déploie avec Content-Security-Policy-Report-Only, puis applique ; garde les rapports sur ton propre serveur.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.