Dernière mise à jour : 22 novembre 2026
Une intégration qui répond 401 à 9 h, alors qu'elle fonctionnait la veille : le scénario est courant dans les équipes qui pilotent WordPress par API. Le mot de passe d'application WordPress est pourtant un mécanisme simple en apparence. Introduit dans le noyau avec la version 5.6 (décembre 2020), il permet à un service tiers de s'authentifier auprès de l'API REST via l'authentification HTTP Basic, sans exposer le mot de passe principal de l'utilisateur.
Le coût d'une panne se mesure vite. Un outil de publication automatique bloqué, un connecteur CRM muet ou un flux de produits interrompu mobilisent un développeur pendant des heures, souvent à tort sur le mauvais composant. Car la cause se situe rarement là où l'on la cherche.
Trois couches interviennent dans la requête : WordPress lui-même, le serveur web (Apache, Nginx, PHP-FPM) et les couches de filtrage (pare-feu applicatif, extensions de sécurité, CDN). Une seule suffit à rompre la chaîne. WordPress, par exemple, désactive la fonctionnalité sans HTTPS en environnement de production, sauf filtre explicite. Certains hébergeurs suppriment l'en-tête Authorization avant qu'il n'atteigne PHP. Une règle de Wordfence peut, elle, bloquer les appels REST authentifiés.
Cet article suit l'ordre d'un diagnostic réel. Nous commencerons par le fonctionnement du mécanisme et les raisons pour lesquelles la section n'apparaît pas dans le profil, puis nous distinguerons les codes 401, 403 et restnotlogged_in. Viendront ensuite les réglages serveur, une méthode avec cURL et les journaux, le cas des extensions de sécurité, un exemple de connexion d'outil de publication et une checklist en 8 points, pour réduire le temps de résolution.
Sommaire
- 1. Comprendre le fonctionnement des mots de passe d'application dans WordPress
- 2. La section mots de passe d'application n'apparaît pas dans votre profil
- 3. Symptômes et codes d'erreur : 401, 403 et rest_not_logged_in
- 4. Problèmes serveur : en-tête Authorization, Apache, Nginx et PHP-FPM
- 5. Méthode de diagnostic pas à pas avec cURL et les journaux
- 6. Wordfence, Security Ninja et les autres extensions de sécurité
- 7. Cas concret : connecter un outil de publication automatique
- 8. Checklist de dépannage en 8 points
- 9. Questions fréquentes
Comprendre le fonctionnement des mots de passe d'application dans WordPress
Authentification Basic Auth, API REST et prérequis depuis WordPress 5.6
Depuis WordPress 5.6 (décembre 2020), le cœur gère nativement les mots de passe d'application. Il s'agit de jetons de 24 caractères, générés dans le profil utilisateur, qui permettent à un service tiers (ERP, CRM, outil d'automatisation) d'appeler l'API REST sans exposer le mot de passe principal. Chaque jeton est révocable individuellement, ce qui limite l'impact d'une fuite.
Le mécanisme repose sur l'authentification HTTP Basic Auth : le client envoie l'en-tête Authorization: Basic contenant identifiant:jeton encodé en Base64. Attention, Base64 est un encodage, pas un chiffrement. Sans TLS, les identifiants circulent en clair.
Points de contrôle techniques :
- l'identifiant est le nom de connexion, pas l'adresse e-mail ;
- les espaces affichés dans le jeton sont facultatifs ;
- le serveur doit transmettre l'en-tête
Authorizationà PHP, ce que certaines configurations FastCGI ou proxys suppriment ; - les routes ciblées sont celles de
/wp-json/, par exemple/wp-json/wp/v2/posts.
Conditions d'activation : HTTPS, rôles utilisateurs et filtre wpisapplicationpasswordsavailable
La fonction est disponible par défaut uniquement si le site est servi en HTTPS, ce que vérifie wpisapplicationpasswordsavailable() via isssl(). Un environnement de développement en HTTP, ou un site derrière un répartiteur de charge qui ne transmet pas X-Forwarded-Proto, verra la section disparaître du profil. Le type d'environnement défini par WPENVIRONMENTTYPE à local lève cette restriction.
Côté droits, l'utilisateur doit posséder la capacité createapppassword, accordée par défaut à tous les rôles pouvant se connecter. Le jeton hérite des permissions du compte : un Éditeur ne pourra jamais installer d'extension via l'API.
Les développeurs disposent de deux filtres pour désactiver ou forcer la fonctionnalité :
wpisapplicationpasswordsavailable: booléen global ;wpisapplicationpasswordsavailableforuser: décision par utilisateur.
Un returnfalse posé par une extension de sécurité ou un thème enfant suffit à masquer l'interface. C'est la première piste à vérifier lors d'un diagnostic.
La section mots de passe d'application n'apparaît pas dans votre profil
Site sans HTTPS ou en local : la condition oubliée
Depuis WordPress 5.6, les mots de passe d'application reposent sur l'API REST et l'authentification HTTP Basic. Pour éviter qu'un identifiant transite en clair, le cœur applique la fonction wpisapplicationpasswordsavailable(), qui exige par défaut que isssl() renvoie vrai. Sans certificat TLS valide, la section « Mots de passe d'application » disparaît simplement de la page Profil, sans message d'erreur.
Le cas touche surtout les environnements de développement en http://localhost ou les préproduction sans certificat. Autre piège : un site en HTTPS derrière un reverse proxy ou un CDN (Cloudflare, par exemple) peut ne pas détecter le protocole, faute de l'en-tête X-Forwarded-Proto. Dans ce cas, ajoutez dans wp-config.php une détection de cet en-tête avant de modifier quoi que ce soit d'autre.
Depuis WordPress 5.6, la valeur de WPENVIRONMENTTYPE est aussi prise en compte : en local, la fonction est disponible même sans HTTPS. Définissez-la uniquement sur une machine de développement, jamais en production.
Une extension ou le thème a désactivé la fonction
Le filtre wpisapplicationpasswordsavailable permet de couper la fonctionnalité pour tous les utilisateurs. Beaucoup d'extensions de sécurité (Wordfence, iThemes Security, Disable REST API) ou de durcissement l'emploient, tout comme certains thèmes ou un fichier functions.php copié depuis un tutoriel. Un filtre voisin, wpisapplicationpasswordsavailableforuser, restreint l'accès par utilisateur ou par rôle.
Pour isoler la cause, procédez par étapes :
- basculez temporairement sur un thème par défaut (Twenty Twenty-Four) ;
- désactivez les extensions de sécurité, puis les autres, une à une ;
- cherchez
returnfalseassocié à ces filtres dans le code, notamment dans un mu-plugin, que l'interface n'affiche pas par défaut.
Testez sur une copie de préproduction : couper une extension de pare-feu en production expose le site pendant le diagnostic.
Symptômes et codes d'erreur : 401, 403 et rest_not_logged_in
Interpréter les réponses JSON de l'API REST et leurs codes d'erreur
L'API REST de WordPress renvoie un objet JSON contenant trois champs : code, message et data.status. Le champ code identifie la cause, le statut HTTP la classe d'erreur. Testez avec curl -i -u utilisateur:"xxxx xxxx xxxx" https://site.tld/wp-json/wp/v2/users/me.
- 401 + restnotloggedin : aucune authentification reconnue. L'en-tête
Authorizationest absent, mal encodé, ou le mot de passe d'application est révoqué. - 401 + incorrectpassword : l'utilisateur existe, mais le jeton est faux. Vérifiez les espaces et la copie complète des 24 caractères.
- 403 + restforbidden : l'authentification réussit, mais le rôle n'a pas la capacité requise (par exemple
editposts). - 401 + applicationpasswordsdisabled : la fonctionnalité est désactivée, souvent par le filtre
wpisapplicationpasswordsavailableou un plugin de sécurité.
Distinguer un problème d'identifiants d'un problème d'infrastructure
Un message JSON signé par WordPress indique un problème applicatif. Une page HTML, un corps vide ou un JSON d'un autre format désigne souvent une couche en amont : pare-feu applicatif (WAF), CDN, proxy inverse.
Le cas classique : Apache avec PHP en CGI/FastCGI supprime l'en-tête Authorization avant qu'il n'atteigne PHP. WordPress répond alors restnotloggedin alors que les identifiants sont corrects. Corrigez avec la règle RewriteRule .* - [E=HTTPAUTHORIZATION:%{HTTP:Authorization}] dans le .htaccess.
Autre piège : HTTPS. Sans connexion sécurisée, WordPress désactive les mots de passe d'application, sauf en environnement local (WPENVIRONMENTTYPE à local). Une redirection 301 de HTTP vers HTTPS peut aussi faire perdre l'en-tête lors du suivi.
Comparez enfin une requête directe sur le serveur d'origine et une requête via le CDN : si seule la seconde échoue, l'identifiant n'est pas en cause.
Problèmes serveur : en-tête Authorization, Apache, Nginx et PHP-FPM
Rétablir l'en-tête HTTPAUTHORIZATION via .htaccess et RewriteRule
WordPress authentifie les mots de passe d'application via l'en-tête HTTP Authorization: Basic (identifiant et mot de passe encodés en Base64). Sous Apache avec CGI ou FastCGI (modfcgid, PHP-FPM via modproxyfcgi), cet en-tête n'est pas transmis à PHP par défaut. Résultat : l'API REST renvoie 401 restnotlogged_in alors que les identifiants sont valides.
Test rapide : curl -u utilisateur:motdepasse https://exemple.fr/wp-json/wp/v2/users/me. Une réponse 401 persistante oriente vers le serveur, pas vers WordPress.
Ajoutez en tête du fichier .htaccess, avant le bloc # BEGIN WordPress :
RewriteEngine On
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule ^ - [E=HTTPAUTHORIZATION:%1]Variante pour Apache 2.4.13 et suivants : CGIPassAuth On. Limite : WordPress régénère son bloc, donc placez vos lignes en dehors des balises pour éviter leur écrasement.
Configurer fastcgiparam, proxys inverses et CDN sans perte d'en-tête
Sous Nginx, l'en-tête doit être transmis explicitement à PHP-FPM dans le bloc location ~ \.php$ :
fastcgiparam HTTPAUTHORIZATION $httpauthorization;
Rechargez ensuite avec nginx -t && systemctl reload nginx. Si Nginx joue le rôle de proxy inverse devant Apache, ajoutez proxysetheader Authorization $httpauthorization; et proxypassrequestheaders on;.
Vérifiez aussi les couches intermédiaires :
- Cloudflare, Fastly ou Varnish : excluez
/wp-json/*du cache, car une réponse mise en cache masque l'authentification. - Authentification HTTP Basic de préproduction (htpasswd) : elle consomme l'en-tête
Authorizationet entre en conflit avec celui de WordPress. Désactivez-la sur l'API REST ou filtrez par adresse IP. - Règles WAF (ModSecurity, plugins de sécurité) : un blocage de l'API REST produit des faux 401 ou 403.
Pour confirmer le correctif, affichez temporairement $SERVER['HTTP_AUTHORIZATION'] dans un script PHP de test, puis supprimez-le. Sur un hébergement mutualisé sans accès à la configuration, le support technique doit appliquer la directive.
Méthode de diagnostic pas à pas avec cURL et les journaux
Tester l'endpoint /wp-json/wp/v2/users/me en ligne de commande
Isolez d'abord le mot de passe d'application du client applicatif. Une requête cURL (client HTTP en ligne de commande) suffit :
curl -i -u "admin:abcd efgh ijkl mnop qrst uvwx" https://exemple.fr/wp-json/wp/v2/users/me
Lisez le code HTTP avant le corps de la réponse :
- 200 : les identifiants sont valides, le défaut vient de l'application cliente.
- 401 restnotloggedin : l'en-tête
Authorizationn'arrive pas à WordPress. Soupçonnez un proxy, une règle Apache ou FastCGI qui le supprime. - 401 incorrectpassword : mot de passe révoqué, mal copié, ou identifiant erroné (le login, pas l'e-mail).
- 403 : blocage en amont, souvent un WAF (pare-feu applicatif) ou un plugin de sécurité.
- 404 : permaliens ou réécriture d'URL défaillants. Testez
?restroute=/wp/v2/users/me.
Ajoutez -v pour vérifier que l'en-tête Authorization: Basic part bien, et exigez HTTPS : sans lui, WordPress désactive la fonctionnalité hors environnement local.
Exploiter WPDEBUG, les logs d'accès et les journaux du pare-feu applicatif
Dans wp-config.php, activez define('WPDEBUG', true); define('WPDEBUGLOG', true); define('WPDEBUG_DISPLAY', false);. Les erreurs PHP d'un plugin d'authentification iront dans wp-content/debug.log, sans s'afficher aux visiteurs. Désactivez ces options après l'intervention : le fichier peut exposer des chemins et des données sensibles.
Côté serveur, filtrez le journal d'accès sur la route concernée :
grep "wp-json/wp/v2/users/me" access.log | tail
Un statut 401 ou 403 avec une taille de réponse atypique oriente le diagnostic. Comparez l'IP source et l'agent utilisateur avec ceux de votre test cURL.
Consultez enfin les journaux du WAF (Cloudflare, ModSecurity, Wordfence). Cherchez l'identifiant de règle déclenchée, par exemple une règle ModSecurity 949110 de score d'anomalie. Créez une exception ciblée sur la route REST et l'IP du client, plutôt que de désactiver la protection globalement.
Wordfence, Security Ninja et les autres extensions de sécurité
Wordfence : l'option qui bloque les mots de passe d'application
Les mots de passe d'application (Application Passwords) reposent sur l'API REST de WordPress et une authentification HTTP Basic. Wordfence peut les désactiver sans avertissement. Dans Wordfence > Tous les paramètres > Options générales de Wordfence, la case « Désactiver les mots de passe d'application WordPress » est cochée par défaut sur certaines installations récentes. Conséquence : le champ de création disparaît du profil utilisateur, ou les requêtes distantes reçoivent une erreur 401 ou 403.
Procédure de vérification :
- Ouvrez les paramètres généraux de Wordfence et décochez l'option.
- Enregistrez, puis purgez le cache serveur et celui de l'extension de cache.
- Régénérez un mot de passe depuis le profil : un secret créé avant le changement n'est pas toujours exploitable.
- Testez avec une requête
curl -u utilisateur:motdepasse /wp-json/wp/v2/users/me.
Le compromis est réel : réactiver cette fonction élargit la surface d'attaque par force brute sur l'API. Limitez-la aux comptes d'intégration, avec un rôle restreint, et laissez active la limitation de tentatives de connexion.
Deux extensions de sécurité actives : vérifier chacune séparément
Associer Wordfence à Security Ninja, iThemes Security (Solid Security) ou All In One WP Security est fréquent en agence, et les règles se cumulent. Une seule extension restrictive suffit à bloquer l'authentification, même si les autres sont correctement réglées. Chacune peut agir sur l'API REST, le XML-RPC, l'en-tête Authorization ou le pare-feu applicatif (WAF).
Méthode d'isolement, sur un environnement de préproduction de préférence :
- Désactivez une extension à la fois, puis relancez le test d'authentification après chaque étape.
- Notez laquelle rétablit l'accès, puis cherchez le réglage exact : restriction REST, liste blanche d'IP, règle de blocage d'URL.
- Consultez les journaux du pare-feu pour repérer les requêtes bloquées vers
/wp-json/.
Une fois le paramètre identifié, réactivez l'extension et corrigez uniquement cette règle. Cette approche évite de laisser un site sans protection et documente le réglage pour les équipes de maintenance.
Cas concret : connecter un outil de publication automatique
Tester la connexion avant de programmer vos articles
Avant de planifier cinquante publications, validez l'authentification avec une requête isolée. Depuis un terminal, appelez le point d'accès REST (interface de programmation de WordPress) qui renvoie l'utilisateur courant :
curl -u "identifiant:xxxx xxxx xxxx xxxx xxxx xxxx" https://votresite.fr/wp-json/wp/v2/users/me
Un code HTTP 200 accompagné d'un objet JSON contenant l'identifiant de l'utilisateur confirme que le mot de passe d'application est accepté. Utilisez le nom de connexion réel, pas l'adresse e-mail. Les espaces du mot de passe généré sont facultatifs, mais les guillemets sont indispensables.
Ensuite, créez un article avec le statut draft (brouillon) via POST /wp-json/wp/v2/posts. Si le brouillon apparaît dans l'administration, le droit editposts est bien attribué. Contrôlez enfin le rôle : un abonné s'authentifie, mais ne publie rien. Dans l'outil, programmez d'abord un seul article, à cinq minutes d'intervalle, pour vérifier le cycle complet.
Que faire si l'outil affiche une erreur 401
Une erreur 401 (non autorisé) signifie que le serveur n'a pas reconnu les identifiants. Procédez par élimination :
- Saisie : régénérez le mot de passe, copiez-le sans caractère parasite et vérifiez l'identifiant.
- En-tête Authorization : certains hébergements Apache en mode CGI suppriment cet en-tête. Ajoutez dans le fichier .htaccess la ligne
SetEnvIf Authorization "(.*)" HTTPAUTHORIZATION=$1. - Extensions de sécurité : un pare-feu applicatif (WAF) ou l'option de désactivation de l'API REST peut bloquer la requête. Testez en les désactivant temporairement.
- HTTPS : sans connexion sécurisée, WordPress désactive les mots de passe d'application, sauf environnement local.
- Redirections : une redirection de http vers https ou de www vers le domaine nu fait perdre l'en-tête. Saisissez l'URL finale exacte.
Si le test curl réussit mais que l'outil échoue, le défaut vient de sa configuration, pas de WordPress.
Checklist de dépannage en 8 points
Les vérifications à faire dans l'ordre
Procédez du plus probable au plus rare. Chaque étape élimine une famille de causes.
- Version de WordPress : les mots de passe d'application existent depuis la 5.6 (décembre 2020). Vérifiez aussi que la section apparaît dans le profil utilisateur.
- HTTPS : sans connexion chiffrée, la fonctionnalité est désactivée par défaut, sauf en environnement local déclaré comme tel via
wpgetenvironmenttype(). - Filtre
wpisapplicationpasswordsavailable: un plugin de sécurité ou un fichierfunctions.phppeut le forcer àfalse. - En-tête Authorization : Apache en CGI/FastCGI le supprime parfois. Ajoutez dans
.htaccess:RewriteRule .* - [E=HTTPAUTHORIZATION:%{HTTP:Authorization}]. - Identifiants : utilisez le nom de connexion, non l'adresse e-mail, et conservez les espaces du mot de passe généré ou supprimez-les de façon cohérente.
- Plugins de sécurité et WAF : désactivez temporairement Wordfence, iThemes ou une règle Cloudflare bloquant
/wp-json/et l'authentification Basic. - Authentification à deux facteurs : elle ne s'applique pas à l'API REST, mais certains modules la bloquent. Testez avec un compte sans 2FA.
- Test direct :
curl -u utilisateur:motdepasse https://exemple.fr/wp-json/wp/v2/users/me. Un code 401 indique un rejet d'authentification, un 403 un blocage par règle serveur.
Quand faire appel à votre hébergeur
Escaladez dès que le test curl échoue alors que les points 1 à 6 sont validés. Les causes sont alors situées hors de WordPress : reverse proxy, module modsecurity, configuration PHP-FPM qui n'transmet pas l'en-tête.
Préparez un ticket exploitable : réponse complète de curl avec -i, version de PHP, type de serveur (Apache, Nginx, LiteSpeed), extrait du journal d'erreurs et liste des plugins actifs. Demandez explicitement de vérifier le transfert de HTTPAUTHORIZATION et les règles WAF appliquées à /wp-json/. Cette précision réduit souvent le délai de résolution à quelques heures.
Questions fréquentes
Les mots de passe d'application fonctionnent-ils sans HTTPS ?
Par défaut, non. WordPress ne les active que si le site est servi en HTTPS, ou si la constante WPENVIRONMENTTYPE vaut « local ». Le filtre wpisapplicationpasswordsavailable permet de contourner ce blocage, mais transmettre des identifiants en Base64 (un encodage, pas un chiffrement) sur HTTP les expose à une interception triviale. À réserver à un environnement de test isolé.
Quelle est la différence entre un mot de passe d'application et le mot de passe du compte ?
Le mot de passe d'application est un jeton de 24 caractères, généré par utilisateur et révocable individuellement. Il ne sert qu'à l'authentification Basic sur l'API REST et XML-RPC, jamais à la connexion à wp-login.php. Une fuite se traite donc par la révocation d'une seule entrée, sans changer le mot de passe principal ni couper les autres intégrations.
Faut-il saisir les espaces affichés dans le mot de passe généré ?
WordPress affiche le jeton en six groupes de quatre caractères séparés par des espaces, uniquement pour la lisibilité. À la validation, les espaces sont ignorés, donc les deux formes sont acceptées. En revanche, un espace en début ou fin de chaîne, copié par erreur depuis un tableau de bord, provoque parfois un échec 401 dans certains clients HTTP.
Quel rôle utilisateur faut-il attribuer au compte de l'intégration ?
Appliquez le principe du moindre privilège. Un outil de publication n'a besoin que du rôle Auteur, voire Éditeur s'il gère les catégories ; Administrateur n'est justifié que pour des opérations sur les extensions ou les réglages. Le jeton hérite des capacités du compte : s'il est compromis, le périmètre du dommage est celui du rôle.
Un mot de passe d'application expire-t-il ?
Non, aucune expiration native n'existe. WordPress enregistre seulement la date de création, la date et l'IP de dernière utilisation. Pour un usage en entreprise, instaurez une rotation, par exemple tous les 90 jours, et révoquez les jetons inactifs depuis plus de 30 jours.
Peut-on désactiver cette fonctionnalité pour tout le site ?
Oui, avec addfilter('wpisapplicationpasswordsavailable', 'returnfalse'). Pour la limiter à certains comptes, utilisez le filtre wpisapplicationpasswordsavailableforuser, qui reçoit l'objet utilisateur. Cette restriction est utile sur un multisite ou un site de e-commerce où seuls un ou deux comptes techniques doivent exposer l'API.
Retenir l'essentiel pour résoudre vos erreurs d'authentification
Dans la grande majorité des cas, un mot de passe d'application WordPress défaillant s'explique par quatre causes : un en-tête Authorization supprimé avant d'atteindre PHP, une extension de sécurité qui bloque l'API REST, une installation sans HTTPS, ou une section absente du profil à cause d'un filtre ou d'une constante. Le code de retour oriente aussitôt le diagnostic : un 401 pointe vers les identifiants ou l'en-tête, un 403 vers un pare-feu ou une règle serveur.
La méthode reste constante. Reproduisez la requête avec cURL, isolez la couche fautive (Apache, Nginx, PHP-FPM, extension), puis confirmez dans les journaux. Cette démarche prend une quinzaine de minutes, contre plusieurs heures de tâtonnement lorsqu'on modifie les réglages au hasard.
Pour une intégration en production, comme un outil de publication automatique, créez un utilisateur dédié aux droits minimaux, un mot de passe par service et notez la date de création. Vous pourrez ainsi révoquer un accès sans interrompre les autres flux. Gardez enfin la checklist en 8 points à portée de main : elle évite de rouvrir le même ticket à chaque mise à jour de l'hébergement ou du pare-feu.
Orchestrateur se connecte à WordPress et publie vos articles pour vous. Voir comment ça marche

