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.
El conector problemas del servidor de GitHub Microsoft 365 Copilot integra los datos de problemas de GitHub en Microsoft 365.
En este artículo se proporciona información sobre los pasos de configuración que deben completar los administradores de GitHub para que su organización pueda implementar el conector de problemas del servidor de GitHub. Para obtener información sobre cómo implementar el conector, consulte Implementación del conector de problemas 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 y configurar los requisitos previos del conector.
| Tarea | Role |
|---|---|
| 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 |
| Comprobación de los permisos de administrador de búsqueda | Administrador de GitHub |
| Uso 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 se va a usar para la configuración del conector.
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. La accesibilidad de api es necesaria para que el conector indexe los problemas.
Identificar reglas de asignación de Microsoft Entra ID
Defina las reglas de asignación de Microsoft Entra ID. Asegúrese de que los usuarios que acceden a los datos indexados de GitHub tienen identidades de Microsoft Entra ID correspondientes para permitir una asignación de permisos precisa.
Inicio de sesión en la cuenta de GitHub
Para los usuarios administrados por la empresa que se autentican a través del inicio de sesión único (SSO), asegúrese de que la cuenta ha iniciado sesión antes de realizar las acciones de instalación. Actualmente, el flujo de autenticación de GitHub no admite el inicio de sesión basado en SSO durante la configuración.
Comprobación de los permisos de administrador de búsqueda
Asegúrese de que la persona que configura el conector es un administrador de búsqueda para el inquilino de Microsoft 365 de su organización.
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 |
| Configuración del firewall | Administrador de red |
Creación y configuración de la aplicación de GitHub
Para crear una aplicación de GitHub para su uso con el conector de problemas del servidor de GitHub:
- En GitHub, seleccione la foto de perfil en la parte superior derecha, seleccione Sus 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
- Administración: solo lectura
- Metadatos : solo lectura
- Problemas: solo lectura
Permisos de organización
- Administración: solo lectura
- Miembros: 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 donde 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.