Integración de con GitHub Autenticación con GitHub Configuración de la canalización de CloudWatch Clases de eventos del Marco de esquema de ciberseguridad abierto compatibles

nota

Importante: Se requieren cuentas de GitHub Enterprise para usar este conector. No se admiten las cuentas personales o de organización de GitHub.

Configuración del origen para registros de auditoría de GitHub

Integración de con GitHub

Las canalizaciones de telemetría de Amazon le permiten recopilar registros de auditoría de GitHub Enterprise Cloud. GitHub Enterprise es una plataforma de desarrollo de software empresarial diseñada para flujos de trabajo complejos del desarrollo moderno. GitHub Enterprise Cloud es la solución basada en la nube de GitHub Enterprise y se aloja en los servidores de GitHub.

Autenticación con GitHub

Para leer los registros de auditoría, la canalización debe autenticarse con su cuenta de GitHub. Para el ámbito de empresa, puede utilizar el token de acceso personal, mientras que, para el ámbito de organización, puede utilizar el token de acceso personal o la aplicación de GitHub.

Genere el token para autenticarse como token de acceso personal:

Inicie sesión en GitHub con las credenciales de la cuenta de GitHub.
El usuario autenticado debe ser un administrador empresarial para usar este punto de conexión.
Abre la página Personal access tokens (classic) de GitHub, busque Generate new token (classic) y siga el procedimiento de GitHub para generar un token con el ámbito read:audit_log y sin caducidad.
Guarda este nuevo token en un secreto de AWS Secrets Manager con la clave personal_access_token.

Genere la clave privada para autenticarse como aplicación de GitHub:

Inicie sesión en GitHub con las credenciales de la cuenta de GitHub.
Asegúrese de que la aplicación de GitHub tenga el permiso para permisos de organización “Administration” (lectura)
Siga las instrucciones de Managing private keys for GitHub Apps y genere la clave privada.
Guarde esta clave privada en un secreto de AWS Secrets Manager con la clave private_key y el nombre de la aplicación de GitHub con la clave app_id.

Configuración de la canalización de CloudWatch

Al configurar la canalización para leer registros de auditoría de GitHub Enterprise Cloud, elija registros de auditoría de GitHub como origen de datos. Seleccione el tipo de origen como empresa u organización según el ámbito de la integración y rellene la información obligatoria, como el nombre de la empresa u organización, de acuerdo con el ámbito seleccionado. Una vez que haya creado la canalización, los datos estarán disponibles en el grupo de registro de Registros de CloudWatch.

Clases de eventos del Marco de esquema de ciberseguridad abierto compatibles

Esta integración es compatible con la versión 1.5.0 del esquema OCSF y las acciones de GitHub que se asignan al cambios de cuentas (3001), la actividad de la API (6003) y la administración de entidades (3004).

El cambio de cuentas contiene las siguientes acciones: