Recopilar registros de Cisco Firepower NGFW

Disponible en:

En este documento se explica cómo ingerir registros de Cisco Firepower Next-Generation Firewall (NGFW) en Google Security Operations mediante Bindplane. El analizador extrae los registros de varios formatos (syslog, JSON y combinaciones de ambos), normaliza la marca de tiempo y asigna los campos relevantes al modelo de datos unificado (UDM). Gestiona tanto los mensajes syslog convencionales como las cargas útiles con formato JSON en los registros. Para ello, utiliza patrones grok y lógica condicional para extraer campos como el ID de evento, la gravedad y la IP del cliente. Después, enriquece los datos con etiquetas basadas en el nombre de host HTTP y el URI.

Antes de empezar

Asegúrate de que cumples los siguientes requisitos previos:

  • Instancia de Google SecOps
  • 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 privilegiado a un dispositivo Cisco Firepower

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: 'CISCO_FIREPOWER_FIREWALL'
            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

  • 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 Syslog en un dispositivo Cisco FirePower

  1. Inicia sesión en la interfaz web de Firepower Device Manager.
  2. Ve a Ajustes del sistema > Ajustes de registro.
  3. Activa el interruptor Habilitar de Almacenamiento de registros de datos.
  4. Haz clic en el icono + situado debajo de Servidores Syslog.
  5. Haga clic en Crear nuevo servidor Syslog. También puede crear el servidor Syslog en Objetos > Servidores Syslog.
  6. Proporcione los siguientes detalles de configuración:
    • Dirección IP: introduce la dirección IP del agente de Bindplane.
    • Tipo de protocolo: selecciona UDP.
    • Número de puerto: introduce el número de puerto del agente de Bindplane.
    • Seleccione Interfaz de datos o Interfaz de gestión.
  7. Haz clic en Aceptar.
  8. Seleccione el servidor Syslog que acaba de crear en la lista y haga clic en Aceptar.
  9. Haz clic en Nivel de gravedad para filtrar todos los eventos y selecciona Informativo en la lista.
  10. Haz clic en Guardar.
  11. Haz clic en el icono Implementar nueva configuración > Implementar ahora.
  12. En la parte superior de la pantalla, haga clic en Políticas.
  13. Coloca el cursor sobre el lado derecho de la regla de ACP y haz clic en editar Editar.
  14. Ve a la pestaña Registro.
  15. Selecciona Al final de la conexión.
  16. Abre la lista Seleccionar una configuración de alerta de Syslog.
  17. Selecciona el servidor Syslog de Bindplane.
  18. Haz clic en Aceptar.
  19. Haz clic en el icono Implementar nueva configuración > Implementar ahora.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
AccessControlRuleAction security_result.action Se asigna directamente desde el registro sin procesar. Los valores se normalizan a UDM (ALLOW/BLOCK).
AccessControlRuleName security_result.rule_name Se asigna directamente desde el registro sin procesar.
ACPolicy security_result.rule_labels.value Se asigna directamente desde el registro sin procesar. La clave es "ACPolicy".
ApplicationProtocol network.application_protocol Se asigna directamente desde el registro sin procesar.
Client network.http.user_agent Se asigna directamente desde el registro sin procesar.
ClientVersion principal.asset.platform_version Se asigna directamente desde el registro sin procesar.
collection_time.nanos metadata.event_timestamp.nanos Se asigna directamente desde el registro sin procesar.
collection_time.seconds metadata.event_timestamp.seconds Se asigna directamente desde el registro sin procesar.
ConnectionDuration network.session_duration.seconds Se asigna directamente desde el registro sin procesar y se convierte a segundos si es necesario (por ejemplo, desde el formato de duración).
data metadata.description Se usa junto con eventId para generar una descripción más detallada. También se usa para extraer otros campos mediante grok y expresiones regulares.
deviceId metadata.product_log_id Se ha asignado directamente desde el registro sin procesar después de cambiar el nombre a device_uuid.
device_uuid metadata.product_log_id Se asigna directamente desde el registro sin procesar.
DstIP target.asset.ip, target.ip Se asigna directamente desde el registro sin procesar.
DstPort target.port Se asigna directamente desde el registro sin procesar.
EgressInterface principal.asset.attribute.labels.value Se asigna directamente desde el registro sin procesar. La clave se ha definido como "EgressInterface".
EgressZone target.location.name Se asigna directamente desde el registro sin procesar.
eventId metadata.product_event_type Se asigna directamente desde el registro sin procesar. También se usa para la lógica condicional y el filtrado.
FileAction security_result.summary Se asigna directamente desde el registro sin procesar.
FileDirection metadata.description Se asigna directamente desde el registro sin procesar y se añade a la descripción.
FileName target.file.full_path Se asigna directamente desde el registro sin procesar.
FilePolicy security_result.rule_name Se asigna directamente desde el registro sin procesar.
FileSize target.file.size Se asigna directamente desde el registro sin procesar.
FileSHA256 target.file.sha256 Se asigna directamente desde el registro sin procesar.
FileSandboxStatus security_result.description Se asigna directamente desde el registro sin procesar.
HTTPReferer network.http.referral_url Se asigna directamente desde el registro sin procesar.
HTTPResponse network.http.response_code Se asigna directamente desde el registro sin procesar.
HTTP_Hostname target.resource.attribute.labels.value Se asigna directamente desde el registro sin procesar. La clave es "HTTP_Hostname".
HTTP_URI target.resource.attribute.labels.value Se asigna directamente desde el registro sin procesar. La clave es "HTTP_URI".
IngressInterface principal.asset.attribute.labels.value Se asigna directamente desde el registro sin procesar. La clave se ha definido como "IngressInterface".
IngressZone principal.location.name Se asigna directamente desde el registro sin procesar.
InitiatorBytes network.received_bytes Se asigna directamente desde el registro sin procesar.
InlineResult security_result.action_details Se asigna directamente desde el registro sin procesar.
IntrusionPolicy security_result.rule_name Se asigna directamente desde el registro sin procesar.
log_type metadata.log_type Se asigna directamente desde el registro sin procesar.
Message security_result.description Se asigna directamente desde el registro sin procesar y, a menudo, se le añade el prefijo "Message : ".
NAPPolicy principal.asset.attribute.labels.value Se asigna directamente desde el registro sin procesar. La clave es "NAPPolicy".
Prefilter Policy security_result.rule_labels.value Se asigna directamente desde el registro sin procesar. La clave se ha definido como "Prefilter Policy".
Priority security_result.priority_details Se asigna directamente desde el registro sin procesar.
priorityId security_result.priority_details Se asigna directamente desde el registro sin procesar.
product metadata.product_name Selecciona "Firepower Firewall".
Protocol network.ip_protocol Se asigna directamente desde el registro sin procesar. Los valores se normalizan en UDM (TCP, UDP, ICMP, etc.).
ResponderBytes network.sent_bytes Se asigna directamente desde el registro sin procesar.
Revision security_result.about.labels.value Se asigna directamente desde el registro sin procesar. La clave es "Signature_Version".
ruleId security_result.rule_id Se asigna directamente desde el registro sin procesar.
security_result.severity security_result.severity Se define en función del campo severity del registro sin procesar. Para ello, se usa una tabla de consulta que asigna los valores de gravedad de UDM.
security_result.severity_details security_result.severity_details Se define en función del campo severity del registro sin procesar. Para ello, se usa una tabla de consulta que asigna los detalles de gravedad de UDM.
SID security_result.threat_id Se asigna directamente desde el registro sin procesar.
SrcIP principal.asset.ip, principal.ip Se asigna directamente desde el registro sin procesar.
SrcPort principal.port Se asigna directamente desde el registro sin procesar.
syslog_msg_id metadata.product_event_type Se asigna directamente desde el registro sin procesar después de convertirse en una cadena. Se usa para anular eventId si está presente.
syslog_msg_text metadata.description, security_result.description Se asigna directamente desde el registro sin procesar. A veces, se le añade el prefijo "Message : ". Se usa para anular la descripción generada a partir de data y eventId.
syslog_severity security_result.severity Se asigna directamente desde el registro sin procesar después de convertirse en una cadena. Se usa para anular la gravedad derivada de eventId. Los valores se normalizan en UDM (INFORMATIONAL, WARNING, ERROR, etc.).
sysloghost intermediary.hostname Se asigna directamente desde el registro sin procesar.
ThreatName security_result.threat_name Se asigna directamente desde el registro sin procesar.
ts metadata.event_timestamp Se analiza a partir del registro sin procesar mediante filtros de fecha y varios formatos.
ts_year metadata.event_timestamp Se analiza a partir del registro sin procesar mediante filtros de fecha y varios formatos.
URL target.url Se asigna directamente desde el registro sin procesar.
URLCategory security_result.category_details Se asigna directamente desde el registro sin procesar.
URLReputation security_result.confidence_details Se asigna directamente desde el registro sin procesar.
User target.user.userid Se asigna directamente desde el registro sin procesar.
UserAgent network.http.user_agent Se asigna directamente desde el registro sin procesar.
UserName target.user.userid Se asigna directamente desde el registro sin procesar.
user_name principal.user.email_addresses Se asignan directamente desde el registro sin procesar de tipos de eventos específicos.
WebApplication target.application Se asigna directamente desde el registro sin procesar.
metadata.event_type se define con un valor predeterminado de NETWORK_CONNECTION y, a veces, se anula en función de eventId u otros campos.
metadata.vendor_name siempre tiene el valor "Cisco".

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.