Configuração do Microsoft OneDrive

Nesta página, descrevemos como definir e configurar uma configuração de terceiros antes de criar o repositório de dados do OneDrive.

Configurar autenticação e permissões

É necessário configurar a autenticação e as permissões no Microsoft 365. Isso é fundamental para permitir que o conector acesse e sincronize dados. O conector do OneDrive é compatível com vários métodos de autenticação, como credenciais de cliente OAuth ou tokens de API.

Registrar o app Microsoft Entra para o conector do Microsoft OneDrive

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

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 Apenas contas neste diretório organizacional.
    3. Na seção URI de redirecionamento, faça o seguinte:
      1. Na lista de plataformas, selecione Web.
      2. No campo de URI de redirecionamento, insira https://vertexaisearch.cloud.google.com/console/oauth/default_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 Other issuer na lista Federated credential scenario.
  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 OneDrive 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 do cliente 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.

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:

Modo de conexão Tipo Scope Purpose
Pesquisa federada Delegado Files.Read.All Permite que o repositório de dados leia todos os arquivos que o usuário pode acessar.
Delegado Sites.Read.All Permite que o repositório de dados leia documentos e liste itens em todas as coleções de sites que o usuário pode acessar.
Delegado User.Read.All Permite que o repositório de dados resolva os locais de drive do usuário para descoberta de conteúdo.
Ingestão de dados Aplicativo Files.Read.All Permite que o repositório de dados leia e sincronize arquivos em toda a organização sem um usuário conectado.
Aplicativo Group.Read.All Permite que o repositório de dados leia propriedades e associações de todos os grupos.
Aplicativo GroupMember.Read.All Permite que o repositório de dados leia as associações de todos os grupos para gerenciar a sincronização do controle de acesso (ACL).
Delegado User.Read Permite que o repositório de dados leia o perfil e as informações básicas da empresa dos usuários que fizeram login.
Aplicativo Sites.FullControl.All Permite o controle total de todas as coleções de sites.
Aplicativo Sites.Selected Permite o acesso a um subconjunto específico de coleções de sites.
Somente credenciais federadas User.Read.All Permite que o repositório de dados leia perfis de usuário.
Delegado User.ReadBasic.All Permite ler um conjunto básico de propriedades de perfil dos usuários na organização.
Ações Delegado Files.ReadWrite.AppFolder Permite que o repositório de dados leia, crie, atualize e exclua arquivos na pasta do Microsoft OneDrive.
Delegado Files.ReadWrite Permite que o repositório de dados leia, baixe, crie, faça upload, atualize e exclua os arquivos que o usuário pode acessar.
Delegado Files.ReadWrite.All Permite que o repositório de dados leia e atualize arquivos em todos os drives que o usuário pode acessar. Necessário para as ações de mutação de arquivos e pastas (copiar, mover, renomear, compartilhar, atualizar propriedades) que operam em arquivos armazenados em drives além do Microsoft OneDrive do usuário.
  1. Clique em Adicionar permissões.
  2. 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.

Solução de problemas

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

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

Quando os usuários se conectam ao Microsoft OneDrive pelo web app do 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 em todo o locatário para fazer login no app da Web do Gemini Enterprise e se conectar ao Microsoft OneDrive.

  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 de novo.

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