Configuration Box

Cette page explique comment configurer une configuration tierce avant de créer le data store Box.

Créer une application Box

  1. Connectez-vous à la console Box pour les développeurs avec votre compte administrateur.
  2. Cliquez sur Créer une application de plate-forme.
  3. Sélectionnez Type d'application > Application personnalisée.
  4. Saisissez le nom de l'application.

  5. Définissez les propriétés suivantes :

    • Objectif : intégration.
    • Catégories : IA.
    • Système externe : Google Cloud Gemini Enterprise.

  6. Sélectionnez Server Auth - JWT (Authentification du serveur - JWT) comme Authentication method (Méthode d'authentification).

  7. Cliquez sur Créer une application.

Configurer l'application Box

  1. Dans la console du développeur Box, sélectionnez l'application de plate-forme sur la page Mes applications de plate-forme.

    Page "Mes applications de plate-forme"
    Page "My Platform Apps" (Mes applications de plate-forme) de la console Box Developer.

  2. Dans l'onglet Configuration, procédez comme suit :

    1. Dans la section Niveau d'accès de l'application, sélectionnez Accès à l'application et à l'entreprise.

      Configurer l'application Box
      Configurer l'application Box

    2. Dans la section Niveaux d'accès de l'application, sélectionnez les niveaux d'accès en fonction du mode de connexion dans le tableau suivant :

      Mode de connexion Scope (Portée) Purpose
      Recherche fédérée Read all files and folders stored in Box Obligatoire pour récupérer les commentaires et les tâches, et pour prévisualiser les fichiers pour la recherche.
      Recherche et actions fédérées Write all files and folders stored in Box Requis pour copier, importer et télécharger des fichiers, récupérer des commentaires et des tâches, et prévisualiser des fichiers pour la recherche.
      Ingestion de données Read all files and folders stored in Box Obligatoire pour l'ingestion de données.
      Manage users Obligatoire pour récupérer la liste des utilisateurs, ce qui permet de récupérer les fichiers, les commentaires et les tâches des comptes utilisateur individuels pour l'ingestion. Le compte de service administrateur ne dispose pas intrinsèquement d'un accès à tous les fichiers appartenant aux utilisateurs. L'en-tête as-user permet au système d'effectuer des requêtes API en tant qu'utilisateur spécifique pour accéder à ses données.
      Manage enterprise properties Nécessaire pour la fonctionnalité de synchronisation incrémentielle, car elle facilite l'utilisation du flux d'événements Enterprise pour suivre les modifications à ingérer.
      Manage groups Obligatoire pour récupérer la liste des groupes et de leurs membres. C'est essentiel pour le contrôle des accès lors de l'ingestion.

      .

  3. Dans la section Add and manage public keys (Ajouter et gérer les clés publiques), cliquez sur Generate a public/private keypair (Générer une paire de clés publique/privée).

    • La clé publique est automatiquement importée dans la console avec un ID, utilisé lors de la création d'une connexion.
    • Vous pouvez télécharger un fichier de configuration contenant la clé privée et la phrase secrète. Veillez à conserver ce fichier pour une utilisation ultérieure.
    • Si vous souhaitez générer votre propre clé, consultez le guide de configuration de la paire de clés Box.

  4. Cliquez sur Enregistrer les modifications.

Autoriser l'application Box

Pour autoriser l'application Box depuis la console Developer, procédez comme suit :

  1. Dans la console du développeur Box, sélectionnez l'application de la plate-forme, puis accédez à l'onglet Authorization (Autorisation).
  2. Cliquez sur Vérifier et envoyer.

  3. Dans la boîte de dialogue Vérifier l'envoi de l'autorisation de l'application, cliquez sur Envoyer.

    Si la demande d'autorisation est envoyée, le message de confirmation suivant s'affiche :

    La demande d'autorisation a bien été envoyée
    La demande d'autorisation a bien été envoyée.

Pour autoriser l'application Box à partir du gestionnaire d'applications de la plate-forme d'administration Box, procédez comme suit :

  1. Connectez-vous au gestionnaire d'applications de la plate-forme d'administration Box avec votre compte administrateur.
  2. Choisissez l'application de plate-forme que vous avez configurée.
  3. Cliquez sur les trois points (…) dans la ligne correspondante.
  4. Sélectionnez Autoriser l'application dans la liste déroulante.
  5. Dans la boîte de dialogue Autoriser l'application, cliquez sur Autoriser pour terminer le processus d'autorisation.

Obtenir les informations d'authentification Box

Pour obtenir les informations d'authentification Box, procédez comme suit :

  1. Dans la console du développeur Box, sélectionnez l'application de plate-forme sur la page Mes applications de plate-forme.

  • ID d'entreprise : obtenez-le dans l'onglet Paramètres généraux.

    obtenir l'ID d'entreprise
    Obtenez l'ID Box Entreprise.

  • ID client et code secret du client : obtenez-les dans l'onglet Configuration sous Identifiants OAuth 2.0.

    obtenir la configuration du client
    Obtenez la configuration du client.

  • Clé privée, ID de clé et Phrase secrète : ces paramètres ont été générés et téléchargés dans un fichier local à partir de l'onglet Configuration sous Ajouter et gérer des clés publiques lors de la configuration de l'application.

    ajouter et gérer des clés publiques ;
    Ajoutez et gérez des clés publiques.