Saltar al contenido principal
Las organizaciones de GitHub Team y Free deben usar la integración de GitHub, que recopila los eventos de seguridad disponibles a través de webhooks de la GitHub App.
La integración de GitHub Enterprise Cloud importa eventos de auditoría de la organización en Wirespeed. Los eventos incluyen actividad web y de Git, como cambios en la pertenencia a la organización, repositorios, permisos, ajustes y autenticación. Wirespeed indexa direcciones IP del actor y nombres de usuario para investigación y detección de amenazas.

​
Antes de conectar

  • Confirme que la organización usa GitHub Enterprise Cloud, requisito necesario para el acceso al registro de auditoría de la organización.
  • Disponga de un propietario de la organización de GitHub para completar o aprobar la instalación de la GitHub App de Wirespeed.
  • Revise y acepte el permiso de solo lectura Organization administration de la App. La App no puede modificar repositorios, ajustes de la organización, miembros ni código.
  • Para investigaciones y detecciones basadas en IP, active la divulgación de la IP de origen en Organization Settings → Logs → Audit log → Settings.

​
Conectar GitHub Enterprise Cloud

  1. En Wirespeed, abra Configuración → Integraciones y seleccione GitHub Enterprise Cloud.
  2. Revise estas instrucciones y, a continuación, seleccione Integrar.
  3. En GitHub, elija la organización de Enterprise Cloud que desea supervisar.
  4. Revise el permiso de organización de solo lectura solicitado e instale la GitHub App de Wirespeed.
  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. Para conectar de nuevo la misma organización, desinstale la App en GitHub (Organization Settings → GitHub Apps) y, a continuación, vuelva a conectar desde Wirespeed para que GitHub pueda ejecutar de nuevo el flujo de instalación OAuth.
Wirespeed usa el token de GitHub de corta duración del usuario que autoriza solo para verificar el acceso a la instalación seleccionada. El sondeo usa un token de instalación de una hora que se regenera automáticamente; el token del usuario no se retiene.

​
Recopilación de datos

La primera sincronización importa hasta siete días de eventos de auditoría de la organización disponibles. Las sincronizaciones posteriores reanudan desde el último evento ingestado correctamente e incluyen eventos web y de Git.
La divulgación de la IP de origen está desactivada de forma predeterminada. Los eventos de auditoría se siguen ingestando cuando está desactivada, pero no incluyen la dirección IP del actor usada por las investigaciones y detecciones basadas en IP.
GitHub puede devolver 403 o 404 cuando la organización no está en Enterprise Cloud o la App no tiene el permiso de lectura Organization administration. Wirespeed informa de ese estado en la integración en lugar de recopilar datos de auditoría parciales.

​
Detecciones

Wirespeed incluye detecciones administradas iniciales para cambios en la lista de permitidos de IP de la organización, asignaciones del rol de propietario, cambios en los requisitos de SAML y de autenticación de dos factores, y concesiones de personal access tokens, OAuth Apps o GitHub Apps.