Configurer Box pour l’indexation de contenu externe

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

    • Créez et autorisez une application OAuth 2.0 dans la Box console développeur pour permettre au connecteur de contenu externe d’accéder Box à votre Box système source.

    Avant de commencer

    Vous avez besoin d’un accès administrateur à la Box console développeur et au portail d’interface utilisateur d’administrateur Box .

    Vous devez avoir créé une paire de clés privée/publique pour le connecteur de Box contenu externe et extrait le certificat de clé publique au format X.509 codé PEM (Base64 ASCII). Pour en savoir plus sur la création de la paire de clés publique/privée et sur l’extraction du certificat de clé publique, reportez-vous à la section Créer une paire de clés publiques/privées pour le connecteur de Box contenu externe.

    Rôle requis : aucun

    Pourquoi et quand exécuter cette tâche

    Le Box connecteur de contenu externe récupère les documents et les autorisations utilisateur de votre Box système source à l’aide de l’API Box .

    Pour permettre au connecteur d’accéder à votre Box système source via l’API Box , vous devez configurer et autoriser une application OAuth 2.0 dans la Box console développeur. Votre ServiceNow AI Platform administrateur d’instance peut utiliser les paramètres copiés à partir de l’application OAuth 2.0 et sa clé API pour configurer le connecteur externe afin d’assurer une Box connexion correcte à votre système source.

    Procédure

    1. Dans la Box console développeur, créez une application OAuth 2.0 pour le connecteur de Box contenu externe.
      1. Accédez à l’administrateur https://app.box.com/developers/console et connectez-vous avec ses informations d’identification.
      2. Sélectionnez Créer une application de plateforme, puis Application personnalisée.
        Écran Mes applications de plateforme dans la Box console développeur.
      3. Dans la fenêtre Créer une application personnalisée, saisissez un nom pour votre application et spécifiez son objectif, puis sélectionnez Suivant.
        Écran Créer une application personnalisée 1 sur 2 dans la Box console développeur.
      4. Dans la fenêtre Créer une application personnalisée, sélectionnez Authentification serveur (avec JWT), puis Créer une application.
        Écran Créer une application personnalisée 2 sur 2 dans la Box console développeur.
        L’écran Configuration de votre nouvelle application OAuth 2.0 s’affiche.
    2. Configurez votre nouvelle application OAuth 2.0 avec les paramètres requis et générez une paire de clés publique/privée pour celle-ci.
      1. Dans la section Niveau d’accès à l’application, sélectionnez l’option App + Accès à l’entreprise .
        Paramètres de configuration du niveau d’accès à l’application dans la Box console développeur.
      2. Dans la section Périmètres de l’application, sous l’en-tête Actions de contenu , sélectionnez les options Lire tous les fichiers et dossiers stockés dans Box et Écrire tous les fichiers et dossiers stockés dans Box si elles ne sont pas déjà sélectionnées.
        Périmètres de l’application Paramètres de configuration dans la Box console développeur.
      3. Dans la section Fonctionnalités avancées, sélectionnez les options Effectuer des appels d’API à l’aide de l’en-tête tel quel et Générer des jetons d’accès utilisateur .
        Paramètres de configuration des fonctionnalités avancées dans la Box console développeur.
      4. Dans la section Ajouter et gérer des clés publiques, sélectionnez Ajouter une clé publique.
        Ajouter et gérer les paramètres de configuration des clés publiques dans la Box console développeur.
        La boîte de dialogue Ajouter une nouvelle clé publique s’affiche.
      5. Dans la boîte de dialogue Ajouter une nouvelle clé publique, collez le texte de clé publique codée PEM, y compris les marqueurs -----BEGIN PUBLIC KEY ----- et -----END PUBLIC KEY -----, dans le champ Clé publique , puis sélectionnez Verify and Save.
        Ajouter une nouvelle boîte de dialogue Clé publique dans la Box console développeur.
      6. Copiez la chaîne d’ID de clé publique qui Box s’affiche pour la nouvelle clé publique et stockez-la dans un emplacement sécurisé.
        ID affiché pour la nouvelle clé publique dans la Box console développeur.
        Important :
        Vos ServiceNow AI Platform administrateurs ont besoin de cette chaîne d’ID de clé publique lors de la configuration du connecteur de Box contenu externe.
      7. Dans la section Paramètres de l’application, sélectionnez Télécharger au format JSON, puis enregistrez le fichier de paramètres au format JSON téléchargé dans un emplacement sécurisé.
        Section Paramètres de l’application dans la Box console développeur.
        Important :
        Vos ServiceNow AI Platform administrateurs ont besoin de ce fichier de paramètres au format JSON lors de la configuration du connecteur de Box contenu externe.
      8. Sélectionnez Enregistrer les changements.
        Un message s’affiche, signalant que la configuration de l’application OAuth 2.0 a été mise à jour avec succès.
    3. Soumettez une demande d’autorisation pour votre nouvelle application OAuth 2.0.
      1. Accédez à l’écran Autorisation de votre nouvelle application OAuth 2.0.
      2. Sélectionnez Examiner et soumettre.
        Option Examiner et soumettre dans les Box paramètres d’autorisation de la console de développeur.
      3. Sur l’écran Examiner la soumission de l’autorisation d’application, saisissez une description de votre application OAuth 2.0, puis sélectionnez Soumettre.
        Écran Examiner la soumission d’autorisation d’application dans la Box console développeur.
        L’état d’autorisation de l’application indique Autorisation en attente.
    4. Dans le portail de l’interface utilisateur d’administration Box , autorisez votre nouvelle application OAuth 2.0.
      1. Accédez à l’administrateur https://app.box.com/master et connectez-vous avec ses informations d’identification.
      2. Sélectionnez l’icône de menu Intégrations , puis accédez à l’onglet Gestionnaire d’applications de plateforme.
      3. Sélectionnez Applications d’authentification du serveur et recherchez l’entrée de votre nouvelle application OAuth 2.0.
      4. Ouvrez le menu contextuel de l’entrée d’application en sélectionnant son icône de débordement , puis sélectionnez Autoriser l’application.
        Écran du gestionnaire d’applications de plateforme dans Box Portail de l’interface utilisateur de l’administrateur.
      5. Sur l’écran Autoriser l’application, sélectionnez Autoriser.
        Autoriser l’écran de l’application dans Box Portail de l’interface utilisateur de l’administrateur.
        L’état d’autorisation de l’application devient Autorisé.

    Que faire ensuite

    Fournissez les éléments suivants à votre ServiceNow AI Platform administrateur :
    • Adresse e-mail du compte d’administrateur Box que vous avez utilisé pour configurer l’application OAuth 2.0.
    • La chaîne d’ID de clé publique que vous avez copiée à l’étape 2.f.
    • Fichier de paramètres au format JSON que vous avez téléchargé à l’étape 2.g.

    Votre ServiceNow AI Platform administrateur a besoin de ces éléments pour configurer un Box connecteur de contenu externe afin de récupérer les boîtes utilisateur et les principaux de sécurité de votre Box système source.

    Pour en savoir plus sur la création et la configuration d’un connecteur de Box contenu externe dans le cloud, reportez-vous à la section Créer un connecteur de Box contenu externe.