Protection API
La catégorie Protection API regroupe quatre fonctions qui verrouillent les interfaces techniques de WordPress, souvent exploitées par les attaquants.
Vue d’ensemble
WordPress expose des interfaces techniques qui permettent à des programmes de dialoguer avec votre site sans passer par les pages : XML-RPC, l’API REST et les pingbacks. Elles sont utiles à certains services, mais aussi très utilisées par les robots. La catégorie « Protection API » regroupe quatre fonctions, toutes actives par défaut et en mode simple :
- Protection XML-RPC : ferme complètement XML-RPC.
- Protection API REST : réserve l’API REST aux utilisateurs connectés.
- Désactiver Pingbacks : coupe les pingbacks et les rétroliens (trackbacks).
- Rate limiting (API / commentaires / XML-RPC) : limite le nombre de requêtes par minute et par adresse IP.
Le détail des réglages se trouve dans Configurer la protection API. Avant d’activer ou de conserver ces protections, lisez la section « Compatibilité » en bas de page si vous utilisez une application mobile, Jetpack ou un service de publication à distance.
Protection XML-RPC
Ce que fait cette fonction
XML-RPC (fichier xmlrpc.php) est l’ancien protocole de publication à distance de WordPress, antérieur à l’API REST. Samaritain Security le ferme entièrement :
- toute requête vers
xmlrpc.phpreçoit une erreur 403 (« XML-RPC is disabled. ») et est inscrite au journal ; - XML-RPC est aussi désactivé dans WordPress lui-même, par sécurité ;
- l’en-tête
X-Pingback, l’adresse de pingback et les liens de découverte RSD et Windows Live Writer sont retirés du code des pages.
Ce blocage s’applique à toutes les adresses IP, y compris celles de la liste blanche.
Pourquoi c’est utile
- Force brute démultipliée : la méthode
system.multicallpermet de tester des centaines de mots de passe en une seule requête, en échappant à la page de connexion. - Déni de service : les pingbacks passent par XML-RPC et peuvent servir à faire attaquer un site tiers par des milliers de sites WordPress.
La plupart des sites n’utilisent plus XML-RPC. Active par défaut, sans réglage.
Protection API REST
Ce que fait cette fonction
L’API REST (adresses en /wp-json/) permet de lire et de modifier le contenu du site. Par défaut, WordPress en ouvre une grande partie à tout le monde. Avec cette protection, un visiteur non connecté reçoit une erreur 401 (« L’API REST est réservée aux utilisateurs authentifiés. »), sauf sur quelques routes indispensables :
/oembed/: intégration de vos contenus sur d’autres sites ;/wc/store/et/wc-auth/: panier, commande et authentification de WooCommerce ;/wp-umbrella/: service de maintenance WP Umbrella ;/samaritain/: échanges internes de Samaritain Security.
Les utilisateurs connectés, y compris par un mot de passe d’application, ne sont pas concernés. Les adresses de la liste blanche et des services partenaires reconnus non plus. Un développeur peut ajouter d’autres routes autorisées (voir le guide de configuration).
Certaines extensions courantes ont besoin que les visiteurs accèdent à l’API REST. Pour elles, la protection ouvre uniquement les routes nécessaires aux visiteurs, et seulement si l’extension concernée est active sur le site : Contact Form 7 (envoi des formulaires), Independent Analytics, Burst Statistics et WP Statistics (mesure d’audience), Complianz et Real Cookie Banner (bandeau et consentement aux cookies), The Events Calendar (navigation dans l’agenda) et WP Mail SMTP (suivi des ouvertures et des clics dans les e-mails). Les autres routes de ces extensions restent fermées aux visiteurs.
La protection s’applique de la même façon aux sites sans permaliens, où l’API REST s’appelle par une adresse en ?rest_route=.
Pourquoi c’est utile
Une API ouverte à tous permet d’aspirer vos contenus, de repérer les extensions installées d’après leurs routes et de sonder le site à la recherche de failles. La fermer aux anonymes réduit cette surface d’attaque. La liste des utilisateurs, elle, est de toute façon masquée par la protection de l’énumération.
Précautions
C’est la protection de cette catégorie la plus susceptible de gêner une extension. Toute fonction qui, côté visiteur, interroge l’API REST sans connexion (envoi de certains formulaires de contact autres que ceux des extensions reconnues ci-dessus, recherche instantanée, chargement d’articles au défilement, application ou site « découplé » qui lit vos contenus) recevra une erreur 401. Après activation, testez vos formulaires et vos pages clés en navigation privée. Active par défaut, sans réglage.
Désactiver Pingbacks
Ce que fait cette fonction
Un pingback est une notification automatique : quand un site publie un lien vers l’un de vos articles, il vous le signale, et un commentaire est créé. Le rétrolien (trackback) est l’équivalent manuel. Cette fonction :
- ferme la réception des pingbacks et des rétroliens sur tous les contenus ;
- retire les méthodes de pingback de XML-RPC, utile si vous avez dû réactiver XML-RPC ;
- supprime l’en-tête
X-Pingbacket le lien court (shortlink) du code des pages ; - empêche, par défaut, les « auto-pingbacks » que WordPress s’envoie à lui-même quand un article contient un lien vers un autre article du site.
Pourquoi c’est utile
Les pingbacks sont surtout utilisés aujourd’hui pour le spam (liens publicitaires glissés dans vos commentaires) et pour des attaques par déni de service. Leur usage légitime est devenu rare. Active par défaut, avec un réglage en mode avancé.
Limitation du débit des requêtes
Ce que fait cette fonction
Dans l’interface, cette fonction s’appelle Rate limiting (API / commentaires / XML-RPC). Elle compte les requêtes de chaque adresse IP et répond par une erreur 429 (« trop de requêtes ») au-delà d’un seuil par minute :
- API REST : 30 requêtes par minute pour un visiteur non connecté, 300 pour un utilisateur connecté ;
- envoi de commentaires : 5 par minute ;
- XML-RPC : 10 requêtes par minute, utile seulement si la protection XML-RPC est désactivée.
Les administrateurs, les adresses de la liste blanche et les services partenaires reconnus ne sont pas limités. Les routes oEmbed, WooCommerce (panier et commande), WP Umbrella et Samaritain Security non plus.
Pourquoi c’est utile
Un robot qui envoie des centaines de requêtes par minute peut ralentir le site, aspirer vos contenus ou inonder vos commentaires de spam. Un humain, lui, reste très loin de ces seuils. Active par défaut, avec cinq réglages en mode avancé.
Compatibilité : applications mobiles, Jetpack et services externes
Application mobile WordPress et logiciels de publication
Les applications et logiciels qui publient à distance passent soit par XML-RPC, soit par l’API REST avec un mot de passe d’application. Par XML-RPC, ils sont bloqués : il faut désactiver Protection XML-RPC. Par l’API REST avec un mot de passe d’application (créé dans votre profil WordPress), ils sont reconnus comme connectés et fonctionnent. Privilégiez cette seconde méthode quand l’application la propose. La première connexion de l’application peut toutefois échouer avec la protection de l’API REST : testez l’ajout du site, et désactivez temporairement la protection si nécessaire.
Jetpack
Jetpack relie votre site aux serveurs de WordPress.com, qui s’adressent à votre site par XML-RPC et par l’API REST. Si vous utilisez Jetpack, désactivez Protection XML-RPC (la liste blanche ne suffit pas, ce blocage ne l’exempte pas), puis vérifiez l’état de la connexion dans le tableau de bord de Jetpack. Si des fonctions restent en erreur, désactivez aussi Protection API REST. La limitation du débit XML-RPC (10 requêtes par minute) reste active : si le journal montre des dépassements, augmentez-la.
Outils de maintenance et services externes
- WP Umbrella est reconnu automatiquement : ses adresses et sa route sont exemptées, sans réglage.
- Pour un autre outil de maintenance, d’automatisation ou de sauvegarde, ajoutez ses adresses IP à la liste blanche : il échappe alors à la protection de l’API REST et à la limitation du débit. S’il utilise XML-RPC, désactivez en plus la protection XML-RPC.
- Si une extension a besoin d’une route REST publique précise, votre développeur peut l’autoriser sans ouvrir toute l’API (voir Configurer la protection API).
