Configuração do Microsoft 365

Nesta página, descrevemos como configurar um aplicativo de terceiros antes de criar o repositório de dados do Microsoft 365.

Configurar autenticação e permissões

O conector do Microsoft 365 faz login como o usuário final usando o fluxo do código de autorização do OAuth 2.0 na Identity Platform da Microsoft. Todas as permissões do Microsoft Graph são delegadas, então o conector só pode acessar os dados que o usuário conectado já pode acessar. É possível configurar a autenticação de duas maneiras:

  • OAuth gerenciado peloGoogle (OAuth 2.0 (gerenciado pelo Google), padrão): o conector usa um aplicativo multilocatário do Microsoft Entra que o Google registra e gerencia. Não é necessário registrar um aplicativo ou inserir um ID de locatário, ID do cliente ou chave secreta do cliente. Consulte Usar o OAuth gerenciado pelo Google.
  • Traga seu próprio app (OAuth 2.0 (Traga seu próprio app)): você registra seu próprio aplicativo do Microsoft Entra, concede a ele as permissões do Microsoft Graph para as ações que planeja ativar e insere o ID do locatário, o ID do cliente e a chave secreta do cliente no Gemini Enterprise. Escolha essa opção se sua organização precisar controlar o aplicativo e as permissões dele diretamente, se você precisar de saída de IP estático ou se o locatário estiver em uma nuvem do governo dos EUA. Consulte Registrar um app do Microsoft Entra.

Usar o OAuth gerenciado pelo Google

Com o OAuth 2.0 (gerenciado pelo Google), você não cria nada no Microsoft Entra antes de criar o repositório de dados. Quando um usuário autoriza o conector, a Microsoft pede que ele concorde com as permissões do Microsoft Graph necessárias para as ações ativadas. Para ver a lista completa, consulte Configurar permissões da API da Microsoft.

Algumas dessas permissões e algumas políticas de consentimento de locatário exigem que um administrador do Microsoft Entra dê o consentimento em nome da organização. Se os usuários receberem uma mensagem Precisa de aprovação do administrador ao autorizar o conector, um administrador precisará conceder consentimento em todo o locatário ao aplicativo gerenciado pelo Google. Para mais informações, consulte Conceder consentimento de administrador em todo o locatário a um aplicativo na documentação da Microsoft.

Lembre-se do seguinte ao usar o OAuth gerenciado pelo Google:

  • O aplicativo gerenciado pelo Googleé registrado na nuvem comercial da Microsoft. Portanto, deixe o Tipo de ambiente do Microsoft 365 definido como Padrão. Para locatários no GCC High ou DoD, use o OAuth 2.0 (Traga seu próprio app).
  • A saída de IP estático não está disponível porque o aplicativo compartilhado não pode ter uma lista de permissões de IP por cliente.

O restante desta seção se aplica apenas ao OAuth 2.0 (Traga seu próprio app).

Registrar um app do Microsoft Entra para o conector do Microsoft 365

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

  1. Acesse o centro de administração do Microsoft Entra.

  2. No menu de navegação, abra Entra ID 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/oauth-redirect.
    4. Clique em Registrar. O Microsoft Entra cria o app e exibe a página de visão geral dele.

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

Encontrar 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

Se você usa o OAuth 2.0 (Traga seu próprio app), conceda ao app as permissões delegadas do Microsoft Graph para as ações que você planeja ativar. Se você usar o OAuth 2.0 (gerenciado pelo Google), não adicione essas permissões. Os usuários precisam consentir com elas ao autorizar o conector.

As permissões necessárias para cada ação estão listadas na coluna Permissões necessárias das tabelas de ações compatíveis. Cada conexão também precisa de User.Read e offline_access.

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

  1. Na página do app, selecione Permissões da API.

  2. Clique em Adicionar uma permissão.

  3. Na página Solicitar permissões da API, selecione Microsoft Graph e, em seguida, Permissões delegadas.

  4. Pesquise e selecione User.Read, offline_access e as permissões listadas para cada ação que você planeja ativar.

  5. Clique em Adicionar permissões

Nuvens soberanas e governamentais

Se o locatário não estiver na nuvem padrão da Microsoft, defina as duas opções a seguir ao criar o repositório de dados. O login pelo Governo dos EUA requer o OAuth 2.0 (Traga seu próprio app), com um app registrado nessa nuvem.

  • Tipo de ambiente do Microsoft 365, na seção Configurações de autenticação, seleciona o endpoint de login: Padrão usa login.microsoftonline.com e Governo dos EUA usa login.microsoftonline.us.

  • Ambiente de nuvem do Microsoft 365, na seção Opções avançadas, seleciona o endpoint do Microsoft Graph: Padrão / GCC usa https://graph.microsoft.com, GCC High usa https://graph.microsoft.us e DoD usa https://dod-graph.microsoft.us.

Solução de problemas

Nesta seção, descrevemos os erros que podem aparecer depois de configurar o aplicativo do Microsoft Entra e como resolvê-los.

Falha nas ações com HTTP 403

Uma ação que retorna HTTP 403 geralmente não tem uma permissão. Verifique se a permissão necessária para a ação foi consentida, se o consentimento do administrador foi concedido, quando necessário, e se a conexão foi autorizada novamente após a ativação da ação. Com o OAuth 2.0 (Traga seu próprio app), verifique também se o registro do app do Microsoft Entra concede a permissão. Um token de atualização atual carrega apenas os escopos consentidos quando foi emitido.

A pesquisa de e-mails retorna MailboxNotEnabledForRESTAPI

Esse erro significa que a caixa de correio não pode ser acessada pelo Microsoft Graph. Isso ocorre quando a caixa de correio é hospedada no local em uma implantação híbrida do Exchange, quando a caixa de correio está inativa ou excluída de maneira reversível ou quando há uma incompatibilidade de locatário ou diretório. Para resolver o problema, verifique se a caixa de correio está hospedada no Exchange Online. Para mais informações, consulte Como corrigir MailboxNotEnabledForRESTAPI na documentação da Microsoft.