Configurer le spoke Box

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • Intégrez votre ServiceNow instance et les API Box pour automatiser les actions du spoke Box. Par exemple, vous pouvez configurer un flux qui supprime un fichier de votre compte Box. Lorsque vous configurez le spoke Box, ce flux est automatisé.

    Avant de commencer

    • Demandez un Centre d'intégration abonnement.
    • Activez le Spoke Box.
    • Accès à la console du développeur Box.
    • Rôle requis : admin.

    Créer une application OAuth

    Créez une application OAuth personnalisée à partir de votre compte Box pour activer l'authentification OAuth 2.0 avec le spoke Box.

    Avant de commencer

    Exigences relatives à la boîte :
    • Compte Box
    • Informations d’identification de l’administrateur Box
    • Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Suivez ces étapes à partir de votre compte Box. Consultez la documentation du portail des développeurs Box pour obtenir des instructions sur la création et la configuration d’applications personnalisées.

    Procédure

    1. Connectez-vous à la console du développeur Box.
    2. Sélectionnez Créer une application.
      Met en surbrillance le bouton Créer une nouvelle application
    3. Sélectionnez Application personnalisée.
      Met en évidence l’option d’application personnalisée
    4. Renseignez le formulaire.

      Champ

      Valeur

      Nom de l'application

      Application Box

      Description (facultative)

      Laisser ce champ vide

      Objectif

      Sélectionner un portail personnalisé
    5. Sélectionnez Suivant.
      Le modal Create a Custom App (Créer une application personnalisée) s’affiche.
    6. Sélectionnez Authentification utilisateur (OAuth 2.0).
    7. Pour confirmer, sélectionnez Créer une application.
      Vous êtes dans les paramètres de configuration de votre application.
    8. Dans la section Informations d’identification OAuth 2.0, copiez l’ID client et le secret client.

      Vous avez besoin de ces informations pour enregistrer l’application en tant que fournisseur OAuth tiers sur votre ServiceNow instance.

    9. Dans la section Périmètres de l’application, activez les autorisations du périmètre que vous souhaitez prendre en charge.

      Périmètres de l'application

      Requis pour...

      Lire et écrire tous les fichiers et dossiers stockés dans Box

      Actions de gestion des documents, de partage de documents et de gestion des dossiers

      Gérer les utilisateurs

      Actions de gestion des utilisateurs

      Gérer les groupes

      Actions de gestion des groupes

      Gérer les propriétés de l’entreprise

      Partage de documents, gestion des groupes et actions de gestion des utilisateurs

      Gérer les webhooks

      Configuration des webhooks V2
    10. Sélectionnez Enregistrer les changements.

    Configurer un enregistrement de connexion pour le spoke Box

    Ajoutez et configurez une connexion Box pour authentifier les ServiceNow demandes dans un spoke Box.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Dans votre ServiceNow instance, accédez à Tous > Automatisation des processus > Studio de workflow.
    2. Cliquez sur l'onglet Intégrations.
    3. Sous Connexions, basculez et activez les connexions sortantes .
    4. Localisez l’alias de Box et cliquez sur Afficher les détails.
      • Pour configurer l’enregistrement d’alias de connexion et d’informations d’identification par défaut fourni avec le spoke Box, cliquez sur Afficher les détails.

        Afficher les détails de la connexion Box.

      • Pour gérer plusieurs enregistrements de connexion de spoke Box, vous devez créer un nouvel enregistrement d’alias enfant en cliquant sur Ajouter une connexion. Pour plus d’informations sur l’utilisation de connexions multiples, reportez-vous à la section Prise en charge de plusieurs connexions.

      Si vous configurez le spoke pour la première fois, cliquez sur Configurer. Sinon, cliquez sur Modifier.

      Configurez la connexion Box.

    5. Renseignez ces valeurs sur le formulaire.

      Champ

      Valeur

      Nom de la connexion

      Boîte.

      URL de connexion

      L’URL de l’instance au format suivant : <provider-domain-name>.net.

      Nom des informations d'identification

      Informations d’identification de chargement Box.

      Nom OAuth

      Boîte OAuth.

      ID client OAuth

      ID client de l’application. Pour plus d’informations, consultez Créer une application OAuth.

      Secret client OAuth

      Secret client de l’application. Pour plus d’informations, consultez Créer une application OAuth.

      URL de redirection OAuth

      URL au format suivant : https://<nom-instance-ServiceNow>.service-now.com/oauth_redirect.do. Remplacez <nom-instance-ServiceNow> par le nom de votre ServiceNow instance.

      Configurez la connexion Box.

    6. Cliquez sur Configurer la connexion.

    Résultats

    La connexion des spokes est configurée et prête à être utilisée.

    Remarque :
    Les jetons OAuth expirent au bout de 30 jours. Un administrateur peut régénérer le jeton OAuth du spoke tous les 30 jours.

    Régénérer le jeton OAuth de Box

    Régénérez le jeton OAuth de Box à son expiration. Le jeton OAuth du spoke Box expire tous les 30 jours.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Dans votre ServiceNow instance, accédez à Tous > Automatisation des processus > Concepteur de flux.
    2. Sélectionnez l’onglet Connexions .
    3. Recherchez l’alias de connexion Box .
    4. Sélectionnez Afficher les détails.
    5. Sélectionnez Obtenir un jeton OAuth pour la connexion.

    Résultats

    Le spoke Box reçoit un nouveau jeton d’accès OAuth. Il expire dans 30 jours.

    Intégrer l’instance ServiceNow au type d’attribution JWT Bearer

    Configurez un fournisseur OAuth avec le type d’attribution JWT Bearer pour intégrer votre ServiceNow instance à Box.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Faites les étapes à l’extrémité de la boîte.
      1. Inscrivez-vous pour un compte développeur Box.
      2. Sur la console développeur, sélectionnez Application personnalisée.
      3. Confirmez que la méthode d’authentification est OAuth 2.0 avec JWT (authentification serveur).
      4. Entrez un nom unique pour l’application et créez l’application.
      5. Affichez l’application.
      6. Dans Informations d’identification OAuth 2.0, copiez l’ID client et le secret client.
      7. Créez un nouveau magasin de clés et exportez une clé publique vers BOX.
      8. Notez l’enterpriseID dans les paramètres de l’application.
      9. Accédez à la Mes applications > <nom de l’application> > Général > Soumettre pour autorisation.
      10. Sélectionnez le nom de votre compte en haut de la console d’administration.
      11. Dans votre compte, créez un dossier et chargez un fichier texte.
    2. Effectuez les étapes à la fin de l’instance ServiceNow .
      1. Accédez à la Définition du système > Certificats > Nouveau > Type > Mot de passe.
      2. Joignez le certificat du magasin de clés.
      3. Configurez une clé de signature JWT en accédant à OAuth système > Clés JWT > Nouveau.
      4. Créez une entrée de registre d’application OAuth en accédant à OAuth système > Registre d'application > Nouveau > Se connecter à un fournisseur OAuth tiers > Type d’attribution par défaut (titulaire JWT).
      5. Sous le profil de l’entité OAuth (oauth_entity_profile), associez le « fournisseur jwt » créé.
      6. Créez un message REST.
      7. Dans le message REST, sélectionnez Obtenir un jeton OAuth pour obtenir le jeton d’accès.
      8. Allez dans la méthode 'Default GET' et cliquez sur 'Test'.
      9. À la fin de la BOX, partagez le dossier et le fichier.