rest_authentication_errors

Définition : rest_authentication_errors est un filtre WordPress utilisé par les mécanismes d’authentification REST pour signaler un succès, une erreur ou l’absence de traitement par la méthode considérée.

Comprendre et utiliser

À quoi sert cette notion ?

Il permet à différents mécanismes d’authentification de coopérer sans se bloquer mutuellement. Sa connaissance est essentielle aux extensions qui ajoutent un fournisseur d’identité.

Fonctionnement technique

La valeur filtrée peut être null, true ou WP_Error. Un mécanisme qui ne reconnaît pas la demande doit normalement laisser la valeur appropriée pour permettre aux autres méthodes de fonctionner.

Dans quel contexte l’utiliser ?

Un plugin d’intégration détecte si son propre mécanisme d’authentification a été sollicité sans interférer avec les mots de passe d’application et les cookies.

Étude de cas : application professionnelle

Lorsque plusieurs fournisseurs d’authentification coexistent, une extension ne doit pas déclarer un succès si elle n’a pas réellement reconnu et vérifié la demande. Le filtre rest_authentication_errors permet de conserver l’état établi ou de laisser un autre mécanisme agir. Tester séparément une session navigateur, un mot de passe d’application et une requête publique. Un filtre qui retourne true systématiquement peut rompre la sécurité de toutes les routes. La bonne discipline consiste à identifier précisément la méthode engagée, vérifier son résultat, et préserver les erreurs déjà produites.

Exemple technique commenté

Cet extrait est destiné à un fichier PHP chargé par WordPress, idéalement dans un plugin local de test. Il ne doit pas être placé dans l'éditeur de contenu. Avant exécution, vérifier que les objets et variables mentionnés existent dans le contexte et que les permissions nécessaires sont définies.

<?php
add_filter( 'rest_authentication_errors', function ( $result ) {
    // Ne pas écraser un résultat déjà établi.
    if ( null !== $result ) {
        return $result;
    }
    // Aucun mécanisme personnalisé appliqué ici.
    return null;
} );

Décryptage du code et résultat attendu

Cet exemple est volontairement neutre et ne met en œuvre aucune authentification personnalisée. Il illustre le respect du résultat déjà produit par un autre composant.

Exercice guidé pour vérifier la notion

Dans un environnement de test, observer les trois familles de valeurs possibles et confirmer qu’un endpoint public fonctionne encore.

Précautions et limites

Ne pas retourner true systématiquement : cela annoncerait un succès d’authentification sans preuve. Ne pas utiliser ce filtre comme mécanisme global de blocage de toutes les routes.