Conectar o Microsoft SharePoint Online com a federação de dados

Nesta página, descrevemos como conectar o Microsoft SharePoint Online ao Gemini Enterprise usando a federação de dados.

Siga este procedimento para pesquisar na sua conta do SharePoint usando a pesquisa federada.

Sobre a federação de dados

Com a federação de dados, o Gemini Enterprise recupera informações diretamente das fontes de dados de terceiros usando APIs, em vez de copiar os dados para o Gemini Enterprise. Com essa abordagem, é possível acessar fontes de dados externas imediatamente, sem esperar pela ingestão.

Antes de começar

Antes de criar o conector no Gemini Enterprise, é necessário configurar um registro de aplicativo do Entra para ativar o acesso seguro ao SharePoint.

  1. Registre o Gemini Enterprise como um aplicativo OAuth 2.0 no Entra.

    1. Acesse o centro de administração do Microsoft Entra.
    2. No menu, expanda a seção Aplicativos e selecione Registros de apps.
    3. Na página Registros de apps, selecione Novo registro.
      Registrar um novo app no Entra
      Registrar um novo app no centro de administração do Microsoft Entra
    4. Crie um registro de app na página Registrar um aplicativo:
      Registrar contas apenas no diretório organizacional
      Selecione o tipo de conta e insira o URI de redirecionamento
    5. Na seção Tipos de conta compatíveis, selecione Apenas contas no diretório organizacional.

    6. Na seção URI de redirecionamento, selecione Web e insira os seguintes URLs como URLs de callback da Web (ou URLs de redirecionamento):

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

    7. Adicione uma chave secreta do cliente:

      1. Acesse Certificados e secrets e clique em Nova chave secreta do cliente.
      2. Copie e anote a string do secret.

  2. Colete as seguintes credenciais:

    • ID do cliente
    • Chave secreta do cliente
    • URL da instância
    • Código do locatário

  3. Configure estas permissões da API do SharePoint (aplicativo) com o consentimento do administrador:

    Permissão Tipo
    AllSites.Read Delegado
    MyFiles.Read Delegado
    Sites.Search.All Delegado

Criar um conector de pesquisa federada com o SharePoint

Console

Siga estas etapas para usar o console Google Cloud para realizar uma pesquisa federada no SharePoint pelo Gemini Enterprise.

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. No menu de navegação, selecione Repositório de dados.

  3. Clique em Criar repositório de dados.

  4. Na página Selecionar uma fonte de dados, role a tela ou pesquise SharePoint federado para conectar sua fonte de terceiros.

    create-data-store
    Pesquisar o SharePoint federado

  5. Em Configurações de autenticação:

    1. Insira o ID do cliente, a chave secreta do cliente, o URL da instância e o ID do locatário.
    2. Clique em Autenticar.

    3. Clique em Continuar.

      enter-auth-info
      Insira as informações de autenticação

  6. Selecione os tipos de entidade que você quer pesquisar.

    select-region-enter-name
    Selecione os tipos de entidade

  7. Selecione uma região para sua fonte de dados.

  8. Em seguida, insira um nome.

    select-region-enter-name
    Configure seu conector de dados

  9. Clique em Criar. O Gemini Enterpriserise cria e exibe os repositórios de dados na página Repositórios de dados.

Depois que o repositório de dados for criado, acesse a página Repositórios de dados e clique no nome dele para conferir o status. Se o estado do conector mudar de Criação para Ativo, o conector de pesquisa federada estará pronto para uso.

Autorização do usuário

Depois de criar um repositório de dados de pesquisa federada, ele vai aparecer como uma das fontes de dados no painel de gerenciamento de fontes. Se você não tiver autorizado o Gemini Enterprise antes, não será possível selecionar a fonte de dados. Em vez disso, um botão Autorizar aparece ao lado dele.

Para iniciar o fluxo de autorização:

  1. Clique em Autorizar. O sistema redirecionará você para o servidor de autorização do SharePoint.
    clicar para autorizar
    Clique em Autorizar

  2. Faça login em sua conta.

  3. Clique em Conceder acesso. Depois de conceder acesso, o sistema redirecionará você de volta ao Gemini Enterprise para concluir o fluxo de autorização. O Gemini Enterprise recebe o access_token e o usa para acessar a pesquisa de terceiros.

Execução da consulta

Quando você insere uma consulta de pesquisa:

  • Se o SharePoint estiver autorizado, o Gemini Enterprise vai enviar a consulta para a API do SharePoint.
  • O Gemini Enterprise combina os resultados com os de outras fontes e os mostra.

Processamento de dados

Ao usar a pesquisa federada de terceiros, sua string de consulta é enviada para o back-end de pesquisa de terceiros. Esses terceiros podem associar consultas à sua identidade. Se várias fontes de dados de pesquisa federada estiverem ativadas, a consulta poderá ser enviada a todas elas.

Depois que os dados chegam ao sistema de terceiros, eles são regidos pelos Termos de Serviço e pelas Políticas de Privacidade desse sistema (não pelos termos do Google Cloud).