L'erreur 401 Unauthorized signifie que la requête nécessite une authentification que le client n'a pas fournie ou qui est invalide. C'est une réponse normale pour les ressources protégées.
Le problème survient quand une page publique renvoie 401 de façon inattendue, ou quand vos identifiants valides sont rejetés. Ce guide vous aide à diagnostiquer ces cas.
Causes Principales
- Identifiants incorrects : Le username/password ou le token API est invalide ou expiré.
- Protection .htpasswd : Un .htaccess protège le dossier avec une authentification HTTP Basic.
- Token expiré : Le token JWT ou OAuth a expiré et doit être renouvelé.
- Header manquant : L'en-tête Authorization n'est pas envoyé ou mal formaté.
Diagnostic
- Vérifier le header : Utilisez les DevTools pour voir si Authorization est bien envoyé.
- Tester les credentials : Validez que les identifiants sont corrects dans un autre contexte.
- Vérifier l'expiration : Pour les tokens JWT, décodez-les pour voir la date d'expiration.
Solutions
- Renouveler le token : Obtenez un nouveau token avec le refresh token ou réauthentifiez.
- Corriger le format : Assurez-vous que le header est "Authorization: Bearer " ou "Basic ".
- Supprimer .htpasswd : Si la protection n'est plus voulue, retirez les directives AuthType du .htaccess.
Questions Fréquentes
Différence entre 401 et 403 ?
401 = "qui êtes-vous ?" (authentification requise). 403 = "je sais qui vous êtes, mais non" (autorisation refusée).
Comment monitorer une API protégée ?
MoniTao permet de configurer des headers d'authentification (Bearer token, Basic Auth) pour surveiller les endpoints protégés.
Le token est correct mais j'ai toujours 401 ?
Vérifiez l'horloge serveur (JWT vérifie exp), le format exact du header, et que le token n'est pas révoqué.
Un 401 est-il une erreur à surveiller ?
Sur une page publique, oui. Sur une page protégée, c'est normal. Configurez MoniTao selon votre cas d'usage.
Prêt à dormir sur vos deux oreilles ?
Commencez gratuitement, sans carte bancaire.