Zum Hauptinhalt gehen

Troubleshooting REST Konnektivität

  • Aktualisiert

Es gibt eine Reihe an Abfragen, die per CMD (Commandline) abgesetzt werden können, um eine REST-Konnektivität zu testen. Admin Rechte sind hierzu nicht notwendig. 

Führen Sie die Abfragen auf jenen Maschinen aus, auf denen Sie versuchen, eine Verbindung aufzubauen. Dies könnte je nach Einsatz jene Maschinen sein, auf denen PowerBi, Excel, Ihr Confluence Server oder andere 3rd Party Produkte ausgeführt werden.

 

Abfrage einer grundsätzlichen Konnektivität

On premise - BOC Produkt in Ihrer eigenen Infrastruktur

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

Cloud (SaaS) - BOC Produkt, dass in unserer Cloud betrieben wird 

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

Positive Antwort:

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

Wenn diese Abfrage erfolgreich war, kann mit den folgenden Tests fortgefahren werden.


Negative Antwort 1: 

--connect-timeout

Ein mögliches Netzwerkproblem liegt vor, der REST Befehl kommt nicht beim Apache Tomcat an.

 

Negative Antwort 2: 

Jede andere Antwort verweist auf einen möglichen Proxy, der sich zwischen Ihrer Maschine und dem Tomcat befindet.

Dazu können folgende Elemente zählen:

  • Reverse Proxy
  • Firewall
  • IIS

Log-Dateien der einzelnen Komponenten in Ihrer Infrastruktur können Aufschluss über einen Lösungsweg bieten.


Abfrage einer Basic Authentifizierung

On premise - BOC Produkt in Ihrer eigenen Infrastruktur

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

Cloud (SaaS) - BOC Produkt, dass in unserer Cloud betrieben wird 

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

Wichtig: Hierfür müsste Basic Auth aktiviert und konfiguriert sein. Der Test funktioniert nur mit lokalen, nicht technischen Usern: Basic Authentication | BOC Developer Portal

ADONIS 16, ADOIT 17 und ADOGRC 13 und später: Basic Auth Anleitung
Vor ADONIS 16, ADOIT 17 und ADOGRC 13: Basic Auth Anleitung

 

Positive Antwort:

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


Negative Antwort 1: 

Unauthorized : basic_auth_invalid 

Mögliche Gründe:

Negative Antwort 2: 

basic_auth_not_allowed

Mögliche Gründe:


Abfrage eines Repository

On premise - BOC Produkt in Ihrer eigenen Infrastruktur

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

Cloud (SaaS) - BOC Produkt, dass in unserer Cloud betrieben wird 

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


Positive Antwort:

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


Negative Antwort 1:

basic_auth_invalid

Mögliche Gründe:

  • Falsche Credentials angegeben


Negative Antwort 2: 

{"repos":[]}

Mögliche Gründe:

  • Dem User wurden keine Repositorys zugewiesen.

 

Weiterführende Informationen zur REST-API

Welcome to the BOC Developer Portal | BOC Developer Portal


 

Verwandte Beiträge