Comment corriger les codes d'état REST 401 et 500 ?

Problème 1 : L'utilisateur ne peut pas accéder à REST (code d'état 401)​

Ce problème est lié à l'authentification. Il indique que l'utilisateur n'a pas la permission d'accéder aux ressources demandées.

Solution : Vérifier l'authentification​

• Vérifiez les Méthodes d'authentification pour ADONIS ou Méthodes d'authentification pour ADOIT (Basic, Token, etc...). Pour ADOGRC, veuillez utiliser le Guide pour ADONIS.
• Lors de l'utilisation de l'authentification basique, configurez le paramètre basicauth_ip_restrictions en spécifiant les adresses IP autorisées à envoyer des requêtes à l'API REST en utilisant l'authentification basique. Pour plus d'informations, consultez la section "Comment utiliser les contraintes IP" dans le manuel d'administration. Encadrez chaque règle par des guillemets.
• Les restrictions qui s'appliquent lors de l'utilisation de l'authentification basique sont décrites dans le Portail développeur BOC dans l'article "Authentification basique".
• Vérifiez si IDM est activé. Des étapes de configuration spécifiques sont nécessaires pour configurer le client web pour ce mécanisme d'authentification. Veuillez contacter votre gestionnaire de compte client pour les instructions.

Problème 2 : L'utilisateur ne peut pas accéder à REST (code d'état 401) en SaaS​

Vous utilisez un produit BOC hébergé dans le cloud BOC (SaaS). L'accès REST à l'environnement était auparavant possible, mais vous ne pouvez plus y accéder maintenant.

Solution : Faire débloquer l'adresse IP​

Les environnements hébergés ont une restriction d'accès supplémentaire : leur propre liste blanche d'IP. Il arrive que l'infrastructure de l'entreprise change et que BOC ne soit pas informé de ces changements (c'est-à-dire que le client demandeur a maintenant une adresse IP différente).

Réessayez la requête et envoyez le horodatage (date et heure) de la requête au support technique BOC. Nous vérifierons alors si votre adresse IP a été bloquée et nous étendrons la liste blanche d'IP si nécessaire.

Remarque : Les ajustements de la liste blanche d'IP ne sont effectués que si la demande est faite par une personne autorisée.

Problème 3 : Les requêtes retournent un code d'état 500 (erreur interne du serveur).​

Certaines requêtes REST fonctionnent normalement sur un client, tandis que d'autres retournent un code d'état 500 (erreur interne du serveur).

Solution : Ajuster le délai d'attente​

Cela se produit généralement avec (mais pas uniquement) des logiciels clients tiers tels qu'Excel et PowerBI.

Ces applications ont généralement une forme de délai d'attente configurée pour offrir une meilleure expérience utilisateur. Une valeur courante est de 100 secondes pour un délai d'attente. Une fois ce délai atteint, l'application interrompt l'opération et signale l'erreur générique "erreur 500".

Cependant, certaines requêtes REST vers le logiciel BOC Management Office peuvent prendre beaucoup plus de temps que 100 secondes. La durée spécifique dépend de nombreux facteurs et peut donc varier.

Ajustez la valeur du délai d'attente dans le logiciel client affecté pour résoudre l'erreur. Plusieurs tentatives avec différentes valeurs peuvent être nécessaires jusqu'à trouver une valeur adaptée.