Ce guide vous montre comment laisser un outil externe lire ou écrire du contenu par l’API REST de WordPress. Cet outil peut être une application mobile, un script de déploiement, un outil d’automatisation, un tableau de bord de rapports ou un autre site WordPress. REST veut dire « representational state transfer ». C’est l’interface HTTP que WordPress publie à /wp-json/. Une API, pour « application programming interface », c’est la façon dont un programme parle à un autre. Donner votre compte administrateur à cet outil est une mauvaise idée. Ça expose le compte dont vous vous servez chaque jour, et ça cesse de marcher le jour où vous activez l’authentification à deux facteurs. La réponse, c’est le mot de passe d’application, un second identifiant intégré au cœur de WordPress depuis la version 5.6, qui ne sert qu’aux appels d’API et qui se révoque tout seul. À la fin, vous aurez un identifiant limité, un appel qui fonctionne avec curl et une routine pour le vérifier et le changer.
Ce que vous allez accomplir
- Créer un mot de passe d’application pour un utilisateur WordPress, autant depuis l’écran de profil que depuis la ligne de commande.
- Donner à l’outil externe son propre utilisateur, avec seulement les permissions dont il a besoin, au lieu de réutiliser un administrateur.
- Appeler l’API REST avec curl et recevoir une vraie réponse, en lecture comme en écriture.
- Distinguer un 401 d’un 403 du premier coup d’œil, pour corriger l’identifiant ou la permission au lieu de deviner.
- Résultat final : une application externe qui s’authentifie en HTTPS avec un identifiant révocable en quelques secondes, sans toucher au mot de passe de qui que ce soit.
Prérequis
- WordPress 5.6 ou plus récent. Vérifiez avec
wp core version, ou regardez Tableau de bord → Mises à jour. - Le site servi en HTTPS, c’est-à-dire HTTP protégé par TLS (« transport layer security », le chiffrement qui protège les données en transit). WordPress cache toute la fonction sur un site en HTTP simple, et ce guide n’offre aucun contournement.
- Un compte administrateur sur le site, pour créer des utilisateurs et lire les mots de passe d’application des autres.
- Un accès shell comme utilisateur du site, par SSH (le protocole de terminal distant chiffré) ou par le Terminal de cPanel. Il vous faut aussi WP-CLI, l’outil WordPress en ligne de commande, disponible sous
wp. Vérifiez avecwp --info. Les étapes 4, 6 et 8 donnent aussi un chemin sans shell. curl, le client HTTP en ligne de commande, sur la machine d’où vous testez. Vérifiez aveccurl --version.- Une chose à savoir avant de commencer. Un mot de passe d’application contourne l’authentification à deux facteurs, par conception, parce qu’un script ne peut pas taper un code reçu sur un téléphone. C’est exactement pour ça que l’utilisateur qui le porte doit être limité. Si vous n’avez pas encore mis en place l’authentification à deux facteurs sur vos comptes admin, faites-le d’abord.
Comment ça fonctionne
Un mot de passe d’application est un identifiant de 24 caractères que WordPress génère pour un utilisateur et range sous forme de hachage, comme il range un mot de passe de connexion. Ce n’est pas une clé d’API au sens habituel, parce qu’il ne porte aucune permission à lui. Il emprunte les rôles et les capacités de l’utilisateur auquel il appartient : un mot de passe sur un compte Auteur ne peut faire que ce qu’un Auteur peut faire. Un utilisateur peut en détenir plusieurs, chacun avec un nom que vous choisissez, et en révoquer un laisse les autres et le mot de passe de connexion intacts.
L’application externe l’envoie par l’authentification HTTP Basic, le mécanisme défini dans la RFC 7617. Le client colle le nom d’utilisateur et le mot de passe d’application avec un deux-points, encode cette chaîne en base64 et l’envoie dans un en-tête : Authorization: Basic <encodé>. Le base64 est un encodage, pas un chiffrement, et quiconque lit l’en-tête lit le mot de passe qui s’y trouve. C’est pour cette seule raison que le HTTPS est obligatoire et non recommandé. WordPress refuse même d’afficher le panneau des mots de passe d’application sur un site qui ne l’utilise pas.
WordPress ignore les espaces et la ponctuation dans la valeur : la forme groupée que l’écran d’admin vous montre et la chaîne continue de 24 caractères marchent toutes les deux.
Deux traces sont conservées pour chaque mot de passe d’application : last_used, la date de sa dernière authentification, et last_ip, l’adresse d’où il venait. Ces deux champs constituent toute la piste de vérification, et l’étape 8 s’en sert.
Étapes
1. Confirmez que c’est le bon identifiant. Le mot de passe d’application convient à un appelant que vous contrôlez : votre script, votre tableau de bord, un autre de vos sites. Il convient à un outil unique qui agit sous une seule identité. Il ne convient pas à un produit qui doit agir pour plusieurs personnes différentes. Il ne convient pas non plus à une session de navigateur sur votre propre site, qui possède déjà un témoin.
2. Vérifiez que la fonction est disponible sur ce site. WordPress désactive les mots de passe d’application sur un site qui n’utilise pas HTTPS. Une extension ou un bout de code peut aussi les désactiver. Posez la question directement à WordPress plutôt que de fouiller les écrans d’administration.
cd ~/public_html
wp option get siteurl
wp eval 'var_export( wp_is_application_passwords_available() ); echo "\n";'
https://example.com
true
true veut dire que vous pouvez continuer. false avec une adresse de site en http:// veut dire qu’il faut corriger le HTTPS d’abord. false avec une adresse en https:// veut dire que quelque chose sur le site filtre la fonction, et le dépannage couvre ce cas.
3. Créez un utilisateur avec seulement les permissions dont l’outil a besoin. Réutiliser votre compte administrateur permet à l’outil externe d’installer des extensions et de modifier les autres utilisateurs. Un tableau de bord de rapports n’a rien à faire là. Prenez le plus petit rôle intégré qui couvre le travail. Abonné peut lire ; Contributeur peut écrire des brouillons ; Auteur peut publier ses propres articles ; Éditeur peut modifier ceux de tout le monde.
wp user create reporting-bot bot@example.com \
--role=author --display_name='Reporting bot'
Success: Created user 7.
Password: aX2%tRq8Lm#4Ze1v
WP-CLI affiche un mot de passe de connexion parce que chaque utilisateur en a un. Vous ne vous en servirez pas, et ce compte n’a jamais besoin de se connecter. Si aucun rôle intégré ne convient, clonez le plus proche et ajustez ses capacités.
wp role create api_reader 'API reader' --clone=subscriber
wp cap add api_reader edit_posts
wp cap list api_reader
Success: Role with key 'api_reader' created.
Success: Added 1 capability to 'api_reader' role.
read
edit_posts
4. Créez le mot de passe d’application dans l’écran de profil. Connectez-vous comme administrateur et ouvrez Utilisateurs → Tous les utilisateurs, puis cliquez sur l’utilisateur créé à l’étape 3. Descendez jusqu’à la section Mots de passe d’application, près du bas. Tapez dans Nom du nouveau mot de passe d’application un nom qui dit quel outil le portera, par exemple reporting-dashboard, puis cliquez sur Ajouter un nouveau mot de passe d’application.
Le mot de passe apparaît une seule fois, en six groupes de quatre caractères, avec un bouton pour le copier. Copiez-le tout de suite. WordPress ne garde qu’un hachage : perdre la valeur oblige à en créer une nouvelle. Le nom est une étiquette pour vos propres dossiers et n’accorde rien.
5. Ou créez-le avec WP-CLI. C’est le chemin pour un script de déploiement ou un serveur sans session de navigateur. Le second argument est le nom, et --porcelain affiche le mot de passe seul, pour que vous puissiez le rediriger ailleurs.
wp user application-password create reporting-bot reporting-dashboard --porcelain
K3mRqz7TbVnW9pXs2Ldh4Jf6
Sans --porcelain, la même valeur apparaît dans un message de succès. Dans les deux cas, elle s’affiche une seule fois. Rangez-la directement dans un gestionnaire de secrets, ou dans un fichier d’environnement que seul le service appelant peut lire.
6. Appelez l’API REST avec curl. Commencez par une lecture qui prouve qui WordPress croit que vous êtes. Tapez le mot de passe dans une variable du shell d’abord, pour qu’il reste hors de votre historique et hors de la liste des processus.
read -rs WP_APP_PASSWORD
curl -sS -u "reporting-bot:$WP_APP_PASSWORD" \
'https://example.com/wp-json/wp/v2/users/me?_fields=id,name,slug'
{"id":7,"name":"Reporting bot","slug":"reporting-bot"}
Voilà toute la poignée de main. L’option -u bâtit l’en-tête Authorization: Basic pour vous. Si votre langage n’a pas d’équivalent, bâtissez l’en-tête vous-même à partir du base64 de user:password.
printf '%s' "reporting-bot:$WP_APP_PASSWORD" | base64
cmVwb3J0aW5nLWJvdDpLM21ScXo3VGJWblc5cFhzMkxkaDRKZjY=
Envoyez cette valeur comme en-tête et le résultat est identique.
curl -sS -H "Authorization: Basic cmVwb3J0aW5nLWJvdDpLM21ScXo3VGJWblc5cFhzMkxkaDRKZjY=" \
'https://example.com/wp-json/wp/v2/users/me?_fields=id,slug'
Prouvez maintenant qu’il peut écrire. Ceci crée un brouillon, qu’on peut supprimer après.
curl -sS -u "reporting-bot:$WP_APP_PASSWORD" -X POST \
-H 'Content-Type: application/json' \
-d '{"title":"Created by the reporting bot","status":"draft"}' \
'https://example.com/wp-json/wp/v2/posts?_fields=id,status,link'
{"id":5120,"status":"draft","link":"https://example.com/?p=5120"}
7. Donnez à chaque outil son propre mot de passe. Un identifiant partagé entre trois outils ne peut pas être révoqué sans en casser deux. Le changer ne coûte alors rien. Créez le remplaçant, déployez-le, confirmez qu’il marche, puis supprimez l’ancien par son UUID. Un UUID, pour « universally unique identifier », c’est la longue chaîne à tirets que WordPress attribue à chaque mot de passe d’application.
wp user application-password list reporting-bot \
--fields=uuid,name,created,last_used,last_ip
+--------------------------------------+---------------------+------------+------------+---------------+
| uuid | name | created | last_used | last_ip |
+--------------------------------------+---------------------+------------+------------+---------------+
| 6f1c0a3e-77b2-4d51-9a08-2b5e4c9d1f30 | reporting-dashboard | 2026-09-19 | 2026-09-19 | 203.0.113.44 |
| 1b7d9e02-3c64-4a88-b1f5-8e0a77c2d613 | deploy-runner | 2026-06-02 | 2026-09-18 | 198.51.100.12 |
+--------------------------------------+---------------------+------------+------------+---------------+
wp user application-password delete reporting-bot 1b7d9e02-3c64-4a88-b1f5-8e0a77c2d613
Success: Deleted 1 of 1 application password.
Si vous n’avez pas de politique à vous, changez-les une fois par année, et changez-les tout de suite quand quelqu’un qui détenait la valeur quitte l’équipe. La révocation prend effet à la requête suivante.
8. Vérifiez ce qui existe déjà. La plupart des sites en service depuis quelques années portent des mots de passe d’application que personne ne se rappelle avoir créés. Parcourez tous les utilisateurs et regardez la colonne last_used.
wp user list --field=ID | while read -r id; do
printf '\n== user %s ==\n' "$id"
wp user application-password list "$id" --fields=name,created,last_used,last_ip
done
Tout ce qui a un last_used vide, ou une date vieille de plusieurs mois, ne fait qu’élargir votre exposition. Supprimez-le. Vous pouvez aussi lire la liste par l’API elle-même, ce qui convient à une tâche de surveillance.
curl -sS -u "reporting-bot:$WP_APP_PASSWORD" \
'https://example.com/wp-json/wp/v2/users/me/application-passwords?_fields=name,last_used,last_ip'
Pour couper d’un coup tous les identifiants d’un utilisateur, après la perte d’un portable par exemple, révoquez-les tous. Dans le navigateur, le même bouton se lit Révoquer tous les mots de passe d’application sur le profil de l’utilisateur.
wp user application-password delete reporting-bot --all
Success: Deleted all application passwords.
Vérifier que ça fonctionne
Quatre contrôles, dans l’ordre. Le premier prouve que l’identifiant marche et le deuxième qu’un mauvais est refusé. Le troisième prouve que WordPress a noté l’usage, et le quatrième que le compte est aussi limité que prévu.
curl -sS -o /dev/null -w 'authenticated: %{http_code}\n' \
-u "reporting-bot:$WP_APP_PASSWORD" \
https://example.com/wp-json/wp/v2/users/me
curl -sS -o /dev/null -w 'wrong password: %{http_code}\n' \
-u 'reporting-bot:WrongWrongWrongWrong1234' \
https://example.com/wp-json/wp/v2/users/me
authenticated: 200
wrong password: 401
Un 200 sur la première ligne et un 401 sur la deuxième, c’est la paire recherchée. Deux 401 veulent dire que l’en-tête n’atteint pas WordPress, et le premier point du dépannage est pour vous. Deux 200 voudraient dire que quelque chose authentifie des requêtes qui devraient échouer, ce qui pointe vers une extension qui remplace l’authentification.
wp user application-password list reporting-bot --fields=name,last_used,last_ip
+---------------------+------------+--------------+
| name | last_used | last_ip |
+---------------------+------------+--------------+
| reporting-dashboard | 2026-09-19 | 203.0.113.44 |
+---------------------+------------+--------------+
La date du jour dans last_used confirme que l’appel que vous venez de faire a bien utilisé cet identifiant et pas un autre. Enfin, demandez à l’API quelque chose que le compte ne devrait pas avoir le droit de faire.
curl -sS -u "reporting-bot:$WP_APP_PASSWORD" \
'https://example.com/wp-json/wp/v2/users?_fields=id,slug'
{"code":"rest_user_cannot_view","message":"Sorry, you are not allowed to list users.","data":{"status":403}}
Un 403 ici est le signal de succès. Il veut dire que l’identifiant s’est authentifié et que la vérification de permission l’a ensuite arrêté, c’est-à-dire la limite que vous avez bâtie à l’étape 3.
Dépannage
Chaque requête retourne 401 même si le mot de passe est bon. D’habitude, le serveur web laisse tomber l’en-tête Authorization avant que PHP tourne. Ça arrive quand PHP tourne en mode CGI ou FastCGI. Sur Apache 2.4.13 et plus récent, ajoutez CGIPassAuth On dans l’hôte virtuel du site ou dans .htaccess. Un Apache plus vieux demande plutôt une règle de réécriture dans .htaccess, au-dessus du bloc WordPress.
RewriteEngine On
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule .* - [E=HTTP_AUTHORIZATION:%1]
Sur Nginx avec PHP-FPM, confirmez que l’en-tête est transmis dans le bloc location ~ \.php$.
fastcgi_param HTTP_AUTHORIZATION $http_authorization;
Rechargez le serveur web et refaites la paire de vérification plus haut.
La section des mots de passe d’application est absente de l’écran de profil. WordPress la cache quand wp_is_application_passwords_available() retourne false. Ça arrive sur un site dont l’adresse est en http:// au lieu de https://, et quand du code filtre la fonction. Vérifiez les deux.
wp option get siteurl
wp option get home
wp eval 'var_export( wp_is_application_passwords_available() ); echo "\n";'
grep -rn "wp_is_application_passwords_available" wp-content/ wp-config.php
Le grep cherche le filtre wp_is_application_passwords_available, la façon dont une extension, un thème ou un bout de code dans wp-config.php désactive la fonction. Un résultat qui retourne false est votre réponse. Corrigez le HTTPS plutôt que de forcer la fonction en HTTP simple, parce qu’en HTTP l’identifiant est lisible par n’importe qui sur le chemin réseau.
Vous obtenez un 403 avec rest_forbidden ou un code en rest_cannot_. L’identifiant a marché et la vérification de capacité a échoué : c’est un problème de permissions et non d’authentification. Regardez ce que l’utilisateur peut vraiment faire.
wp user get reporting-bot --fields=ID,user_login,roles
wp cap list author
Donnez au rôle la capacité manquante avec wp cap add, ou déplacez l’utilisateur vers un rôle qui l’a déjà. Résistez à l’envie de le passer administrateur, parce que ça défait l’étape 3. Notre guide sur les erreurs de l’API REST WordPress liste les autres codes d’erreur et ce que chacun désigne.
Les requêtes anonymes vers /wp-json/ échouent aussi. Le problème est alors la surface REST, pas votre identifiant. Testez sans aucun identifiant.
curl -sS -o /dev/null -w '%{http_code}\n' https://example.com/wp-json/
Un 200 veut dire que REST est joignable. Un 403, un 404 ou une page de défi en HTML veut dire qu’une extension de sécurité, une règle de pare-feu ou le CDN devant le site bloque /wp-json/. Autorisez l’adresse IP de votre appelant, ou resserrez la règle sur les routes que vous voulez vraiment fermer. Si vous aviez verrouillé REST plus tôt, revoyez comment restreindre l’accès non authentifié à l’API REST et ajoutez une exception pour cet utilisateur.
L’identifiant marche avec curl mais échoue depuis votre application. Deux causes expliquent la plupart des cas. Certains clients HTTP abandonnent les identifiants quand ils suivent une redirection : pointez l’application vers l’adresse canonique, sans redirection sur le chemin, ou activez l’équivalent de l’option --location-trusted de curl. D’autres n’envoient l’en-tête qu’après un défi 401 ; WordPress n’en émet pas, alors réglez le client pour qu’il envoie les identifiants Basic dès la première requête.
Quand ce n’est pas la bonne approche
Les mots de passe d’application conviennent à un appelant qui vous appartient. Ils cessent de convenir dans quatre situations.
Un produit qui agit pour plusieurs utilisateurs différents demande OAuth 2.0, ajouté par une extension. Chaque personne accorde l’accès depuis son propre compte et peut le retirer plus tard. Demander à des centaines de personnes de coller un mot de passe d’application dans un service externe ne sert bien personne.
Un frontal découplé, c’est-à-dire un site dont les pages sont rendues hors de WordPress, gagne d’habitude à passer par une extension à jetons JWT (« JSON Web Token »). Ces jetons sont de courte durée et expirent d’eux-mêmes, ce qui limite les dégâts quand l’un d’eux fuit dans un fichier journal.
Le trafic machine à machine à gros volume convient mal pour une autre raison. L’authentification Basic vérifie le hachage du mot de passe à chaque requête, ce qui coûte du vrai temps de processeur à des centaines de requêtes par minute. Un point d’accès bâti sur mesure, avec de la mise en cache et une limite de débit, vous servira mieux.
Et quand il vous faut une permission plus étroite que n’importe quel rôle WordPress, écrivez votre propre route REST avec un permission_callback qui vérifie exactement la capacité voulue. Le manuel de l’API REST WordPress couvre l’enregistrement des routes, et la documentation de WP-CLI couvre les commandes d’utilisateurs et de capacités employées plus haut. Pour d’autres motifs en ligne de commande comme ceux de ce guide, voyez nos notes sur les commandes WP-CLI avancées.
Un WordPress qui rapporte vraiment mérite un opérateur — Stack Harbor opère cette pile sous WordPress Entreprise ; réservez une consultation d’infrastructure.