Compartir a través de

Conector de Microsoft 365 Copilot de GitLab Server

El conector de Microsoft 365 Copilot de GitLab Server permite a su organización indexar solicitudes de combinación, problemas, wikis y documentación almacenadas en GitLab. Después de configurar el conector e indexar el contenido de GitLab, los usuarios pueden buscar y recuperar información a través de Microsoft Search y Microsoft 365 Copilot.

Este artículo está destinado a los administradores de Microsoft 365 o a cualquier persona que configure, ejecute o supervise el conector Microsoft 365 Copilot GitLab.

Capacidades

  • Indexe repositorios de GitLab, solicitudes de combinación y problemas de acceso, wikis y documentación.
  • Habilite Microsoft Search y Microsoft 365 Copilot para recuperar datos de GitLab de forma eficaz.
  • Mantenga las ACL de GitLab y los permisos de usuario.
  • Permitir a los administradores personalizar la frecuencia de rastreo y las preferencias de indexación.

Limitaciones

  • El conector no admite la indexación de canalizaciones de CI/CD de GitLab más allá de la indexación de estado.
  • Solo se indexan repositorios, problemas, solicitudes de combinación, .md, archivos .txt y wikis.
  • No se admite la prohibición de usuarios como regla de permisos. Como solución alternativa, los administradores pueden quitar usuarios de grupos en su lugar.
  • No se admite la restricción del acceso a grupos por dirección IP. Se recomienda que los administradores creen un grupo privado para administrar el acceso.
  • Debido a los problemas de estabilidad identificados durante las pruebas internas de Microsoft, la compatibilidad con el rol planner ha quedado en desuso de forma conservadora. El acceso ahora está restringido a los roles de reportero y versiones posteriores. Los usuarios pueden encontrar problemas al asignar miembros del equipo al rol de Planner. Para mitigar posibles problemas, asigne roles de reportero o superior. Supervisamos estrechamente esta característica y seguimos trabajando en mejoras.
  • En el caso de los conectores de GitLab Server Copilot, debido a consideraciones de seguridad, el acceso a las solicitudes de combinación de proyectos públicos con visibilidad restringida a los miembros del proyecto se establece de forma conservadora en el rol de reportero y versiones posteriores.

Requisitos previos

Antes de configurar el conector, asegúrese de lo siguiente:

  1. Confirme que la instancia de GitLab es accesible a través de la API.
  2. Genere un identificador de cliente y un secreto de cliente de GitLab para la autenticación.
  3. La cuenta de usuario de autenticación debe tener acceso a repositorios, problemas, solicitudes de combinación, archivos de conocimiento y páginas wiki.
  4. El identificador de cliente y el secreto de cliente deben incluir los ámbitos siguientes:
    • read_api
    • read_repository
    • read_user
  5. Los usuarios que acceden a los datos de GitLab indexados deben tener las identidades de Microsoft Entra ID correspondientes para la asignación de permisos.
  6. Establezca las direcciones URL de redireccionamiento adecuadas durante la configuración de la autenticación de 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

Detalles del conector de Copilot del servidor GitLab

Para las instancias de GitLab autoadministrada, asegúrese de lo siguiente:

  • La versión de GitLab debe ser 17.7 o posterior.
  • La versión del agente del conector de Microsoft Graph debe ser 3.1.8.0 o posterior y debe instalarse en un servidor que pueda conectarse a la instancia de GitLab.
    Siga la guía de configuración para configurar el agente.
  • La cuenta de autenticación debe tener privilegios administrativos para habilitar el rastreo de ACL.
  1. Para mejorar el rendimiento, deshabilite o aumente los límites en la configuración límites de velocidad de IP y usuario . Para obtener más información, consulte la documentación de GitLab. La configuración recomendada es:
    • Límites de velocidad de ip y de usuario: desactive Enable authenticated API request rate limit y Enable authenticated web request rate limit.
    • Límites de velocidad de API de archivos: desactive Enable authenticated API request rate limit.
    • Límites de velocidad de API en desuso: desactive Enable authenticated API request rate limit.
    • Límites de velocidad de API de los usuarios: se establece en Max requests per 10 minutes per user un valor alto (por ejemplo, 100000).
    • Límites de velocidad de API de grupos: establezca todos los valores 0 en para deshabilitar los límites.
    • Límites de velocidad de API de proyectos: establezca todos los valores 0 en para deshabilitar los límites.
    • Límites de velocidad de API de miembros: establezca en 0.

Introducción

1. Elija el nombre para mostrar.

Elija un nombre para mostrar que ayude a los usuarios a reconocer solicitudes de combinación, problemas o documentación en una respuesta de Copilot.

2. Autenticación

  • Escriba el id. de cliente y el secreto de cliente de GitLab.
  • Elija Autorizar para iniciar sesión y conceder acceso.
  • Conceda los ámbitos de API necesarios.

3. Lanzamiento a audiencia limitada

Antes de implementar el conector, pruebe la conexión con una base de usuarios limitada en Copilot y Microsoft Search.

Configuración personalizada

La configuración personalizada es para los administradores que desean editar los valores predeterminados de cualquier configuración. Al elegir Configuración personalizada, verá otras tres pestañas: Usuarios, Contenido y Sincronización.

Usuarios

Asignación de identidades

Para garantizar la correcta aplicación de permisos, asigne una de las siguientes identidades de usuario de GitLab a Microsoft Entra ID.

  • Email: coincide con los correos electrónicos de usuario de GitLab con Microsoft Entra ID correos electrónicos. (Asignación predeterminada y recomendada)
  • Nombre de usuario: hace coincidir los nombres de usuario de GitLab con Microsoft Entra ID nombre principal de usuario (UPN).
  • Nombre: asigna nombres de usuario de GitLab con nombres para mostrar Microsoft Entra ID.

Si se produce un error en la asignación directa, use expresiones regulares (regex) para la transformación.

Contenido

Puede comprobar las asignaciones de propiedades en los datos de ejemplo para metadatos como títulos, descripciones, estados y marcas de tiempo en la pestaña Contenido.

Sincronizar

Puede configurar rastreos completos e incrementales en función de las opciones de programación presentes aquí. De forma predeterminada, el rastreo incremental se establece para cada 15 minutos y el rastreo completo se establece para cada día. Si es necesario, puede ajustar estas programaciones para que se ajusten a sus necesidades de actualización de datos.

Pasos siguientes

Para obtener información sobre la solución de problemas, consulte la guía de solución de problemas de GitLab.

Si tiene problemas o necesita soporte técnico, consulte Soporte técnico de Microsoft Graph.

  • Last updated on