Configurer le spoke Box

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

• Demander Hub d'intégration un abonnement
• Activer le module d’extension Spoke Box
• Accès à la console de développement 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 de la boîte :

• Compte Box
• Informations d’identification de l’administrateur Box
• Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Effectuez 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 développeur Box.
2. Sélectionnez Créer une application.
   
3. Sélectionnez une application personnalisée.
   
4. Renseignez le formulaire.

   Champ	Valeur
   Nom de l'application	Application Box
   Description (facultatif)	Laissez ce champ vide
   Objectif	Sélectionner un portail personnalisé

5. Sélectionnez Suivant.
   Le modal 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 inscrire 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	Requis pour...
   Lire et écrire tous les fichiers et dossiers stockés dans Box	Actions de gestion des documents, du partage de documents et de la 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

10. Sélectionnez Enregistrer les modifications.

Configurer une connexion pour un 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 à Tout > 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. Configurez une connexion.
   1. Ajoutez ou modifiez une connexion.

      • Pour configurer une connexion existante, sélectionnez Configurer ou Modifier.

      • Pour créer et configurer une nouvelle connexion, sélectionnez Ajouter une connexion.

      Remarque :

      Pour prendre en charge plusieurs connexions via un spoke, reportez-vous à la section Prise en charge de plusieurs connexions.
   2. Complétez le formulaire de configuration.

      Champ	Valeur
      Nom de la connexion	Boîte.
      URL de connexion	URL de l’instance au format suivant : <nom-domaine-fournisseur>.net.
      Nom des informations d'identification	Informations d’identification de chargement Box.
      Nom OAuth	Boîte OAuth.
      ID client OAuth	ID du client de l’application. Pour plus d’informations, consultez Créer une application OAuth.
      Secret client OAuth	Clé secrète du client d’application. Pour plus d’informations, consultez Créer une application OAuth.
      URL de redirection OAuth	URL au format suivant : <nom-instance>.com/oauth.do.

   3. Confirmez votre configuration.
      • Pour une connexion existante, sélectionnez Modifier et obtenir un jeton OAuth.
      • Pour une nouvelle connexion, sélectionnez Configurer et obtenir un jeton OAuth.

      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 à Tout > 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 le jeton OAuth pour la connexion.

Résultats

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