Forum aux questions sur les webhooks

Cette rubrique répertorie les questions et problèmes susceptibles d’être rencontrés lorsque l’on utilise des webhooks, ainsi que des solutions possibles.

• ArcGIS Enterprise est déployé dans un environnement déconnecté derrière le pare-feu de mon organisation. Puis-je tout de même configurer des webhooks ?

• En quoi consiste la mise à jour d’un élément, d’un utilisateur ou d’un groupe ?

• J’utilise l’authentification Windows intégrée sur mon portail ArcGIS Enterprise. Puis-je tout de même m’abonner aux utilisateurs qui se connectent au portail et s’en déconnectent (user/<username>/signIn) ?

• Que se passe-t-il si ma payload URL est indisponible ou ne fonctionne plus ? Existe-t-il un moyen de récupérer une payload qui n’a pas été livrée ?

ArcGIS Enterprise est déployé dans un environnement déconnecté derrière le pare-feu de mon organisation. Puis-je tout de même configurer des webhooks ?

Oui. Pour configurer des webhooks, vous devez utiliser une payload URL que votre portail ArcGIS Enterprise peut atteindre. Pour ce faire, vous pouvez créer une application personnalisée et la déployer sur votre serveur interne.

En quoi consiste la mise à jour d’un élément, d’un utilisateur ou d’un groupe ?

Si vous vous êtes abonné aux mises à jour pour les éléments, utilisateurs et groupes de votre portail, votre webhook se déclenche dès que leurs propriétés sont mises à jour. Par exemple, si vous vous êtes abonné aux mises à jour d’un élément spécifique sur votre portail, votre webhook se déclenche si une mise à jour est apportée au titre, aux étiquettes ou à la miniature de cet élément. Pour déterminer facilement si une action constitue une mise à jour de votre portail, examinez le trafic réseau. Chaque fois qu’une action engendre l’appel de l’opération Update (Mise à jour), cette même action peut également déclencher un webhook qui écoutera les mises à jour.

J’utilise l’authentification Windows intégrée sur mon portail ArcGIS Enterprise. Puis-je tout de même m’abonner aux utilisateurs qui se connectent au portail et s’en déconnectent (user/<username>/signIn) ?

Vous pouvez utiliser l’événement déclencheur /signin afin de capturer les événements de connexion pour l’authentification au niveau du portail ou au niveau du Web et les identifiants de connexion d’entreprise.

Que se passe-t-il si ma payload URL est indisponible ou ne fonctionne plus ? Existe-t-il un moyen de récupérer une payload qui n’a pas été livrée ?

Lorsque vous configurez des webhooks d’organisation pour vos utilisateurs, vos groupes et vos éléments, vous avez la possibilité de configurer des paramètres avancés qui déterminent comment et quand le portail tente une autre livraison lorsqu’une payload n’est pas envoyée, ainsi qu’une politique de désactivation allant désactiver le webhook si les tentatives de livrer une payload continuent à échouer. Les paramètres de webhook de service emploient les mêmes politiques de désactivation. Si le portail ou le service tente de livrer une payload à une payload URL ou un récepteur webhook qui est inaccessible ou qui ne répond pas, les paramètres avancés que vous avez définis déterminent le nombre de tentatives supplémentaires que le portail effectue pour livrer la payload. Si ces tentatives supplémentaires échouent également, cela compte comme un seul échec dans la politique de désactivation.

Pour voir toutes les tentatives de livraison de la payload et déterminer si elles ont réussi ou non, vous pouvez également consulter l’état de notification des webhooks d’organisation et des webhooks de service.

Un certain nombre de journaux peuvent être générés pour les webhooks de service qui permettent d’identifier et de corriger les écarts dans les payloads non livrées. Tous les webhooks de service consignent un journal de niveau INFO lors de l’envoi d’une payload à un récepteur webhook. Si la payload ne peut pas être livrée, un journal de niveau SEVERE indiquant l’échec est créé, et un journal supplémentaire de niveau WARNING est créé avec la payload non livrée. Si, à la suite d’un certain nombre d’échecs, la politique de désactivation désactive le webhook, aucun journal supplémentaire n’est créé.