Configuración del servicio GitHub para la ingesta del conector de GitHub Cloud Knowledge

El conector Microsoft 365 Copilot conocimiento de GitHub permite a las organizaciones indexar los archivos markdown y de texto en los repositorios de GitHub en Microsoft 365 Copilot y experiencias de búsqueda. En este artículo se proporciona información sobre los pasos de configuración que deben completar los administradores de GitHub antes de que su organización implemente el conector de GitHub Cloud Knowledge.

Para obtener información sobre cómo implementar el conector, consulte Implementación del conector de Conocimiento 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.

Identificación del nombre de la organización de GitHub

Determine qué organización de GitHub desea indexar al configurar el conector.

Garantizar el acceso de API a la instancia de GitHub de destino

Confirme que la instancia de GitHub es accesible a través de la API.

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 habilitar la 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.

Uso de una aplicación de GitHub personalizada para la autenticación (opcional)

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.

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 de Conocimiento en la nube de GitHub:

1. 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.

   

2. En la página información general de la organización, seleccione Configuración.

   

3. En la barra lateral izquierda, desplácese hacia abajo hasta Configuración del desarrollador y seleccione Aplicaciones de GitHub.

   

4. Seleccione Nueva aplicación de GitHub.

   

5. 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

   

6. Desactive la opción Webhook .

7. Establezca los permisos siguientes:

   Permisos del repositorio

   • Contenido: solo lectura
   • Metadatos : solo lectura
   • Administración: solo lectura
   • Webhooks: lectura y escritura

   Permisos de organización

   • Miembros: solo lectura
   • Administración: solo lectura
   • Webhooks: lectura y escritura

   Permisos de cuenta

   • direcciones Email: solo lectura

8. 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

1. En la página General de la aplicación de GitHub, seleccione Instalar aplicación.

   

2. Seleccione la organización en la que desea instalar la aplicación.

   

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.

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.

Paso siguiente