Conectar Microsoft SharePoint Online con la federación de datos

En esta página se describe cómo conectar Microsoft SharePoint Online a Gemini Enterprise mediante la federación de datos.

Sigue este procedimiento para buscar en tu cuenta de SharePoint mediante la búsqueda federada.

Acerca de la federación de datos

Con la federación de datos, Gemini Enterprise obtiene directamente información de las fuentes de datos de terceros mediante APIs, en lugar de copiar los datos en Gemini Enterprise. Con este método, puedes acceder a fuentes de datos externas inmediatamente, sin tener que esperar a que se ingieran.

Antes de empezar

Antes de crear el conector en Gemini Enterprise, debes configurar un registro de aplicación de Entra para habilitar el acceso seguro a SharePoint.

  1. Registra Gemini Enterprise como aplicación OAuth 2.0 en Entra.

    1. Vaya al centro de administración de Microsoft Entra.
    2. En el menú, expande la sección Aplicaciones y selecciona Registros de aplicaciones.
    3. En la página Registros de aplicaciones, selecciona Nuevo registro.
      Registrar una aplicación en Entra
      Registrar una aplicación en el centro de administración de Microsoft Entra
    4. Crea un registro de aplicación en la página Registrar una aplicación:
      Registrar cuentas solo en el directorio de la empresa
      Selecciona el tipo de cuenta e introduce el URI de redireccionamiento
    5. En la sección Tipos de cuenta admitidos, selecciona Solo cuentas del directorio de la organización.

    6. En la sección URI de redirección, selecciona Web e introduce las siguientes URLs como URLs de retrollamada web (o URLs de redirección):

      • https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html
      • https://vertexaisearch.cloud.google.com/oauth-redirect

    7. Añade un secreto de cliente:

      1. Ve a Certificados y secretos y haz clic en Nuevo secreto de cliente.
      2. Copia y anota la cadena secreta.

  2. Recoge las siguientes credenciales:

    • ID de cliente
    • Secreto de cliente
    • URL de la instancia
    • ID de cliente

  3. Configura estos permisos de la API de SharePoint (aplicación) con el consentimiento del administrador:

    Permiso Tipo
    AllSites.Read Delegada
    MyFiles.Read Delegada
    Sites.Search.All Delegada

Crear un conector de búsqueda federada con SharePoint

Consola

Sigue estos pasos para usar la consola y realizar una búsqueda federada en SharePoint desde Gemini Enterprise. Google Cloud

  1. En la Google Cloud consola, ve a la página Gemini Enterprise.

    Gemini Enterprise

  2. En el menú de navegación, haga clic en Almacenes de datos.

  3. Haz clic en Crear almacén de datos.

  4. En la página Seleccionar una fuente de datos, desplázate o busca SharePoint Federated (SharePoint federado) para conectar tu fuente de terceros.

    create-data-store
    Busca SharePoint Federated

  5. En Ajustes de autenticación:

    1. Introduce el ID de cliente, el secreto de cliente, la URL de instancia y el ID de cliente.
    2. Haz clic en Autenticar.

    3. Haz clic en Continuar.

      enter-auth-info
      Introduce la información de autenticación

  6. Selecciona los tipos de entidad que quieras buscar.

    select-region-enter-name
    Selecciona los tipos de entidad

  7. Selecciona una región para tu fuente de datos.

  8. Escribe el nombre de la fuente de datos.

    select-region-enter-name
    Configurar el conector de datos

  9. Haz clic en Crear. Gemini Enterprise crea tu almacén de datos y lo muestra en la página Almacenes de datos.

Una vez creado el almacén de datos, ve a la página Almacenes de datos y haz clic en el nombre del almacén para ver el estado. Si el estado del conector cambia de Creando a Activo, el conector de búsqueda federada estará listo para usarse.

Autorización de usuario

Después de crear un almacén de datos de búsqueda federada, lo verá en la lista de fuentes de datos del panel de gestión de fuentes. Si no has autorizado Gemini Enterprise, no podrás seleccionar la fuente de datos. En su lugar, aparece un botón Autorizar junto a él.

Para iniciar el flujo de autorización, sigue estos pasos:

  1. Haz clic en Autorizar. Se te redirige al servidor de autorización de SharePoint.
    autorización con un clic
    Haz clic en Autorizar.

  2. Inicia sesión en tu cuenta.

  3. Haz clic en Conceder acceso. Después de conceder acceso, se te redirigirá a Gemini Enterprise para completar el proceso de autorización. Gemini Enterprise obtiene el access_token y lo usa para acceder a la búsqueda de terceros.

Ejecución de consultas

Cuando introduces una consulta de búsqueda:

  • Si SharePoint está autorizado, Gemini Enterprise envía la consulta a la API de SharePoint.
  • Gemini Enterprise combina los resultados con los de otras fuentes y los muestra.

Tratamiento de datos

Cuando se usa la búsqueda federada de terceros, la cadena de consulta se envía al backend de búsqueda de terceros. Estos terceros pueden asociar las consultas con tu identidad. Si hay varias fuentes de datos de búsqueda federada habilitadas, la consulta se puede enviar a todas ellas.

Una vez que los datos llegan al sistema de terceros, se rigen por los Términos del Servicio y las políticas de privacidad de ese sistema (no por los términos de Google Cloud).