CSP : script-src
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since August 2016.
La directive HTTP Content-Security-Policy
script-src
spécifie les sources valides pour du code JavaScript. Cela inclut les URL chargées directement par les éléments <script>
, et aussi les scripts embarqués, les attributs de gestion d'évènements (par exemple onclick
) et les feuilles de style XSLT pouvant déclencher l'exécution de scripts.
Version de CSP | 1 |
---|---|
Type de directive | Directive de récupération |
Utilisation de default-src par défaut |
Oui, si cette directive est absente, l'agent utilisateur consultera la directive default-src . |
Syntaxe
Une ou plusieurs sources peuvent être autorisées pour cette directive :
Content-Security-Policy: script-src <source>;
Content-Security-Policy: script-src <source> <source>;
Sources
<source>
peut être n'importe quelle valeur parmi celles énumérées dans l'article sur les valeurs sources CSP.
On notera que cet ensemble de valeurs peut être utilisé pour toutes les directives de récupération (et pour certaines autres directives).
Exemples
Cas de violation
Soit cet en-tête CSP :
Content-Security-Policy: script-src https://example.com/
Ces scripts seront bloqués et ne seront pas chargés ou exécutés :
<script src="https://not-example.com/js/bibliotheque.js"></script>
On notera que les gestionnaires d'évènements déclarés dans les attributs sont aussi bloqués :
<button id="btn" onclick="faireQuelqueChose()"></button>
Il faudra les remplacer par des appels à la méthode addEventListener()
:
document.getElementById("btn").addEventListener("click", faireQuelqueChose);
Scripts embarqués non fiables
Note : Bloquer les styles et scripts embarqués est l'une des stratégies de sécurité principales que CSP propose. Toutefois, si vous en avez absolument besoin, il existe des mécanismes qui vous permettront de les autoriser.
Vous pouvez autoriser les scripts embarqués et les gestionnaires d'évènements par attributs en spécifiant la valeur 'unsafe-inline'
, des nonces ou des empreintes correspondant au script.
Content-Security-Policy: script-src 'unsafe-inline';
Cette directive CSP autorisera tous les scripts <script>
embarqués à même le HTML :
<script>
var inline = 1;
</script>
Vous pouvez aussi utiliser un nonce pour autoriser spécifiquement certains éléments <script>
contenus à même le document HTML :
Content-Security-Policy: script-src 'nonce-2726c7f26c'
Ce nonce doit alors être utilisé sur l'élément <script>
:
<script nonce="2726c7f26c">
var inline = 1;
</script>
Autrement, vous pouvez créer des empreintes à partir de vos scripts. CSP accepte les algorithmes sha256, sha384 et sha512.
Content-Security-Policy: script-src 'sha256-B2yPHKaXnvFWtRChIbabYmUBFZdVfKKXHbWtWidDVF8='
Lors de la génération de l'empreinte, vous ne devez pas inclure les balises et tenir compte de la casse et des caractères blancs (espaces, retours à la ligne, etc.).
<script>
var inline = 1;
</script>
unsafe-eval
La valeur 'unsafe-eval'
contrôle différents méthodes qui créent du code JavaScript à partir de chaines de caractères. Si 'unsafe-eval'
n'est pas spécifiée avec la directive script-src
, ces méthodes seront bloquées et n'auront aucun effet :
-
En passant une chaine à des méthodes tel que :
window.setTimeout("alert('Coucou le monde');", 500);
-
window.execScript()
Non-standard (IE10 et versions précédentes)
strict-dynamic
La valeur 'strict-dynamic'
indique que la confiance explicitement donnée à un script de la page, par le biais d'un nonce ou d'une empreinte, doit être propagée à tous les scripts chargés par celui-ci. Par conséquent, toute liste de permissions ou expressions de sources telles que 'self'
ou 'unsafe-inline'
sera ignorée. Par exemple, une règle telle que script-src 'strict-dynamic' 'nonce-R4nd0m' https://whitelisted.com/
autoriserait le chargement de scripts comme <script nonce="R4nd0m" src="https://example.com/loader.js">
et s'appliquerait ensuite à tous les scripts chargés par loader.js
, mais interdirait les scripts chargés depuis https://allowlisted.example.com/
à moins qu'ils soient accompagnés d'un nonce ou chargés depuis un script dont la source est de confiance.
Content-Security-Policy: script-src 'strict-dynamic' 'nonce-someNonce'
Ou :
Content-Security-Policy: script-src 'strict-dynamic' 'sha256-base64EncodedHash'
Il est possible de déployer strict-dynamic
de manière rétrocompatible, sans chercher à connaitre l'agent utilisateur. Cette directive :
Content-Security-Policy: script-src 'unsafe-inline' https: 'nonce-abcdefg' 'strict-dynamic'
fonctionnera comme 'unsafe-inline' https:
pour les navigateurs prenant en charge CSP1, https: 'nonce-abcdefg'
pour ceux prenant en charge CSP2 et comme 'nonce-abcdefg' 'strict-dynamic'
pour ceux prenant en charge CSP3.
Spécifications
Specification |
---|
Content Security Policy Level 3 # directive-script-src |
Compatibilité des navigateurs
BCD tables only load in the browser