Configurer les headers de sécurité
La fonction En-têtes de sécurité est la plus configurable de l’extension. Chaque en-tête protège contre un type d’attaque précis.
Avant de commencer
Cette page détaille chaque réglage de la fonction En-têtes de sécurité. Pour comprendre à quoi servent ces en-têtes et ce qui est actif par défaut, lisez d’abord la page En-têtes de sécurité.
Les réglages se trouvent dans les réglages de Samaritain Security, en mode avancé, catégorie En-têtes de sécurité. Ils sont répartis en sept sections repliables. N’oubliez pas de cliquer sur Enregistrer les modifications en bas de page : aucun changement n’est pris en compte avant.
Cache : si votre site utilise une extension de cache de page, videz son cache après chaque enregistrement, sinon vos visiteurs continueront de recevoir les anciennes pages. Une alerte s’affiche en haut de la vue lorsqu’une telle extension est détectée.
Section 1 : Protection de base
Forcer la connexion sécurisée (HTTPS) : Strict-Transport-Security
Oblige les navigateurs à toujours utiliser HTTPS pour votre domaine, pendant la durée choisie. L’en-tête n’est envoyé que sur une connexion HTTPS ; si votre site n’utilise pas HTTPS, un avertissement l’indique et le réglage n’est pas appliqué.
| Réglage | Par défaut | Rôle / conseil |
|---|---|---|
| Activer | Activé | À laisser activé si votre site est entièrement en HTTPS avec un certificat renouvelé automatiquement. |
| Durée : (1 mois, 6 mois, 1 an) | 1 an | Durée pendant laquelle le navigateur retient la consigne. Pour une première mise en place, un mois permet de revenir en arrière plus vite. |
| Appliquer aussi à tous les sous-domaines | Activé | Étend la consigne à tous les sous-domaines (boutique.exemple.fr, mail.exemple.fr…). Désactivez-le si l’un d’eux n’a pas de certificat HTTPS, sinon il deviendra inaccessible. |
| Inscrire le site sur la liste de préchargement des navigateurs (expert) | Désactivé | Ajoute la mention preload à l’en-tête. L’inscription elle-même se fait sur hstspreload.org et est très difficile à annuler : réservé aux domaines définitivement en HTTPS, sous-domaines compris. |
Attention : un navigateur qui a reçu HSTS le garde en mémoire jusqu’à la fin de la durée, même si vous désactivez ensuite le réglage. Ne l’activez pas sur un site dont le certificat n’est pas fiable.
Empêcher le navigateur de deviner le type des fichiers : X-Content-Type-Options
| Réglage | Par défaut | Rôle / conseil |
|---|---|---|
| Activer la protection | Activé | Envoie nosniff : un fichier déclaré comme image ne peut pas être exécuté comme script. Aucune raison de le désactiver. |
Empêcher l’affichage de votre site dans un cadre : X-Frame-Options
| Réglage | Par défaut | Rôle / conseil |
|---|---|---|
| Autoriser uniquement votre propre site (recommandé) | Oui | Valeur SAMEORIGIN : seules vos propres pages peuvent afficher votre site dans un cadre. Compatible avec l’aperçu du thème et les constructeurs de pages. |
| Interdire à tous les sites, y compris le vôtre | Non | Valeur DENY : peut casser les fonctions qui utilisent des cadres internes. |
| Désactivé | Non | Aucun en-tête : votre site peut être piégé dans un cadre invisible sur un autre site. Déconseillé. |
Les navigateurs récents utilisent de préférence la directive CSP frame-ancestors ; X-Frame-Options reste utile pour les navigateurs plus anciens.
Informations transmises aux autres sites : Referrer-Policy
Quand un visiteur clique sur un lien vers un autre site, ce réglage décide de ce que cet autre site apprend sur la page d’origine. Les choix proposés, avec la valeur technique envoyée :
| Choix dans la liste | Valeur envoyée | Conseil |
|---|---|---|
| Recommandé : seulement votre domaine vers les sites externes | strict-origin-when-cross-origin | Par défaut. Bon équilibre entre confidentialité et compatibilité (statistiques, liens d’affiliation). |
| Ne rien transmettre (confidentialité maximale) | no-referrer | Peut fausser les statistiques de provenance de vos partenaires. |
| Transmettre uniquement à l’intérieur de votre site | same-origin | Rien n’est transmis aux sites externes. |
| Toujours seulement votre domaine | strict-origin | Domaine seul, y compris pour vos propres pages. |
| Toujours votre domaine (même si la sécurité baisse) | origin | Transmet le domaine même d’une page HTTPS vers une page HTTP. |
| Votre domaine à l’externe, adresse complète en interne | origin-when-cross-origin | Proche de la valeur recommandée, sans la protection lors d’un passage vers HTTP. |
| Tout transmettre, sauf lors d’une baisse de sécurité | no-referrer-when-downgrade | Transmet l’adresse complète aux sites externes en HTTPS. |
| Tout transmettre en permanence (déconseillé) | unsafe-url | Peut divulguer des adresses contenant des paramètres privés. |
| Désactivé | aucune | Le navigateur applique son comportement habituel. |
Filtre anti-injection pour anciens navigateurs : X-XSS-Protection
| Réglage | Par défaut | Rôle / conseil |
|---|---|---|
| Activer le filtre | Activé | Envoie 1; mode=block. Utile seulement pour de très anciens navigateurs ; sans effet sur les récents. Peut rester activé. |
Section 2 : Content Security Policy (CSP)
La CSP liste, directive par directive, les sources autorisées pour chaque type de ressource. C’est la protection la plus forte contre l’injection de scripts, et la plus délicate à régler.
Mode CSP
| Réglage | Par défaut | Rôle / conseil |
|---|---|---|
| Désactivé | Oui | Aucune CSP n’est envoyée. |
| Mode test (report-only) | Non | Envoie l’en-tête Content-Security-Policy-Report-Only : rien n’est bloqué, les navigateurs signalent chaque violation à votre site. Commencez toujours par ce mode. |
| Mode actif (enforcement) | Non | Envoie l’en-tête Content-Security-Policy : les ressources non autorisées sont bloquées. Un avertissement rappelle de tester d’abord. |
Les signalements sont envoyés à l’adresse /wp-json/samaritain/v1/csp-report de votre site, uniquement en mode test. En mode actif, l’extension ne demande pas de signalement : les ressources bloquées n’apparaissent que dans la console du navigateur (outils de développement).
Directives CSP
Le tableau affiche les 14 directives reconnues, préremplies avec des valeurs de départ compatibles avec WordPress. Un champ vidé retire la directive de l’en-tête.
| Directive | Valeur de départ | Ce qu’elle contrôle |
|---|---|---|
default-src | 'self' | Sources par défaut, pour toute directive non précisée. |
script-src | 'self' 'unsafe-inline' | Scripts JavaScript. |
style-src | 'self' 'unsafe-inline' | Feuilles de style. |
img-src | 'self' data: https: | Images (toute image en HTTPS est acceptée). |
font-src | 'self' | Polices de caractères. |
connect-src | 'self' | Requêtes envoyées par les scripts (AJAX, fetch). |
frame-src | 'self' | Cadres intégrés (vidéos, cartes, formulaires externes). |
object-src | 'none' | Anciens modules (Flash, Java) : à laisser bloqué. |
base-uri | 'self' | Adresses de base autorisées. |
frame-ancestors | 'self' | Sites pouvant afficher le vôtre dans un cadre. |
form-action | 'self' | Destinations autorisées des formulaires. |
media-src | 'self' | Vidéos et sons. |
worker-src | 'self' | Scripts d’arrière-plan (Web Workers). |
upgrade-insecure-requests | Case non cochée | Cochée, demande au navigateur de charger en HTTPS toute ressource appelée en HTTP. |
Syntaxe : séparez les valeurs par des espaces. Les mots-clés s’écrivent entre apostrophes droites.
| Valeur | Signification |
|---|---|
'self' | Votre propre domaine. |
'unsafe-inline' | Scripts ou styles écrits directement dans le HTML. |
'none' | Tout bloquer pour cette directive. |
https: | Toute ressource servie en HTTPS. |
https://domaine.com | Un domaine précis. |
data: et blob: | Ressources intégrées ou générées par le navigateur (images encodées, Web Workers). |
Exemple pour frame-src sur un site qui intègre des vidéos YouTube et Vimeo :
'self' https://www.youtube.com https://player.vimeo.com
Le bouton Réinitialiser aux valeurs par défaut remet immédiatement toutes les directives à leurs valeurs de départ.
Ajout en un clic des services tiers
Sous le tableau, des boutons ajoutent les domaines nécessaires à 27 services courants, rangés par catégorie. Un champ de recherche permet de filtrer la liste. Les domaines sont ajoutés aux valeurs existantes, sans doublon ; il reste à enregistrer.
| Catégorie | Services |
|---|---|
| Vidéo & média | YouTube, Vimeo, Dailymotion, Wistia, SoundCloud & Spotify |
| Réseaux sociaux | Facebook & Instagram, Google (connexion, bouton YouTube), X (Twitter), TikTok |
| Paiement | Stripe, PayPal |
| Polices & icônes | Polices intégrées (data:), Google Fonts, Adobe Fonts, Font Awesome |
| Anti-spam & formulaires | reCAPTCHA, hCaptcha, Cloudflare Turnstile, Mailchimp, Calendly |
| Statistiques | Google Analytics, Hotjar, Microsoft Clarity |
| Chat & support | Crisp, Tawk.to |
| Divers | Google Maps, Gravatar & Jetpack |
Le préréglage Facebook & Instagram autorise aussi les adresses que le SDK de Facebook appelle pour charger sa configuration (directive connect-src), sans lesquelles le bouton J’aime et la connexion par Facebook échouent. Google (connexion, bouton YouTube) couvre la connexion avec un compte Google et le bouton d’abonnement YouTube. Polices intégrées (data:) autorise les polices et icônes incluses directement dans les feuilles de style, fréquentes dans les thèmes et les constructeurs de pages.
Dernières violations CSP
En mode test, les violations signalées par les navigateurs s’affichent dans un tableau : date, directive violée, adresse bloquée, page concernée (son chemin seul ; les adresses complètes s’affichent au survol). Les 20 plus récentes sont affichées (100 au plus sont conservées).
- Le bouton Autoriser ajoute la source à la bonne directive : uniquement l’origine (par exemple
https://cdn.exemple.com, sans chemin), ou le mot-clé correspondant ('unsafe-inline','unsafe-eval',data:,blob:…). Quand l’ajout automatique n’est pas possible, la mention Manuel s’affiche : ajoutez la valeur vous-même dans la directive. - L’autorisation est enregistrée tout de suite, et le champ de la directive est mis à jour dans la page : cliquer ensuite sur Enregistrer les modifications ne l’annule pas. Tous les signalements que cette autorisation règle (même directive, même source, quelle que soit la page) disparaissent de la liste.
- Le bouton Effacer les violations vide la liste.
Prudence : n’importe qui peut envoyer de faux signalements. N’autorisez que des domaines que vous reconnaissez comme des services réellement utilisés par votre site, et évitez d’autoriser
'unsafe-eval'sur le site public sans raison précise.
Pour limiter les abus, l’extension ignore les signalements qui décrivent une page d’un autre site, accepte au plus 20 signalements par adresse toutes les 10 minutes et ignore les doublons rapprochés. Les adresses IP des visiteurs ne sont pas enregistrées, seule une empreinte non réversible sert au comptage.
Repli automatique
Si au moins 10 violations sont signalées en 10 minutes par au moins 3 visiteurs distincts, l’extension force le mode test pendant 10 minutes, affiche un avertissement dans cette section et vous prévient par un e-mail d’alerte critique. Le journal enregistre l’événement « Politique CSP passée en mode rapport seul » avec le nombre de blocages signalés, le nombre de visiteurs et la ressource bloquée (par exemple « 37 blocages signalés par 17 visiteurs · script-src : https://connect.facebook.net ») ; l’adresse affichée est « Plusieurs visiteurs », sans bouton Bannir. Ce mécanisme dépend des signalements des navigateurs, que l’extension ne demande qu’en mode test : il ne remplace pas une période de test avant le passage en mode actif.
CSP et administration
Si vous appliquez tous les en-têtes à l’administration (section 6), l’extension ajoute automatiquement 'unsafe-eval' à script-src dans l’administration uniquement : l’éditeur de blocs et de nombreuses extensions (Site Kit, Yoast, Elementor, Divi…) en ont besoin. Le site public garde la CSP telle que vous l’avez réglée.
Section 3 : Cross-Origin
Trois en-têtes d’isolement, tous désactivés par défaut. Activez-les un par un et vérifiez ensuite les connexions par un compte externe, les paiements et les contenus intégrés.
| Réglage | Par défaut | Rôle / conseil |
|---|---|---|
| Activer (Cross-Origin-Opener-Policy, COOP) | Désactivé | Isole vos pages des fenêtres ouvertes par d’autres sites. Peut casser les fenêtres de connexion Google ou Facebook et les fenêtres de paiement. |
| Valeur : COOP | same-origin | same-origin : isolement complet. same-origin-allow-popups : garde le lien avec les fenêtres que vous ouvrez (à choisir si vous utilisez des fenêtres de paiement ou de connexion). unsafe-none : aucun isolement. |
| Activer (require-corp) (Cross-Origin-Embedder-Policy, COEP) | Désactivé | Chaque ressource externe doit autoriser explicitement son chargement. Casse souvent les images, polices et scripts servis par un CDN. Utile seulement pour des fonctions avancées du navigateur (SharedArrayBuffer). |
| Activer (Cross-Origin-Resource-Policy, CORP) | Désactivé | Décide quels sites peuvent charger vos fichiers (images, scripts). |
| Valeur : CORP | same-site | same-site : votre domaine et ses sous-domaines. same-origin : votre domaine exact. cross-origin : tout le monde, à choisir si vos fichiers sont servis par un CDN ou affichés par des sites partenaires. |
Section 4 : Permissions Policy
Cochez Activer Permissions-Policy (désactivé par défaut) pour afficher le tableau des fonctions du navigateur. Pour chacune, trois colonnes : Bloquer (personne ne peut l’utiliser, valeur ()), Autoriser (self) (votre site uniquement, valeur (self)) et Personnalisé (liste d’origines).
| Fonction | Par défaut | Usage |
|---|---|---|
geolocation | Bloquer | Position de l’appareil (cartes « autour de moi », calcul de livraison). |
camera, microphone | Bloquer | Caméra et micro (visioconférence, enregistrement). |
payment | Bloquer | Paiement intégré au navigateur (boutons Apple Pay ou Google Pay de certaines passerelles). |
usb | Bloquer | Périphériques USB. |
accelerometer, gyroscope, magnetometer, ambient-light-sensor | Bloquer | Capteurs de l’appareil. |
display-capture | Bloquer | Capture de l’écran. |
interest-cohort | Bloquer | Ancien dispositif de ciblage publicitaire de Chrome (FLoC), abandonné ; le bloquer est sans inconvénient. |
autoplay | Autoriser (self) | Lecture automatique des médias. |
fullscreen | Autoriser (self) | Plein écran. |
picture-in-picture | Autoriser (self) | Vidéo incrustée dans une petite fenêtre. |
Limite de la version actuelle : le choix Personnalisé n’est pas encore pris en compte à l’enregistrement. La fonction concernée est alors enregistrée comme Bloquer. Pour autoriser une fonction, utilisez Autoriser (self) ; si un service intégré (vidéo, carte, paiement) en a besoin, laissez la Permissions-Policy désactivée en attendant le correctif.
Boutiques en ligne : si votre passerelle de paiement propose Apple Pay ou Google Pay, le blocage de
paymentpeut faire disparaître ces boutons. Vérifiez votre page de paiement après activation.
Section 5 : Headers à supprimer
| Réglage | Par défaut | Rôle / conseil |
|---|---|---|
| Supprimer X-Powered-By | Activé | Retire l’en-tête qui annonce la version de PHP du serveur. |
| Supprimer X-Generator | Activé | Retire la balise « generator » qui annonce la version de WordPress dans le code des pages. |
L’en-tête Server ne peut être retiré que dans la configuration du serveur web (Apache ou nginx), en passant par votre hébergeur.
Section 6 : Contextes & Test
| Réglage | Par défaut | Rôle / conseil |
|---|---|---|
| Appliquer tous les headers sur le back-office (/wp-admin) | Désactivé | Désactivé, l’administration ne reçoit que X-Content-Type-Options et X-XSS-Protection, pour éviter les conflits avec les extensions. À n’activer que si vous avez vérifié que vos extensions d’administration fonctionnent avec vos réglages (CSP notamment). |
| Appliquer les headers sur la REST API (/wp-json) | Activé | Envoie aussi les en-têtes sur les réponses de l’API REST. Désactivé, l’API ne reçoit plus que la suppression de X-Powered-By. |
Les boutons SecurityHeaders.com et Mozilla Observatory ouvrent l’analyse de votre site dans ces services externes. Videz le cache avant de tester.
Section 7 : Compatibilité avec le cache
Cette section n’est proposée que si votre serveur lit les fichiers .htaccess (Apache ou LiteSpeed). Sur nginx, un message explique que l’option est sans effet.
| Réglage | Par défaut | Rôle / conseil |
|---|---|---|
| Écrire les en-têtes dans le fichier .htaccess | Désactivé | Recommandé si une extension de cache de page est active : le serveur web pose les en-têtes sur chaque réponse, y compris les pages servies depuis le cache. |
Ce que l’option écrit. À l’enregistrement, puis à chaque changement de réglage, l’extension écrit dans le .htaccess à la racine web du site (le dossier web/ sous Bedrock, et non celui de WordPress) un bloc délimité par des marqueurs, avec les en-têtes de base, la Permissions-Policy et la suppression de X-Powered-By. HSTS n’y est envoyé que sur les connexions HTTPS. La CSP et les en-têtes Cross-Origin n’y figurent jamais : ils restent envoyés par PHP. Exemple de bloc avec les valeurs par défaut :
# BEGIN Samaritain Security Headers
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains" env=HTTPS
Header always set X-Content-Type-Options "nosniff"
Header always set X-Frame-Options "SAMEORIGIN"
Header always set Referrer-Policy "strict-origin-when-cross-origin"
Header always set X-XSS-Protection "1; mode=block"
Header always unset X-Powered-By
Header unset X-Powered-By
</IfModule>
# END Samaritain Security Headers
- Une fois l’écriture confirmée, un message vert indique sa date, et PHP cesse d’envoyer ces en-têtes en double. Si l’écriture échoue (fichier non modifiable), un avertissement s’affiche et PHP continue de les envoyer : vérifiez les droits du fichier
.htaccess, puis enregistrez de nouveau. - Écrits dans le
.htaccess, ces en-têtes s’appliquent à toutes les réponses du serveur, administration et fichiers statiques compris. - Avant chaque modification, une copie du
.htaccessest enregistrée danswp-content/uploads/samaritain-htaccess-backups/(dossier fermé au web). - En multisite, seul un super-administrateur peut déclencher cette écriture, le
.htaccessétant commun à tout le réseau.
Revenir en arrière. Décochez l’option (ou désactivez la fonction) et enregistrez : le bloc est retiré automatiquement au chargement suivant d’une page de l’administration. En cas de problème d’accès au site, vous pouvez aussi ouvrir le .htaccess par FTP ou par le gestionnaire de fichiers de votre hébergeur et supprimer tout ce qui se trouve entre # BEGIN Samaritain Security Headers et # END Samaritain Security Headers, marqueurs compris, ou restaurer l’une des copies de sauvegarde. La désinstallation de l’extension retire aussi ce bloc.
Configurations conseillées
Blog ou site vitrine
- Protection de base : valeurs par défaut ; durée HSTS d’un mois au début si vous n’êtes pas sûr de vos sous-domaines.
- CSP : mode test pendant quelques jours, boutons des services utilisés, puis mode actif.
- Cross-Origin : désactivés.
- Permissions Policy : activée avec les valeurs par défaut.
- Cache : option .htaccess activée si vous utilisez une extension de cache.
Boutique en ligne (WooCommerce)
- Protection de base : valeurs par défaut, HSTS fortement recommandé.
- CSP : boutons Stripe ou PayPal, et test complet du tunnel de commande avant le mode actif.
- Cross-Origin : COOP seulement si besoin, avec la valeur
same-origin-allow-popups. - Permissions Policy : vérifiez les boutons de paiement express après activation.
Site avec beaucoup de contenus intégrés
- CSP : boutons des services (YouTube, Google Maps, réseaux sociaux…), puis bouton Autoriser sur les violations restantes que vous reconnaissez.
- CORP :
cross-originsi vos fichiers sont servis par un CDN.
