Configurar o serviço GitHub para a ingestão de conectores do GitHub Cloud Pull Request

O conector gitHub Cloud Pull Requests Microsoft 365 Copilot permite à sua organização indexar pedidos Pull armazenados em repositórios do GitHub em experiências de Microsoft 365 Copilot e Microsoft Search.

Este artigo fornece informações sobre os passos de configuração que os administradores do GitHub precisam de concluir para que a sua organização implemente o conector GitHub Cloud Pull Requests.

Para obter informações sobre como implementar o conector, veja Implementação de Pedidos Pull do GitHub Cloud.

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 a 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 configurar o conector. 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 o Aplicativo GitHub

1. No GitHub, selecione o seu foto de perfil, 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, selecione Definições do programador e, em seguida, Aplicações gitHub.

   

4. Selecione Novo Aplicativo GitHub.

   

5. Configurar a aplicação:

   • Aplicativo GitHub nome: introduza um nome à sua escolha.
   • URL da home page: utilize o URL da sua organização.
   • URL de chamada de retorno:
     • Microsoft 365 para grandes empresas: https://gcs.office.com/v1.0/admin/oauth/callback
     • Microsoft 365 Government: 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
   • Conteúdo - Só de leitura
   • Metadados - Só de leitura
   • Pedidos Pull – 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 a aplicação GitHub

Na página Geral do Aplicativo 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 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