Hay varias maneras de acceder a los datos del registro de auditoría y conservarlos para su empresa:
- Interfaz web: vea la actividad reciente en la configuración de la empresa. Consulte Visualización del registro de auditoría de la empresa a través de la interfaz web.
- Exportaciones json/CSV: descargue un archivo de actividad de registro de auditoría. Consulte Exportación de actividades del registro de auditoría de su empresa.
- Punto de conexión de la API REST: consulte los eventos de registro de auditoría mediante programación. Consulte Uso de la API de registro de auditoría para la empresa.
- Streaming a un sistema externo: entregue eventos continuamente a un sistema al que los respondedores de incidentes puedan acceder y consultar. Consulte Streaming del registro de auditoría de su empresa.
Cada método expone un subconjunto diferente de los datos del registro de auditoría. Para obtener la lista completa de eventos, consulte Eventos de registro de auditoría de la empresa.
Datos del registro de auditoría disponibles por método de acceso
| Datos disponibles | Interfaz web | Exportar JSON/CSV | endpoint de la API REST | Streaming a un sistema externo |
|---|---|---|---|---|
| Rango de eventos web | 180 días | 180 días | 180 días | Determinado por la directiva de retención de tu sistema externo |
| Eventos de solicitud de API | (Si está habilitado) | |||
| Eventos de Git | (solo JSON). La bitácora de auditoría retiene eventos de Git por siete días. | . La bitácora de auditoría retiene eventos de Git por siete días. | ||
| Respuestas de inicio de sesión único (organización y empresa) | ||||
| Ejecuciones de flujo de trabajo creadas y completadas | ||||
| Trabajos de flujo de trabajo iniciados, incluidos los secretos proporcionados a cada trabajo | ||||
| Runners autohospedados en línea y sin conexión |
En las empresas que usan Enterprise Managed Users, el registro de auditoría empresarial también incluye eventos de usuario. Para ver una lista de estos eventos de usuario, consulte Eventos de registro de seguridad.
Para conservar los eventos de Git más allá de su disponibilidad en el registro de auditoría, guárdelos en el almacenamiento externo antes de que expiren. Configure el streaming de registros de auditoría de antemano para recopilar eventos continuamente.
Las exportaciones de eventos de Git no incluyen eventos iniciados a través de la interfaz web ni las API rest o GraphQL. Por ejemplo, cuando alguien fusiona una solicitud de extracción en la interfaz web, el push resultante a la rama base no aparece en la exportación.
api.request los eventos solo están disponibles en los registros de auditoría empresariales transmitidos y solo cuando se ha habilitado la opción para transmitir eventos de solicitud de API. Para obtener más información, vea Streaming del registro de auditoría de su empresa.
Importante
La transmisión de registros de auditoría solo incluye actividad desde el momento en que la habilitas. Al habilitarlo durante un incidente, no se recuperará la actividad anterior.
Preparación para una respuesta a incidentes
Habilite la transmisión de registros de auditoría empresarial, el streaming de eventos de solicitud de API y la divulgación de direcciones IP de origen para prepararse para la respuesta a incidentes. Sin las tres características habilitadas, los respondedores tendrán brechas de visibilidad críticas al investigar incidentes que afectan a la empresa o a sus organizaciones. Establezca un período de retención adecuado para los registros transmitidos y asegúrese de que los respondedores de incidentes puedan acceder a ellos.
Para obtener instrucciones de configuración, consulte Streaming del registro de auditoría de su empresa, Habilitación del streaming de registros de auditoría de solicitudes de API y Presentación de direcciones IP en el registro de auditoría de la empresa.
Durante un incidente de seguridad, Soporte de GitHub puede responder a preguntas sobre las características y los datos disponibles, pero no investiga en su nombre ni conserva los registros para su investigación. Para obtener más información, vea Comprender cómo GitHub soporte técnico puede ayudar durante un incidente de seguridad.
Visualización del registro de auditoría de la empresa a través de la interfaz web
El registro de auditoría muestra los eventos que desencadenan las actividades que afectan a la empresa en los últimos 180 días. La bitácora de auditoría retiene eventos de Git por siete días.
De forma predeterminada, solo se muestran los eventos de los últimos tres meses. Para ver eventos anteriores, debe especificar un intervalo de fechas con el parámetro created. Consulta Entender la sintaxis de búsqueda.
- Vaya a su empresa. Por ejemplo, desde la página Empresas en GitHub.com.
- En la parte superior de la página, haga clic en Configuración.
- En "Configuración", haz clic en Registro de auditoría.