Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se proporciona información sobre los pasos de configuración que los administradores de GitHub deben completar para que su organización implemente el conector de solicitudes de incorporación de cambios del servidor de GitHub. Cuando se configura, el conector indexa los datos de solicitud de incorporación de cambios de GitHub Enterprise Server para que los usuarios puedan buscar, resumir y recuperar información de solicitud de incorporación de cambios en Microsoft Search, Microsoft 365 Copilot y Copilot Search.
Este artículo se aplica al conector de solicitudes de incorporación de cambios del servidor de GitHub. Para obtener información sobre cómo implementar el conector, consulte Implementación del conector de solicitudes de incorporación de cambios del servidor de GitHub.
Lista de comprobación de configuración
En la lista de comprobación siguiente se enumeran los pasos necesarios para configurar el entorno de GitHub Server y configurar los requisitos previos del conector.
| Tarea | Rol |
|---|---|
| Identificar el nombre de la organización | Administrador de GitHub |
| Garantizar el acceso de API a la instancia de GitHub de destino | Administrador de GitHub |
| Identificar Microsoft Entra ID reglas de asignación de identidades | Administrador de GitHub |
| Inicio de sesión en la cuenta de GitHub | Administrador de GitHub |
| Configuración de una aplicación de GitHub personalizada para la autenticación | Administrador de GitHub |
| Ajuste del límite de velocidad de la API de GitHub Server | Administrador de GitHub |
| Configuración del firewall | Administrador de red |
Identificar el nombre de la organización
Determine qué organización de GitHub Enterprise Server usará el conector para la ingesta de PR. El conector indexa solo el contenido accesible para la aplicación de GitHub instalada en la organización seleccionada.
Garantizar el acceso de API a la instancia de GitHub de destino
Confirme que la instancia de GitHub Enterprise Server es accesible a través de la API. El conector requiere acceso a la API para recuperar los metadatos de la solicitud de incorporación de cambios. Asegúrese de que:
- La instancia de GitHub es accesible a través de HTTPS.
- Las restricciones de firewall o red permiten solicitudes de API entrantes o salientes.
- El dispositivo host del agente del conector de Graph puede llegar al dominio de GitHub Enterprise Server.
Identificar reglas de asignación de Microsoft Entra ID
Defina las reglas de asignación de Microsoft Entra ID. La asignación de identidades garantiza la aplicación correcta de los permisos cuando los usuarios acceden a los datos de solicitud de incorporación de cambios en Copilot y a las experiencias de búsqueda.
Entre las estrategias de asignación admitidas se incluyen:
- Email: coincide con las direcciones de correo electrónico de GitHub con Microsoft Entra ID propiedades.
- Iniciar sesión: Asigna nombres de usuario de GitHub a atributos Microsoft Entra ID.
- Nombre: Usa el nombre del perfil de GitHub para la asignación.
Si las identidades no coinciden directamente, puede usar expresiones regulares (regex) para normalizar los datos. Por ejemplo: [a-zA-Z0-9]+
Los usuarios deben compartir los atributos de identidad de GitHub necesarios, especialmente en entornos de Bring Your Own User (BYOU).
Inicio de sesión en la cuenta de GitHub
Si su organización usa el inicio de sesión único (SSO), inicie sesión en GitHub antes de configurar el conector. Actualmente, el conector de solicitudes de incorporación de cambios del servidor de GitHub no admite la finalización de flujos de autenticación que dependen del inicio de sesión único durante la configuración del conector.
Uso de una aplicación de GitHub personalizada para la autenticación
Para obtener la experiencia de configuración más simplificada, use la aplicación de GitHub administrada por Microsoft.
También puede optar por usar su propia aplicación de GitHub para la autenticación. Si elige esta opción, siga los pasos de la siguiente lista de comprobación para completar la configuración.
| Tarea | Rol |
|---|---|
| Creación y configuración de la aplicación de GitHub | Administrador de GitHub |
| Creación de credenciales para la aplicación de GitHub | Administrador de GitHub |
| Instalación de la aplicación de GitHub | Administrador de GitHub |
Creación y configuración de la aplicación de GitHub
Compruebe que tiene asignados los permisos adecuados para configurar el servicio de GitHub. Para obtener más información, consulte Roles en una organización.
Para crear una aplicación de GitHub para usarla con el conector solicitudes de incorporación de cambios del servidor de GitHub:
En GitHub, seleccione la foto de perfil en la parte superior derecha, seleccione Organizaciones y elija la organización de la que el conector debe extraer datos.
En la página información general de la organización, seleccione Configuración.
En la barra lateral izquierda, desplácese hacia abajo hasta Configuración del desarrollador y seleccione Aplicaciones de GitHub.
Seleccione Nueva aplicación de GitHub.
Configure la aplicación:
- Nombre de la aplicación de GitHub: escriba el nombre que prefiera.
- Dirección URL de la página principal: copie la dirección URL de la barra de direcciones del explorador.
-
Dirección URL de devolución de llamada:
- Para Microsoft 365 para empresas:
https://gcs.office.com/v1.0/admin/oauth/callback - Para Microsoft 365 Government:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Para Microsoft 365 para empresas:
Desactive la opción Webhook .
Establezca los permisos siguientes:
Permisos del repositorio
- Contenido: solo lectura
- Metadatos : solo lectura
- Administración: solo lectura
Permisos de organización
- Miembros: solo lectura
- Administración: solo lectura
Permisos de cuenta
- direcciones Email: solo lectura
En Where can this GitHub App be installed (Dónde se puede instalar esta aplicación de GitHub), seleccione Any account (Cualquier cuenta) y, a continuación, seleccione Create GitHub App (Crear aplicación de GitHub).
Creación de credenciales para la aplicación de GitHub
En la página General de la aplicación GitHub, seleccione Generar un nuevo secreto de cliente para generar y copiar el secreto de cliente.
Instalación de la aplicación de GitHub
En la página General de la aplicación de GitHub, seleccione Instalar aplicación.
Seleccione la organización en la que desea instalar la aplicación.
Ajuste del límite de velocidad de la API de GitHub Server
Al ingerir grandes volúmenes de datos de GitHub, como solicitudes de incorporación de cambios, problemas o archivos de conocimiento, la configuración del límite de velocidad de API en el entorno de GitHub Server afecta directamente a la rapidez con la que se completa el proceso de ingesta. GitHub Server aplica un límite de API predeterminado de 15 000 solicitudes autenticadas por hora por usuario o token. Este límite admite conjuntos de datos más pequeños, pero puede ralentizar la ingesta cuando se procesan cientos de miles o millones de elementos.
Si su organización necesita aumentar el rendimiento, puede aumentar el límite de velocidad de API. Los límites más altos permiten al conector recuperar elementos más rápidamente, pero también aumentan la carga en la infraestructura de GitHub Server. Antes de actualizar la configuración de límite de velocidad, compruebe que el entorno tiene suficiente capacidad de CPU, E/S de almacenamiento y ancho de banda de red para admitir el aumento del volumen de solicitudes. Después de actualizar el límite, supervise el rendimiento del sistema para garantizar una ingesta estable a un mayor rendimiento.
Recomendaciones de configuración de límite de velocidad
Use las instrucciones de la tabla siguiente para ayudarle a elegir una configuración de límite de velocidad adecuada en función del número aproximado de solicitudes de incorporación de cambios en el entorno de GitHub.
| Número aproximado de elementos | Configuración de límite de velocidad recomendada | Tiempo aproximado para completar la ingesta |
|---|---|---|
| Hasta 100 000 | Usar la configuración predeterminada del límite de velocidad (velocidad de ingesta normal) | ND |
| De 100 000 a 1000 000 | Aumento del límite de velocidad a 30 000 solicitudes por hora | 2 días a 1 semana |
| 1000 000 o más | Usar 30 000 solicitudes/hora o superior (dependiendo de la capacidad del servidor) | 1–2 semanas (varía según la carga del entorno) |
Actualización de la configuración de límite de velocidad de API
Para aumentar el límite de solicitudes de API:
- Inicie sesión en la instancia de GitHub Server con una cuenta de administrador.
- En la esquina superior derecha, seleccione Administrador del sitio para entrar en modo de administración. Para obtener más información, consulte Configuración de límites de velocidad.
- En el panel izquierdo, seleccione Consola de administración (o Administración Consola, según su versión).
- Abra la pestaña Limitación de velocidad .
- Confirme que habilitar la limitación de velocidad de API HTTP está seleccionada.
- En Solicitudes de API (por hora): autenticadas, escriba el valor de límite de velocidad (por ejemplo, 30000).
- Seleccione Guardar configuración.
Nota:
Al guardar los cambios, es posible que determinados servicios de GitHub Server se reinicien y provoquen una breve interrupción del servicio. Después de guardar, espere tiempo para que la configuración se propague a través de la instancia.
Configuración del firewall
Para mayor seguridad, puede configurar reglas de firewall de IP para su Azure SQL Server o base de datos. Para obtener más información, consulte Reglas de firewall de IP.
Agregue los siguientes intervalos IP de cliente en la configuración del firewall.
| Región | Microsoft 365 Enterprise | Microsoft 365 Government |
|---|---|---|
| NAM | 52.250.92.252/30, 52.224.250.216/30 | 52.245.230.216/30, 20.141.117.64/30 |
| EUR | 20.54.41.208/30, 51.105.159.88/30 | ND |
| APC | 52.139.188.212/30, 20.43.146.44/30 | ND |
Las restricciones de IP pueden hacer que el conector deje de funcionar y provoque errores de rastreo. Para resolver este problema, agregue la dirección IP del conector a la lista de permitidos.