Créer et gérer des connexions webhook

Disponible avec une licence Workflow Manager.

Licence :

Ces fonctions nécessitent une licence pour l’extension d’organisation ArcGIS Workflow Manager Advanced.

Dans ArcGIS Workflow Manager, vous pouvez créer des connexions webhook pour ajouter des suspensions de dépendance webhook aux étapes.

Vous devez activer la gestion des processus dans les paramètres Organization extensions (Extensions d’organisation) de votre organisation ArcGIS avant de pouvoir créer des connexions webhook.

En savoir plus sur les conditions requises pour créer un webhook

Créer des connexions webhook

Pour créer des connexions webhook, procédez comme suit :

1. Accédez à l’application Web Workflow Manager.
2. Cliquez sur l’onglet Design (Création).

   La page Design (Création) apparaît.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Design (Création) n’est pas disponible.

3. Cliquez sur Webhook Configuration (Configuration du webhook) .

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, Webhook Configuration (Configuration du webhook) n’est pas disponible.

4. Cliquez sur l’onglet Webhook Connections (Connexions webhook).

   Le volet ArcGIS Webhook Connections (Connexions webhook ArcGIS) s’ouvre.

5. Cliquez sur Créer.
6. Cliquez sur Browse (Parcourir) pour sélectionner une couche d’entités.

   Vérifiez que la couche d’entités satisfait les conditions préalables pour la création de webhooks.

7. Sélectionnez un déclencheur d’événement pris en charge :
   • FeaturesEdited : une entité est modifiée, par exemple une insertion, une mise à jour ou une suppression
   • FeaturesUpdated : une entité est mise à jour

   Remarque :

   Seul le propriétaire du service d’entités associé ou un administrateur de portail peut configurer les déclencheurs d’événements.

8. Renseignez un nom pour la connexion webhook dans la zone de texte Connection Name (Nom de connexion).
9. Cliquez sur la flèche de la liste déroulante Run As (Exécuter en tant que) et choisissez un compte webhook.

   Remarque :

   Actuellement, seuls les utilisateurs intégrés sont pris en charge.

10. Optionnellement, ajoutez le compte de l’utilisateur actuel en tant que nouveau compte webhook.
    1. Cliquez sur Opt in as user (Accepter en tant qu’utilisateur).

       La boîte de dialogue Opt in to use my account (Accepter l’utilisation de mon compte) s’ouvre.

    2. Cliquez sur Opt in (Accepter).
11. Optionnellement, ajoutez un autre compte d’utilisateur en tant que compte webhook.
    1. Cliquez sur Add webhook account (Ajouter un compte webhook).

       La boîte de dialogue Add webhook account (Ajouter un compte webhook) s’affiche.

    2. Renseignez les informations de connexion du nouveau compte webhook.
    3. Cliquez sur Verify (Vérifier) pour valider et ajouter le compte webhook.
12. Vous avez également l’option de configurer un compte webhook de secours.
    1. Cliquez sur Enable fallback user (Activer l’utilisateur de secours).
    2. Cliquez sur la flèche de la liste déroulante Fallback user (Utilisateur de secours) et choisissez un compte webhook.

    Remarque :

    La couche d’entités doit être partagée avec les comptes utilisateurs spécifiés pour Exécuter en tant que ou Secours.

13. Vous avez également l’option de terminer les étapes antérieures pour ajouter d’autres comptes webhook.
14. Vous pouvez également fournir une clé secrète pour renforcer la sécurité.

    La clé est utilisée pour générer une signature qui est incluse dans les en-têtes de charge utile de webhook. Le récepteur webhook peut utiliser cette signature pour déterminer si le message est fiable. Le récepteur webhook doit déjà exister et être configuré de façon à communiquer via une connexion HTTPS sécurisée.

15. Cliquez sur Save (Enregistrer) pour enregistrer la connexion webhook.

    L’URL du webhook apparaît.

Modifier les connexions webhook

Pour modifier les connexions webhook, procédez comme suit :

1. Accédez à l’application Web Workflow Manager.
2. Cliquez sur l’onglet Design (Création).

   La page Design (Création) apparaît.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Design (Création) n’est pas disponible.

3. Cliquez sur Webhook Configuration (Configuration du webhook) .

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, Webhook Configuration (Configuration du webhook) n’est pas disponible.

4. Cliquez sur l’onglet Webhook Connections (Connexions webhook).

   Le volet ArcGIS Webhook Connections (Connexions webhook ArcGIS) s’ouvre.

5. Cliquez sur le nom de la connexion webhook que vous souhaitez mettre à jour.

   Conseil :

   Vous pouvez filtrer la liste des connexions webhook à l’aide de la zone de texte Search Webhook Connections (Rechercher des connexions webhook).

6. Mettez à jour la connexion webhook selon les besoins.

   Attention :

   Une fois que vous avez créé la connexion webhook, vous ne pouvez mettre à jour que les propriétés suivantes :

   • Nom de la connexion
   • Exécuter en tant qu’utilisateur
   • Secret
7. Cliquez sur Save (Enregistrer).

Supprimer les connexions webhook

La suppression d’une connexion webhook est définitive et irréversible.

Pour supprimer une connexion webhook, procédez comme suit :

1. Accédez à l’application Web Workflow Manager.
2. Cliquez sur l’onglet Design (Création).

   La page Design (Création) apparaît.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Design (Création) n’est pas disponible.

3. Cliquez sur Webhook Configuration (Configuration du webhook) .

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, Webhook Configuration (Configuration du webhook) n’est pas disponible.

4. Cliquez sur l’onglet Webhook Connections (Connexions webhook).

   Le volet ArcGIS Webhook Connections (Connexions webhook ArcGIS) s’ouvre.

5. Cliquez sur le nom de la connexion webhook que vous souhaitez supprimer.

   Conseil :

   Vous pouvez filtrer la liste des connexions webhook à l’aide de la zone de texte Search Webhook Connections (Rechercher des connexions webhook).

6. Cliquez sur More Actions (Autres actions) et sélectionnez Delete webhook connection (Supprimer une connexion webhook).

   Un message de confirmation apparaît.

7. Cliquez sur Yes (Oui) pour confirmer l’opération ou sur No (Non) pour l’annuler.

Gérer des connexions webhook

Vous pouvez réviser et gérer des comptes utilisateurs qui sont associés à des connexions webhook en procédant comme suit :

1. Cliquez sur l’onglet Webhook Accounts (Comptes webhook) pour voir les comptes associés aux connexions webhook.
2. Optionnellement, cliquez sur Remove user from webhooks (Supprimer l’utilisateur des webhooks) dans un compte pour supprimer un compte d’utilisateur de toutes les connexions webhook.

   Remarque :

   Une fois qu’un utilisateur est supprimé de toutes les connexions webhook associées, il ne peut plus exécuter d’actions webhook avec ce compte. Pour être associé à une nouvelle connexion webhook, l’utilisateur doit renseigner ses informations de connexions pour se réinscrire.