{"canonical_url":"https://engineer.company/fr/glossary/csp/","content_markdown":"# Content Security Policy\n\n## Ce que c'est\n\nContent Security Policy est un ensemble de règles qu'un site transmet au navigateur sur ce que ses pages peuvent exécuter, récupérer et soumettre ; le navigateur les applique pour le compte du site. Son nom est presque toujours abrégé en CSP. Le site les envoie dans un en-tête de réponse `Content-Security-Policy` ou les écrit dans la page dans un élément `meta`. Dès lors, tout script, feuille de style, image, police, cadre ou connexion que les règles n'autorisent pas est refusé avant son chargement.\n\nUne politique est une courte chaîne de directives séparées par des points-virgules. Chaque directive nomme une catégorie de ressource ou de comportement et les sources acceptées. Présentée sur plusieurs lignes pour être lisible, même si elle ne forme qu'une valeur d'en-tête sur le réseau, une politique stricte ressemble à ceci :\n\n```text\ndefault-src 'self';\nscript-src 'nonce-q8Zt3VwR1mKx7NpL2cYfJA==' 'strict-dynamic';\nobject-src 'none';\nbase-uri 'none';\nform-action 'self';\nframe-ancestors 'none'\n```\n\nLe vocabulaire est restreint. `'self'` désigne l'origine de la page. Un hôte comme `https://static.example.com` ou un schéma comme `https:` élargit cette portée. `'none'` n'autorise rien. Un nonce est une valeur aléatoire que le serveur génère pour une réponse et inscrit à la fois dans la politique et sur chaque élément script qu'il approuve. Un hachage est l'empreinte du texte exact d'un script en ligne, de sorte que ce script seul puisse s'exécuter. Deux mots-clés, `'unsafe-inline'` et `'unsafe-eval'`, désactivent à nouveau des protections, et leurs noms constituent un avertissement justifié.\n\n`default-src` sert de repli aux directives de récupération omises, comme `script-src`, `style-src`, `img-src` et `connect-src`. Il ne sert de repli qu'aux directives de récupération. Les directives qui régissent un comportement plutôt qu'une récupération, notamment `base-uri`, `form-action` et `frame-ancestors`, restent sans restriction si elles ne sont pas écrites explicitement.\n\nUne politique peut aussi fonctionner en observation. Envoyée comme `Content-Security-Policy-Report-Only`, elle ne bloque rien et signale chaque violation à un point de collecte désigné par `report-to`, via la Reporting API du navigateur. L'ancienne directive `report-uri` est dépréciée à son profit. Le texte actuel de la norme est Content Security Policy Level 3, un document de travail (Working Draft) du W3C émanant du Web Application Security Working Group.\n\n## Pourquoi c'est important\n\nCSP a été conçue contre le cross-site scripting. Quelqu'un introduit le texte de son choix dans une page, par un commentaire, un terme de recherche répété dans le HTML ou une dépendance compromise ; le navigateur l'exécute comme script avec tous les droits du code du site : lire la page, agir comme l'utilisateur connecté et envoyer ce qu'il trouve n'importe où. La première défense est l'échappement correct de la sortie, qui doit être juste dans chaque template, à chaque ligne et chaque fois. CSP est la seconde défense. Lorsqu'une erreur d'échappement passe tout de même, le script injecté doit encore franchir la politique ; une politique qui n'exécute que les scripts portant le nonce de cette réponse le refuse.\n\nElle limite aussi ce qu'un script effectivement exécuté peut atteindre. `connect-src` décide avec quels hôtes il peut communiquer et restreint les destinations vers lesquelles un script de vol de données peut envoyer ce qu'il collecte. `frame-ancestors` décide quels sites peuvent afficher la page dans un cadre ; c'est la défense standard contre le détournement de clic, où une page en recouvre une autre pour que le clic atteigne un endroit non voulu par l'utilisateur. `form-action` décide où les formulaires peuvent envoyer leurs données, et `base-uri` empêche un élément `base` injecté de rediriger discrètement toutes les adresses relatives de la page.\n\nIl faut préciser qui CSP protège. Cette politique s'applique dans le navigateur et protège donc la personne qui lit la page contre le contenu qu'un attaquant y a placé. Elle ne protège en rien le serveur contre cette même personne, qui peut modifier ou enlever l'en-tête dans son navigateur en quelques secondes. Une politique justifie de moins faire confiance à la page, jamais de davantage faire confiance à la requête.\n\nLe coût est surtout celui de l'inventaire. Une politique oblige l'équipe à connaître chaque origine à partir de laquelle ses pages chargent des ressources, chaque script en ligne et chaque gestionnaire d'événement écrit dans un attribut. Un nouveau site peut suivre une politique stricte dès son premier commit pour très peu de travail. Un site ancien avec des gestionnaires en ligne, un gestionnaire de balises et plusieurs widgets doit d'abord faire le nettoyage, qui constitue généralement le véritable projet.\n\n## À quoi cela ressemble en pratique\n\nCe site s'en impose une. La [page de sécurité](/fr/security/) énumère une Content Security Policy stricte, déclarée dans la page, avec `form-action 'none'`, car le site n'envoie aucun formulaire nulle part. Chaque page HTML déclare `script-src 'none'` : aucun JavaScript exécutable ni service worker ne tourne. Le site ne fait aucune requête tierce ; tout ce dont une page a besoin vient de son propre hôte, ce qui laisse très peu de choses à autoriser.\n\nUne application avec des utilisateurs connectés demande plus qu'une courte liste d'autorisation. Sur une plateforme contenant des données professionnelles et organisationnelles,\n[le middleware proxy Next.js définit une Content-Security-Policy avec un nonce par requête et `strict-dynamic`](/fr/portfolio/hardened-the-application-with-nonce-based-csp/),\naux côtés de HSTS et de cookies SameSite. Un nonce neuf à chaque réponse signifie que seuls les éléments script marqués par le serveur pour cette réponse pourront s'exécuter. Avec `strict-dynamic`, un script approuvé par le nonce peut charger lui-même d'autres scripts ; la politique n'a donc pas à nommer chaque hôte d'où un bundle récupère ses fragments. Cette plateforme suppose le client hostile. Les droits de chaque requête sont donc revérifiés sur le serveur, et les contrôles du frontend ne comptent que pour l'expérience utilisateur. CSP y est une couche parmi plusieurs, qui protège les utilisateurs du code injecté ; l'autorisation se décide ailleurs.\n\n## Où les problèmes surviennent\n\n**La politique est activée et la moitié du site cesse de fonctionner.** Une politique stricte appliquée directement bloque le script en ligne oublié et la balise de suivi ajoutée deux ans plus tôt. Livrez d'abord `Content-Security-Policy-Report-Only`, lisez les rapports jusqu'à stabilisation, autorisez ou retirez chaque source nommée, puis seulement appliquez les blocages. L'en-tête du mode observation doit être un véritable en-tête HTTP : la spécification ne le prend pas en charge dans un élément `meta`.\n\n**La liste d'autorisation fait confiance à un hôte entier.** `script-src https://cdn.example.com` autorise tous ses fichiers, y compris les anciennes versions de bibliothèques et les points d'accès qui renvoient une entrée de l'appelant sous forme de script. La spécification dit elle-même qu'une politique efficace contre le cross-site scripting est difficile à déployer et recommande ce qu'elle appelle une Strict CSP : `script-src` fondé sur des nonces ou des hachages avec `'strict-dynamic'`, ainsi que `base-uri` fixé à `'self'` ou `'none'`.\n\n**On suppose que `'unsafe-inline'` autorise tous les scripts en ligne.** Dès qu'un nonce ou un hachage figure dans la même liste de sources, les navigateurs qui les comprennent ignorent `'unsafe-inline'`. Cela permet de conserver `'unsafe-inline'` en repli pour les navigateurs trop anciens pour connaître les nonces, tandis que les navigateurs actuels appliquent la liste stricte. Une équipe qui ajoute un nonce à un seul script peut donc être surprise de voir les autres scripts en ligne bloqués.\n\n**Le nonce cesse d'être secret.** La spécification exige une nouvelle valeur à chaque envoi de politique et recommande au moins 128 bits issus d'un générateur cryptographiquement sûr. Un nonce codé en dur dans un template, ou une page entière avec son nonce conservée dans un cache partagé et servie à tous, donne à l'attaquant la valeur nécessaire pour marquer son propre script.\n\n**Une politique dans un élément `meta` en fait moins que la même politique en en-tête.** Le navigateur ignore `frame-ancestors`, `report-uri` et `sandbox` lorsqu'ils arrivent ainsi, et la politique ne régit que ce qui suit cet élément dans le document ; tout ce qui le précède dans la section head se charge sans contrôle. Un site qui ne maîtrise pas ses en-têtes bénéficie tout de même d'une véritable protection grâce à une politique `meta`, placée aussi tôt que possible dans la section head, mais la protection contre l'intégration dans des cadres exige l'en-tête.\n\n**Une seconde politique durcit au lieu d'assouplir.** Une réponse peut porter plusieurs politiques, venant d'un framework, d'un proxy et d'un CDN ; une ressource doit toutes les satisfaire. Ajouter une politique ne peut que restreindre ; un en-tête permissif ajouté en aval pour réparer une requête bloquée ne change donc rien. Il faut corriger la politique à l'origine du blocage.\n\n## Pour aller plus loin\n\n- [Content Security Policy Level 3](https://www.w3.org/TR/CSP3/) — la norme elle-même, avec la recommandation Strict CSP et une section sur le vol des nonces.\n- [Norme HTML : l'élément meta](https://html.spec.whatwg.org/multipage/semantics.html) — le pragma appliquant une politique déclarée dans la page, les directives qu'il ignore et les raisons pour lesquelles des ressources récupérées avant lui peuvent échapper à la politique.\n- [Reporting API](https://www.w3.org/TR/reporting-1/) — le mécanisme de point de collecte derrière `report-to`, pour lire les violations avant d'appliquer les blocages.\n- [Trusted Types](https://www.w3.org/TR/trusted-types/) — la norme complémentaire activée par `require-trusted-types-for`, visant les scripts injectés par le DOM.\n\n\u003chttps://engineer.company/fr/glossary/csp/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Comment CSP bloque les scripts injectés, comment déployer une politique sans casser le site et quelles erreurs la rendent discrètement inefficace.","formats":{"gemtext":"https://engineer.company/fr/glossary/csp/index.gmi","gopher":"https://engineer.company/fr/glossary/csp/gophermap","html":"https://engineer.company/fr/glossary/csp/","json":"https://engineer.company/fr/glossary/csp/index.json","markdown":"https://engineer.company/fr/glossary/csp/index.md","pdf":"https://engineer.company/fr/glossary/csp/index.pdf"},"kind":"page","language":"fr","title":"Qu'est-ce qu'une Content Security Policy ?","url":"https://engineer.company/fr/glossary/csp/","version":1}