Saltar al contenido principal
Esta integración cubre organizaciones GitHub Team y Free con webhooks de GitHub App en tiempo real. Los clientes de GitHub Enterprise Cloud deben usar la integración GitHub Enterprise Cloud para la cobertura del registro de auditoría de la organización.
La integración de GitHub recibe cambios relevantes para la seguridad en la pertenencia a la organización, los repositorios, la protección de ramas, las deploy keys y las alertas de seguridad de GitHub. Wirespeed indexa usuarios y repositorios para investigación y ejecuta detecciones gestionadas contra los eventos.

​
Antes de conectar

  • Disponga de un propietario de la organización de GitHub disponible para completar o aprobar la instalación de la GitHub App de Wirespeed.
  • Revise y acepte los permisos de solo lectura de la App sobre Members de la organización, Administration del repositorio, Contents del repositorio, Deployments del repositorio, Dependabot, secret scanning y code scanning. GitHub requiere Contents para entregar eventos de push y release, y Deployments para entregar eventos de deploy key; Wirespeed los usa solo para recibir metadatos de eventos y no lee archivos del repositorio.
  • Elija los repositorios que la App debe supervisar. Los eventos de repositorios fuera de la instalación de la App no son visibles para Wirespeed.

​
Conectar GitHub

  1. En Wirespeed, abra Configuración → Integraciones y seleccione GitHub.
  2. Revise estas instrucciones y, a continuación, seleccione Integrar.
  3. En GitHub, elija la organización Team o Free que desea supervisar.
  4. Elija todos los repositorios o seleccione los repositorios que Wirespeed debe supervisar y, a continuación, instale la App.
  5. Autorice la App cuando GitHub se lo solicite. GitHub le devolverá a Wirespeed cuando la conexión esté lista.
Repita el flujo de conexión para cada organización que deba supervisarse.
Eliminar la conexión de Wirespeed no desinstala la GitHub App. Elimine la App en Organization Settings → GitHub Apps cuando la conexión deba dejar de enviar eventos.

​
Recopilación de datos

La recopilación comienza cuando se instala la App. Los webhooks de GitHub no proporcionan eventos históricos ni rellenan la actividad anterior a la instalación. Wirespeed se suscribe a:
  • Miembros de la organización, pertenencia y equipos
  • Ciclo de vida del repositorio y cambios de visibilidad
  • Reglas de protección de ramas, activación o desactivación de la protección de ramas para un repositorio, rulesets del repositorio y deploy keys
  • Activación o desactivación de funciones de seguridad del código para un repositorio
  • Pushes, incluidos la ref, los SHA anteriores y posteriores, los indicadores de force-push y de creación/eliminación de ramas, el pusher y los autores de commits, mensajes y rutas de archivos modificados de hasta los primeros 100 commits de cada push. Los pushes muy grandes pueden tener mensajes de commit acortados y listas parciales de rutas modificadas
  • Forks y releases
  • Ciclo de vida de la GitHub App de Wirespeed y cambios de acceso a repositorios
  • Alertas de Dependabot, secret scanning y code scanning cuando esas funciones de GitHub están habilitadas
  • Solicitudes de bypass de push protection y push ruleset de secret scanning, y solicitudes de descarte de alertas de Dependabot, secret scanning y code scanning, cuando la organización usa delegated bypass o delegated alert dismissal
Las Dependabot alerts se pueden activar para todos los repositorios en Settings → Advanced Security. Primero debe estar habilitado el dependency graph. El Secret scanning se ejecuta en repositorios públicos. Los repositorios públicos pueden usar code scanning, y Wirespeed recibe esos eventos solo después de configurarlo con la configuración predeterminada de CodeQL o un workflow. Los repositorios privados necesitan GitHub Secret Protection o GitHub Code Security. Sin esa licencia, Wirespeed no recibe eventos de esas funciones. Un propietario de la organización puede habilitar las funciones disponibles para muchos repositorios en Organization settings → Security → Advanced Security → Configurations.
GitHub Team y Free no exponen la API de registro de auditoría de la organización Enterprise. Los webhooks generalmente no incluyen direcciones IP del actor, actividad de clonación/acceso a Git, cambios de SAML o de autenticación en dos pasos de la organización, concesiones de personal access token ni un relleno histórico.

​
Actualizaciones de permisos

Cuando Wirespeed añade un permiso a la GitHub App, las instalaciones existentes conservan sus permisos anteriores hasta que un propietario de la organización aprueba la solicitud. GitHub no envía eventos que necesiten el nuevo permiso hasta entonces. Wirespeed muestra una advertencia de permisos de la GitHub App en Derechos de la página de la integración mientras una solicitud está pendiente. Para aprobarla:
  1. Pase el cursor sobre la advertencia y seleccione Review in GitHub, o abra Organization Settings → GitHub Apps → Wirespeed → Configure.
  2. Seleccione Review request y acepte los nuevos permisos.
Solo los propietarios de la organización de GitHub pueden aprobar solicitudes de permisos. La advertencia se borra automáticamente cuando GitHub informa de la aprobación, y la conexión en Wirespeed no necesita volver a conectarse.

​
Detecciones

Wirespeed incluye detecciones gestionadas para:
  • Concesiones de acceso de administrador de la organización
  • Repositorios hechos públicos o transferidos
  • Cambios en la protección de ramas
  • Deploy keys añadidas a repositorios
  • Alertas de secret scanning nuevas o reabiertas
  • Alertas de code scanning y de dependencias altas o críticas