Configurer le spoke Box

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 fichier .
    • 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 aux boîtes :
    • 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 Create New App (Créer une application).
      Met en évidence le bouton Create New App (Créer une application)
    3. Sélectionnez Application personnalisée.
      Met l’accent sur l’option d’application personnalisée
    4. Complétez le formulaire.

      Champ

      Valeur

      Nom de l'application

      Application Box

      Description (facultative)

      Laissez ce champ vide

      Objectif

      Sélectionner le 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 Create App.
      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 de périmètre que vous souhaitez prendre en charge.

      Périmètres de l'application

      Utiliser pour

      Lecture et écriture de 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 d’entreprise

      Actions de partage de documents, de gestion des groupes et de gestion des utilisateurs

      Gérer les webhooks

      Configuration des webhooks V2

      Gérer l’IA

      Interagir avec les actions de Box IA
    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.

        Affichez 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îtier OAuth.

      ID client OAuth

      ID du 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

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

      Configurez la connexion Box.

    6. Cliquez sur Configurer la connexion.

    Résultats

    La connexion de spoke est configurée et prête à être utilisée.

    Remarque :
    Les jetons OAuth expirent après 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.