En esta página, se describe cómo establecer y definir una configuración de terceros antes de crear el almacén de datos de OneDrive.
Configura la autenticación y los permisos
Debes configurar la autenticación y los permisos en Microsoft 365. Esto es fundamental para permitir que el conector acceda a los datos y los sincronice. El conector de OneDrive admite varios métodos de autenticación, como credenciales de cliente de OAuth o tokens de API.
Registra la app de Microsoft Entra para el conector de Microsoft OneDrive
Antes de crear el conector en Gemini Enterprise, debes configurar un registro de aplicación de Entra para habilitar el acceso seguro a Microsoft OneDrive.
Para registrar Gemini Enterprise como una aplicación de OAuth 2.0 en Entra, haz lo siguiente:
- Navega al centro de administración de Microsoft Entra.
- En el menú de navegación, expande el ID de Entra y selecciona Registros de apps.
- En la página Registros de aplicaciones, haz clic en Nuevo registro.
En la página Registrar una aplicación, haz lo siguiente:
- En el campo Nombre, ingresa un nombre para tu app.
- En la sección Tipos de cuentas compatibles, selecciona Cuentas solo en este directorio de la organización.
- En la sección URI de redireccionamiento, haz lo siguiente:
- En la lista de plataformas, selecciona
Web. - En el campo de URI de redireccionamiento, ingresa
https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html.
- En la lista de plataformas, selecciona
- Haz clic en Registrar. Microsoft Entra crea tu app y muestra su página de resumen.
En el menú de navegación de la app, haz clic en Authentication.
Haz clic en Agregar URI de redireccionamiento.
En el panel de selección de plataforma, haz lo siguiente:
- Selecciona Web.
- En el campo URI de redireccionamiento, ingresa
https://vertexaisearch.cloud.google.com/oauth-redirect. - Haz clic en Configurar.
Agrega credenciales federadas para la transferencia de datos
Si usas la Transferencia de datos como el modo de conexión y las Credenciales federadas como el método de autenticación, haz lo siguiente:
- En el menú de navegación de la app, haz clic en Certificados y secretos.
- Selecciona la pestaña Credenciales federadas.
- Haz clic en Agregar credencial.
- Selecciona Otro emisor en la lista Situación de credencial federada.
- En el campo Emisor, ingresa
https://accounts.google.com. - En el campo Identificador del sujeto, ingresa el valor que obtienes de la consola de Google Cloud . Este valor se genera durante la creación del almacén de datos de Microsoft OneDrive en la sección de datos.
- En el campo Nombre, ingresa una etiqueta única para la credencial federada.
- Haz clic en Agregar para otorgar acceso.
Crea una configuración de OAuth 2.0
Para crear una conexión con el método de autenticación de OAuth 2.0, debes obtener un ID de cliente, un secreto del cliente y tu ID de usuario de la página de registro de la aplicación de Microsoft Entra.
Obtén el ID de cliente y el secreto del cliente
Para obtener el ID de cliente, haz lo siguiente:
- En el menú de navegación de la app, selecciona Descripción general.
- Copia el ID de la aplicación (cliente).
Para obtener el secreto del cliente de la app, haz lo siguiente:
- En el menú de navegación de la app, selecciona Certificados y secretos.
- Haz clic en Nuevo secreto del cliente.
- En el panel del secreto del cliente, haz lo siguiente:
- En el campo Descripción, ingresa una descripción para el Secret.
- En la lista Vence, selecciona una duración de vencimiento.
- Haz clic en Agregar.
- Copia el secreto del cliente de la columna Valor.
Obtén el ID de usuario
Puedes encontrar el ID de usuario en el cuadro ID de usuario de la página de resumen en el centro de administración de Microsoft Entra.
Configura los permisos de la API de Microsoft
Para configurar los permisos de la API requeridos para la app, haz lo siguiente:
- Navega a la página de la app.
En el menú de navegación de la app, selecciona Permisos de API.
Haz clic en Agregar permisos.
En el panel Solicitar permisos de API, selecciona Microsoft Graph.
Busca y selecciona los siguientes permisos según tu modo de conexión:
| Modo de conexión | Tipo | Permiso | Purpose |
|---|---|---|---|
| Búsqueda federada | Delegada | Files.Read.All |
Permite que el almacén de datos lea todos los archivos a los que el usuario puede acceder. |
| Delegada | Sites.Read.All |
Permite que el almacén de datos lea documentos y enumere elementos en todas las colecciones de sitios a las que puede acceder el usuario. | |
| Delegada | User.Read.All |
Permite que el almacén de datos resuelva las ubicaciones de las unidades de los usuarios para descubrir contenido. | |
| Ingesta de datos | Aplicación | Files.Read.All |
Permite que el almacén de datos lea y sincronice archivos en toda la organización sin que un usuario acceda. |
| Aplicación | Group.Read.All |
Permite que el almacén de datos lea las propiedades y las membresías de todos los grupos. | |
| Aplicación | GroupMember.Read.All |
Permite que el almacén de datos lea las membresías de todos los grupos para administrar la sincronización del control de acceso (ACL). | |
| Delegada | User.Read |
Permite que el almacén de datos lea el perfil y la información básica de la empresa de los usuarios que accedieron. | |
| Aplicación | Sites.FullControl.All |
Permite el control total de todas las colecciones de sitios. | |
| Aplicación | Sites.Selected |
Permite el acceso a un subconjunto específico de colecciones de sitios. | |
| Solo credenciales federadas | User.Read.All |
Permite que el almacén de datos lea los perfiles de usuario. | |
| Delegada | User.ReadBasic.All |
Permite leer un conjunto básico de propiedades de perfil de los usuarios de la organización. | |
| Actions | Delegada | Files.ReadWrite.AppFolder |
Permite que el almacén de datos lea, cree, actualice y borre archivos en la carpeta de Microsoft OneDrive. |
| Delegada | Files.ReadWrite |
Permite que el almacén de datos lea, descargue, cree, suba, actualice y borre los archivos a los que puede acceder el usuario. | |
| Delegada | Files.ReadWrite.All |
Permite que el almacén de datos lea y actualice archivos en todas las unidades a las que el usuario tiene acceso. Es obligatorio para las acciones de mutación de archivos y carpetas (copiar, mover, cambiar el nombre, compartir y actualizar propiedades) que operan en archivos almacenados en unidades más allá de la propia unidad de Microsoft OneDrive del usuario. |
- Haz clic en Agregar permisos.
- Otorga el consentimiento del administrador. Para obtener información sobre cómo otorgar consentimiento, consulta Otorga consentimiento de administrador para toda la organización a una aplicación en la documentación de Microsoft Entra.
Soluciona problemas
En esta sección, se describe cómo resolver problemas habituales con el conector de Microsoft OneDrive.
Los usuarios ven el mensaje "Se necesita la aprobación del administrador" cuando se conectan
Cuando los usuarios se conectan a Microsoft OneDrive desde la app web de Gemini Enterprise por primera vez, es posible que Microsoft muestre una pantalla que indique que se necesita la aprobación del administrador. Esto sucede si Gemini Enterprise solicita permisos de nivel de administrador o si tu usuario de Microsoft Entra prohíbe que los usuarios autoricen apps de terceros sin el consentimiento previo del administrador para todo el usuario.
Para resolver este problema, un administrador debe completar la primera autorización. Después de eso, otros usuarios de tu inquilino podrán conectarse sin la pantalla de aprobación.
Pídele a un administrador de Microsoft Entra ID que pueda otorgar consentimiento para todo el usuario que acceda a la app web de Gemini Enterprise y se conecte a Microsoft OneDrive.
En la pantalla de permisos, pídele al administrador que seleccione Consentimiento en nombre de tu organización y, luego, que haga clic en Aceptar.
Pídeles a los usuarios que vuelvan a conectarse.
Para obtener más información, consulta Otorga consentimiento de administrador para toda la organización en la documentación de Microsoft Entra.