Configurer le spoke Box

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Intégrez votre ServiceNow instance et les API Box pour automatiser les actions des spokes 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 du développeur Box
    • Rôle requis : administrateur

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

    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 l’accent sur 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 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

      Requis pour...

      Lecture et écriture de tous les fichiers et dossiers stockés dans Box

      Actions de gestion de documents, de partage de documents et de gestion de 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

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

    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. Remplissez le formulaire de configuration.

        Champ

        Valeur

        Nom de la connexion

        Boîte.

        URL de connexion

        L’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 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

        L’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 : administrateur

    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.