Recoger registros de CrowdStrike Falcon Stream
En este documento se describe cómo recoger registros de Crowdstrike Falcon Stream mediante Bindplane. El analizador extrae pares clave-valor y los asigna al modelo de datos unificado (UDM), gestiona diferentes delimitadores y enriquece los datos con contexto adicional, como la gravedad y los tipos de eventos. También realiza transformaciones específicas para determinados tipos de eventos y campos, como los inicios de sesión de los usuarios y los resultados de seguridad.
Antes de empezar
Asegúrate de que cumples los siguientes requisitos previos:
- Instancia de Google Security Operations
- Windows 2016 o versiones posteriores, o un host Linux con
systemd
- Si se ejecuta a través de un proxy, asegúrate de que los puertos del cortafuegos estén abiertos.
- Acceso con privilegios a la consola de CrowdStrike Falcon
- Obtener credenciales de API para Falcon Stream (ID de cliente y secreto de cliente)
Obtener el archivo de autenticación de ingestión de Google SecOps
- Inicia sesión en la consola de Google SecOps.
- Ve a Configuración de SIEM > Agentes de recogida.
- Descarga el archivo de autenticación de ingestión.
- Guarda el archivo de forma segura en el sistema en el que se instalará BindPlane.
Obtener el ID de cliente de Google SecOps
- Inicia sesión en la consola de Google SecOps.
- Ve a Configuración de SIEM > Perfil.
- Copia y guarda el ID de cliente de la sección Detalles de la organización.
Instalar el agente de Bindplane
Instala el agente de Bindplane en tu sistema operativo Windows o Linux siguiendo las instrucciones que se indican a continuación.
Instalación de ventanas
- Abre el símbolo del sistema o PowerShell como administrador.
Ejecuta el siguiente comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Instalación de Linux
- Abre un terminal con privilegios de superusuario o sudo.
Ejecuta el siguiente comando:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
Recursos de instalación adicionales
Para ver más opciones de instalación, consulta la guía de instalación.
Configurar el agente de BindPlane para ingerir Syslog y enviarlo a Google SecOps
- Accede al archivo de configuración:
- Busca el archivo
config.yaml
. Normalmente, se encuentra en el directorio/etc/bindplane-agent/
en Linux o en el directorio de instalación en Windows. - Abre el archivo con un editor de texto (por ejemplo,
nano
,vi
o Bloc de notas).
- Busca el archivo
Edita el archivo
config.yaml
de la siguiente manera:receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <customer_id> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization log_type: 'CS_STREAM' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
- Sustituye el puerto y la dirección IP según sea necesario en tu infraestructura.
- Sustituye
<customer_id>
por el ID de cliente real. - Actualiza
/path/to/ingestion-authentication-file.json
a la ruta en la que se guardó el archivo de autenticación en la sección Obtener el archivo de autenticación de ingestión de Google SecOps.
Reinicia el agente de Bindplane para aplicar los cambios
Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:
sudo systemctl restart bindplane-agent
Para reiniciar el agente de Bindplane en Windows, puedes usar la consola Servicios o introducir el siguiente comando:
net stop BindPlaneAgent && net start BindPlaneAgent
Configurar y obtener una clave de API de CrowdStrike
- Inicia sesión en CrowdStrike Falcon con una cuenta con privilegios.
- Ve a Menú > Asistencia.
- Haz clic en Clientes de API > Seleccionar claves.
- Haz clic en Añadir nuevo cliente de API.
- En la sección Permisos de la API, selecciona Secuencias de eventos y, a continuación, habilita la opción Leer.
- Haz clic en Añadir.
- Copia y guarda los valores de ID de cliente, Secreto de cliente y URL base.
Instalar el conector de Falcon SIEM
- Descarga el paquete de instalación RPM para tu sistema operativo.
Instalación de paquetes:
- Sistema operativo CentOS:
sudo rpm -Uvh <installer package>
- Sistema operativo Ubuntu:
sudo dpkg -i <installer package>
Directorios de instalación predeterminados:
- Conector de Falcon SIEM -
/opt/crowdstrike/
. - Servicio:
/etc/init.d/cs.falconhoseclientd/
.
- Conector de Falcon SIEM -
Configurar el conector SIEM para reenviar eventos a Bindplane
- Inicia sesión en el equipo con SIEM Connector instalado como usuario
sudo
. - Ve al directorio
/opt/crowdstrike/etc/
. - Cambia el nombre de
cs.falconhoseclient.leef.cfg
acs.falconhoseclient.cfg
.- SIEM Connector usa la configuración
cs.falconhoseclient.cfg
de forma predeterminada.
- SIEM Connector usa la configuración
- Edita el archivo
cs.falconhoseclient.cfg
y modifica o define los siguientes parámetros:api_url:
: la URL base de Crowdstrike Falcon que has copiado en el paso anterior.app_id:
: cualquier cadena como identificador para conectarse a la API Falcon Streaming (por ejemplo,app_id: SECOPS-LEEF
).client_id:
: el valor declient_id
copiado en el paso anterior.client_secret:
: el valor declient_secret
copiado en el paso anterior.send_to_syslog_server: true
: habilita el envío al servidor Syslog.host:
: la IP o el nombre de host del agente de BindPlane.port:
: el puerto del agente de BindPlane.
- Guarda el archivo
cs.falconhoseclient.cfg
. Inicia el servicio SIEM Connector:
- Sistema operativo CentOS
sudo service cs.falconhoseclientd start
- Sistema operativo Ubuntu 16.04 o versiones posteriores
sudo systemctl start cs.falconhoseclientd.service
(Opcional) Detén el servicio SIEM Connector:
- Sistema operativo CentOS
sudo service cs.falconhoseclientd stop
- Sistema operativo Ubuntu 16.04 o versiones posteriores
sudo systemctl stop cs.falconhoseclientd.service
(Opcional): Reinicia el servicio del conector SIEM:
- Sistema operativo CentOS
sudo service cs.falconhoseclientd restart
- Sistema operativo Ubuntu 16.04 o versiones posteriores
sudo systemctl restart cs.falconhoseclientd.service
Tabla de asignación de UDM
Campo de registro | Asignación de UDM | Lógica |
---|---|---|
cat |
security_result.category_details |
El valor del campo cat se asigna directamente al campo security_result.category_details . |
commandLine |
target.process.command_line |
El valor del campo commandLine se asigna directamente al campo target.process.command_line . |
cs1 |
security_result.summary |
Si cs1Label es "incidentType", el valor de cs1 se asigna a security_result.summary . De lo contrario, se asigna como un par clave-valor en security_result.detection_fields con la clave de cs1Label y el valor de cs1 . |
cs1Label |
security_result.detection_fields.key |
Se usa como clave en security_result.detection_fields cuando cs1 no es un tipo de incidencia. |
cs2 |
security_result.detection_fields.value |
Se asigna como un par clave-valor en security_result.detection_fields con la clave de cs2Label y el valor de cs2 . |
cs2Label |
security_result.detection_fields.key |
Se usa como clave en security_result.detection_fields junto con cs2 . |
cs3 |
security_result.detection_fields.value |
Se asigna como un par clave-valor en security_result.detection_fields con la clave de cs3Label y el valor de cs3 . |
cs3Label |
security_result.detection_fields.key |
Se usa como clave en security_result.detection_fields junto con cs3 . |
cs4 |
security_result.about.url |
Si cs4Label es "falconHostLink", el valor de cs4 se asigna a security_result.about.url . De lo contrario, se asigna como un par clave-valor en security_result.detection_fields con la clave de cs4Label y el valor de cs4 . |
cs4Label |
security_result.detection_fields.key |
Se usa como clave en security_result.detection_fields cuando cs4 no es un falconHostLink. |
description |
metadata.description |
El valor del campo description se asigna directamente al campo metadata.description . Si está vacío, se utilizan incidentDescription , msg o serviceName . |
devTime |
metadata.event_timestamp |
El valor del campo devTime se analiza y se asigna al campo metadata.event_timestamp . |
deviceCustomDate1 |
metadata.event_timestamp |
Si no se incluye devTime , se analiza el valor del campo deviceCustomDate1 y se asigna al campo metadata.event_timestamp . |
domain |
principal.administrative_domain |
Se extrae del campo userName mediante una expresión regular y se asigna a principal.administrative_domain . |
duser |
principal.user.userid |
Si está presente, el valor de duser sobrescribe el campo usrName y se usa para rellenar los campos de usuario. |
endpointName |
security_result.detection_fields.value |
Se asigna como un par clave-valor en security_result.detection_fields con la clave "endpointName". |
eventType |
metadata.product_event_type |
El valor del campo eventType se asigna directamente al campo metadata.product_event_type . |
falconHostLink |
security_result.about.url |
El valor del campo falconHostLink se asigna directamente al campo security_result.about.url . |
filePath |
target.process.file.full_path |
El valor del campo filePath se asigna directamente al campo target.process.file.full_path . |
identityProtectionIncidentId |
security_result.detection_fields.value |
Se asigna como un par clave-valor en security_result.detection_fields con la clave "identityProtectionIncidentId". |
incidentDescription |
metadata.description |
Si description está vacío, el valor del campo incidentDescription se asigna al campo metadata.description . |
incidentType |
security_result.summary |
El valor del campo incidentType se asigna directamente al campo security_result.summary . |
log_type |
metadata.log_type |
El valor del campo log_type se asigna directamente al campo metadata.log_type . |
msg |
metadata.description |
Si description y incidentDescription están vacíos, el valor del campo msg se asigna al campo metadata.description . |
numbersOfAlerts |
security_result.detection_fields.value |
Se asigna como un par clave-valor en security_result.detection_fields con la clave "numbersOfAlerts". |
numberOfCompromisedEntities |
security_result.detection_fields.value |
Se asigna como un par clave-valor en security_result.detection_fields con la clave "numberOfCompromisedEntities". |
product |
metadata.product_name |
El valor del campo product se asigna directamente al campo metadata.product_name . |
resource |
target.resource.name |
El valor del campo resource se asigna directamente al campo target.resource.name . |
serviceName |
target.application |
El valor del campo serviceName se asigna directamente al campo target.application . También se usa como alternativa para metadata.description . |
severityName |
security_result.severity |
El valor del campo severityName se asigna al campo security_result.severity después de convertirse a mayúsculas. La lógica de asignación incluye conversiones específicas para diferentes nombres de gravedad. |
sha256 |
target.file.sha256 |
El valor del campo sha256 se asigna directamente al campo target.file.sha256 . |
src |
principal.ip |
El valor del campo src se asigna directamente al campo principal.ip . |
srcMAC |
principal.mac |
El valor del campo srcMAC se asigna directamente al campo principal.mac después de sustituir los guiones por dos puntos. |
state |
security_result.detection_fields.value |
Se asigna como un par clave-valor en security_result.detection_fields con la clave "state". |
success |
security_result.action |
Si success es "true", security_result.action se define como "ALLOW". Si success es "false", security_result.action se define como "BLOCK". |
userName |
principal.user.userid |
Si no se incluye usrName , se usa el valor del campo userName para rellenar los campos de usuario. El dominio se extrae si está presente. |
usrName |
principal.user.userid /target.user.userid |
Si está presente, el valor del campo usrName se asigna a principal.user.userid o target.user.userid en función del eventType . Si se trata de una dirección de correo, también se añade al campo email_addresses correspondiente. |
vendor |
metadata.vendor_name |
El valor del campo vendor se asigna directamente al campo metadata.vendor_name . |
version |
metadata.product_version |
El valor del campo version se asigna directamente al campo metadata.product_version . |
(Lógica del analizador) | extensions.auth.mechanism |
Se asigna el valor "USERNAME_PASSWORD" si eventType es "saml2Assert" o "twoFactorAuthenticate". |
(Lógica del analizador) | extensions.auth.type |
Asigna el valor "AUTHTYPE_UNSPECIFIED" si eventType es "assert" o "userAuthenticate". |
(Lógica del analizador) | metadata.event_timestamp |
La marca de tiempo del campo collection_time o timestamp del registro sin procesar se usa como marca de tiempo del evento. |
(Lógica del analizador) | metadata.event_type |
Se determina en función de la eventType y otros campos. El valor predeterminado es "GENERIC_EVENT" y se puede cambiar a "USER_LOGIN", "GROUP_MODIFICATION", "GROUP_DELETION", "SERVICE_STOP", "SERVICE_START" o "USER_UNCATEGORIZED". |
(Lógica del analizador) | target.resource.type |
Se define como "GROUP" si eventType es "remove_group", "update_group" o "delete_group". |
¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.