Configuração do Microsoft SharePoint

Para conectar o Gemini Enterprise ao Microsoft SharePoint, conclua as etapas de configuração a seguir.

Configurar autenticação e permissões

Você precisa configurar a autenticação e as permissões no centro de administração do Microsoft Entra. Isso é crucial para permitir que o conector acesse e sincronize dados.

Registrar o app Microsoft Entra para o conector do Microsoft SharePoint

Antes de criar o conector do Microsoft SharePoint no Gemini Enterprise, registre um aplicativo do Microsoft Entra para ativar o acesso seguro.

Para registrar o Gemini Enterprise como um aplicativo OAuth 2.0 no Entra, faça o seguinte:

  1. Acesse o centro de administração do Microsoft Entra.
  2. No menu de navegação, abra o ID do Entra e selecione Registros de apps.
  3. Na página Registros de apps, clique em Novo registro.

  4. Na página Registrar um aplicativo, faça o seguinte:

    1. No campo Nome, insira um nome para o app.
    2. Na seção Tipos de conta compatíveis, selecione Somente contas neste diretório organizacional (que também pode ser rotulado como Somente locatário único ou Somente locatário único - MSFT, dependendo da configuração do locatário). Isso restringe o acesso a usuários e convidados no seu próprio locatário ou diretório.
    3. Na seção URI de redirecionamento, faça o seguinte:
      1. Na lista de plataformas, selecione Web.
      2. No campo "URI de redirecionamento", insira https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.
    4. Clique em Registrar. O Microsoft Entra cria o app e exibe a página de visão geral dele.

  5. No menu de navegação do app, clique em Autenticação.

  6. Clique em Adicionar URI de redirecionamento.

  7. No painel de seleção de plataforma, faça o seguinte:

    1. Selecione Web.
    2. No campo URI de redirecionamento, insira https://vertexaisearch.cloud.google.com/oauth-redirect.
    3. Clique em Configurar.

Adicionar credencial federada para ingestão de dados

Se você estiver usando Ingestão de dados como o modo de conexão e Credenciais federadas como o método de autenticação, faça o seguinte:

  1. No menu de navegação do app, clique em Certificados e chaves secretas.
  2. Selecione a guia Credenciais federadas.
  3. Clique em Adicionar credencial.
  4. Selecione Outro emissor na lista Cenário de credencial federada.
  5. No campo Emissor, insira https://accounts.google.com.
  6. No campo Identificador do assunto, insira o valor que você recebe do console do Google Cloud . Esse valor é gerado durante a criação do repositório de dados do Microsoft SharePoint na seção de dados.
  7. No campo Nome, insira um rótulo exclusivo para a credencial federada.
  8. Clique em Adicionar para conceder acesso.

Criar uma configuração do OAuth 2.0

Para criar uma conexão usando o método de autenticação OAuth 2.0, você precisa de um ID do cliente, uma chave secreta do cliente e o ID do locatário na página de registro do aplicativo do Microsoft Entra.

Receber o ID e a chave secreta do cliente

  1. Para conseguir o ID do cliente, faça o seguinte:

    1. No menu de navegação do app, selecione Visão geral.
    2. Copie o ID do aplicativo (cliente).

  2. Para conseguir a chave secreta do cliente do app, faça o seguinte:

    1. No menu de navegação do app, selecione Certificados e chaves secretas.
    2. Clique em Nova chave secreta do cliente.
    3. No painel da chave secreta do cliente, faça o seguinte:
      1. No campo Descrição, insira uma descrição para o secret.
      2. Na lista Expira, selecione uma duração de validade.
      3. Clique em Adicionar.
    4. Copie a chave secreta do cliente da coluna Valor.

Obter o URI da instância

O URI da instância tem um dos seguintes formatos:

  • Para todos os sites de primeiro nível: https://DOMAIN_OR_SERVER.sharepoint.com , por exemplo, mydomain.sharepoint.com.
  • Para um único site: https://DOMAIN_OR_SERVER.sharepoint.com/sites/WEBSITE , por exemplo, mydomain.sharepoint.com/sites/sample-site.

Conseguir o ID do locatário

O ID do locatário pode ser encontrado na caixa ID do locatário na página de visão geral no centro de administração do Microsoft Entra.

Configurar permissões da API Microsoft

Para configurar as permissões de API necessárias para o app, faça o seguinte:

  1. Acesse a página do app.

  2. No menu de navegação do app, selecione Permissões da API.

  3. Clique em Adicionar permissões.

  4. No painel Solicitar permissões da API, selecione Microsoft Graph.

  5. Pesquise e selecione as seguintes permissões com base no seu modo de conexão:

    Para o modo de conexão Pesquisa federada, não são necessárias permissões da API Graph.

    Para o modo de conexão Ingestão de dados com Credenciais federadas:

    Permissão Tipo Descrição
    GroupMember.Read.All Aplicativo Permite que o conector leia as associações e as propriedades básicas de todos os grupos sem um usuário conectado.
    User.Read Delegado Permite que o conector leia o perfil dos usuários que fizeram login. Ele também permite que o conector leia informações básicas da empresa dos usuários que fizeram login.
    Opções de controle do site
    Opção 1: Sites.FullControl.All Aplicativo Permite que o conector tenha controle total de todas as coleções de sites.
    Opção 2: Sites.Selected Aplicativo Permite que o conector acesse um subconjunto de coleções de sites. As coleções de sites específicas e as permissões concedidas podem ser configuradas no SharePoint Online.
    Opções de leitura de perfil
    Opção 1: User.Read.All Aplicativo Permite que o conector leia perfis de usuário.
    Opção 2: User.ReadBasic.All Aplicativo Permite que o conector leia um conjunto básico de propriedades de perfil de outros usuários na organização.

    Para o modo de conexão Ingestão de dados com o token de atualização do OAuth 2.0:

    Permissão Tipo Descrição
    GroupMember.Read.All Aplicativo Permite que o conector leia as associações e as propriedades básicas de todos os grupos sem um usuário conectado.
    User.Read Delegado Permite que o conector leia o perfil de usuários conectados. Ele também permite que o conector leia informações básicas da empresa dos usuários que fizeram login.
    User.Read.All Aplicativo Permite que o conector leia perfis de usuário.
    Opções de controle do site
    Opção 1: Sites.FullControl.All Aplicativo Permite que o conector tenha controle total de todas as coleções de sites.
    Opção 2: Sites.Selected Aplicativo Permite que o conector acesse um subconjunto de coleções de sites. As coleções de sites específicas e as permissões concedidas podem ser configuradas no SharePoint Online.

    Se você ativar as Ações para o modo de conexão Pesquisa federada ou Ingestão de dados, selecione também as seguintes permissões:

    Permissão Tipo Descrição
    Sites.ReadWrite.All Delegado Permite que o conector edite ou exclua documentos e itens de lista em todas as coleções de sites em nome do usuário conectado.
    Files.ReadWrite Delegado Permite que o conector leia (faça o download), crie (faça upload), atualize e exclua os arquivos do usuário conectado.
    Files.ReadWrite.All Delegado Permite que o conector leia (baixe), crie (faça upload), atualize e exclua todos os arquivos que o usuário conectado pode acessar.
    Sites.Manage.All Delegado Permite que o conector crie ou exclua bibliotecas de documentos e listas em todas as coleções de sites em nome do usuário.

  6. Clique em Adicionar permissões.

  7. No painel Solicitar permissões da API, selecione Microsoft SharePoint.

  8. Pesquise e selecione as seguintes permissões com base no seu modo de conexão:

    Para o modo de conexão Pesquisa federada:

    Permissão Tipo Descrição
    Sites.Search.All Delegado Permite que o conector execute consultas de pesquisa e leia informações básicas do site em nome do usuário conectado. Os resultados da pesquisa são baseados nas permissões do usuário, e não nas do app.
    AllSites.Read Delegado Permite que o conector leia documentos e liste itens em todas as coleções de sites em nome do usuário conectado.

    Para o modo de conexão Ingestão de dados com Credenciais federadas:

    Permissão Tipo Descrição
    Opções de controle do site
    Opção 1: Sites.FullControl.All Aplicativo Permite que o conector tenha controle total de todas as coleções de sites.
    Opção 2: Sites.Selected Aplicativo Permite que o conector acesse um subconjunto de coleções de sites com um usuário conectado. As coleções de sites específicas e as permissões concedidas podem ser configuradas no SharePoint Online.

    Para o modo de conexão Ingestão de dados com o token de atualização do OAuth 2.0:

    Permissão Tipo Descrição
    Opções de controle do site
    Opção 1: AllSites.FullControl Delegado Permite que o conector tenha controle total de todas as coleções de sites em nome do usuário conectado.
    Opção 2: Sites.Selected Delegado Permite que o conector acesse um subconjunto de coleções de sites com um usuário conectado. As coleções de sites específicas e as permissões concedidas podem ser configuradas no SharePoint Online.

    Se você ativar as Ações para o modo de conexão Pesquisa federada ou Ingestão de dados, selecione também as seguintes permissões:

    Permissão Tipo Descrição
    AllSites.Write Delegado Permite que o conector crie, leia, atualize, exclua, faça upload e download de documentos e liste itens em todas as coleções de sites em nome do usuário conectado.

  9. Clique em Adicionar permissões.

  10. Conceda o consentimento do administrador. Para saber como conceder consentimento, consulte Conceder consentimento de administrador em todo o locatário a um aplicativo na documentação do Microsoft Entra.

Conceder permissão de fullcontrol aos sites selecionados

Se você escolher a opção Sites.Selected para conceder controle sobre sites selecionados no Microsoft Graph, precisará conceder a permissão fullcontrol ao aplicativo Gemini Enterprise. Para isso, use um dos seguintes métodos:

  • PowerShell
  • Microsoft Graph

PowerShell

Para uma sintaxe genérica para conceder permissões usando o PnP PowerShell, consulte Como conceder permissões usando o PnP PowerShell.

  1. Para conceder a permissão FullControl, execute o seguinte comando no PowerShell :

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

    Substitua:

    • CLIENT_ID: o ID do cliente do aplicativo do Microsoft Entra.
    • SITE_URL: o URL do site do SharePoint, por exemplo, https://example.sharepoint.com/sites/ExampleSite1.
    • DISPLAY_NAME: o nome de exibição do aplicativo do Microsoft Entra.

Microsoft Graph

Para conferir o processo geral de concessão de permissões usando o Microsoft Graph, consulte Conceder permissões usando o Microsoft Graph.

Use o Microsoft Graph Explorer para chamar os seguintes métodos. Esses métodos só podem ser chamados por um proprietário do site.

  1. Consiga o ID do site:

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

    Substitua:

    • HOSTNAME: o nome do host do site do SharePoint. Por exemplo, example.sharepoint.com.
    • SITE_PATH: o caminho do site do SharePoint, por exemplo, /sites/ExampleSite1 ou /teams/ExampleSite2.

  2. Dê a fullcontrol acesso ao site com o ID que você recuperou na etapa anterior.

    • Envie a seguinte solicitação POST:

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

    • Use o seguinte corpo de solicitação:

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

      Substitua:

      • SITE_ID: o ID do site do SharePoint que você recebeu na etapa anterior. O formato é example.sharepoint.com,48332b69-85ab-0000-0000-dbb7132863e7,2d165439-0000-0000-b0fe-030b976868a0.
      • CLIENT_ID: o ID do cliente do aplicativo Microsoft Entra.
      • DISPLAY_NAME: o nome de exibição do aplicativo do Microsoft Entra.

Solução de problemas

Nesta seção, descrevemos como resolver problemas comuns com o conector do Microsoft SharePoint.

Os usuários veem a mensagem "Precisa de aprovação do administrador" ao se conectarem

Quando os usuários se conectam ao Microsoft SharePoint pelo web app Gemini Enterprise pela primeira vez, a Microsoft pode mostrar uma tela Precisa de aprovação do administrador. Isso acontece se o Gemini Enterprise solicitar permissões de administrador ou se o locatário do Microsoft Entra proibir que os usuários autorizem apps de terceiros sem o consentimento prévio do administrador em todo o locatário.

Para resolver esse problema, um administrador precisa concluir a primeira autorização. Depois disso, outros usuários no seu locatário poderão se conectar sem a tela de aprovação.

  1. Peça a um administrador do Microsoft Entra ID que possa conceder consentimento para todo o locatário fazer login no app da Web do Gemini Enterprise e se conectar ao Microsoft SharePoint.

  2. Na tela de permissões, o administrador precisa selecionar Consentimento em nome da sua organização e clicar em Aceitar.

  3. Peça para os usuários se conectarem novamente.

Para mais informações, consulte Conceder consentimento de administrador em todo o locatário na documentação do Microsoft Entra.