Configuración de Microsoft SharePoint

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:

  1. Navega al centro de administración de Microsoft Entra.
  2. En el menú de navegación, expande Entra ID y selecciona Registros de aplicaciones.
  3. En la página Registros de aplicaciones, haz clic en Nuevo registro.

  4. En la página Registrar una aplicación, haz lo siguiente:

    1. En el campo Nombre, ingresa un nombre para tu app.
    2. En la sección Tipos de cuentas compatibles, selecciona Cuentas solo en este directorio de la organización (que también puede etiquetarse como Solo un usuario o Solo un usuario: MSFT según la configuración de tu usuario). Esto restringe el acceso a los usuarios y los invitados dentro de tu propio directorio o usuario.
    3. En la sección URI de redireccionamiento, haz lo siguiente:
      1. En la lista de plataformas, selecciona Web.
      2. En el campo de URI de redireccionamiento, ingresa https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.
    4. Haz clic en Registrar. Microsoft Entra crea tu app y muestra la página de resumen de la app.

  5. En el menú de navegación de la app, haz clic en Authentication.

  6. Haz clic en Agregar URI de redireccionamiento.

  7. En el panel de selección de plataforma, haz lo siguiente:

    1. Selecciona Web.
    2. En el campo URI de redireccionamiento, ingresa https://vertexaisearch.cloud.google.com/oauth-redirect.
    3. 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:

  1. En el menú de navegación de la app, haz clic en Certificados y secretos.
  2. Selecciona la pestaña Credenciales federadas.
  3. Haz clic en Agregar credencial.
  4. Selecciona Otro emisor en la lista Situación de credencial federada.
  5. En el campo Emisor, ingresa https://accounts.google.com.
  6. 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 SharePoint en la sección de datos.
  7. En el campo Nombre, ingresa una etiqueta única para la credencial federada.
  8. 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

  1. Para obtener el ID de cliente, haz lo siguiente:

    1. En el menú de navegación de la app, selecciona Descripción general.
    2. Copia el ID de la aplicación (cliente).

  2. Para obtener el secreto del cliente de la app, haz lo siguiente:

    1. En el menú de navegación de la app, selecciona Certificados y secretos.
    2. Haz clic en Nuevo secreto del cliente.
    3. En el panel del secreto del cliente, haz lo siguiente:
      1. En el campo Descripción, ingresa una descripción para el Secret.
      2. En la lista Vence, selecciona una duración de vencimiento.
      3. Haz clic en Agregar.
    4. Copia el secreto del cliente de la columna Valor.

Obtén 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).

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:

  1. Navega a la página de la app.

  2. En el menú de navegación de la app, selecciona Permisos de API.

  3. Haz clic en Agregar permisos.

  4. En el panel Solicitar permisos de API, selecciona Microsoft Graph.

  5. Busca y selecciona los siguientes permisos según tu modo de conexión:

    Para el modo de conexión Búsqueda federada, no se requieren permisos de la API de Graph.

    Para el modo de conexión Transferencia de datos con Credenciales federadas:

    Permiso Tipo Descripción
    GroupMember.Read.All Aplicació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.Read Delegada Permite que el conector lea el perfil de los usuarios que accedieron. También permite que el conector lea la información básica de la empresa de los usuarios que accedieron.
    Opciones de control del sitio
    Opción 1: Sites.FullControl.All Aplicación Permite que el conector tenga control total de todas las colecciones de sitios.
    Opción 2: Sites.Selected Aplicació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.All Aplicación Permite que el conector lea perfiles de usuario.
    Opción 2: User.ReadBasic.All Aplicación Permite que el conector lea un conjunto básico de propiedades de perfil de otros usuarios de la organización.

    Para el modo de conexión Ingesta de datos con el token de actualización de OAuth 2.0:

    Permiso Tipo Descripción
    GroupMember.Read.All Aplicació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.Read Delegada Permite que el conector lea el perfil de los usuarios que accedieron. También permite que el conector lea la información básica de la empresa de los usuarios que accedieron.
    User.Read.All Aplicación Permite que el conector lea perfiles de usuario.
    Opciones de control del sitio
    Opción 1: Sites.FullControl.All Aplicación Permite que el conector tenga control total de todas las colecciones de sitios.
    Opción 2: Sites.Selected Aplicació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 las Acciones para el modo de conexión Búsqueda federada o Transferencia de datos, selecciona también los siguientes permisos:

    Permiso Tipo Descripción
    Sites.ReadWrite.All Delegada 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.ReadWrite Delegada Permite que el conector lea (descargue), cree (suba), actualice y borre los archivos del usuario que accedió.
    Files.ReadWrite.All Delegada Permite que el conector lea (descargue), cree (suba), actualice y borre todos los archivos a los que puede acceder el usuario que accedió.
    Sites.Manage.All Delegada Permite que el conector cree o borre bibliotecas y listas de documentos en todas las colecciones de sitios en nombre del usuario.

  6. Haz clic en Agregar permisos.

  7. En el panel Solicitar permisos de API, selecciona Microsoft SharePoint.

  8. Busca y selecciona los siguientes permisos según tu modo de conexión:

    Para el modo de conexión Búsqueda federada, haz lo siguiente:

    Permiso Tipo Descripción
    Sites.Search.All Delegada Permite que el conector ejecute consultas de búsqueda 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.
    AllSites.Read Delegada Permite que el conector lea documentos y enumere elementos en todas las colecciones de sitios en nombre del usuario que accedió.

    Para el modo de conexión Transferencia de datos con Credenciales federadas:

    Permiso Tipo Descripción
    Opciones de control del sitio
    Opción 1: Sites.FullControl.All Aplicación Permite que el conector tenga control total de todas las colecciones de sitios.
    Opción 2: Sites.Selected Aplicación Permite que el conector acceda a un subconjunto de colecciones de sitios con un usuario que accedió a su cuenta. 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 el token de actualización de OAuth 2.0:

    Permiso Tipo Descripción
    Opciones de control del sitio
    Opción 1: AllSites.FullControl Delegada Permite que el conector tenga control total de todas las colecciones de sitios en nombre del usuario que accedió.
    Opción 2: Sites.Selected Delegada Permite que el conector acceda a un subconjunto de colecciones de sitios con un usuario que accedió a su cuenta. Las colecciones de sitios específicas y los permisos otorgados se pueden configurar en SharePoint Online.

    Si habilitas las Acciones para el modo de conexión Búsqueda federada o Transferencia de datos, selecciona también los siguientes permisos:

    Permiso Tipo Descripción
    AllSites.Write Delegada Permite que el conector cree, lea, actualice, borre, suba y descargue documentos y elementos de lista en todas las colecciones de sitios en nombre del usuario que accedió.

  9. Haz clic en Agregar permisos.

  10. 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.

Otorgar permiso de fullcontrol a los sitios seleccionados

Si eliges la opción Sites.Selected para otorgar control sobre los sitios seleccionados en Microsoft Graph, debes otorgar el permiso fullcontrol a la aplicación de Gemini Enterprise. Para ello, puedes usar uno de los siguientes métodos:

  • PowerShell
  • Microsoft Graph

PowerShell

Para obtener una sintaxis genérica que permita otorgar permisos con PnP PowerShell, consulta Otorga permisos con PnP PowerShell.

  1. Para otorgar el permiso FullControl, ejecuta el siguiente comando en PowerShell :

    Grant-PnPAzureADAppSitePermission -AppId CLIENT_ID -DisplayName DISPLAY_NAME -Permissions FullControl -Site SITE_URL

    Reemplaza lo siguiente:

    • CLIENT_ID: Es el ID de cliente de la aplicación de Microsoft Entra.
    • SITE_URL: Es la URL de tu sitio de SharePoint, por ejemplo, https://example.sharepoint.com/sites/ExampleSite1.
    • DISPLAY_NAME: Es el nombre visible de la aplicación de Microsoft Entra.

Microsoft Graph

Para conocer el proceso general de otorgamiento de permisos con Microsoft Graph, consulta Otorga permisos con Microsoft Graph.

Usa el Explorador de Microsoft Graph para llamar a los siguientes métodos. Solo el propietario de un sitio puede llamar a estos métodos.

  1. Obtén el ID del sitio:

    GET `https://graph.microsoft.com/v1.0/sites/HOSTNAME:SITE_PATH`

    Reemplaza lo siguiente:

    • HOSTNAME: el nombre de host del sitio de SharePoint, por ejemplo, example.sharepoint.com.
    • SITE_PATH: Es la ruta de acceso del sitio de SharePoint, por ejemplo, /sites/ExampleSite1 o /teams/ExampleSite2.

  2. Otorga acceso a fullcontrol al sitio cuyo ID recuperaste en el paso anterior.

    • Envía la siguiente solicitud POST:

         POST `https://graph.microsoft.com/v1.0/sites/SITE_ID/permissions`

    • Usa el siguiente cuerpo de la solicitud:

      {
  "roles": ["fullControl"],
  "grantedToIdentities": [{
    "application": {
      "id": "CLIENT_ID",
      "displayName": "DISPLAY_NAME"
    }
  }]
}

      Reemplaza lo siguiente:

      • SITE_ID: Es el ID del sitio de SharePoint que recibiste en el paso anterior. Tiene el formato example.sharepoint.com,48332b69-85ab-0000-0000-dbb7132863e7,2d165439-0000-0000-b0fe-030b976868a0.
      • CLIENT_ID: Es el ID de cliente de la aplicación de Microsoft Entra.
      • DISPLAY_NAME: Es el nombre visible de la aplicación de Microsoft Entra.

Soluciona problemas

En esta sección, se describe cómo resolver problemas habituales con el conector de Microsoft SharePoint.

Los usuarios ven el mensaje "Se necesita la aprobación del administrador" cuando se conectan

Cuando los usuarios se conectan a Microsoft SharePoint 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 usuario pueden conectarse sin la pantalla de aprobación.

  1. 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 SharePoint.

  2. 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.

  3. 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.