Recoger registros de CrowdStrike Falcon Stream

Disponible en:

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

  1. Inicia sesión en la consola de Google SecOps.
  2. Ve a Configuración de SIEM > Agentes de recogida.
  3. 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

  1. Inicia sesión en la consola de Google SecOps.
  2. Ve a Configuración de SIEM > Perfil.
  3. 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

  1. Abre el símbolo del sistema o PowerShell como administrador.
  2. Ejecuta el siguiente comando:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    

Instalación de Linux

  1. Abre un terminal con privilegios de superusuario o sudo.
  2. 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

  1. 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).
  2. 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
    

Reinicia el agente de Bindplane para aplicar los cambios

  1. Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:

    sudo systemctl restart bindplane-agent
    
  2. 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

  1. Inicia sesión en CrowdStrike Falcon con una cuenta con privilegios.
  2. Ve a Menú > Asistencia.
  3. Haz clic en Clientes de API > Seleccionar claves.
  4. Haz clic en Añadir nuevo cliente de API.
  5. En la sección Permisos de la API, selecciona Secuencias de eventos y, a continuación, habilita la opción Leer.
  6. Haz clic en Añadir.
  7. Copia y guarda los valores de ID de cliente, Secreto de cliente y URL base.

Instalar el conector de Falcon SIEM

  1. Descarga el paquete de instalación RPM para tu sistema operativo.
  2. Instalación de paquetes:

    • Sistema operativo CentOS:
    sudo rpm -Uvh <installer package>
    
    • Sistema operativo Ubuntu:
    sudo dpkg -i <installer package>
    
  3. Directorios de instalación predeterminados:

    • Conector de Falcon SIEM - /opt/crowdstrike/.
    • Servicio: /etc/init.d/cs.falconhoseclientd/.

Configurar el conector SIEM para reenviar eventos a Bindplane

  1. Inicia sesión en el equipo con SIEM Connector instalado como usuario sudo.
  2. Ve al directorio /opt/crowdstrike/etc/.
  3. Cambia el nombre de cs.falconhoseclient.leef.cfg a cs.falconhoseclient.cfg.
    • SIEM Connector usa la configuración cs.falconhoseclient.cfg de forma predeterminada.
  4. 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 de client_id copiado en el paso anterior.
    • client_secret:: el valor de client_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.
  5. Guarda el archivo cs.falconhoseclient.cfg.
  6. 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
    
  7. (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
    
  8. (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.