Configuração do Microsoft Teams

Pré-visualização pública: a pesquisa federada está em pré-visualização pública. Esta funcionalidade está sujeita aos "Termos de ofertas de pré-disponibilidade geral" na secção de Termos de Utilização Gerais dos Termos Específicos do Serviço. As funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Esta página descreve como configurar a autenticação e as autorizações antes de criar o arquivo de dados do Microsoft Teams.

Configure a autenticação e as autorizações

Tem de configurar a autenticação e as autorizações no Microsoft 365, o que é fundamental para permitir que o Gemini Enterprise aceda aos dados do Microsoft Teams.

Registo da app Entra para o repositório de dados do Microsoft Teams

Tem de configurar um registo de aplicação do Microsoft Entra para ativar o acesso seguro ao Microsoft Teams antes de criar o arquivo de dados do Gemini Enterprise.

Para registar o Gemini Enterprise como uma aplicação OAuth 2.0 no Microsoft Entra, faça o seguinte:

1. Navegue para o centro de administração do Microsoft Entra.
2. No menu, expanda a secção Entra ID e selecione Registos de apps.
3. Na página Registos de apps, selecione adicionar Novo registo.
4. Na página Registar uma aplicação, crie um registo de app fazendo o seguinte:
   1. Na secção Nome, introduza um nome a apresentar para a aplicação.

      

      Registe uma página de aplicação

   2. Na secção Tipos de contas suportados, selecione Apenas contas no diretório organizacional. Esta opção restringe o acesso a utilizadores no inquilino do Microsoft Entra da sua organização, o que é adequado para uma aplicação empresarial.
   3. Na secção URI de redirecionamento, selecione Web e introduza o seguinte URL como URL de callback da Web (ou URL de redirecionamento):
      • https://vertexaisearch.cloud.google.com/oauth-redirect
   4. Clique em Registar. O Microsoft Entra cria a sua app e apresenta-a na página Todas as aplicações.

Crie uma configuração do OAuth 2.0

Para criar uma associação através do método de autenticação OAuth 2.0, siga estes passos para obter um ID de cliente, um segredo do cliente e um ID do inquilino na página de registo da aplicação Microsoft Entra.

Obtenha o ID de cliente e o segredo do cliente

Para obter o ID de cliente e o segredo da app, faça o seguinte:

1. Navegue para o centro de administração do Microsoft Entra.
2. No menu, expanda a secção Entra ID e selecione Registos de apps.
3. Na página Registos de apps, selecione Todas as aplicações.
4. Abra a aplicação que criou.
5. Na página da app, selecione Certificados e segredos.
6. Clique em adicionar Novo segredo do cliente.
7. Na caixa de diálogo Adicionar um segredo do cliente:
   1. Introduza uma descrição para o segredo.

      

      Caixa de diálogo Adicionar segredo do cliente

   2. Selecione uma duração de validade. Recomendamos que selecione o valor predefinido.
   3. Clique em Adicionar.
8. Copie o segredo da coluna Valor (Client Secret) e o identificador da coluna ID do segredo (Client ID) e armazene-os em segurança para utilização posterior.

Obtenha o ID do inquilino

Pode encontrar o seu ID do inquilino na caixa ID do inquilino na página de vista geral no centro de administração do Microsoft Entra.

Obtenha o ID do inquilino

Configure as autorizações do Microsoft Graph

Para configurar as autorizações do Microsoft Graph necessárias para a app, faça o seguinte:

1. Navegue para o centro de administração do Microsoft Entra.
2. No menu de navegação, expanda a secção ID do Entra e selecione Registos de apps.
3. Na página Registos de apps, selecione Todas as aplicações.
4. Abra a aplicação que criou.
5. Na página da app, selecione Autorizações da API.
6. Clique em Adicionar uma autorização.
7. Na página Pedir autorizações da API, selecione Microsoft Graph e, de seguida, Autorizações delegadas.

8. Pesquise e selecione as seguintes autorizações para o seu modo de ligação. Certifique-se de que um administrador concede consentimento para todas as autorizações delegadas indicadas na tabela seguinte. Assim que o consentimento for concedido, a coluna Estado apresenta Concedido com uma marca de verificação verde (✓).

   Modo de ligação	Autorização	Tipo de autorização	Finalidade
   Pesquisa federada	Chat.Read	Delegado	Permite que a app leia todos os chats.
   	Chat.ReadBasic	Delegado	Permite que a app leia as propriedades básicas dos chats.
   	ChatMessage.Read	Delegado	Permite que a app leia todas as mensagens de chats individuais e em grupo.
   	Channel.ReadBasic.All	Delegado	Permite que a app leia os nomes e as descrições dos canais.
   	ChannelMessage.Read.All	Delegado	Permite que a app leia mensagens do canal do utilizador.
   	Team.ReadBasic.All	Delegado	Permite que a app leia os nomes e a descrição das equipas.
   	User.Read	Delegado	Permite que a app inicie sessão e leia o perfil do utilizador.
   Pesquisa e ações federadas	Chat.Read	Delegado	Permite que a app leia todos os chats.
   	Chat.ReadBasic	Delegado	Permite que a app leia as propriedades básicas dos chats.
   	ChatMessage.Read	Delegado	Permite que a app leia todas as mensagens de chats individuais e em grupo.
   	Channel.ReadBasic.All	Delegado	Permite que a app leia os nomes e as descrições dos canais.
   	ChannelMessage.Read.All	Delegado	Permite que a app leia mensagens do canal do utilizador.
   	Team.ReadBasic.All	Delegado	Permite que a app leia os nomes e a descrição das equipas.
   	User.Read	Delegado	Permite que a app inicie sessão e leia o perfil do utilizador.
   	ChannelMessage.Send	Delegado	Permite que a app envie mensagens em qualquer canal.
   	ChatMessage.Send	Delegado	Permite que a app envie mensagens de chat.

   Nota: se pretender usar o armazenamento de dados apenas para pesquisa e não para realizar ações que modifiquem o conteúdo no Microsoft Teams, pode limitar o âmbito às autorizações Read.All. São necessárias outras autorizações para ações que envolvam a atualização de conteúdo no Microsoft Teams.

9. Clique em Adicionar autorizações.

Conceda o consentimento do administrador para autorizações

Para conceder o consentimento do administrador para autorizações, faça o seguinte:

1. Inicie sessão no centro de administração do Microsoft Entra como administrador global ou de aplicações.
2. No menu de navegação, expanda a secção ID do Entra e selecione Registos de apps.
3. Na página Registos de apps, selecione Todas as aplicações.
4. Abra a aplicação que criou.
5. Na página da app, selecione Autorizações da API.

6. Clique no botão Conceder consentimento do administrador para.

   

   Conceda consentimento do administrador

7. Selecione Sim na caixa de diálogo para confirmar a ação de consentimento.