Politique de Sécurité du Contenu (CSP) : Comment Vérifier, Corriger et Configurer sur Votre Site Web
Apprenez à vérifier, ajouter et corriger les en-têtes de Politique de Sécurité du Contenu sur Apache, Nginx, WordPress et Joomla, avec des outils de diagnostic pratiques et des conseils d'hébergement.
Politique de sécurité du contenu (CSP) : comment la vérifier, la corriger et la configurer sur votre site web
HTTPS et les mises à jour logicielles sont essentiels, mais ils ne suffisent pas à empêcher l’exécution de tous les scripts malveillants dans le navigateur d’un visiteur. La politique de sécurité du contenu (CSP) impose des restrictions au niveau du navigateur sur les ressources qu’une page peut charger et exécuter. Elle contribue à atténuer certaines attaques de type cross-site scripting (XSS), mais ne remplace pas l’échappement du code en sortie, la validation des entrées ou les mises à jour des dépendances.
Ce tutoriel pratique explique comment inspecter votre politique actuelle, en trouver l’origine, apporter des modifications en toute sécurité et résoudre les problèmes sur Apache, Nginx, WordPress et Joomla.
1. Vérifiez votre CSP existante
Chrome ou Firefox : Ouvrez la page, appuyez sur F12, sélectionnez Réseau, rechargez, cliquez sur le document HTML et inspectez Les en-têtes de réponse. Recherchez Content-Security-Policy (applicable) ou Content-Security-Policy-Report-Only (diagnostic uniquement). Vérifiez la console pour détecter les violations.
Ligne de commande : Exécutez curl -I https://example.com/. Sur macOS/Linux, filtrez la réponse avec curl -sSI https://example.com/ | grep -i content-security-policy. Les réponses HEAD peuvent différer des réponses GET ; utilisez donc les outils de développement du navigateur pour confirmer.
Outils en ligne : SecurityHeaders.com vérifie les en-têtes de sécurité ; Google CSP Evaluator signale les faiblesses d’une politique. Aucun de ces outils ne prouve que l’ensemble du site web est sécurisé.
L’absence d’en-tête CSP dans une réponse ne signifie pas que toutes les pages en manquent. Inspectez également tout tag <meta http-equiv="Content-Security-Policy"> : les politiques méta ont des limitations, notamment l’absence de support pour frame-ancestors ou Report-Only.
2. Trouvez où la politique est définie
| Environnement | Emplacement probable |
|---|---|
| Apache / compatible LiteSpeed | .htaccess, configuration du hôte virtuel ou du serveur |
| Nginx | CONFIGURATION server / location |
| PHP | Code d’application utilisant header() |
| WordPress | Plugin, code personnalisé, proxy inverse ou hôte |
| Joomla | Plugin System – HTTP Headers, serveur ou proxy |
| Cloudflare | Règles de transformation des en-têtes de réponse |
| Hébergement géré | Panneau d’hébergement ou configuration gérée par le fournisseur |
Inspectez les en-têtes de réponse existants avant d’en ajouter un nouveau. Les navigateurs appliquent plusieurs politiques CSP de manière cumulative ; un nouvel en-tête permissif ne remplace pas un en-tête restrictif existant. Vérifiez également les règles du CDN et de l’hébergement.
3. Ajouter CSP dans Apache en utilisant .htaccess
En utilisant le gestionnaire de fichiers de votre hébergeur ou SFTP (FileZilla/WinSCP), localisez le répertoire public contenant index.php, souvent public_html ou httpdocs. Activez les fichiers cachés pour voir .htaccess. Téléchargez une sauvegarde et évitez de placer des règles personnalisées dans un bloc de réécriture géré par le CMS.
Si mod_headers d’Apache est activé et que l’hébergeur autorise ces directives, ajoutez :
<IfModule mod_headers.c>
Header always set Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'"
</IfModule>
Rechargez et vérifiez l’en-tête sous Réseau → En-têtes. Vérifiez la console pour détecter les violations. Report-Only signale des restrictions potentielles mais ne bloque pas les ressources. Cet exemple est diagnostique, et non une politique de déploiement complète.
Si un script CDN de confiance est signalé, confirmez d’abord son objectif et sa propriété. Vous pourriez adapter la directive à script-src 'self' https://cdn.example.com ; n’ajoutez pas aveuglément chaque hôte bloqué. Les listes blanches d’hôtes sont moins robustes contre les attaques XSS que les politiques de nonce/hash bien conçues.
Après avoir testé la connexion, les formulaires, le processus de paiement, les éditeurs et d’autres workflows, vous pouvez remplacer Content-Security-Policy-Report-Only par Content-Security-Policy pour appliquer votre politique testée. Si le site se casse, restaurez le fichier sauvegardé, videz les caches du serveur/CDN et retestez. Un code HTTP 500 après modification suggère un problème de syntaxe ou de permissions du serveur.

4. Configurer CSP sur Nginx
Nginx ignore .htaccess. Si vous administrez le serveur, inspectez sa configuration active (souvent /etc/nginx/sites-available/ ou /etc/nginx/conf.d/). Dans le bloc server pertinent, utilisez :
add_header Content-Security-Policy-Report-Only "default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'" always;
Testez avec sudo nginx -t, puis rechargez avec sudo systemctl reload nginx. Surveillez l’héritage de add_header et les règles dans des emplacements plus spécifiques. Sur un hébergement géré sans accès à la configuration Nginx, utilisez le panneau de contrôle du fournisseur ou son support.
5. WordPress : plugin ou petite intégration personnalisée
Solution sans code : Vérifiez d’abord si votre hébergeur ou un plugin de sécurité d’en-tête existant envoie déjà CSP. Choisissez un plugin maintenu qui supporte explicitement CSP et de préférence Report-Only ; ne supposez pas qu’un plugin de sécurité général supporte l’un ou l’autre. Dans ses paramètres, activez Report-Only, commencez par une politique de diagnostic conservatrice, enregistrez et testez à la fois les pages publiques et wp-admin avant l’application.
Solution pour développeurs : Créez wp-content/plugins/ceikay-csp/ceikay-csp.php :
<?php
/**
* Plugin Name: CeiKay CSP Example
* Description: CSP diagnostics on the WordPress frontend.
*/
add_action('send_headers', function () {
if (is_admin()) {
return;
}
header(
"Content-Security-Policy-Report-Only: "
. "default-src 'self'; "
. "script-src 'self'; "
. "object-src 'none'; "
. "base-uri 'self'"
);
});
Activez-le dans Plugins → Plugins installés, puis confirmez l’en-tête de réponse. Cela ne remplace pas un CSP existant provenant du serveur web, du CDN ou d’un autre plugin. Il exclut délibérément wp-admin et ne fournit pas une politique entièrement appliquée.
Dépannage : Si un CAPTCHA échoue, inspectez les requêtes script-src, frame-src et connect-src bloquées et consultez les instructions d’intégration du fournisseur de CAPTCHA. Si un générateur de page signale des scripts en ligne bloqués, vérifiez le support pour les nonces ou les hachages CSP. N’ajoutez pas automatiquement 'unsafe-inline'. Pour les nonces par réponse, assurez-vous que la mise en cache de page complète ne réutilise pas le même nonce et le même HTML pour différents visiteurs.
6. Joomla : utiliser le plugin natif des en-têtes HTTP
Dans l’administration de Joomla, ouvrez Système → Plugins, recherchez En-têtes HTTP et ouvrez System – HTTP Headers. Le libellé exact du menu varie selon la version et la langue de Joomla.
Activez ses options CSP et commencez par Report-Only sur le site public. Commencez par diagnostiquer une directive telle que script-src 'self' ; enregistrez et inspectez la console. Testez les modèles, les générateurs de pages, les éditeurs, les formulaires de contact, les CAPTCHAS, les intégrations de paiement et les fonctionnalités multimédias.
Si vous voyez Refused to execute inline script, identifiez quel modèle ou extension le génère. Préférez une approche compatible avec les nonces ou les hachages lorsque cela est supporté ; validez que le script est légitime avant de l’autoriser. Testez l’administrateur séparément du frontend. Si le serveur définit déjà CSP, réconciliez les configurations plutôt que de superposer des politiques conflictuelles.
Consultez la documentation Joomla sur les en-têtes HTTP pour les options supportées par votre version installée.
7. Corriger la violation réelle, et non l’ensemble de la politique
| Violation | Ce qu’il faut investiguer | Correction typique |
|---|---|---|
script-src |
JavaScript externe ou en ligne | Vérifiez la source ; utilisez un nonce/hash approprié ou une source étroitement délimitée |
style-src |
Feuille de style ou CSS en ligne | Inspectez les styles générés ; utilisez une source approuvée ou un hachage/nonce compatible |
img-src |
Image externe ou URL de données | Autorisez un hôte d’image vérifié uniquement si nécessaire |
connect-src |
fetch/XHR/WebSocket | Vérifiez l’origine de l’API et ajoutez une autorisation étroitement délimitée |
frame-src |
Vidéo intégrée/CAPTCHA/fenêtre de paiement | Suivez les domaines documentés par le fournisseur |
form-action |
Cible de soumission de formulaire | Autorisez une origine de soumission légitime |
frame-ancestors |
Autre site intégrant votre page | Autorisez explicitement les origines parentes prévues, ou utilisez 'none' |
Par exemple, si une image légitime à https://images.example.com/photo.webp est bloquée par img-src 'self', modifiez la directive pertinente en img-src 'self' https://images.example.com après avoir confirmé que l’hôte est fiable. Ne rendez pas default-src moins sécurisé simplement pour corriger une image.

Certaines directives, notamment frame-ancestors et form-action, ne reviennent pas à default-src. Incluez-les explicitement lorsque nécessaire.
8. L’hébergement affecte-t-il la configuration de CSP ?
Oui—la norme CSP du navigateur reste la même, mais votre contrôle sur les en-têtes de réponse change. L’hébergement partagé Apache peut exposer .htaccess ; un Nginx géré peut nécessiter un panneau de contrôle fournisseur ; les administrateurs de VPS peuvent modifier la configuration du serveur ; et les CDN peuvent ajouter des en-têtes après que l’application a généré la réponse.
Avant de choisir un service d’hébergement, demandez : Puis-je définir et supprimer des en-têtes CSP sans accès root ? Puis-je utiliser Report-Only ? Puis-je inspecter la réponse finale ? Des en-têtes personnalisés sont-ils disponibles dans mon plan ? Le support peut-il expliquer les conflits avec les règles du CDN ou de l’application ?
Cloudways : contrôles des en-têtes HTTP au niveau de l’hébergement
Cloudways documente Règles web → Règles d’en-têtes pour gérer les en-têtes de réponse HTTP, y compris CSP. Cela offre une alternative au niveau de l’hébergement à l’édition de fichiers d’application, sous réserve des fonctionnalités disponibles pour votre application et votre plan. Cela ne crée pas automatiquement un CSP sécurisé ; vous devez toujours tester et maintenir vos directives.
9. Protection plus forte avec CSP basée sur les nonces
Un CSP strict utilise des nonces ou des hachages imprévisibles plutôt que de s’appuyer uniquement sur des listes blanches de domaines. Un exemple simplifié en PHP :
<?php
$nonce = base64_encode(random_bytes(16));
header(
"Content-Security-Policy: "
. "script-src 'nonce-{$nonce}' 'strict-dynamic'; "
. "object-src 'none'; "
. "base-uri 'none'"
);
Dans le modèle HTML :
<script nonce="<?= htmlspecialchars($nonce, ENT_QUOTES, 'UTF-8') ?>">
console.log('Trusted script');
</script>
Générez un nonce imprévisible nouveau pour chaque réponse. Gardez le nonce de l’en-tête et du HTML cohérents, et planifiez autour des proxies inverses et des caches de pages complètes. Avec 'strict-dynamic', un script de confiance peut charger d’autres scripts, surveillez donc attentivement les chargeurs de confiance. Il s’agit d’une illustration, et non d’une politique complète à intégrer pour toutes les applications.
10. Liste de contrôle pour le déploiement final
- Identifiez tous les en-têtes CSP existants et les politiques méta.
- Sauvegardez la configuration du serveur et du CMS.
- Faites l’inventaire des scripts, styles, cadres, API, images et services externes.
- Déployez d’abord une politique Report-Only.
- Investigatez chaque violation et autorisez uniquement les comportements fiables et nécessaires.
- Testez le frontend, l’administration, la connexion, le processus de paiement, les formulaires et les intégrations.
- Vérifiez le comportement de la mise en cache, des nonces, du CDN et des en-têtes en double.
- Activez l’application progressivement et surveillez après les mises à jour logiciels.
Conclusion
Une CSP utile n’est pas simplement un en-tête copié d’une liste de contrôle. Inspectez votre configuration actuelle, trouvez où elle est définie, testez en mode Report-Only, corrigez les problèmes de compatibilité précis, et n’appliquez qu’alors une politique adaptée à votre site web. Les administrateurs de WordPress et Joomla peuvent commencer avec les outils du CMS ; les développeurs peuvent utiliser Apache, Nginx ou PHP ; et les plateformes d’hébergement peuvent offrir un contrôle direct des en-têtes.
CSP réduit les opportunités d’attaque, mais reste une couche parmi d’autres, aux côtés du codage sécurisé, des mises à jour, de l’authentification et de la surveillance.