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

O conector Microsoft 365 Copilot Problemas da Cloud do GitHub permite que a sua organização indexe problemas armazenados no GitHub para os disponibilizar 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 Problemas na Cloud do GitHub.

Para obter informações sobre como implementar o conector, veja Implementar o conector Problemas 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 Entra ID

Defina as regras de mapeamento do Entra ID. Certifique-se de que os utilizadores que acedem aos dados indexados do GitHub têm identidades de 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

Para criar uma aplicação do GitHub para utilização com o conector Problemas 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:

   • Nome da aplicação GitHub: 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

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

   Permissões da organização

   • Administração - Só de leitura
   • Membros - 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 o Aplicativo 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 o Aplicativo GitHub

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

   

2. Selecione a organização onde pretende instalar a aplicação.

   

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