Modelo de conexión
- Cada usuario conecta su propia cuenta de Google. La conexión pasa por la pantalla de consentimiento de OAuth estándar de Google y es privada para el usuario que la inició. Otros usuarios de tu organización de Profound no pueden usar la misma conexión.
- Sin cuenta de servicio, delegación de todo el dominio ni consentimiento de administrador. Profound no usa una cuenta de servicio ni delegación de todo el dominio, y un administrador de Workspace no necesita otorgar ningún permiso para que un usuario se conecte. Profound nunca accede a Drive con una identidad distinta a la del usuario conectado, y no puede acceder a nada que ese usuario no pueda abrir.
- El acceso es más limitado que el acceso del propio usuario. Profound solicita el alcance
drive.file, por lo que solo puede leer los archivos que el usuario elige en el Google Picker y los archivos que Profound crea en nombre del usuario. Profound no puede enumerar, buscar ni leer nada más en el Drive del usuario, ni siquiera archivos que ese usuario puede abrir.
Alcances de OAuth
La integración de Google Drive de Profound no solicita ningún alcance de Drive restringido. Consulta Choose Google Drive API scopes para ver la clasificación de Google de cada alcance de Drive.
Flujos de usuario
Importaciones a Knowledge Base
- Un usuario con acceso de edición a una Knowledge Base selecciona archivos en el Google Picker. Profound recibe el ID, el nombre y el tipo de archivo de cada archivo seleccionado.
- Profound lee los metadatos de cada archivo seleccionado y descarga su contenido. Los documentos de Google Docs se exportan como
.docx, las hojas de Google Sheets como.xlsx, y las presentaciones de Google Slides y los dibujos de Google Drawings como PDF. Los archivos PDF, Word, Excel, de texto sin formato, Markdown y CSV se descargan tal cual. Los archivos de más de 100 MB no se importan. - Profound resuelve los nombres de las carpetas principales de los archivos seleccionados para poder recrear la estructura de carpetas dentro de la Knowledge Base.
Cache-Control: no-store.
Sincronización automática
Si un usuario activa la sincronización automática para una carpeta de Google Drive importada, Profound busca cambios con la frecuencia elegida mediante la Changes API de Google. En cada ejecución, Profound:- vuelve a descargar los archivos importados cuyo contenido cambió y omite aquellos cuyo contenido no cambió
- elimina la copia en la Knowledge Base de un archivo que se eliminó de Drive, o al que Profound ya no puede acceder o que ya no puede descargar
Nodos de Workflow
Los nodos de Google Docs, Google Sheets y Google Slides de los Workflows usan la misma conexión con Google Drive y la misma concesióndrive.file. Los nodos de lectura solo leen los archivos que seleccionó el usuario. Los nodos de creación y escritura (por ejemplo, crear un documento de Google Docs o escribir filas en una hoja de Google Sheets) crean archivos nuevos en el Drive del usuario conectado o modifican archivos que seleccionó el usuario.
Los nodos que aceptan un archivo por nombre solo buscan entre los archivos cubiertos por la concesión drive.file, y piden un ID o una URL de archivo si el nombre coincide con más de un archivo.
Operaciones que Profound realiza con la API de Drive
Estas son las únicas operaciones de la API de Drive que realiza la conexión con Google Drive. Las escrituras en Drive solo se producen a través de los nodos de Workflow de Google Docs y Google Sheets.
Dónde se almacena el contenido importado
Profound solo almacena los archivos que los usuarios importan a una Knowledge Base. Los nodos de lectura de Workflow también descargan el contenido de los archivos que leen, pero solo para esa ejecución: el contenido se convierte en la salida del nodo, que Profound conserva en el historial de ejecución del Workflow como cualquier otra salida de nodo. Para cada archivo importado, Profound almacena:- el contenido del archivo en un bucket de Amazon S3, separado lógicamente en la cuenta de AWS de Profound
- el texto analizado en el mismo bucket de S3, y sus embeddings de búsqueda en un servicio administrado de búsqueda vectorial, para que la búsqueda de la Knowledge Base pueda encontrarlo
- el nombre, la ruta, el tamaño, el tipo, el enlace de origen y el hash del contenido del archivo en la base de datos de Profound
Eliminación y retención
Profound conserva el contenido importado hasta que ocurre una de estas situaciones:- un usuario elimina el documento, la carpeta o la Knowledge Base en Profound
- la sincronización automática detecta que el archivo se eliminó de Drive o que ya no es accesible
Almacenamiento y gestión de tokens
- Cifrado: Profound aplica cifrado de sobre a los tokens de acceso y de actualización de OAuth con una clave de AWS Key Management Service (KMS) reservada para datos de clientes y almacena el texto cifrado en Amazon DynamoDB. El contexto de cifrado vincula cada registro a una organización, un proveedor y un usuario, de modo que un registro no se puede descifrar con la identidad de otra organización o de otro usuario. La base de datos principal de Profound solo contiene una referencia al registro cifrado, nunca los tokens.
- Alcance: Cada lectura de credenciales verifica que la conexión pertenezca a la organización del usuario que la solicita y, en el caso de conexiones personales como Google Drive, al propio usuario que la solicita. Profound registra cada lectura de credenciales en una tabla de auditoría interna, con la integración, el endpoint que la solicita, el usuario para el que se realizó la lectura y una marca de tiempo. Este registro no es visible en la plataforma.
- Actualización: Profound solicita acceso sin conexión a Google, por lo que recibe un token de actualización y puede mantener en funcionamiento la sincronización automática de la Knowledge Base sin pedir al usuario que vuelva a iniciar sesión. Cuando un token de acceso vence, el backend de Profound intercambia el token de actualización por uno nuevo. Si varias solicitudes necesitan el token al mismo tiempo, solo una de ellas contacta con Google. Las demás esperan a que termine esa actualización y reutilizan su resultado.
- Qué se almacena sobre la cuenta: Profound almacena la dirección de correo electrónico de la cuenta de Google y su identificador de sujeto (la clave
suben la carga útil del token de ID) junto con la conexión. El identificador de sujeto nunca cambia, aunque cambie la dirección de correo electrónico de la cuenta, por lo que Profound lo usa para reconocer cuándo un usuario vuelve a conectar la misma cuenta.
Revocar el acceso
Los usuarios revocan la conexión en Profound en Settings > Integrations > Google Drive, desde el menú de acciones … de la cuenta conectada, seleccionando Revoke. Cuando un usuario revoca la conexión:- Profound elimina el registro cifrado del token y marca la conexión como revocada. La eliminación no se puede revertir.
- Si es la última conexión de Google que le queda a la cuenta en tu organización, Profound también llama al endpoint de revocación de tokens de Google para el token de acceso y el token de actualización. De lo contrario, aplaza esa llamada, como se explica a continuación.
- La sincronización automática de la Knowledge Base y los nodos de Workflow que usan la conexión dejan de funcionar hasta que el usuario vuelva a conectarse.
Los usuarios también pueden revocar el acceso de Profound desde la página de acceso de terceros de su cuenta de Google. A partir de ese momento, el token de actualización almacenado por Profound deja de funcionar, y el usuario debe volver a conectar la cuenta en Profound antes de usar la integración de nuevo.
Controles para administradores de Google Workspace
- Permitir o bloquear Profound como aplicación. Gestiona el acceso de Profound como se describe en Control which third-party and internal apps access Google Workspace data de Google. Esta configuración puede requerir el ID de cliente OAuth de Profound. El equipo de tu cuenta de Profound puede proporcionártelo.
- El acceso limitado es suficiente para la integración de Google Drive. La configuración Limited access de Google solo permite que las aplicaciones usen alcances no restringidos.
drive.file,openidyuserinfo.emailson todos no restringidos, por lo que la integración de Google Drive funciona con Limited. - Un solo cliente cubre las integraciones de Google de Profound. Como las integraciones de Google Drive, Gmail, Google Search Console y Google Ads de Profound comparten un mismo cliente OAuth (Google Analytics tiene el suyo), una lista de permitidos o un bloqueo se aplica a todas ellas.