Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Google Drive
Google Drive es un servicio de colaboración y almacenamiento de archivos basado en la nube. Puedes conectar Google Drive como fuente de datos para tu base de conocimientos gestionada para rastrear las unidades personales, las unidades compartidas y los archivos compartidos con la identidad autenticada.
Características admitidas
-
Rastrea las unidades personales, las unidades compartidas y los archivos compartidos con la identidad autenticada
-
Detección automática de campos de documentos comunes (como el título, el autor y las fechas de creación o modificación)
-
El contenido de inclusión y exclusión filtra por ID de unidad compartida y tipo de MIME
-
Inclusión granular de carpetas y archivos específicos (solo con la autenticación OAuth 2.0)
-
Date-based filtrar el contenido modificado antes o después de una fecha específica
-
El contenido incremental se sincroniza para el contenido agregado, actualizado y eliminado
-
Cuenta de servicio y autenticación OAuth 2.0
-
Document-level control de acceso (ACL), con autenticación de cuentas de servicio
Métodos de autenticación
Una fuente de datos de Google Drive admite dos métodos de autenticación. Elige uno antes de empezar, ya que determina las credenciales que creas, qué contenido puede rastrear el conector y si puedes usar el control de acceso a nivel de documento. Recomendamos la autenticación de las cuentas de servicio para las nuevas fuentes de datos.
| Método | ¿Cómo se autentica | Cuándo se debe usar | Configuración |
|---|---|---|---|
Cuenta de servicio (SERVICE_ACCOUNT): recomendada |
Una cuenta de servicio de Google Cloud con delegación en todo el dominio se autentica con una clave privada y, a continuación, se hace pasar por un usuario administrador de Google Workspace para acceder al contenido de Drive de cualquier usuario de tu dominio. | La mayoría de las fuentes de datos y cualquier fuente de datos que utilice un control de acceso a nivel de documento. Se requiere un administrador de Google Workspace para configurarlo. | Configura la autenticación de la cuenta de servicio |
OAuth 2.0 () OAUTH2 |
Un identificador y un secreto de cliente de OAuth 2.0, junto con un token de actualización delegada que se obtiene al iniciar sesión con un único usuario de Google. El conector solo accede al contenido al que puede acceder el usuario. | Úsalo cuando un solo usuario de Google tenga acceso a todo el contenido de Drive que quieras rastrear o cuando no puedas configurar la delegación en todo el dominio. Los filtros granulares de ID de archivos y carpetas solo están disponibles con este método. No es compatible con el control de acceso a nivel de documento. | Configura la autenticación de OAuth 2.0 |
importante
La autenticación de la cuenta de servicio requiere el acceso de administrador de Google Workspace. Si tu organización restringe el acceso a aplicaciones de terceros en Google Workspace, es posible que tu administrador también deba permitir el acceso a OAuth 2.0 en tu nombre mediante el método OAuth 2.0.
Requisitos previos
En Google Workspace y Google Cloud, asegúrate de:
-
Ten acceso a un proyecto de Google Cloud en el que puedes habilitar las API y crear credenciales.
-
Ten una cuenta de Google Workspace con un dominio de correo electrónico que coincida con el contenido que quieres rastrear. Para autenticar la cuenta de servicio, también necesitas acceso de administrador a Google Workspace.
En tu AWS cuenta, asegúrate de:
-
Almacenar sus credenciales de autenticación en un secreto de AWS Secrets Manager y tomar nota del nombre de recurso de Amazon (ARN) del secreto.
-
Para ver los pares clave-valor exactos que deseas almacenar en el secreto, consulta la página de configuración de tu método de autenticación: Configurar la autenticación de la cuenta de servicio para Google Drive o. Configurar la autenticación OAuth 2.0 para Google Drive
-
Incluya los permisos necesarios para conectarse a su fuente de datos en la role/permissions política AWS Identity and Access Management (de IAM) de su base de conocimientos. Para obtener información sobre los permisos necesarios, consultePermisos de acceso a los orígenes de datos.
Cómo configurar una fuente de datos de Google Drive
La configuración de una fuente de datos de Google Drive implica los siguientes pasos:
-
Configura la autenticación. Sigue la página del método que elijas para configurar Google Cloud y Google Workspace, generar credenciales y almacenarlas en AWS: Configurar la autenticación de la cuenta de servicio para Google Drive oConfigurar la autenticación OAuth 2.0 para Google Drive.
-
Conecte la fuente de datos. Cree la fuente de datos de Google Drive en la base de conocimientos mediante la API Consola de administración de AWS o la API. Consulte Conectar una fuente de datos de Google Drive.
-
(Opcional) Habilite el control de acceso a nivel de documento. Filtra los resultados de las consultas según los permisos de Google Drive de cada usuario. Requiere la autenticación de la cuenta de servicio. Consulte Document-level controles de acceso.
