Configuration Box

Aperçu privé : le data store d'ingestion de données est en aperçu privé. Vous devez figurer sur la liste d'autorisation pour utiliser le data store d'ingestion de données. Pour être ajouté à la liste d'autorisation, contactez votre équipe de compte ou l'équipe commerciale.

Version Preview publique : les fonctionnalités de recherche et d'actions fédérées sont disponibles en version Preview publique. Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section Conditions générales du service des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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 pour les développeurs Box avec votre compte administrateur.
2. Cliquez sur Créer une application de plate-forme.
3. Sélectionnez Type d'application, puis 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 méthode d'authentification.

7. Cliquez sur Créer une application.

Configurer l'application Box

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

   

   Page "My Platform Apps" (Mes applications de plate-forme) dans la console de développement Box.

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

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

      Remarque : L'accès à l'application et à l'entreprise est requis pour récupérer les fichiers, les commentaires et les tâches des comptes d'utilisateurs individuels. De plus, ce niveau d'accès est nécessaire pour la fonctionnalité de synchronisation incrémentale. Le flux d'événements Enterprise s'appuie sur ce niveau pour identifier et récupérer efficacement les fichiers, commentaires et tâches nouveaux ou modifiés.

      

      Configurez l'application Box.

   2. Dans la section Scopes d'application, sélectionnez les scopes en fonction du mode de connexion dans le tableau suivant :

      Mode de connexion	Scope (Portée)	Purpose
      Recherche unifiée	Read all files and folders stored in Box	Nécessaire 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	Nécessaire pour copier les fichiers, récupérer les commentaires et les tâches, et prévisualiser les 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	Nécessaire 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 n'a pas accès à tous les fichiers appartenant aux utilisateurs. L'en-tête "as-user" permet au système d'envoyer des requêtes d'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.

      Remarque : Si vous prévoyez d'utiliser le data store uniquement pour la recherche et non pour effectuer des actions qui modifient le contenu dans Box, vous pouvez limiter le champ d'application à Lire tous les fichiers et dossiers stockés dans Box. Le champ d'application Write all files and folders stored in Box (Écrire tous les fichiers et dossiers stockés dans Box) est requis pour les actions qui impliquent la mise à jour de contenu dans Box.

3. Dans la section Ajouter et gérer les clés publiques, cliquez sur Générer une paire de clés publique/privée.

   • La clé publique est automatiquement importée dans la console avec un ID, qui est 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 le souhaitez, vous pouvez générer votre propre clé. Pour ce faire, 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 pour les développeurs Box, sélectionnez l'application de plate-forme, puis accédez à l'onglet Autorisation.
2. Cliquez sur Vérifier et envoyer.

3. Dans la boîte de dialogue Examiner la demande d'autorisation de l'application, cliquez sur Envoyer.

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

   

   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 :

1. Dans la console des développeurs 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.

  

  Obtenez l'ID Enterprise.

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

  

  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.

  

  Ajoutez et gérez les clés publiques.