Configurer un webhook bidirectionnel pour un spoke Box

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture

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

    Avant de commencer

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

    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 : admin

    Procédure

    1. Connectez-vous à la console 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 à 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 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

        L’URL de point de terminaison de l’instance ServiceNow au format suivant : https://<instance-name>.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 n’importe quelle méthode GET ou POST
      2. Sélectionnez Enregistrer Webhoook.
    6. Pour créer un webhook V2, sélectionnez Créer un webhook , puis 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 de point de terminaison de l’instance ServiceNow au format suivant : https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint.
      2. Pour Le type d’élément pour 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.
        Une 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.

    Inscrire un webhook Box dans ServiceNow

    Créez un registre de 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é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 éventuellement décrire l’objectif de l’enregistrement.
    4. Pour confirmer, sélectionnez Soumettre.

    Résultats

    Le webhook Box est enregistré dans votre instance ServiceNow.