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. Isto é fundamental para permitir que o conetor aceda aos dados. O conector do MS Teams suporta vários métodos de autenticação, como credenciais de cliente OAuth ou tokens de API.

Registo de apps do Entra para o conetor do Microsoft Teams

Tem de configurar um registo de aplicação do Microsoft Entra para ativar o acesso seguro ao Microsoft Teams antes de poder criar o conector 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 Contas apenas 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 os seguintes URLs como URLs de callback da Web (ou URLs 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, tem de obter um ID de cliente, um segredo do cliente e um ID de 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

Autorizações mínimas da Microsoft Graph

Para configurar as autorizações da API necessárias para a 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 Autorizações da API.
6. Clique em Adicionar uma autorização.

7. Na página Pedir autorizações da API, selecione Microsoft Graph e Autorizações delegadas.

8. Pesquise e selecione as seguintes autorizações para a pesquisa federada:

   Modo de ligação	Autorização	Finalidade
   Pesquisa federada	Group.Read.All	Permite que o repositório de dados leia as propriedades e as associações de grupos, bem como as conversas de todos os grupos.
   	Sites.Read.All	Permite que o repositório de dados leia todos os ficheiros e documentos partilhados nos canais do Teams em toda a organização.
   	ChatMessage.Read.All	Permite que a app leia todas as mensagens de chats individuais e em grupo.
   	User.Read.All	Permite que o arquivo de dados leia perfis de utilizadores.

9. Clique em Adicionar autorizações.