Recopila registros de inteligencia contra amenazas de STIX

Compatible con:

En este documento, se explica cómo transferir registros de inteligencia contra amenazas de STIX a Google Security Operations con el agente de Bindplane.

STIX (Structured Threat Information Expression) es un lenguaje y formato estandarizados para compartir indicadores de compromiso (IOC) y datos de inteligencia contra amenazas entre organizaciones. Los datos de STIX suelen recibirse como archivos JSON o XML de servidores TAXII o plataformas de inteligencia contra amenazas. El agente de Bindplane recopila archivos de datos de STIX directamente del sistema de archivos local.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Una instancia de Google SecOps
  • Windows Server 2016 o posterior, o host de Linux con systemd
  • Si se ejecuta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos según los requisitos del agente de Bindplane
  • Un cliente de TAXII o una plataforma de inteligencia contra amenazas que guarde archivos con formato STIX (JSON o XML) en un directorio local

Obtén credenciales de Google SecOps para el agente de Bindplane

Para autenticar el agente de Bindplane en Google SecOps, elige uno de los siguientes métodos:

  • Implementaciones nuevas: Usa la API de Chronicle (opción 1).
  • Implementaciones heredadas: Sigue usando el archivo de autenticación de transferencia (opción 2) hasta que se descontinúe la API de Ingestion el 20 de julio de 2027.
  1. Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
  2. Ve a IAM y administración > Cuentas de servicio.
  3. Haga clic en Crear cuenta de servicio.
  4. Proporciona los siguientes detalles de configuración:
    • Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo, bindplane-ingest).
    • Descripción de la cuenta de servicio: Ingresa una descripción (por ejemplo, Bindplane agent log ingestion).
  5. Haz clic en Crear y continuar.
  6. En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y elige Editor de Chronicle.
  7. Haz clic en Continuar y, luego, en Listo.
  8. Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
  9. Haz clic en Agregar clave > Crear clave nueva.
  10. Selecciona JSON y haz clic en Crear. El archivo de claves se descargará en tu computadora.
  11. Guarda el archivo de claves como ingestion-auth.json en el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.json en Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json en Windows) o actualiza creds_file_path en config.yaml para que coincida con la ruta de acceso en la que lo guardas.
  12. Ve a IAM y administración > Configuración y copia el Número de proyecto. Lo necesitarás para la configuración del exportador.

Opción 2: Descarga el archivo de autenticación de transferencia (heredado)

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración > Administración de datos > Agentes de recopilación. Si estás en una plataforma solo de SIEM, ve a Configuración > Agentes de recopilación.
  3. Descarga el archivo de autenticación de transferencia.
  4. Guarda el archivo de forma segura en el sistema en el que se instalará el agente de Bindplane.

Obtén el ID de cliente de Google SecOps

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > Perfil.
  3. Copia y guarda el ID de cliente de la sección Detalles de la organización.

Instala el agente de Bindplane

Instala el agente de Bindplane en tu sistema operativo Windows o Linux según las siguientes instrucciones.

Instalación en Windows

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

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. Espera a que se complete la instalación.

  4. Ejecuta el siguiente comando para verificar la instalación:

    sc query observiq-otel-collector
    

    El servicio debería mostrarse como RUNNING.

Instalación en Linux

  1. Abre una terminal con privilegios de raíz o sudo.
  2. Ejecuta el comando siguiente:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. Espera a que se complete la instalación.

  4. Ejecuta el siguiente comando para verificar la instalación:

    sudo systemctl status observiq-otel-collector
    

    El servicio debería mostrarse como active (running).

Recursos de instalación adicionales

Para obtener más opciones de instalación y solución de problemas, consulta la guía de instalación del agente de Bindplane.

Configurar el agente de BindPlane para transferir registros y enviarlos a Google SecOps

Ubica el archivo de configuración

  • Linux:

    sudo nano /opt/observiq-otel-collector/config.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Edita el archivo de configuración

  • Reemplaza todo el contenido de config.yaml por la siguiente configuración:

    receivers:
      filelog:
        include:
          - /var/log/stix/*.json
        start_at: beginning
    
    exporters:
      chronicle/stix:
        protocol: https
        # Region of your instance, for example us, europe, asia-southeast1
        location: <LOCATION>
        # Project number of the Google Cloud project linked to the instance
        project: '<PROJECT_NUMBER>'
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: chronicle.googleapis.com
        log_type: STIX
        raw_log_field: body
        ingestion_labels:
          env: production
    
    service:
      pipelines:
        logs/stix_to_chronicle:
          receivers:
            - filelog
          exporters:
            - chronicle/stix
    

Parámetros de configuración

Reemplaza los marcadores de posición que se indican más abajo:

  • Configuración del receptor:

    • filelog: Es el tipo de receptor para recopilar archivos de registro del disco.
    • include: Es la lista de rutas de acceso de archivos que se supervisarán. Establece este valor en el directorio en el que se guardan los archivos STIX:
      • Linux: /var/log/stix/*.json
      • Windows: C:\Logs\stix\*.json
    • start_at: Configúralo como beginning para leer los registros existentes o como end para leer solo las entradas nuevas.
  • Configuración del exportador:

    • stix: Es el nombre descriptivo del exportador.
    • creds_file_path: Ruta de acceso completa al archivo de claves JSON de la cuenta de servicio (opción 1):
      • Linux: /opt/observiq-otel-collector/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • <customer_id>: Es el ID de cliente del paso anterior.
    • location: Reemplaza <LOCATION> por la región de tu instancia de Google SecOps (por ejemplo, us, europe o asia-southeast1). El exportador agrega el prefijo chronicle.googleapis.com con este valor. Consulta Extremos regionales para obtener la lista completa.
    • project: Reemplaza <PROJECT_NUMBER> por el número de proyecto de IAM y administración > Configuración.
    • endpoint: Mantén la configuración como chronicle.googleapis.com.
    • STIX: Es el tipo de registro tal como aparece en Chronicle.
    • ingestion_labels: Son etiquetas opcionales en formato YAML (por ejemplo, env: production).
  • Configuración de la canalización:

    • stix_to_chronicle: Es el nombre descriptivo de la canalización.

Exportador de la API de transferencia heredada

  • Si usas el archivo de autenticación de transferencia de la opción 2, reemplaza el bloque exporters por lo siguiente. Establece creds_file_path en la ruta de acceso al archivo de autenticación de transferencia y, si tu instancia está fuera de EE.UU., reemplaza malachiteingestion-pa.googleapis.com por tu extremo regional (por ejemplo, europe-malachiteingestion-pa.googleapis.com).

    exporters:
      chronicle/stix:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: STIX
        raw_log_field: body
        ingestion_labels:
          env: production
    

Guarda el archivo de configuración

  • Después de editarlo, guarda el archivo:
    • Linux: Presiona Ctrl+O, luego Enter y, por último, Ctrl+X
    • Windows: Haz clic en Archivo > Guardar.

Reinicia el agente de Bindplane para aplicar los cambios.

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

    sudo systemctl restart observiq-otel-collector
    
    1. Verifica que el servicio esté en ejecución:

      sudo systemctl status observiq-otel-collector
      
    2. Revisa los registros en busca de errores:

      sudo journalctl -u observiq-otel-collector -f
      
  • Para reiniciar el agente de Bindplane en Windows, elige una de las siguientes opciones:

    • Símbolo del sistema o PowerShell como administrador:

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • Consola de servicios:

      1. Presiona Win+R, escribe services.msc y presiona Intro.
      2. Busca observIQ OpenTelemetry Collector.
      3. Haz clic con el botón derecho y selecciona Reiniciar.
      4. Verifica que el servicio esté en ejecución:

        sc query observiq-otel-collector
        
      5. Revisa los registros en busca de errores:

        type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
        

Configura la recopilación de archivos de datos STIX

STIX es un formato de datos, no un producto. Los datos de inteligencia contra amenazas de STIX se suelen recibir como archivos JSON o archivos en formato XML de clientes de TAXII, plataformas de inteligencia contra amenazas o descargas manuales. Debes asegurarte de que estos archivos se coloquen en un directorio que supervise el agente de Bindplane.

Linux

  1. Crea un directorio para almacenar los archivos de datos de STIX:

    sudo mkdir -p /var/log/stix
    
  2. Configura tu cliente de TAXII o plataforma de inteligencia contra amenazas para guardar archivos STIX en /var/log/stix/.

  3. Asegúrate de que la cuenta de servicio del agente de Bindplane tenga acceso de lectura al directorio:

    sudo chmod 755 /var/log/stix
    

Windows

  1. Crea un directorio para almacenar los archivos de datos de STIX:

    mkdir C:\Logs\stix
    
  2. Configura tu cliente de TAXII o plataforma de inteligencia contra amenazas para guardar archivos STIX en `C:\Logs\stix`.

  3. Actualiza la ruta de acceso include del agente de Bindplane en config.yaml para que coincida con lo siguiente:

    include:
      - C:\Logs\stix\*.json
    

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
entity.administrative_domain Establece el valor en "TEST".
assetid_value entity.asset.asset_id Valor de assetid_value si no está vacío
condition_label, related_indicators_relationship_label, related_indicators_scope, indicator_types_label, valid_start_time_label, controlled_structure_label, marking_structure_label entity.asset.attribute.labels Se combinaron varias etiquetas
nombre entity.file.full_path El valor se copia directamente.
val, hash.simple_hash_value, MD5_val, hash_value entity.file.md5 Valor de val si coincide con la regex de MD5; de lo contrario, hash.simple_hash_value si el tipo es MD5; de lo contrario, MD5_val; de lo contrario, hash_value
valor entity.file.names El valor se copia directamente.
val, hash.simple_hash_value, sha1_val, hash_value entity.file.sha1 Valor de val si coincide con la regex sha1; de lo contrario, hash.simple_hash_value si el tipo es SHA1; de lo contrario, sha1_val; de lo contrario, hash_value
val, hash.simple_hash_value, sha256val, sha_value, sha_value entity.file.sha256 Es el valor de val si coincide con la regex sha256; de lo contrario, es hash.simple_hash_value si el tipo es SHA256; de lo contrario, es sha256val; de lo contrario, es sha_value.
observable.object.properties.value, dom, value, host, name, external_references.0.source_name entity.hostname Valor de observable.object.properties.value si el tipo es FQDN; de lo contrario, dom de grok; de lo contrario, valor si el tipo es domain-name; de lo contrario, host; de lo contrario, name si main_observable_type es domain/hostname; de lo contrario, external_references.0.source_name
ip_val, ipval, ip, source_ip, value, src_ip entity.ip Valor de ip_val si grok coincidió; de lo contrario, ipval si la categoría es ipv4-addr; de lo contrario, ip del patrón grok; de lo contrario, source_ip; de lo contrario, valor si el tipo es ipv4; de lo contrario, src_ip de grok
source_port, src_port entity.port Valor de source_port o src_port
indicator_label, extension_value1, extension_value2, extension_value3, extension_value4, revoked_value, spec_version_value, object_marking_ref_value, label_value entity.resource.attribute.labels Se combinaron varias etiquetas
observable.object.properties.value, url_val, value, observable_properties_value entity.url Valor de observable.object.properties.value si es de tipo URL; de lo contrario, url_val de grok; de lo contrario, valor si es de tipo URL; de lo contrario, observable_properties_value si no está vacío
email_val, mail, value entity.user.email_addresses Valor de email_val si grok coincidió; de lo contrario, correo de grok; de lo contrario, valor si el tipo es email-addr
timestamp metadata.collected_timestamp Se convirtió con la coincidencia de fecha ISO8601/RFC 3339
title, description metadata.description Valor del título o la descripción
entity_type metadata.entity_type El valor se copia directamente.
timestamp, valid_until metadata.interval.end_time Se convirtió de timestamp o valid_until con la coincidencia de fecha ISO8601/RFC 3339
timestamp, valid_from, created metadata.interval.start_time Se convirtió de timestamp, valid_from, created o timestamp con la coincidencia de fecha ISO8601/RFC 3339
id metadata.product_entity_id El valor se copia directamente.
versión metadata.product_version El valor se copia directamente.
threat_detail metadata.threat Combinado de threat_detail
threat_detail_category threat.category El valor se copia directamente.
confidence_value, confidence, x_stix_confidence, x_ctix_confidence_score threat.confidence_details Valor de confidence_value; de lo contrario, confidence si no_value; de lo contrario, x_stix_confidence; de lo contrario, x_ctix_confidence_score
value, confidence, x_ctix_confidence_score threat.confidence_score Valor de value si name es Confidence Score, de lo contrario, confidence, de lo contrario, x_ctix_confidence_score, convertido en float
property_label, sha512_value, observable_id, observable_object_id, keyword_label threat.detection_fields Se combinaron varias etiquetas
descripción threat.description El valor se copia directamente.
value, extensions.extension-definition--ea279b3e-5c71-4632-ac08-831c66a786ba.score threat.risk_score Valor de value si name es Risk; de lo contrario, puntuación de extensions, convertida en número de punto flotante
metadata.product_name Establece el valor en "STIX".
metadata.vendor_name Establece el valor en "STIX".
dom event.idm.entity.entity.hostname Asignado desde el registro de cambios
name event.idm.entity.entity.url Asignado desde el registro de cambios
valid_from event.idm.entity.entity.resource.attribute.labels Asignado desde el registro de cambios
valid_until event.idm.entity.entity.resource.attribute.labels Asignado desde el registro de cambios
pattern_version event.idm.entity.entity.resource.attribute.labels Asignado desde el registro de cambios
observable.object.properties.value.condition event.idm.entity.entity.asset.attribute.labels Asignado desde el registro de cambios
handling.controlled_structure event.idm.entity.entity.asset.attribute.labels Asignado desde el registro de cambios
handling.marking_structures.color event.idm.entity.entity.asset.attribute.labels Asignado desde el registro de cambios
related_indicators.related_indicators event.idm.entity.entity.asset.attribute.labels Asignado desde el registro de cambios
related_indicators.scope event.idm.entity.entity.asset.attribute.labels Asignado desde el registro de cambios
indicator_types event.idm.entity.entity.asset.attribute.labels Asignado desde el registro de cambios
valid_time_positions event.idm.entity.entity.asset.attribute.labels Asignado desde el registro de cambios
observable.object.properties.custom_properties event.idm.entity.metadata.threat.detection_fields Asignado desde el registro de cambios
observable.object.properties.value event.ioc.domain_and_ports.domain Asignado desde el registro de cambios
mitre-extension-definition.extension_type entity.resource.attribute.labels.value Asignado desde el registro de cambios
sco-extension-definition.extension_type entity.resource.attribute.labels.value Asignado desde el registro de cambios
x_ctix_confidence_score threat_detail.confidence_score Asignado desde el registro de cambios
modified timestamp Asignado desde el registro de cambios
valid_from entity_event.metadata.interval.start_time Asignado desde el registro de cambios
confidence threat_detail.confidence_score Asignado desde el registro de cambios
name entity.entity.file.full_path Asignado desde el registro de cambios
description threat_detail.description Asignado desde el registro de cambios
external_references.0.source_name entity_event.entity.hostname Asignado desde el registro de cambios
entity_type IP_ADDRESS Asignado desde el registro de cambios
entity_type USER Asignado desde el registro de cambios
entity_type FILE Asignado desde el registro de cambios
entity_type DOMAIN_NAME Asignado desde el registro de cambios

Registro de cambios

Consulta el registro de cambios de este analizador

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.