Configurer le spoke Box

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 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

    • 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.
      Met en évidence le bouton Créer une nouvelle application
    3. Sélectionnez une application personnalisée.
      Met l’accent sur l’option 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.