Configurer un webhook bidirectionnel pour le spoke Box

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Configurez un webhook pour vous abonner à Box avec une URL de rappel ServiceNow.

    Avant de commencer

    • Demander un abonnement à Centre d’intégration Professional
    • Activer le spoke Box
    • Rôle requis : administrateur

    Ajouter une URL de point de terminaison dans un compte Box

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

    Avant de commencer

    Rôle requis : administrateur

    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 et sélectionnez V1.
      1. Renseignez les champs.

        Champ

        Valeur

        Nom

        Mettre à jour le flux Chatter

        Description

        Met automatiquement à jour votre fil 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 l’option 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 permettant de déclencher un webhook, sélectionnez Choisir un élément.
      3. Sélectionnez le fichier ou les dossiers configurés pour le webhook.
      4. Pour confirmer, sélectionnez Choisir.
        La liste des déclencheurs de webhook configurés s’affiche sur 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 à votre compte Box. Vous pouvez créer des registres webhook et des flux secondaires en fonction de vos besoins.

    Enregistrer un webhook Box dans ServiceNow

    Créez un registre Webhook Box dans ServiceNow pour notifier 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 > Diagramme à boîtes > 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électionner 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 l’objet de l’enregistrement.
    4. Pour confirmer, sélectionnez Soumettre.

    Résultats

    Le webhook Box est enregistré dans votre instance ServiceNow.