Connecteur Google Drive V1.0

PDFRSS

Google Drive est un service de stockage de fichiers basé sur le cloud. Vous pouvez l'utiliser Amazon Kendra pour indexer les documents et les commentaires stockés dans les dossiers Drive partagés, Mes Drives et Shared with me de votre source de données Google Drive. Vous pouvez indexer les documents Google Workspace, ainsi que les documents répertoriés dans la section Types de documentation. Vous pouvez également utiliser des filtres d'inclusion et d'exclusion pour indexer le contenu par nom de fichier, type de fichier et chemin de fichier.

Note

Connecteur Google Drive V1.0/ L' DriveConfiguration API Google a pris fin en 2023. Nous vous recommandons de migrer vers ou d'utiliser le connecteur Google Drive TemplateConfiguration V2.0/API.

Pour résoudre les problèmes liés à votre connecteur de source de données Amazon Kendra Google Drive, consultezDépannage des sources de données.

Fonctionnalités prises en charge

• Mappages de champs

• Contrôle d'accès utilisateur

• Filtres d'inclusion/exclusion

Prérequis

Avant de pouvoir Amazon Kendra indexer votre source de données Google Drive, apportez ces modifications à votre Google Drive et à vos AWS comptes.

Dans Google Drive, assurez-vous d'avoir :

• Vous avez obtenu l'accès par un rôle de super administrateur ou vous êtes un utilisateur doté de privilèges administratifs. Vous n'avez pas besoin d'un rôle de super administrateur si l'accès vous a été accordé par un rôle de super administrateur.

• Création d'un compte de service avec Activer la délégation à l'échelle du domaine G Suite activé et une clé JSON comme clé privée à l'aide du compte.

• Vous avez copié l'adresse e-mail de votre compte utilisateur et celle de votre compte de service. Lorsque vous vous connectez, entrez l'adresse e-mail de votre compte utilisateur en tant qu'adresse e-mail du compte administrateur et l'adresse e-mail de votre compte de service en tant qu'e-mail client dans votre AWS Secrets Manager code secret. Amazon Kendra

  Note

  Nous vous recommandons d'actualiser ou de modifier régulièrement vos informations d'identification et votre code secret. Fournissez uniquement le niveau d'accès nécessaire pour votre propre sécurité. Nous vous déconseillons de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).

• Ajout de l'API du SDK d'administration et de l'API Google Drive dans votre compte.

• Vous avez ajouté (ou demandé à un utilisateur doté d'un rôle de super administrateur d'ajouter) les autorisations suivantes à votre compte de service à l'aide d'un rôle de super administrateur :

  • https://www.googleapis.com/auth/lecteur.readonly

  • https://www.googleapis.com/auth/drive.metadata.readonly

  • https://www.googleapis.com/auth/admin.directory.user.readonly

  • https://www.googleapis.com/auth/admin.directory.group.readonly

• Il est vérifié que chaque document est unique dans Google Drive et dans les autres sources de données que vous prévoyez d'utiliser pour le même index. Chaque source de données que vous souhaitez utiliser pour un index ne doit pas contenir le même document dans toutes les sources de données. IDs Les documents sont globaux par rapport à un index et doivent être uniques par index.

Dans votre Compte AWS, assurez-vous d'avoir :

• Création d'un Amazon Kendra index et, si vous utilisez l'API, notez l'ID de l'index.

• Vous avez créé un IAM rôle pour votre source de données et, si vous utilisez l'API, notez l'ARN du IAM rôle.

  Note

  Si vous modifiez votre type d'authentification et vos informations d'identification, vous devez mettre à jour votre IAM rôle pour accéder au bon identifiant AWS Secrets Manager secret.

• Stockez vos informations d'authentification Google Drive dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.

  Note

  Nous vous recommandons d'actualiser ou de modifier régulièrement vos informations d'identification et votre code secret. Fournissez uniquement le niveau d'accès nécessaire pour votre propre sécurité. Nous vous déconseillons de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).

Si vous n'avez pas de IAM rôle ou de secret existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle et un nouveau Secrets Manager secret lorsque vous connectez votre source de données Google Drive à Amazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle et d'un Secrets Manager secret existants, ainsi qu'un identifiant d'index.

Instructions de connexion

Pour vous connecter Amazon Kendra à votre source de données Google Drive, vous devez fournir les informations nécessaires sur votre source de données Google Drive afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré Google Drive pour Amazon Kendra voirPrérequis.

Console

Pour vous connecter Amazon Kendra à Google Drive

1. Connectez-vous à la console AWS de gestion et Amazon Kendra ouvrez-la.

2. Dans le volet de navigation de gauche, choisissez Index, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.

   Note

   Vous pouvez choisir de configurer ou de modifier vos paramètres de contrôle d'accès utilisateur dans les paramètres de l'index.

3. Sur la page de démarrage, choisissez Ajouter une source de données.

4. Sur la page Ajouter une source de données, choisissez le connecteur Google Drive V1.0, puis sélectionnez Ajouter un connecteur.

5. Sur la page Spécifier les détails de la source de données, entrez les informations suivantes :

   1. Dans Nom et description, pour Nom de la source de données : entrez le nom de votre source de données. Vous pouvez inclure des tirets, mais pas des espaces.

   2. (Facultatif) Description : entrez une description facultative pour votre source de données.

   3. Dans la langue par défaut : choisissez une langue pour filtrer vos documents pour l'index. Sauf indication contraire, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.

   4. Dans Balises, pour Ajouter une nouvelle balise : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.

   5. Choisissez Suivant.

6. Sur la page Définir l'accès et la sécurité, entrez les informations suivantes :

   1. Pour le type d'authentification, choisissez entre existant et nouveau. Si vous choisissez d'utiliser un secret existant, utilisez Select secret pour choisir votre secret.

   2. Si vous choisissez de créer un nouveau secret, une option AWS Secrets Manager secrète s'ouvre.

      1. Entrez les informations suivantes dans la fenêtre Créer un AWS Secrets Manager secret :

         1. Nom secret : nom de votre secret. Le préfixe « AmazonKendra -Google Drive » est automatiquement ajouté à votre nom secret.

         2. Pour l'adresse e-mail du compte administrateur, l'adresse e-mail du client et la clé privée, entrez les valeurs d'identification d'authentification que vous avez générées et téléchargées depuis votre compte Google Drive.

         3. Choisissez Enregistrer l'authentification.

   3. IAM rôle —Choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.

      Note

      IAM les rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez Créer un nouveau rôle pour éviter les erreurs.

   4. Choisissez Suivant.

7. Sur la page Configurer les paramètres de synchronisation, entrez les informations suivantes :

   1. Exclure les comptes utilisateur : les utilisateurs de Google Drive que vous souhaitez exclure de l'index. Vous pouvez ajouter jusqu'à 100 comptes utilisateurs.

   2. Exclure les lecteurs partagés : les lecteurs partagés Google Drive que vous souhaitez exclure de votre index. Vous pouvez ajouter jusqu'à 100 disques partagés.

   3. Exclure les types de fichiers lecteurs : les types de fichiers Google Drive que vous souhaitez exclure de votre index. Vous pouvez également choisir de modifier les sélections de type MIME.

   4. Configurations supplémentaires : modèles d'expressions régulières pour inclure ou exclure certains contenus. Vous pouvez ajouter jusqu'à 100 motifs.

   5. Fréquence : fréquence Amazon Kendra de synchronisation avec votre source de données.

   6. Choisissez Suivant.

8. Sur la page Définir les mappages de champs, entrez les informations suivantes :

   1. Pour GoogleDrive le nom du champ et les mappages de champs supplémentaires suggérés, sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés que vous souhaitez mapper à votre index.

   2. Ajouter un champ —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.

   3. Choisissez Suivant.

9. Sur la page Réviser et créer, vérifiez que les informations saisies sont correctes, puis sélectionnez Ajouter une source de données. Vous pouvez également choisir de modifier vos informations à partir de cette page. Votre source de données apparaîtra sur la page Sources de données une fois que la source de données aura été ajoutée avec succès.

API

Pour vous connecter Amazon Kendra à Google Drive

Vous devez spécifier les éléments suivants à l'aide de l'GoogleDriveConfigurationAPI :

• Nom de ressource Amazon secret (ARN) : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification de votre compte Google Drive. Le secret est stocké dans une structure JSON avec les clés suivantes :

  {
      "clientAccount": "service account email",
      "adminAccount": "user account email"",
      "privateKey": "private key"
  }

• IAM role —Spécifiez à quel RoleArn moment vous appelez CreateDataSource pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et d'appeler le public requis APIs pour le connecteur Google Drive et Amazon Kendra. Pour plus d'informations, consultez la section IAM Rôles des sources de données Google Drive.

Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :

• Filtres d'inclusion et d'exclusion : Amazon Kendra indexe par défaut tous les documents de Google Drive. Vous pouvez spécifier si vous souhaitez inclure ou exclure certains contenus dans les lecteurs partagés, les comptes utilisateur, les types MIME de documents et les fichiers. Si vous choisissez d'exclure des comptes utilisateurs, aucun des fichiers du My Drive appartenant au compte n'est indexé. Les fichiers partagés avec l'utilisateur sont indexés sauf si le propriétaire du fichier est également exclu.

  Note

  La plupart des sources de données utilisent des modèles d'expressions régulières, qui sont des modèles d'inclusion ou d'exclusion appelés filtres. Si vous spécifiez un filtre d'inclusion, seul le contenu correspondant au filtre d'inclusion est indexé. Tout document qui ne correspond pas au filtre d'inclusion n'est pas indexé. Si vous spécifiez un filtre d'inclusion et d'exclusion, les documents correspondant au filtre d'exclusion ne sont pas indexés, même s'ils correspondent au filtre d'inclusion.

• Mappages de champs : choisissez de mapper les champs de votre source de données Google Drive à vos champs d' Amazon Kendra index. Pour plus d'informations, veuillez consulter la rubrique Mappage des champs de source de données.

  Note

  Le champ du corps du document ou l'équivalent du corps du document pour vos documents est requis pour Amazon Kendra effectuer une recherche dans vos documents. Vous devez associer le nom du champ du corps du document dans votre source de données au nom du champ d'index_document_body. Tous les autres champs sont facultatifs.

• Filtrage du contexte utilisateur et contrôle d'accèsAmazon Kendra  : analyse la liste de contrôle d'accès (ACL) de vos documents, si vous disposez d'une ACL pour vos documents. Les informations ACL sont utilisées pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Pour plus d'informations, consultez la section Filtrage du contexte utilisateur.

En savoir plus

Pour en savoir plus sur l'intégration Amazon Kendra à votre source de données Google Drive, consultez :

• Commencer à utiliser le connecteur Amazon Kendra Google Drive