Aller au contenu principal

Dépannage de la connexion REST-API

  • Mise à jour

Un certain nombre de requêtes peuvent être exécutées via CMD (ligne de commande) pour tester la connectivité REST-API. Les droits d’administrateur ne sont pas requis pour cela. 

Exécutez les requêtes sur les machines où vous essayez d’établir une connexion. Selon l’utilisation, cela peut être des machines exécutant PowerBi, Excel, votre Serveur Confluence ou tout autre produit tiers.

 

Interrogation de la connectivité de base

Sur site - Produit BOC dans votre propre infrastructure

curl https://<SERVER_NAME>:<PORT>/<PRODUCT><VERSION>/rest/connection

Cloud (SaaS) - Produit BOC hébergé par nos soins

curl https://example-pp123456.boc-cloud.com/rest/connection

Réponse positive :

REST Connection Service Evaluation invoked @ Mon Mar 10 15:50:36 CET 2025

Si cette requête a réussi, vous pouvez poursuivre avec les tests suivants.


Réponse négative 1 : 

--connect-timeout

Un problème réseau possible existe. La commande REST n’atteint pas votre serveur Apache Tomcat.

 

Réponse négative 2 : 

Toute autre réponse indique un proxy possible entre votre machine et le serveur Tomcat.

Les éléments suivants peuvent être impliqués :

  • Proxy inverse
  • Pare-feu
  • IIS

Les fichiers journaux des différents composants de votre infrastructure peuvent fournir des indications pour une solution.


Interrogation de l’authentification de base

Sur site - Produit BOC dans votre propre infrastructure

curl -u "username:password" https://<SERVER_NAME>:<PORT>/<PRODUCT><VERSION>/rest/connection/auth

Cloud (SaaS) - Produit BOC hébergé par nos soins

curl -u "username:password" https://example-pp123456.boc-cloud.com/rest/connection/auth

Important : L’authentification de base doit être activée et configurée pour que cela fonctionne. Le test ne fonctionne qu’avec des utilisateurs locaux, non techniques : Authentification de base | Portail développeur BOC
 
ADONIS 16, ADOIT 17, et ADOGRC 13 et versions ultérieures : Guide d’authentification de base
Avant ADONIS 16, ADOIT 17, et ADOGRC 13 : Guide d’authentification de base

 

Réponse positive :

Authorized Access Granted @ Mon Mar 10 15:54:54 CET 2025


Réponse négative 1 : 

Unauthorized : basic_auth_invalid 

Raisons possibles :

  • Identifiants utilisateur incorrects
  • Un utilisateur IDM ou technique a été utilisé
  • Authentification de base non activée/configurée entièrement
     

Réponse négative 2 : 

basic_auth_not_allowed

Raison possible :


Interrogation d’un dépôt

Sur site - Produit BOC dans votre propre infrastructure

curl -u "username:password" https://<SERVER_NAME>:<PORT>/<PRODUCT><VERSION>/rest/<restversion>/repos

Cloud (SaaS) - Produit BOC hébergé par nos soins

curl -u "username:password" https://example-pp123456.boc-cloud.com/rest/<restversion>/repos


Réponse positive :

{"repos":[{"id":"{163197e6-b923-495b-a1be-814af464a620}","name":"Standard Repository"}]}


Réponse négative 1 :

basic_auth_invalid

Raison possible :

  • Identifiants incorrects saisis


Réponse négative 2 : 

{"repos":[]}

Raison possible :

  • Aucun dépôt assigné à l’utilisateur

 

Informations complémentaires sur REST-API

Bienvenue sur le Portail développeur BOC | Portail développeur BOC


 

Articles associés