Para conectar correctamente Gemini Enterprise con Microsoft SharePoint, debes completar los siguientes pasos de configuración.
Configura la autenticación y los permisos
Debes configurar la autenticación y los permisos en el centro de administración de Microsoft Entra. Esto es fundamental para permitir que el conector acceda a los datos y los sincronice.
Registra la app de Microsoft Entra para el conector de Microsoft SharePoint
Antes de crear el conector de Microsoft SharePoint en Gemini Enterprise, registra una aplicación de Microsoft Entra para habilitar el acceso seguro.
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 Entra ID y selecciona Registros de aplicaciones.
- 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 URI de redireccionamiento, ingresa
https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.
- En la lista de plataformas, selecciona
- Haz clic en Registrar. Microsoft Entra crea tu app y muestra la página de descripción general de la app.
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 plataformas, haz lo siguiente:
- Selecciona Web.
- En el campo URI de redireccionamiento, ingresa
https://vertexaisearch.cloud.google.com/oauth-redirect. - Haz clic en Configurar.
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 inquilino en 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 y el secreto del cliente de la app, haz lo siguiente:
- Navega a la página de la app.
- En el menú de navegación de la app, selecciona Certificados y secretos.
- Haz clic en Nuevo secreto del cliente.
- En el panel de secreto del cliente, haz lo siguiente:
- En el campo Descripción, ingresa una descripción para el secreto.
- En la lista Vence, selecciona una duración de vencimiento.
- Haz clic en Agregar.
- Copia el secreto que se muestra en la columna Value (
Client Secret) y el identificador de la columna Secret ID (Client ID), y almacena ambos de forma segura para usarlos más adelante.
Cómo obtener el URI de la instancia
El URI de la instancia tiene uno de los siguientes formatos:
- Para todos los sitios de primer nivel:
https://DOMAIN_OR_SERVER.sharepoint.com(por ejemplo,mydomain.sharepoint.com). - Para un solo sitio:
https://DOMAIN_OR_SERVER.sharepoint.com/sites/WEBSITE(por ejemplo,mydomain.sharepoint.com/sites/sample-site).
Cómo obtener el ID de usuario
Puedes encontrar el ID de tu arrendatario en el cuadro ID de arrendatario de la página de descripción general en el centro de administración de Microsoft Entra.
Configura los permisos de la API de Microsoft
Para configurar los permisos de API necesarios 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 la 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:
Para el modo de conexión de búsqueda federada, no se requieren permisos de la API de Graph.
Para el modo de conexión Transferencia de datos con Credenciales federadas, haz lo siguiente:
Permiso Tipo Descripción GroupMember.Read.AllAplicación Permite que el conector lea las membresías y las propiedades básicas de todos los grupos sin un usuario que haya accedido. User.ReadDelegada Permite que el conector lea el perfil de los usuarios que accedieron. También permite que el conector lea información básica de la empresa de los usuarios que accedieron. Opciones de control del sitio Opción 1: Sites.FullControl.AllAplicación Permite que el conector tenga control total de todas las colecciones de sitios. Opción 2: Sites.SelectedAplicación Permite que el conector acceda a un subconjunto de colecciones de sitios. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online. Opciones de lectura del perfil Opción 1: User.Read.AllAplicación Permite que el conector lea los perfiles de los usuarios. Opción 2: User.ReadBasic.AllAplicación Permite que el conector lea un conjunto básico de propiedades del perfil de otros usuarios de la organización. Para el modo de conexión Ingesta de datos con token de actualización de OAuth 2.0, haz lo siguiente:
Permiso Tipo Descripción GroupMember.Read.AllAplicación Permite que el conector lea las membresías y las propiedades básicas de todos los grupos sin un usuario que haya accedido. User.ReadDelegada Permite que el conector lea el perfil de los usuarios que accedieron. También permite que el conector lea información básica de la empresa de los usuarios que accedieron. User.Read.AllAplicación Permite que el conector lea los perfiles de los usuarios. Opciones de control del sitio Opción 1: Sites.FullControl.AllAplicación Permite que el conector tenga control total de todas las colecciones de sitios. Opción 2: Sites.SelectedAplicación Permite que el conector acceda a un subconjunto de colecciones de sitios. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online. Si habilitas Acciones para el modo de conexión Búsqueda federada o Transferencia de datos, también selecciona los siguientes permisos:
Permiso Tipo Descripción Sites.ReadWrite.AllDelegada Permite que el conector edite o borre documentos y elementos de lista en todas las colecciones de sitios en nombre del usuario que accedió. Files.ReadWriteDelegada Permite que el conector lea, cree, actualice y borre los archivos del usuario que accedió. Files.ReadWrite.AllDelegada Permite que el conector lea, cree, actualice y borre todos los archivos a los que puede acceder el usuario que accedió. Sites.Manage.AllDelegada Permite que el conector cree o borre bibliotecas de documentos y listas en todas las colecciones de sitios en nombre del usuario. Haz clic en Agregar permisos.
En el panel Solicitar permisos de API, selecciona Microsoft SharePoint.
Busca y selecciona los siguientes permisos según tu modo de conexión:
Para el modo de conexión de Búsqueda federada, haz lo siguiente:
Permiso Tipo Descripción Sites.Search.AllDelegada Permite que el conector ejecute búsquedas y lea información básica del sitio en nombre del usuario que accedió. Los resultados de la búsqueda se basan en los permisos del usuario, no en los de la app. Opciones de control del sitio Opción 1: AllSites.ReadDelegada Permite que el conector lea documentos y elementos de lista en todas las colecciones de sitios en nombre del usuario que accedió. Opción 2: Sites.SelectedDelegada Permite que el conector acceda a un subconjunto de colecciones de sitios con un usuario que accedió. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online. Para el modo de conexión Transferencia de datos con Credenciales federadas, haz lo siguiente:
Permiso Tipo Descripción Opciones de control del sitio Opción 1: Sites.FullControl.AllAplicación Permite que el conector tenga control total de todas las colecciones de sitios. Opción 2: Sites.SelectedAplicación Permite que el conector acceda a un subconjunto de colecciones de sitios con un usuario que accedió. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online. Para el modo de conexión Ingesta de datos con token de actualización de OAuth 2.0, haz lo siguiente:
Permiso Tipo Descripción Opciones de control del sitio Opción 1: AllSites.FullControlDelegada Permite que el conector tenga control total de todas las colecciones de sitios en nombre del usuario que accedió. Opción 2: Sites.SelectedDelegada Permite que el conector acceda a un subconjunto de colecciones de sitios con un usuario que accedió. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online. Si habilitas Acciones para el modo de conexión Búsqueda federada o Transferencia de datos, también selecciona los siguientes permisos:
Permiso Tipo Descripción AllSites.WriteDelegada Permite que el conector cree, lea, actualice y borre documentos y elementos de lista en todas las colecciones de sitios en nombre del usuario que accedió. Haz clic en Agregar permisos.