Extension Cloudflare pour WP Cerber
English version: Cloudflare add-on for WP Cerber
L'extension Cloudflare pour WP Cerber synchronise certaines décisions de WP Cerber concernant les adresses IP avec les règles d'accès IP de Cloudflare. Une fois activée, elle permet de créer et de supprimer des règles Cloudflare pour les blocages WP Cerber et pour les entrées des listes d'accès IP autorisées et bloquées. Cloudflare appliquant ces règles avant qu'une requête n'atteigne votre serveur WordPress, l'extension peut réduire le trafic provenant des adresses que WP Cerber a déjà bloquées.
Ce module complémentaire fonctionne avec les règles d'accès IP de Cloudflare , et non avec les règles personnalisées de Cloudflare.
Important : Cette extension crée des règles d’accès IP Cloudflare au niveau de l’utilisateur. Chaque règle s’applique à toutes les zones Cloudflare appartenant à l’utilisateur Cloudflare dont vous configurez les identifiants , et non uniquement au site WordPress sur lequel l’extension est installée. Tenez compte de cette portée si le même utilisateur Cloudflare possède plusieurs sites web.
Exigences
Avant d'installer l'extension, assurez-vous que votre site web répond aux exigences suivantes :
- WP Cerber 9.8.3 ou plus récent
- PHP 7.4 ou version ultérieure
- Un compte Cloudflare gratuit ou payant
- Le nom d'hôte du site web est protégé par un proxy Cloudflare et n'est pas configuré uniquement au niveau du DNS.
- Le paramètre du moteur de sécurité de chargement de WP Cerber est défini sur le mode Standard.
- Le paramètre « Mon site est derrière un proxy inverse » de WP Cerber est activé lorsque le site web est servi via le proxy Cloudflare.
Les règles d'accès IP de Cloudflare peuvent agir sur les requêtes avant qu'elles n'atteignent le serveur d'origine uniquement si Cloudflare fait bien office de proxy pour le trafic HTTP et HTTPS du site web. Un enregistrement DNS seul ne fait pas transiter le trafic web par Cloudflare.
Du côté de WordPress, la configuration du proxy inverse est tout aussi importante. WP Cerber ne peut prendre des décisions de sécurité fiables basées sur l'adresse IP que s'il détecte correctement l'adresse IP d'origine du visiteur. N'activez l'option « Mon site est derrière un proxy inverse » que si le site web est effectivement protégé par Cloudflare ou un autre proxy inverse de confiance.
Cloudflare et HTTPS
Lorsque votre site web est acheminé via un proxy Cloudflare, Cloudflare s'interpose entre les visiteurs et votre serveur d'origine et termine les connexions TLS des visiteurs à sa périphérie, ce qui signifie que le trafic de votre site web est traité par l'infrastructure Cloudflare.
La connexion entre Cloudflare et votre serveur d'origine peut toujours être chiffrée. Cloudflare prend en charge les connexions d'origine chiffrées et recommande le mode strict (Complet) lorsque cela est possible.
Si votre site web est soumis à des exigences en matière de confidentialité, de traitement des données ou de protocole TLS, veuillez consulter la configuration Cloudflare correspondante avant d'activer l'extension.
Installez le module complémentaire
L'extension Cloudflare est un plugin WordPress standard. Elle est distribuée via le site web WP Cerber, et non via le répertoire de plugins de wordpress.org.
- Téléchargez l'extension : https://downloads.wpcerber.com/plugin/wp-cerber-cloudflare-addon.zip
- Connectez-vous à votre tableau de bord d'administration WordPress.
- Allez dans Plugins → Ajouter un nouveau plugin .
- Cliquez sur « Télécharger le plugin » .
- Sélectionnez l'archive ZIP téléchargée.
- Cliquez sur Installer maintenant .
- Cliquez sur Activer le plugin .
Après l'activation, ouvrez WP Cerber → Extensions → Cloudflare . Toutes les options de synchronisation sont désactivées par défaut.
Configurer les identifiants Cloudflare
Dans la section des identifiants Cloudflare , saisissez :
- l'adresse e-mail de votre compte Cloudflare
- la clé API globale de ce compte
Vous trouverez la clé API globale dans le tableau de bord Cloudflare, sous Mon profil → Jetons API , dans la section Clés API .
La version 2.5 s'authentifie à l'aide de l'adresse e-mail du compte et de la clé API globale. Les jetons API Cloudflare ne sont pas pris en charge par cette version de l'extension. La clé API globale doit être traitée comme une information d'identification sensible, car elle confère un accès plus étendu qu'un jeton API à portée limitée.
Lorsque vous enregistrez les paramètres de l'extension, WP Cerber vérifie les identifiants en créant et en supprimant une règle d'accès IP Cloudflare temporaire. Si Cloudflare rejette la requête, l'extension signale l'échec dans l'interface d'administration WordPress.
Synchronisation des verrouillages WP Cerber
Sans l'extension, WP Cerber applique ses blocages au serveur WordPress. Activez la synchronisation des adresses IP bloquées pour que les blocages pris en charge soient également appliqués par Cloudflare.
Lorsque WP Cerber bloque une adresse et que ce blocage est synchronisable, l'extension crée une règle de blocage Cloudflare afin que les requêtes provenant de cette adresse soient bloquées par Cloudflare avant d'atteindre votre serveur WordPress. Lorsque WP Cerber lève le blocage, l'extension supprime la règle correspondante.
Certains verrouillages ne sont pas synchronisés.
De par sa conception, l'extension ne répercute pas systématiquement chaque blocage WP Cerber. Aucune règle Cloudflare n'est créée lorsque :
- la requête appartient à un utilisateur connecté
- Le verrouillage est déclenché par certaines requêtes erronées, telles que des requêtes 404 répétées.
- La limite de tentatives de connexion est atteinte pour la première fois, dans les cas où WP Cerber traite différemment le premier verrouillage
- La requête est identifiée comme provenant de Googlebot et du domaine googlebot.com
- Cloudflare ne peut pas représenter l'adresse ou le réseau bloqué comme cible de règle d'accès IP
Ces exclusions concernent uniquement la copie du blocage sur Cloudflare. Le blocage lui-même reste actif sur WP Cerber.
Verrouillages de sous-réseau
La version 2.5 prend en charge le verrouillage des sous-réseaux. Si l'option « Bloquer le sous-réseau – Bloquer systématiquement l'intégralité du sous-réseau de classe C de l'adresse IP de l'intrus » est activée dans WP Cerber, l'extension crée une règle pour le sous-réseau verrouillé par WP Cerber, et non uniquement pour l'adresse IP ayant déclenché le verrouillage. Avec le mode de sous-réseau actuel de WP Cerber, cela génère généralement une règle Cloudflare /24.
La règle n'est créée que si Cloudflare prend en charge cette taille de réseau. Dans le cas contraire, le blocage reste actif dans WP Cerber sans équivalent chez Cloudflare.
Les versions précédentes de l'extension ne synchronisaient pas les verrouillages de sous-réseau et nécessitaient la désactivation de l'option « Bloquer le sous-réseau » . La version 2.5 supprime cette restriction.
Synchronisation des listes d'accès IP
Activez l' option « Activer la synchronisation des listes d'accès IP » pour synchroniser les modifications prises en charge dans les listes d'accès IP autorisées et bloquées de WP Cerber avec les règles d'accès IP de Cloudflare.
La synchronisation est unidirectionnelle : WP Cerber → Cloudflare . Les modifications apportées directement aux règles d’accès IP dans le tableau de bord Cloudflare ne sont pas renvoyées à WP Cerber.
Liste d'accès IP bloquée
Une entrée autorisée ajoutée à la liste d'accès IP bloquée de WP Cerber devient une règle de blocage Cloudflare. Par exemple, si vous ajoutez 192.168.1.0/24 à la liste, l'extension peut créer une règle Cloudflare correspondante qui bloque les requêtes provenant de ce réseau avant qu'elles n'atteignent votre serveur WordPress.
Liste d'accès IP autorisée
Une entrée autorisée ajoutée à la liste d'accès IP autorisée de WP Cerber devient une règle d'autorisation Cloudflare. Par conséquent, utilisez cette liste avec précaution. Cloudflare indique qu'une règle d'accès IP avec l'action « Autoriser » peut contourner d'autres contrôles de sécurité Cloudflare pour cette adresse, notamment les règles personnalisées, les règles de limitation de débit, les règles gérées par le WAF et certaines autres fonctionnalités de sécurité.
Pour cette raison, n'ajoutez une adresse à la liste d'accès IP autorisée que si vous lui faites confiance et si vous comprenez l'effet d'une règle d'autorisation Cloudflare.
Adresses IP et réseaux pris en charge
WP Cerber accepte davantage d'adresses IP et de formats de réseau que les règles d'accès IP de Cloudflare.
Si une entrée est valide dans WP Cerber mais que Cloudflare ne peut pas la représenter, l'extension ne crée pas de règle Cloudflare correspondante. L'entrée reste inchangée dans votre liste d'accès IP ; aucune modification ni suppression n'est effectuée pour la rendre compatible avec Cloudflare.
| Inscription dans une liste d'accès IP Cerber de WordPress | Synchronisé avec Cloudflare |
|---|---|
Une seule adresse IPv4, par exemple 192.168.1.1 |
Oui |
Une seule adresse IPv6, par exemple 2001:db8::1 |
Oui |
Un réseau IPv4 avec une longueur de préfixe /16 ou /24, par exemple 192.168.1.0/24 |
Oui |
Un réseau IPv6 avec une longueur de préfixe /32, /48 ou /64, par exemple 2001:db8::/48 |
Oui |
Un réseau IPv4 avec une longueur de préfixe différente, par exemple 10.0.0.0/8 |
Non |
| Une plage d'adresses IP, écrite sous la forme d'une première et d'une dernière adresse IP. | Non |
La notation générique WP Cerber est automatiquement convertie en notation CIDR lorsque Cloudflare prend en charge le réseau résultant :
-
192.168.1.*devient192.168.1.0/24 -
192.168.*.*devient192.168.0.0/16
Activation de la synchronisation des listes de contrôle d'accès IP sur un site web existant
L'activation de la synchronisation des listes de contrôle d'accès IP n'entraîne pas une synchronisation globale des entrées déjà présentes dans ces listes. Seules les entrées ajoutées ou supprimées après l'activation de cette fonction sont synchronisées, au fur et à mesure.
Pour dupliquer immédiatement une entrée existante, supprimez-la de la liste d'accès IP de WP Cerber, puis ajoutez-la à nouveau. Soyez prudent avec les entrées qui affectent votre propre accès au site web.
La reconstruction unique effectuée lors de la mise à jour depuis une version d'extension antérieure à la version 2.5 fonctionne différemment. Elle lit les listes d'accès actuelles et peut recréer les règles Cloudflare pour les entrées existantes au moment de la mise à jour.
Autres paramètres complémentaires
Notes de règles détaillées
Activez l'option « Notes de règles détaillées » pour inclure des informations supplémentaires sur WP Cerber dans les notes de règles Cloudflare. Pour les règles de liste de contrôle d'accès IP, l'extension peut ajouter le commentaire de l'entrée. Pour les règles de blocage, elle peut ajouter le motif du blocage.
Les notes détaillées facilitent l'identification et la recherche des règles Cloudflare, mais ces informations sont ensuite stockées par Cloudflare. Désactivez cette option si les commentaires de votre liste d'accès ou les motifs de verrouillage contiennent des informations que vous ne souhaitez pas y stocker.
Supprimer les règles Cloudflare lors de la désactivation
Lorsque l'option « Supprimer les règles Cloudflare lors de la désactivation » est activée, la désactivation de l'extension Cloudflare supprime les règles Cloudflare enregistrées par celle-ci. Ce même nettoyage est également effectué lors de la désactivation de WP Cerber.
Si la suppression via Cloudflare échoue, aucune nouvelle tentative n'est effectuée lors de la désactivation. L'extension ne suit alors plus cette règle ; vous devez donc la supprimer manuellement dans Cloudflare. Après avoir désactivé l'extension pour supprimer l'ensemble de règles, vérifiez les règles d'accès IP dans votre compte Cloudflare afin de confirmer que les règles attendues ont bien été supprimées.
La réactivation des plugins ne recrée pas automatiquement les règles supprimées lors de leur désactivation. À partir de ce moment, la synchronisation est gérée par les événements.
Activer la journalisation des diagnostics
Activez l'option « Activer la journalisation des diagnostics » avant d'examiner un problème de synchronisation. Lorsque cette option est activée, l'extension enregistre l'activité de synchronisation et les erreurs Cloudflare dans le journal de diagnostic de WP Cerber, accessible via WP Cerber → Outils → Journal de diagnostic . Lorsque l'option est désactivée, l'extension n'enregistre rien dans ce journal.
Dépannage
Les identifiants Cloudflare ont été refusés.
Vérifiez ceci :
- vous avez saisi l'adresse e-mail du compte Cloudflare
- Vous avez saisi la clé API globale , et non un jeton API.
- Les identifiants appartiennent à l'utilisateur Cloudflare dont vous souhaitez affecter les zones via l'extension.
Enregistrez ensuite à nouveau les paramètres pour relancer la vérification des informations d'identification.
Aucune entrée WP Cerber n'apparaît dans Cloudflare
Suivez les étapes suivantes :
- Assurez-vous que l'option de synchronisation correspondante est activée.
- Vérifiez que Cloudflare prend en charge le format d'adresse ou de réseau.
- Si l'entrée a été ajoutée avant que vous n'activiez la synchronisation, n'oubliez pas que les entrées existantes ne sont pas synchronisées en masse.
- Recherchez une erreur Cloudflare dans les notifications d'administration WordPress.
- Activez la journalisation des diagnostics et consultez WP Cerber → Outils → Journal de diagnostic .
Rien ne se passe après la mise à jour depuis une version antérieure.
La reconstruction unique s'effectue lors du prochain événement IP WP Cerber pertinent, et non nécessairement au moment de la mise à jour de l'extension. Vérifiez également que l'adresse e-mail Cloudflare et la clé API globale sont bien enregistrées.
Pour déclencher vous-même un événement pertinent, ajoutez une entrée à votre liste de contrôle d'accès IP, puis supprimez-la. Choisissez une adresse qui n'affectera pas votre propre accès à WordPress ni aux autres zones Cloudflare.
L'ensemble de règles Cloudflare semble incomplet après une mise à jour.
Une reconstruction importante peut s'étendre sur plusieurs requêtes, et pendant son déroulement, les identifiants des règles Cloudflare et le nombre de règles visibles peuvent changer.
Activez la journalisation des diagnostics et consultez le journal des diagnostics pour les opérations Cloudflare rejetées ou les cibles non prises en charge.
Se remettre d'un blocage accidentel
Une règle de blocage Cloudflare peut empêcher votre adresse IP actuelle d'accéder à WordPress. Si vous vous bloquez accidentellement, deux solutions pratiques s'offrent à vous pour récupérer votre compte.
Utilisez une autre connexion Internet
Utilisez un appareil ou une connexion avec une adresse IP publique différente, par exemple un appareil mobile connecté aux données cellulaires plutôt qu'à votre réseau Wi-Fi. Connectez-vous ensuite à WordPress et supprimez le blocage ou l'entrée de la liste de contrôle d'accès IP qui en était la cause.
C’est l’option privilégiée lorsque vous devez rétablir immédiatement un accès normal à WordPress.
Supprimez manuellement la règle Cloudflare
Connectez-vous à Cloudflare, ouvrez Sécurité → Règles de sécurité → Règles d'accès IP , trouvez la règle correspondant à votre adresse IP et supprimez-la. Pour connaître votre adresse IP publique actuelle, utilisez l'outil « Quelle est mon adresse IP ? ».
La suppression de la règle Cloudflare permet à vos requêtes d'atteindre à nouveau le serveur WordPress, mais ne supprime pas le blocage WP Cerber correspondant ni l'entrée de la liste de contrôle d'accès IP. WP Cerber continue d'appliquer son propre état jusqu'à son expiration ou jusqu'à ce que vous le modifiiez dans WordPress.
L'extension ne détecte pas une règle supprimée manuellement et continue de la considérer comme active jusqu'à la levée du blocage correspondant ou la suppression de l'entrée de la liste de contrôle d'accès IP dans WordPress. À ce moment-là, l'extension efface l'enregistrement de la règle et, si la même adresse est ajoutée ultérieurement, une nouvelle règle Cloudflare est créée comme d'habitude.
Supprimez toutes les règles Cloudflare créées par l'extension.
Pour supprimer les règles actuellement enregistrées par l'extension :
- Ouvrez WP Cerber → Modules complémentaires → Cloudflare .
- Activer la suppression des règles Cloudflare lors de la désactivation .
- Enregistrez les paramètres.
- Rendez-vous sur la page des plugins WordPress.
- Désactivez le plugin Cloudflare pour WP Cerber Security .
- Vérifiez vos règles d'accès IP Cloudflare pour confirmer que les règles attendues ont été supprimées.
- Réactivez l'extension uniquement si vous souhaitez toujours l'utiliser.
N'oubliez pas que les suppressions individuelles de règles Cloudflare peuvent échouer ; la désactivation ne garantit donc pas la suppression de toutes les règles distantes.
Soutien
Si vous rencontrez un problème de synchronisation, activez la journalisation des diagnostics , reproduisez le problème, puis consultez WP Cerber → Outils → Journal des diagnostics .
Les clients de WP Cerber Professional peuvent utiliser le service d'assistance à l'adresse https://my.wpcerber.com . L'assistance pour la version gratuite est disponible via la communauté WP Cerber à l' adresse https://talk.wpcerber.com .
Références à Cloudflare
La documentation de Cloudflare aborde les sujets suivants plus en détail :
- Comportement et portée des règles d'accès IP : https://developers.cloudflare.com/waf/tools/ip-access-rules/
- État du proxy et différence entre les noms d'hôtes avec proxy et les noms d'hôtes DNS uniquement : https://developers.cloudflare.com/dns/proxy-status/
- Mode TLS complet (strict) : https://developers.cloudflare.com/ssl/origin-configuration/ssl-modes/full-strict/