Configuration Box

Preview privée : la création et l'utilisation d'un data store à l'aide de l'ingestion de données sont disponibles en preview privée. 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 chargée du compte ou l' équipe commerciale.

Preview publique : les fonctionnalités de recherche et d'actions fédérées sont disponibles en 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 des développeurs Box avec votre compte administrateur.
2. Cliquez sur Create platform app (Créer une application de plate-forme).
3. Sélectionnez Custom app (Application personnalisée) comme App type (Type d'application).
4. Saisissez le App name (Nom de l'application).

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

   • Purpose (Objectif) : Integration (Intégration).
   • Categories (Catégories) : AI (IA).
   • External system (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 Create App (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 My Platform Apps.

   

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

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

   1. Dans la section App access level (Niveau d'accès à l'application), sélectionnez App + Enterprise access (Accès à l'application et à l'entreprise).

      Remarque : L'option App + Enterprise access (Accès à l'application et à l'entreprise) est requise pour récupérer les fichiers, les commentaires et les tâches à partir de comptes utilisateur individuels. De plus, ce niveau d'accès est nécessaire pour la fonctionnalité de synchronisation incrémentale. Le flux d'événements d'entreprise s'appuie sur ce niveau pour identifier et récupérer efficacement les fichiers, commentaires et tâches nouveaux et modifiés.

      

      Configurer l'application Box.

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

      Mode de connexion	Champ d'application	Objectif
      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	Obligatoire pour copier, importer et télécharger des fichiers, ainsi que pour récupérer les commentaires et les tâches, et pour 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	Obligatoire pour récupérer la liste des utilisateurs, ce qui permet de récupérer les fichiers, les commentaires et les tâches à partir de comptes utilisateur individuels pour l'ingestion. Le compte de service administrateur ne dispose pas intrinsèquement d'un accès à tous les fichiers appartenant à l'utilisateur. 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émentale, car elle facilite l'utilisation du flux d'événements d'entreprise pour suivre les modifications à des fins d'ingestion.
      	Manage groups	Obligatoire pour récupérer la liste des groupes et de leurs membres. Cela est essentiel pour le contrôle des accès lors de l'ingestion.

      Remarque : Si vous n'avez l'intention d'utiliser le data store que pour la recherche et non pour effectuer des actions qui modifient le contenu dans Box, vous pouvez limiter le champ d'application à Read all files and folders stored in Box (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 compatibles qui impliquent la mise à jour du contenu dans Box.

3. Dans la section Add and manage public keys (Ajouter et gérer les clés publiques), cliquez 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 avec la clé privée et la phrase secrète. Veillez à conserver ce fichier pour une utilisation ultérieure.
   • Si vous le souhaitez, pour 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 à partir de la console des développeurs, procédez comme suit :

1. Dans la console des développeurs Box, sélectionnez l' application de plate-forme, puis accédez à l'onglet Authorization (Autorisation).
2. Cliquez sur Review and submit (Examiner et envoyer).

3. Dans la boîte de dialogue Review app authorization submission (Examiner l'envoi de l'autorisation de l'application), cliquez sur Submit (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.

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. Sélectionnez l'application de plate-forme que vous avez configurée.
3. Cliquez sur les trois points de suspension (...) dans la ligne correspondante.
4. Sélectionnez Authorize app (Autoriser l'application) dans la liste déroulante.
5. Dans la boîte de dialogue Authorize app (Autoriser l'application), cliquez sur Authorize (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 des développeurs Box, sélectionnez l' application de plate-forme sur la page My Platform Apps.

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

  

  Obtenir l'ID d'entreprise.

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

  

  Obtenir 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 Add and manage public keys (Ajouter et gérer les clés publiques) lors de la configuration de l'application.

  

  Ajouter et gérer les clés publiques.