Module REST

Ce que fait le module

Le module REST permet à BrynQ d'appeler une API REST de votre réseau. BrynQ envoie la requête (ou un lot de requêtes) à l'Agent, l'Agent appelle l'API interne et renvoie la réponse, y compris le code de statut et les en-têtes.

Il prend en charge l'authentification NTLM / Negotiate, souvent exigée par les applications IIS sur site (par exemple Exact Synergy, SharePoint ou d'anciennes versions de Dynamics).
Les réponses binaires, comme les fichiers PDF, sont renvoyées en toute sécurité (encodées en base64).

Quand l'utiliser

Une application sur site possède une API REST qui n'est pas accessible depuis Internet.
L'API exige une authentification Windows (NTLM).

Pas pour : les API cloud que BrynQ peut joindre directement.

Le configurer

Pendant l'installation : sélectionnez le module REST. L'adresse de l'API et les identifiants sont définis dans l'interface dans BrynQ.

Ensuite : le tableau de bord d'administration local > REST Proxy contient des paramètres par défaut :

Champ	Signification
Default Timeout (seconds)	Par défaut : 30.
Allowed URL Patterns	Les adresses internes utilisées, une par ligne, par exemple http://localhost:*.
Default Headers	En-têtes à ajouter par défaut, par exemple Content-Type: application/json.
Verify SSL	Indique si le certificat de l'API interne est vérifié.

Dépannage

Ce que vous voyez	Que faire
Statut 502 avec le code d'erreur OUTBOUND_REQUEST_FAILED	L'Agent n'a reçu aucune réponse de l'API interne : mauvaise adresse, problème DNS, connexion refusée ou délai dépassé. Ouvrez l'adresse de l'API dans un navigateur sur le serveur de l'Agent pour la tester.
Un autre statut d'erreur (401, 404, 500...)	L'API interne a elle-même répondu avec ce statut. Vérifiez l'adresse et les identifiants dans l'interface, ainsi que les journaux de cette application.
401 avec l'authentification NTLM/Windows	Vérifiez le nom d'utilisateur (DOMAIN\user) et le mot de passe utilisés par l'interface.
Un module renvoie 404 Not Found	Le module REST n'est pas activé. Relancez le programme d'installation et sélectionnez REST.

⚠ Attention aux nouvelles tentatives. Avec OUTBOUND_REQUEST_FAILED, la requête a peut-être quand même atteint l'application interne. Relancer une requête qui crée ou modifie des données peut alors créer un doublon.

Plus d'informations : Dépannage de l'Agent BrynQ.