Skip to main content

​
Acerca de GitHub

El conector de GitHub lee los metadatos de los repositorios, la protección de ramas, la pertenencia a equipos, la configuración de la organización, los registros de auditoría y la configuración de seguridad relacionada de tu organización de GitHub. Esos datos aparecen en Iru Compliance como artefactos que puedes asignar a acciones y controles. La integración es de solo lectura. Iru no abre pull requests, no cambia la configuración ni modifica repositorios más allá de lo que la API de GitHub permite para los ámbitos que concedas.

​
Cómo funciona

Iru llama a la API REST de GitHub con un token de acceso personal (PAT) enviado como token Bearer:
Los PAT detallados (fine-grained, recomendados) te permiten limitar estrictamente los repositorios y permisos. Los PAT clásicos funcionan, pero son más amplios y más difíciles de ajustar al mínimo privilegio. Si tu organización exige SAML SSO, debes autorizar el PAT para la organización después de crearlo; de lo contrario, las llamadas a la API para datos de la organización fallarán. Referencias oficiales: Administrar tokens de acceso personal, Autenticación de REST y Límites de velocidad.

​
Requisitos previos

  • Acceso a GitHub como miembro (o propietario) de la organización que quieres que Iru lea.
  • Acceso de Propietario en esa organización si necesitas registros de auditoría y configuración de seguridad de toda la organización (según lo que espere tu programa de cumplimiento).
  • Un PAT con permisos de lectura alineados con las tablas siguientes (se muestra un PAT detallado).
Permisos mínimos del PAT detallado (típicos) Amplíalos solo si tus controles requieren ámbitos de lectura adicionales.

​
Conectar GitHub a Iru

​
Crear un token de acceso personal detallado

1

Abre Developer settings

Inicia sesión en GitHub. Selecciona tu foto de perfil → Configuración → Developer settings → Personal access tokens → Fine-grained tokens.
2

Crea un token nuevo

Selecciona Generate new token.
3

Establece el nombre, la caducidad y el alcance de recursos

Establece un nombre claro (por ejemplo, Iru Compliance) y una caducidad (los PAT detallados pueden durar hasta 366 días; configura un recordatorio para rotarlos con antelación). En Resource owner, elige tu organización cuando necesites datos de nivel de organización. En Repository access, elige All repositories o solo los que abarque el cumplimiento.
4

Establece los permisos de repositorio y organización

En Permisos, habilita al menos los permisos de lectura de repositorio y organización indicados en Requisitos previos más arriba.
5

Genera y copia el token

Genera el token y cópialo de inmediato. Solo se muestra una vez.
6

Autoriza para SAML SSO (si es necesario)

Si tu organización usa SAML SSO, abre Configuración → Developer settings → Personal access tokens, busca el token, selecciona Configure SSO y Authorize para tu organización.

​
Completar el conector en Iru

1

Abre Sources

En Iru Compliance, en la barra de navegación izquierda, expande Cumplimiento y selecciona Fuentes.
Navegación izquierda: Compliance expandido, Sources seleccionado
2

Activa GitHub

Busca GitHub (usa Categoría o Buscar por nombre o descripción). En esa tarjeta, activa el interruptor. Se abre una pestaña nueva con el asistente del conector.
3

Pega el token de acceso personal

Cuando veas el paso del token Bearer, pega tu PAT en el campo Token y envíalo.
4

Finaliza la conexión

Selecciona Enviar token de Bearer. Cuando la conexión se realiza correctamente, el asistente muestra Conexión configurada.
5

Confirma que la fuente está activa

Cierra la pestaña del navegador Iru está solicitando acceso a servicios externos, luego vuelve a Cumplimiento → Fuentes y confirma que la tarjeta de GitHub está Activo.

​
Solución de problemas

Revisa la configuración del bloqueador de ventanas emergentes para el sitio de Iru e inténtalo de nuevo.
Confirma que el PAT se copió completo, que no ha caducado y que no se ha revocado.
Para lecturas de toda la organización, el resource owner del PAT debe ser la organización, no solo tu cuenta personal. Crea un PAT nuevo si es necesario.
Autoriza el PAT para SAML SSO (consulta Crear un token de acceso personal detallado).
Vuelve a generar el PAT con los permisos de repositorio y organización que requieren tus controles.
Las solicitudes REST autenticadas comparten los límites de velocidad de GitHub (consulta la documentación de GitHub). Iru agrupa el trabajo dentro de esos límites; los picos sostenidos pueden retrasar la sincronización.

​
Consideraciones

Es preferible usar PAT detallados con el conjunto más pequeño…

Es preferible usar PAT detallados con el conjunto de repositorios y los ámbitos de lectura más pequeños que sigan cumpliendo tus controles.

Rota los PAT antes de que caduquen y actualiza el conector…

Rota los PAT antes de que caduquen y actualiza el conector para que la recopilación de evidencia no se detenga.

Iru lee los metadatos y la configuración expuestos por las…

Iru lee los metadatos y la configuración expuestos por las API que permites; no omite los permisos de GitHub que aplica tu organización.

​
Artículos relacionados

Gestión de fuentes

Explora y gestiona todas las fuentes de Compliance.

Introducción a Compliance

Marcos, acciones y Artefactos.

Descripción general de Iru

Cómo encajan Endpoint, Compliance e Identity.

Gestión de artefactos

Sube, revisa y organiza la evidencia de fuentes y acciones.