HTTP 401 "Authentication failed" ou "Error 30: Invalid token" sur un appel web service
Le symptôme
Un appel SOAP ou REST vers un endpoint Syracuse (api1/x3/...) échoue avec le statut HTTP 401 Unauthorized. Le message retourné est soit "Authentication failed, please verify username and password and try again" (mode Basic Auth), soit "Error 30: Invalid token" (mode Bearer). Sur X3 2023 R1 avec Syracuse 12.18.x, une variante connue provoque un blocage silencieux : la requête reste en attente sans retourner d'erreur.
Cause probable
L'en-tête HTTP Authorization: Basic contient des identifiants incorrects ou mal encodés en base64, notamment en présence de caractères spéciaux. En mode Bearer, le jeton transmis est expiré ou invalide. Sur certaines configurations Syracuse 12.18.x, une combinaison login/mot de passe incorrecte déclenche un comportement de hang plutôt qu'un 401 immédiat, signalé comme anomalie connue.
Vérifications
- 01Contrôler la valeur exacte de l'en-tête Authorization envoyé : le format attendu est Basic base64(login:password), sans caractères spéciaux mal échappés dans la chaîne encodée.
- 02Vérifier que le compte utilisateur X3 utilisé dispose des habilitations nécessaires sur l'endpoint ou la ressource REST appelée.
- 03Si le mode d'authentification est Bearer, contrôler la validité et la date d'expiration du jeton auprès du fournisseur d'identité configuré dans Syracuse.
- 04Reproduire l'appel dans Postman en saisissant manuellement les identifiants, afin d'isoler un éventuel problème d'encodage côté application cliente.
- 05Si la requête se bloque sans retourner de code d'erreur sur X3 2023 R1 / Syracuse 12.18.x, rechercher dans la base de connaissances Sage un correctif documenté pour cette anomalie de hang.
Correction
Corriger les identifiants ou le jeton transmis dans l'en-tête d'authentification. Si le symptôme est un blocage silencieux plutôt qu'un 401 explicite sur Syracuse 12.18.x, appliquer le correctif Sage documenté pour cette anomalie, sans conclure à une panne du service.
Votre cas est différent ? Posez-le au copilote, la première réponse est gratuite.
Autres fiches sur ces versions
Cette fiche décrit une cause probable, pas un diagnostic sur votre dossier. Testez toujours hors production quand vous en avez la possibilité. House Info est indépendant de Sage.