Intégration à Box

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

    • L’intégration de Box votre Gestion des actifs logiciels application au service vous permet de suivre vos abonnements logiciels et de récupérer les licences inutilisées.

    Important :
    Minimisez les risques de sécurité et protégez les informations en accordant l’accès uniquement aux autorisations nécessaires de l’utilisateur ou de l’API.
    Tableau 1. Autorisations utilisateur minimales
    Processus Rôle d’utilisateur requis dans l’application Box Périmètres d’authentification
    Télécharger les abonnements Coadministrateur avec autorisation Gérer les utilisateurs Gérer les utilisateurs
    Pull user activity (Transférer l’activité utilisateur) Coadministrateur avec Autorisation Exécuter de nouveaux rapports et accéder aux rapports existants Gérer les propriétés de l’entreprise
    Récupérer l'abonnement
    • Coadministrateur avec autorisation Gérer les utilisateurs
    • Coadministrateur avec l’autorisation Afficher le contenu des utilisateurs
    • Gérer les utilisateurs
    • Lire tous les fichiers et dossiers stockés dans Box
    • Écrire tous les fichiers et dossiers stockés dans Box

    Pour plus d’informations sur le Box service, consultez la Box Community.

    Créer une Box application

    Créez une application sur la Box plateforme.

    Avant de commencer

    Box Rôle requis : consultez la table Autorisations utilisateur minimales .

    Procédure

    1. Accédez à la Box Developer Console et connectez-vous à votre compte.
    2. Sur la page Mes applications, sélectionnez Créer une application.
    3. Sélectionnez Application personnalisée.
    4. Sur la page Méthode d’authentification, sélectionnez OAuth standard 2.0 (authentification utilisateur).
    5. Saisissez un nom d’application, puis sélectionnez Créer une application.
    6. Sur la page de configuration, obtenez l’ID et le secret client.

      Vous devrez copier et coller ces valeurs dans votre ServiceNow instance en procédant comme suit.

      Remarque :
      Votre ID client et votre secret client sont sensibles. Ne les partagez pas.
    7. Entrez https:// instance.service-now.com/oauth_redirect.do comme URI de redirection, où instance est le nom de votre ServiceNow instance.
    8. Cochez les cases suivantes pour le périmètre de l’application :
      • Lire et écrire tous les fichiers et dossiers stockés dans Box
      • Gérer les utilisateurs
      • Gérer les propriétés de l’entreprise

      Ces champs d’application permettent à l’intégration d’obtenir une liste des utilisateurs, d’obtenir l’activité de l’utilisateur et de récupérer les abonnements inutilisés.

    9. Sélectionnez Enregistrer les changements.

    Créer un profil d'intégration Box

    Créez un profil d’intégration pour suivre les abonnements logiciels et optimiser la gestion des licences pour le Box service.

    Avant de commencer

    Pour créer un profil d’intégration, demandez le module d’extension BoxGestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès de ServiceNow Store.

    ServiceNow Rôle requis : sam_integrator ou admin

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, l’option de création du profil d’intégration Box dans Interface utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Zone de sélection Profil d’intégration.
      Espace de travail actifs logiciels
      1. Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Zone dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Remplissez les champs du formulaire.
      Tableau 2. Formulaire Profil d’intégration
      Champ Valeur
      Nom complet Nom du profil d’intégration. Par exemple, Box Integration
      ID client ID client de l’application OAuth créée dans le SaaS compte administrateur.
      URL de redirection URL du fournisseur OAuth vers lequel vous êtes redirigé après authentification. Cette valeur est automatiquement renseignée.
      Secret client Mot de passe associé à l’ID client.
      Type de profil Type de profil d'intégration. Cette valeur est automatiquement définie sur Box Abonnement.
      Analyser l'activité de l'utilisateur à partir de Vous pouvez choisir de commencer à analyser les données à partir de la date actuelle ou jusqu’à 60 jours plus tôt. Le choix d’une date dans le passé vous permet de détecter les abonnements périmés sans attendre en temps réel, car vous pouvez voir les abonnements qui n’ont pas été utilisés récemment. Étant donné que le choix d’une date dans le passé augmente la quantité de données analysées, il peut s’écouler plusieurs heures avant que vous ne puissiez visualiser les résultats.
    3. Dans la section Configuration du processus, examinez les rôles d’utilisateur requis ou les autorisations d’API spécifiés dans le champ de configuration du fournisseur pour chaque processus afin de minimiser les risques de sécurité et d’optimiser SaaS les licences.
      Remarque :
      Pour plus d’informations sur les rôles et les champs d’application requis, consultez Table des autorisations utilisateur minimales .

      • La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la désactiver.

      • La case Télécharger l’activité est cochée par défaut. Si vous l’effacez, la tâche SAM - Refresh <displayname> Events planifiée d’activité n’est pas créée.

        Dans le champ Analyser l’activité utilisateur , vous pouvez également sélectionner la date et l’heure à partir desquelles vous souhaitez analyser l’activité utilisateur. Par défaut, vous pouvez analyser l’activité des utilisateurs jusqu’à 60 jours avant la date actuelle et afficher les événements effectués par des utilisateurs individuels à partir du moment où vous créez ce profil.
        Remarque :
        Gestion des actifs logiciels extrait les événements à partir du moment où vous commencez à analyser l’activité de l’utilisateur, quelle que soit la date de création du profil.
        Vous pouvez modifier cette valeur dans le champ Seuil de la dernière activité de vos règles de réclamation de logiciel. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.

      • La case Récupérer les abonnements est cochée par défaut. Si vous ne souhaitez pas récupérer les abonnements, vous pouvez décocher cette case. Si vous l’effacez, les candidats à la suppression sont créés, mais le flux secondaire d’abonnement de récupération n’est pas déclenché ou le processus de réclamation n’est pas initié.

    4. Sélectionnez Soumettre.
      Votre ServiceNow instance crée une ébauche de profil d’intégration.
    5. Sur le profil d’intégration, sélectionnez Obtenir un jeton OAuth.
      Remarque :
      Pour connaître le rôle requis pour effectuer cette étape, consultez la table Autorisations utilisateur minimales .
    6. Dans la fenêtre contextuelle, sélectionnez votre Box compte administrateur, puis sélectionnez Autoriser.
      Remarque :
      Lorsque les abonnements utilisateur sont récupérés, les fichiers des comptes récupérés sont transférés vers le compte administrateur sélectionné à cette étape. Ce compte peut être un compte administrateur différent de celui utilisé pour configurer l’intégration. Si vous transférez des fichiers à un nouvel administrateur, vous pouvez sélectionner à nouveau le lien connexe Obtenir un jeton OAuth à tout moment pour sélectionner un autre compte administrateur. Après avoir sélectionné un nouvel administrateur, vous pouvez récupérer l’ancien compte administrateur pour transférer tous ses fichiers au nouvel administrateur, y compris tous les fichiers utilisateur précédemment récupérés.
    7. Sur le formulaire de profil d’intégration, sélectionnez Valider la connexion pour vérifier les détails de connexion et d’informations d’identification de cette intégration.

      La validation de la connexion vérifie les API Télécharger les abonnements et Calculer l’activité, mais pas les API Récupérer les abonnements.

    8. Une fois la connexion validée, sélectionnez Publier.
    9. Dans la boîte de dialogue Publier la confirmation, sélectionnez OK.
      Remarque :
      Si vous décochez la case Télécharger l’activité une fois le profil d’intégration validé et les travaux planifiés créés, vous devez revalider les connexions, car les événements suivants se produisent :
      • Le champ État du formulaire de profil d’intégration devient Brouillon.
      • Le bouton Valider la connexion s’affiche sur le formulaire.
      • La tâche actuelle SAM - Refresh <displayname> Events est supprimée.

    Résultats

    Vous pouvez afficher les événements effectués par des utilisateurs individuels jusqu’à un an avant la date actuelle. Pour plus d’informations, reportez-vous à la section Examiner une règle de réclamation de logiciel. Gestion des actifs logiciels extrait les événements à partir du moment où vous commencez à télécharger les abonnements utilisateur, quelle que soit la date de création du profil.

    Que faire ensuite

    Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels, des règles de réclamation et des abonnements logiciels qui sont actualisés quotidiennement.

    Après avoir créé un profil d’intégration, affichez les informations relatives au profil dans le Software Asset Workspace en accédant à Opérations de licence > Abonnement de l'utilisateur > Profils d'intégration directe. Vous pouvez sélectionner un profil d’intégration pour afficher les listes connexes suivantes. Si toutes les listes connexes suivantes ne sont pas visibles pour un profil d’intégration dans la vue par défaut, vous pouvez sélectionner la vue d’intégration personnalisée dans l’onglet Détails :
    • Modèles logiciels
    • Identificateurs d'abonnement non reconnus
    • Travaux planifiés
    • Résultats de la tâche planifiée
    • Abonnements logiciels
    • Règle d'exclusion de l'identificateur d'abonnement
    • Règle d'exclusion de l'utilisateur de l'abonnement

    Après avoir créé un profil d’intégration, vous pouvez définir des règles d’exclusion des abonnements afin d’exclure certains abonnements du calcul des coûts de licence. Pour plus d'informations, consultez Exclusions d’abonnements pour SaaS les applications SSO et.

    Si vous souhaitez configurer plusieurs profils d’intégration avec des connexions uniques, créez des alias enfants pour gérer différentes configurations et paramètres pour chaque profil d’intégration. Pour plus d'informations, consultez Créer un alias enfant pour configurer plusieurs profils d’intégration.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements utilisateur. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.

    Créez des autorisations logicielles pour les modèles logiciels générés automatiquement afin de suivre les logiciels utilisés par rapport aux logiciels possédés.
    Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou à la demande. Vous pouvez afficher vos résultats de rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou dans la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position en matière de conformité de licence et corriger toute non-conformité.