Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Google Drive
Google Drive est un service de collaboration et de stockage de fichiers basé sur le cloud. Vous pouvez connecter Google Drive en tant que source de données pour votre base de connaissances gérée afin d'analyser les disques personnels, les disques partagés et les fichiers partagés avec l'identité authentifiée.
Fonctionnalités prises en charge
-
Explorez les disques personnels, les disques partagés et les fichiers partagés avec l'identité authentifiée
-
Détection automatique des champs courants du document (tels que le titre, l'auteur et les dates de création ou de modification)
-
Filtres de contenu d'inclusion et d'exclusion par ID de lecteur partagé et type MIME
-
Inclusion granulaire de dossiers et de fichiers spécifiques (avec authentification OAuth 2.0 uniquement)
-
Date-based filtrage du contenu modifié avant ou après une date précise
-
Synchronisation incrémentielle du contenu pour le contenu ajouté, mis à jour et supprimé
-
Compte de service et authentification OAuth 2.0
-
Document-level contrôle d'accès (ACL), avec authentification du compte de service
Méthodes d’authentification
Une source de données Google Drive prend en charge deux méthodes d'authentification. Choisissez-en un avant de commencer, car il détermine les informations d'identification que vous créez, le contenu que le connecteur peut explorer et si vous pouvez utiliser le contrôle d'accès au niveau du document. Nous recommandons l'authentification des comptes de service pour les nouvelles sources de données.
| Method | Comment s'authentifie-t-il | Quand l’utiliser | Configuration |
|---|---|---|---|
Compte de service (SERVICE_ACCOUNT) — recommandé |
Un compte de service Google Cloud doté d'une délégation à l'échelle du domaine s'authentifie à l'aide d'une clé privée, puis se fait passer pour un administrateur de Google Workspace afin d'accéder au contenu Drive pour tous les utilisateurs de votre domaine. | La plupart des sources de données, et toutes les sources de données utilisant un contrôle d'accès au niveau du document. Nécessite la configuration d'un administrateur Google Workspace. | Configurer l'authentification du compte de service |
OAuth 2.0 () OAUTH2 |
Un identifiant client et un code secret OAuth 2.0 ainsi qu'un jeton d'actualisation délégué que vous obtenez lors de la connexion d'un seul utilisateur Google. Le connecteur accède uniquement au contenu auquel l'utilisateur peut accéder. | À utiliser lorsqu'un seul utilisateur de Google a accès à l'ensemble du contenu Drive que vous souhaitez explorer ou lorsque vous ne pouvez pas configurer la délégation à l'échelle du domaine. Les filtres granulaires de dossiers et d'identifiants de fichiers ne sont disponibles qu'avec cette méthode. Non pris en charge avec le contrôle d'accès au niveau du document. | Configurer l'authentification OAuth 2.0 |
Important
L'authentification du compte de service nécessite un accès administrateur à Google Workspace. Si votre organisation restreint l'accès aux applications tierces dans Google Workspace, votre administrateur devra peut-être également autoriser l'accès à OAuth 2.0 en votre nom pour la méthode OAuth 2.0.
Conditions préalables
Dans Google Workspace et Google Cloud, assurez-vous de :
-
Accédez à un projet Google Cloud dans lequel vous pouvez activer les API et créer des informations d'identification.
-
Disposez d'un compte Google Workspace avec un domaine de messagerie correspondant au contenu que vous souhaitez explorer. Pour l'authentification du compte de service, vous devez également disposer d'un accès administrateur à Google Workspace.
Dans votre AWS compte, assurez-vous de :
-
Pour l’authentification, assurez-vous de stocker vos informations d’identification dans un secret AWS Secrets Manager et notez l’Amazon Resource Name (ARN) du secret.
-
Pour connaître les paires clé-valeur exactes à stocker dans le secret, consultez la page de configuration de votre méthode d'authentification : Configurer l'authentification du compte de service pour Google Drive ou. Configurer l'authentification OAuth 2.0 pour Google Drive
-
Incluez les autorisations nécessaires pour vous connecter à votre source de données dans votre role/permissions politique Gestion des identités et des accès AWS (IAM) pour votre base de connaissances. Pour plus d'informations sur les autorisations requises, consultezAutorisations d’accès aux sources de données.
Comment configurer une source de données Google Drive
La configuration d'une source de données Google Drive implique les étapes suivantes :
-
Configurez l'authentification. Suivez la page correspondant à la méthode que vous avez choisie pour configurer Google Cloud et Google Workspace, générer des informations d'identification et les stocker dans AWS : Configurer l'authentification du compte de service pour Google Drive ouConfigurer l'authentification OAuth 2.0 pour Google Drive.
-
Connectez la source de données. Créez la source de données Google Drive dans la base de connaissances à l'aide de l'API AWS Management Console ou de l'API. Consultez Connect une source de données Google Drive.
-
(Facultatif) Activez le contrôle d'accès au niveau du document. Filtrez les résultats des requêtes en fonction des autorisations Google Drive de chaque utilisateur. Nécessite l'authentification du compte de service. Consultez Document-level contrôles d'accès.
