Conector de Microsoft 365 Copilot do GitLab Server

O conector de Microsoft 365 Copilot do GitLab Server permite à sua organização indexar pedidos de intercalação, problemas, wikis e documentação armazenados no GitLab. Depois de configurar o conector e indexar o conteúdo do GitLab, os utilizadores podem procurar e obter informações através do Microsoft Search e Microsoft 365 Copilot.

Este artigo destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute ou monitorize o conector de Microsoft 365 Copilot do GitLab.

Recursos

• Indexar repositórios do GitLab, pedidos de intercalação e problemas de acesso, wikis e documentação.
• Ative o Microsoft Search e o Microsoft 365 Copilot para obter dados do GitLab de forma eficiente.
• Mantenha as ACLs do GitLab e as permissões de utilizador.
• Permitir que os administradores personalizem as preferências de indexação e frequência de pesquisa.

Limitações

• O conector não suporta a indexação de pipelines CI/CD do GitLab para além status indexação.
• Apenas os repositórios, problemas, pedidos de intercalação, .md, ficheiros .txt e wikis são indexados.
• A proibição de utilizadores não é suportada como regra de permissão. Como solução, os administradores podem remover utilizadores de grupos.
• A restrição do acesso a grupos por endereço IP não é suportada. Recomendamos que os administradores criem um grupo privado para gerir o acesso.
• Devido a preocupações de estabilidade identificadas durante os testes internos da Microsoft, o suporte para a função do Planner foi preterido de forma conservadora. O acesso está agora restringido às funções de Jornalista e superior. Os utilizadores podem deparar-se com problemas ao atribuir membros da equipa à função planner. Para mitigar potenciais problemas, atribua funções de Jornalista ou superior. Monitorizamos esta funcionalidade de perto e continuamos a trabalhar em melhorias.
• Para os conectores Do GitLab Server Copilot, devido a considerações de segurança, o acesso a pedidos de intercalação de projetos públicos com visibilidade restrita aos membros do projeto está definido de forma conservadora para a função de jornalista e superior.

Pré-requisitos

Antes de configurar o conector, certifique-se do seguinte:

1. Confirme que a instância do GitLab está acessível através da API.
2. Gere um ID de Cliente e Um Segredo do Cliente a partir do GitLab para autenticação.
3. A conta de utilizador de autenticação tem de ter acesso a repositórios, problemas, pedidos de intercalação, ficheiros de conhecimento e páginas wiki.
4. O ID de Cliente e o Segredo do Cliente têm de incluir os seguintes âmbitos:
   • read_api
   • read_repository
   • read_user
5. Os utilizadores que acedem aos dados indexados do GitLab têm de ter identidades de Microsoft Entra ID correspondentes para mapeamento de permissões.
6. Defina os URLs de redirecionamento adequados durante a configuração da autenticação do GitLab:
   • Microsoft 365 Enterprise:
     https://gcs.office.com/v1.0/admin/oauth/callback
   • Microsoft 365 Government:
     https://gcsgcc.office.com/v1.0/admin/oauth/callback

GitLab server Copilot connector specifics (Especificações do conector Copilot do servidor do GitLab)

Para instâncias do GitLab autogeridas, confirme o seguinte:

• A versão do GitLab tem de ser a 17.7 ou posterior.
• A versão do agente do conector do Microsoft Graph tem de ser a 3.1.8.0 ou posterior e tem de ser instalada num servidor que se possa ligar à instância do GitLab.
  Siga o guia de configuração para configurar o agente.
• A conta de autenticação tem de ter privilégios administrativos para ativar a pesquisa da ACL.

4. Para um melhor desempenho, desative ou aumente os limites nas definições limites de taxa de UTILIZADOR e IP . Para obter mais informações, veja a documentação do GitLab. A configuração recomendada é:
   • Limites de Taxa de IP e utilizador: desmarque Enable authenticated API request rate limit e Enable authenticated web request rate limit.
   • Limites de Taxa da API de Ficheiros: desmarque Enable authenticated API request rate limit.
   • Limites de Taxa de API preteridos: desmarque Enable authenticated API request rate limit.
   • Limites da Taxa de API dos Utilizadores: definido Max requests per 10 minutes per user para um valor elevado (por exemplo, 100000).
   • Limites de Taxa de API de Grupos: defina todos os valores como para 0 desativar os limites.
   • Limites de Taxa de API de Projetos: defina todos os valores como para 0 desativar os limites.
   • Limites de Taxa da API de Membros: definido como 0.

Introdução

1. Selecione o nome a apresentar

Escolha um nome a apresentar que ajude os utilizadores a reconhecer pedidos de intercalação, problemas ou documentação numa resposta copilot.

2. Autenticar

• Introduza o ID de Cliente e o Segredo do cliente do GitLab.
• Selecione Autorizar para iniciar sessão e conceder acesso.
• Conceda os âmbitos de API necessários.

3. Implementar para público-alvo limitado

Antes de implementar o conector, teste a ligação com uma base de utilizadores limitada no Copilot e no Microsoft Search.

Configuração personalizada

A configuração personalizada destina-se a administradores que pretendam editar os valores predefinidos para quaisquer definições. Quando seleciona Configuração personalizada, vê outros três separadores: Utilizadores, Conteúdo e Sincronização.

Usuários

Mapeamento de identidade

Para garantir a imposição de permissão correta, mapeie uma das seguintes identidades de utilizador do GitLab para Microsoft Entra ID.

• Email: corresponde a e-mails de utilizador do GitLab com Microsoft Entra ID e-mails. (Mapeamento predefinido e recomendado)
• Nome de utilizador: corresponde aos nomes de utilizador do GitLab para Microsoft Entra ID nome principal de utilizador (UPN).
• Nome: mapeia nomes de utilizador do GitLab com Microsoft Entra ID nomes a apresentar.

Se o mapeamento direto falhar, utilize expressões regulares (regex) para a transformação.

Conteúdo

Pode verificar os mapeamentos de propriedades nos dados de exemplo para metadados, tais como títulos, descrições, estados e carimbos de data/hora no separador Conteúdo .

Sincronização

Pode configurar pesquisas completas e incrementais com base nas opções de agendamento aqui presentes. Por predefinição, a pesquisa incremental é definida para cada 15 minutos e a pesquisa completa é definida para todos os dias. Se necessário, pode ajustar estas agendas de acordo com as suas necessidades de atualização de dados.

Próximas etapas

Para obter informações sobre a resolução de problemas, veja o guia de resolução de problemas do GitLab.

Se tiver problemas ou precisar de suporte, consulte Suporte do Microsoft Graph.