Cette page explique comment connecter Box à Gemini Enterprise. Le connecteur est compatible avec l'ingestion de données et la recherche fédérée. Consultez la section correspondant à l'approche que vous prévoyez d'utiliser :
Connect Box (ingestion de données)
Procédez comme suit pour synchroniser les données de Box avec Gemini Enterprise.
Une fois que vous avez configuré votre source de données et importé des données pour la première fois, le datastore synchronise les données de cette source à la fréquence que vous avez sélectionnée lors de la configuration.
Avant de commencer
Avant de configurer votre connexion :
Vous devez disposer d'un accès administrateur à l'instance Box, avec l'authentification à deux facteurs activée. Toutes les instructions de configuration ne peuvent être suivies que depuis le compte administrateur.
Configurez le contrôle des accès pour votre source de données. Pour savoir comment configurer le contrôle des accès, consultez Utiliser le contrôle des accès aux sources de données.
Consultez la section Configuration avec JWT de la documentation Box pour obtenir une présentation de la configuration, avec des captures d'écran.
Créer une application Box
- Connectez-vous à la console pour les développeurs Box avec votre compte administrateur.
- Cliquez sur Créer une application de plate-forme.
- Sélectionnez Type d'application, puis Application personnalisée.
- Saisissez le nom de l'application.
- Définissez les propriétés suivantes :
- Objectif : intégration
- Catégories : IA
- Système externe : Google Cloud Gemini Enterprise
Sélectionnez Server authentication (with JWT) (Authentification du serveur [avec JWT]) comme Authentication method (Méthode d'authentification).
Sélectionnez "Server authentication (with JWT)" (Authentification du serveur [avec JWT]). Cliquez sur Créer l'application.
Configurer l'application Box
Dans la console pour les développeurs Box, sélectionnez l'application de plate-forme, puis accédez à l'onglet Configuration.
Dans la section Niveau d'accès à l'application, sélectionnez Accès à l'application et à l'entreprise.
Dans la section Niveaux d'accès de l'application, sélectionnez les niveaux d'accès suivants :
L'autorisation Read all files and folders stored in Box (Lire tous les fichiers et dossiers stockés dans Box) est requise pour récupérer les commentaires et les tâches, et pour prévisualiser les fichiers. Toutefois, elle ne suffit pas pour télécharger les fichiers.
Write all files and folders stored in Box (Écrire tous les fichiers et dossiers stockés dans Box) est nécessaire pour télécharger des fichiers. Si vous sélectionnez cette option, l'accès Read all files (Lire tous les fichiers) est automatiquement accordé. Bien que ce champ d'application soit large et permette techniquement de créer et de modifier des fichiers, il n'est utilisé que pour le téléchargement de fichiers.
L'autorisation Gérer les utilisateurs est requise 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.
L'autorisation Gérer les groupes est également requise pour récupérer la liste des groupes et de leurs membres. C'est essentiel pour le contrôle des accès, car les membres des groupes Box avec lesquels des éléments sont partagés doivent être identifiés.
Gérer les propriétés Enterprise est un champ d'application nécessaire pour la fonctionnalité de synchronisation incrémentielle, car il facilite l'utilisation du flux d'événements Enterprise pour suivre les modifications.
Dans la section Fonctionnalités avancées, sélectionnez Effectuer des appels d'API à l'aide de l'en-tête as-user.
Configurez l'application Box. 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. Cet ID 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.
Gérez les clés.
Cliquez sur Enregistrer les modifications.
Autoriser l'application Box
- Dans la console pour les développeurs Box, sélectionnez l'application de plate-forme, puis accédez à l'onglet Autorisation.
- Cliquez sur Vérifier et envoyer.
Dans la boîte de dialogue Vérifier la demande d'autorisation de l'application, cliquez sur Envoyer.
Autorisez l'application Box. 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. Connectez-vous au gestionnaire d'applications de la plate-forme d'administration Box avec votre compte administrateur.
Choisissez l'application de plate-forme que vous avez configurée.
Cliquez sur les trois points (...) dans la ligne correspondante.
Sélectionnez Autoriser l'application dans la liste déroulante.
Dans la boîte de dialogue Autoriser l'application, cliquez sur Autoriser pour terminer le processus d'autorisation.
Cliquez sur "Autoriser".
Préparez les informations d'authentification Box suivantes :
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 déjà été générés et téléchargés dans un fichier local à partir de l'onglet Configuration sous Ajouter et gérer les clés publiques lors de la configuration de l'application.
Ajoutez et gérez les clés publiques.
Créer un connecteur Box
Console
Pour synchroniser les données de Box avec Gemini Enterprise à l'aide de la console Google Cloud , procédez comme suit :
Dans la console Google Cloud , accédez à la page Gemini Enterprise.
Dans le menu de navigation, cliquez sur Datastores.
Cliquez sur Créer un datastore.
Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Box pour connecter votre source tierce.
Saisissez vos informations d'authentification dans les paramètres d'authentification. Dans le champ Clé privée, copiez et collez la valeur de clé privée suivante.
-----BEGIN ENCRYPTED PRIVATE KEY-----\nMIIFLTBXBgkqhkiG9w0BBQ0wSjApBgkqhkiGK7wbIkVf2jW\n-----END ENCRYPTED PRIVATE KEY-----\nSélectionnez les entités à synchroniser, puis cliquez sur Continuer.
Sélectionnez la fréquence de synchronisation pour la synchronisation complète et la fréquence de synchronisation incrémentielle pour la synchronisation incrémentielle des données. Pour en savoir plus, consultez Planification de synchronisation.
Si vous souhaitez planifier des synchronisations complètes distinctes pour les données d'entité et d'identité, développez le menu sous Synchronisation complète, puis sélectionnez Options personnalisées.
Définir des plannings distincts pour la synchronisation complète des entités et la synchronisation complète des identités. Sélectionnez une région pour votre datastore.
Attribuez un nom à votre datastore
Cliquez sur Créer. Gemini Enterprise crée votre datastore et l'affiche sur la page Datastores.
Pour vérifier l'état de l'ingestion, accédez à la page Datastores, puis cliquez sur le nom de votre datastore pour afficher des informations détaillées sur la page Données. L'état du connecteur passe de Création à Exécution lorsqu'il commence à synchroniser les données. Une fois l'ingestion terminée, l'état devient Actif pour indiquer que la connexion à votre source de données est configurée et qu'elle attend la prochaine synchronisation planifiée.
Selon la taille de vos données, l'ingestion peut prendre de quelques minutes à plusieurs heures.
Étapes suivantes
Pour associer votre data store à une application, créez une application et sélectionnez votre data store en suivant les étapes décrites dans Créer une application de recherche.
Pour prévisualiser l'apparence de vos résultats de recherche une fois votre application et votre data store configurés, consultez Obtenir des résultats de recherche.
Pour activer les alertes pour le datastore, consultez Configurer des alertes pour les datastores tiers.
Associer la recherche fédérée à Box
Utilisez la procédure suivante pour effectuer une recherche dans votre compte Box à l'aide de la recherche fédérée.
À propos de la fédération de données
Grâce à la fédération de données, Gemini Enterprise récupère directement les informations à partir des sources de données tierces à l'aide d'API, au lieu de copier les données dans Gemini Enterprise. Cette approche vous permet d'accéder immédiatement aux sources de données externes, sans attendre l'ingestion.
Avant de commencer
Avant de créer un data store Box dans Gemini Enterprise, vous devez enregistrer une application OAuth 2.0 dans la console développeur Box.
Pour enregistrer l'application, procédez comme suit :
Connectez-vous à la console pour les développeurs Box avec votre compte administrateur.
Cliquez sur Create Platform App (Créer une application de plate-forme).
Créez une application de plate-forme. Cliquez sur Custom App (Application personnalisée).
Renseignez les champs obligatoires.
Fournissez des informations sur votre application. Sélectionnez Authentification de l'utilisateur (OAuth 2.0).
Sélection de la méthode d'authentification Cliquez sur Créer une application.
Copiez l'ID client et le code secret du client. Ces informations sont nécessaires pour créer un data store de recherche fédérée avec Box dans Gemini Enterprise.
Enregistrez les identifiants OAuth 2.0. Dans la section URI de redirection OAuth 2.0, ajoutez les URI de redirection suivants :
https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.htmlhttps://vertexaisearch.cloud.google.com/oauth-redirect
Indiquez les URI de redirection. Sélectionnez les niveaux d'accès suivants pour l'application :
- Lire tous les fichiers et dossiers stockés dans Box
- Écrire tous les fichiers et dossiers stockés dans Box
Sélectionnez les niveaux d'accès requis. Cliquez sur Enregistrer les modifications.
Créer un connecteur de recherche fédérée avec Box
Console
Suivez les étapes ci-dessous dans la console Google Cloud pour effectuer une recherche fédérée dans Box à partir de Gemini Enterprise.
Dans la console Google Cloud , accédez à la page Gemini Enterprise.
Dans le menu de navigation, cliquez sur Datastores.
Cliquez sur Créer un datastore.
Sur la page Sélectionner une source de données, faites défiler la page ou recherchez Box Federated (Box fédéré) pour connecter votre source tierce.
Rechercher Box Federated Sous Paramètres d'authentification :
- Saisissez l'ID client et le code secret du client.
- Cliquez sur Authentifier.
Cliquez sur Continuer.
Saisissez les informations d'authentification.
Sélectionnez une région pour votre source de données.
Saisissez le nom de votre source de données.
Configurer votre connecteur de données Cliquez sur Créer. Gemini Enterprise crée votre data store et l'affiche sur la page Datastores.
Une fois le datastore créé, accédez à la page Datastores et cliquez sur le nom de votre datastore pour afficher l'état. Si l'état du connecteur passe de Création à Actif, le connecteur de recherche fédérée est prêt à être utilisé.
Autorisation des utilisateurs
Une fois que vous avez créé un datastore de recherche fédérée, il s'affiche en tant que source de données dans votre panneau de gestion des sources. Si vous n'avez pas autorisé Gemini Enterprise auparavant, vous ne pouvez pas sélectionner la source de données. À la place, un bouton Autoriser s'affiche à côté.
Pour lancer le flux d'autorisation :
Cliquez sur Autoriser. Vous êtes redirigé vers le serveur d'autorisation Box.
Cliquez sur Autoriser. Connectez-vous à votre compte Box.
Cliquez sur Accorder l'accès. Une fois l'accès accordé, vous êtes redirigé vers Gemini Enterprise pour terminer le flux d'autorisation.
Gemini Enterprise obtient le
access_tokenet l'utilise pour accéder à la recherche tierce.
Exécution de la requête
Lorsque vous saisissez une requête de recherche :
- Si la recherche fédérée Box est autorisée, Gemini Enterprise envoie la requête à l'API Box.
- Gemini Enterprise fusionne les résultats avec ceux des autres sources et les affiche.
Traitement des données
Lorsque vous utilisez la recherche fédérée tierce, votre chaîne de requête est envoyée au backend de recherche tiers. Ces tiers peuvent associer les requêtes à votre identité. Si plusieurs sources de données de recherche fédérée sont activées, la requête peut être envoyée à chacune d'elles.
Une fois les données transférées vers le système tiers, elles sont régies par les conditions d'utilisation et les règles de confidentialité de ce système (et non par celles de Google Cloud).