Configurer un webhook bidirectionnel pour le spoke Box

Configurez un webhook pour s’abonner à Box avec une URL de rappel ServiceNow.

Avant de commencer

• Demandez un Hub d'intégration abonnement.
• Activez le spoke Box.
• Rôle requis : admin.

Ajouter une URL de point de terminaison dans un compte Box

Indiquez une URL de point de terminaison dans votre compte Box afin de créer un webhook pour le spoke Box.

Avant de commencer

Rôle requis : admin

Procédure

1. Connectez-vous à la console du développeur Box.
2. Créez une application en fonction de vos besoins.

   Pour en savoir plus sur la création d’applications, reportez-vous à la section Créer une application OAuth.

3. Générez une clé primaire et une clé secondaire pour votre application et enregistrez les valeurs.
   1. Dans Mes applications, sélectionnez l’application.
      Vous êtes dans les paramètres généraux de votre application.
   2. Accédez aux webhooks.
   3. Sélectionnez Gérer les clés de signature.
   4. Dans la section Clé primaire, sélectionnez Générer la clé.
   5. Dans la section Clé secondaire, sélectionnez Générer la clé.
   6. Copiez et enregistrez les deux valeurs clés pour plus tard.
4. Accédez à la section Webhooks .
5. Pour créer un webhook V1, sélectionnez Créer un webhook , puis sélectionnez V1.
   1. Renseignez les champs.

      Champ	Valeur
      Nom	Mettre à jour le flux Chatter
      Description	Met automatiquement à jour votre flux Chatter lorsqu’un changement se produit
      Type d'événement	Activer au moins une option
      URL du point de terminaison	URL du point de terminaison de l’instance ServiceNow au format suivant : https://<nom-instance>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint
      Format de charge utile	Sélectionnez le format de données de charge utile approprié
      Paramètres de rappel	Sélectionnez Ajouter un paramètre de rappel pour configurer des méthodes GET ou POST

   2. Sélectionnez Enregistrer webhoook.
6. Pour créer un webhook V2, sélectionnez Créer un webhook et sélectionnez V2.
   Remarque :

   Pour créer un webhook V2, vous devez activer Gérer les webhooks dans les paramètres de configuration . Pour plus d'informations, consultez Créer une application OAuth.
   1. Pour l’adresse URL, saisissez l’URL du point de terminaison de l’instance ServiceNow au format suivant : https://<nom-instance>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint.
   2. Pour Le type d’élément déclenchant un webhook, sélectionnez Choisir un élément.
   3. Sélectionnez le ou les dossiers configurés pour le webhook.
   4. Pour confirmer, sélectionnez Choisir.
      Une liste des déclencheurs de webhook configurés s’affiche dans la page Créer un webhook .
   5. Activez les méthodes GET et POST appropriées pour chaque déclencheur.
   6. Pour confirmer, sélectionnez Créer un webhook.

Résultats

L’URL du point de terminaison est ajoutée dans votre compte Box. Vous pouvez créer des registres de webhooks et des flux secondaires en fonction de vos besoins.

Enregistrer un webhook Box dans ServiceNow

Créez un registre de webhooks Box dans ServiceNow pour avertir l’application ServiceNow lorsque certains événements se produisent dans votre compte Box.

Avant de commencer

Rôle requis : admin.

Procédure

1. Dans votre ServiceNow, accédez à Tout > Box > Registre du Webhook Box.
2. Sélectionnez Nouveau.
3. Renseignez les champs.

   Champ	Valeur
   Nom	Vous pouvez également nommer le registre Webhook
   Nom déclencheur	Sélectionnez le déclencheur d’événement approprié
   Clé primaire	Clé primaire que vous avez générée dans Ajouter une URL de point de terminaison dans un compte Box
   Nom du flux	Flux qui se produit lorsque l’événement se déclenche
   Clé secondaire	Clé secondaire que vous avez générée dans Ajouter une URL de point de terminaison dans un compte Box
   Description	Vous pouvez également décrire le but de l’enregistrement

4. Pour confirmer, sélectionnez Soumettre.

Résultats

Le webhook Box est enregistré dans votre instance ServiceNow.