Configurar o serviço GitHub para ingestão de conectores de Conhecimento na Cloud do GitHub

O conector de Microsoft 365 Copilot de Conhecimento do GitHub permite que as organizações indexem ficheiros de markdown e texto nos seus repositórios do GitHub em experiências de pesquisa e Microsoft 365 Copilot. Este artigo fornece informações sobre os passos de configuração que os administradores do GitHub têm de concluir antes de a sua organização implementar o conector de Conhecimento da Cloud do GitHub.

Para obter informações sobre como implementar o conector, veja Deploy the GitHub Knowledge connector (Implementar o conector de Conhecimento do GitHub).

Lista de verificação de configuração

A lista de verificação seguinte lista os passos envolvidos na configuração do ambiente e na configuração dos pré-requisitos do conector.

Identificar o nome da organização do GitHub

Determine a organização do GitHub que pretende indexar quando configurar o conector.

Garantir o acesso da API à instância do GitHub de destino

Confirme que a instância do GitHub está acessível através da API.

Identificar regras de mapeamento de Microsoft Entra ID

Defina as regras de mapeamento de Microsoft Entra ID. Certifique-se de que os utilizadores que acedem aos dados indexados do GitHub têm identidades de Microsoft Entra ID correspondentes para ativar o mapeamento de permissões preciso.

Iniciar sessão na conta do GitHub

Para os utilizadores geridos pela empresa que se autenticam através do início de sessão único (SSO), certifique-se de que a conta tem sessão iniciada antes de executar quaisquer ações de configuração. Atualmente, o fluxo de autenticação do GitHub não suporta o início de sessão baseado em SSO durante a configuração.

Utilizar uma aplicação do GitHub personalizada para autenticação (opcional)

Para obter a experiência de configuração mais simplificada, utilize a aplicação GitHub gerida pela Microsoft.

Também pode optar por utilizar a sua própria aplicação GitHub para autenticação. Se escolher esta opção, siga os passos na seguinte lista de verificação para concluir a configuração.

Criar e configurar a aplicação GitHub

Verifique se tem as permissões corretas atribuídas para configurar o serviço GitHub. Para obter mais informações, veja Funções numa organização.

Para criar uma aplicação do GitHub para utilização com o conector de Conhecimento da Cloud do GitHub:

1. No GitHub, selecione a sua foto de perfil no canto superior direito, selecione As suas organizações e escolha a organização a partir da qual o conector deve extrair dados.

   

2. Na página de descrição geral da organização, selecione Definições.

   

3. Na barra lateral esquerda, desloque-se para baixo até Definições do programador e selecione Aplicações gitHub.

   

4. Selecione Novo Aplicativo GitHub.

   

5. Configurar a aplicação:

   • Aplicativo GitHub nome: introduza o nome à sua escolha.
   • URL da home page: copie o URL da barra de endereço do browser.
   • URL de chamada de retorno:
     • Para o Microsoft 365 para grandes empresas: https://gcs.office.com/v1.0/admin/oauth/callback
     • Para o Microsoft 365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback

   

6. Desmarque a opção Webhook .

7. Defina as seguintes permissões:

   Permissões de repositório

   • Conteúdo - Só de leitura
   • Metadados - Só de leitura
   • Administração - Só de leitura
   • Webhooks - Leitura e Escrita

   Permissões da organização

   • Membros - Só de leitura
   • Administração - Só de leitura
   • Webhooks - Leitura e Escrita

   Permissões da conta

   • endereços de Email – Só de leitura

8. Em Onde é que esta Aplicativo GitHub pode ser instalada, selecione Qualquer conta e, em seguida, selecione Criar Aplicativo GitHub.

   

Criar credenciais para a aplicação GitHub

• Na página Geral da aplicação GitHub, selecione Gerar um novo segredo do cliente para gerar e copiar o segredo do cliente.

  

Instalar a aplicação GitHub

1. Na página Geral da aplicação GitHub, selecione Instalar Aplicação.

   

2. Selecione a organização onde pretende que a aplicação seja instalada.

   

Configurar as definições da firewall

Para maior segurança, pode configurar regras de firewall de IP para o servidor ou base de dados do SQL do Azure. Para obter mais informações, veja Regras de firewall de IP.

Adicione os seguintes intervalos de IP de cliente nas definições da firewall.

As restrições de IP podem fazer com que o conector deixe de funcionar e leve a falhas de pesquisa. Para resolve este problema, adicione o endereço IP do conector à lista de permissões.

Próxima etapa