Recoger registros de Darktrace
En este documento se explica cómo ingerir registros de Darktrace en Google Security Operations mediante un agente de Bindplane. Este analizador primero extrae los campos comunes de los mensajes syslog y, a continuación, usa la lógica condicional para gestionar los registros de Darktrace con formato CEF y JSON. Asigna los campos extraídos al esquema del modelo de datos unificado (UDM), enriquece los datos con contexto de seguridad y estandariza la categorización de eventos para el análisis posterior.
Antes de empezar
Asegúrate de que cumples los siguientes requisitos previos:
- Instancia de Google SecOps
- Windows 2016 o una versión posterior, o un host Linux con systemd
- Si se ejecuta a través de un proxy, los puertos del cortafuegos están abiertos
- Acceso privilegiado a Darktrace
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
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,vio Bloc de notas).
 
- Busca el archivo 
- Edita el archivo - config.yamlde la siguiente manera:- receivers: tcplog: # Replace the port and IP address as required listen_address: `0.0.0.0:10282` exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds: '/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 ingestion_labels: log_type: DARKTRACE raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - tcplog 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.jsona 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 Bindlane 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 Darktrace
- Inicia sesión en la interfaz web de Darktrace.
- Ve a Administrar > Configuración del sistema.
- Haz clic en Verificar configuración de alertas.
- Proporcione los siguientes detalles de configuración:
- Alertas de Syslog de CEF: selecciona True.
- Servidor Syslog de CEF: introduce la dirección IP de Bindplane.
- Puerto del servidor Syslog de CEF: introduce el número de puerto de Bindplane (por ejemplo, 10282).
- Alerta de CEF Syslog TCP: seleccione True.
 
- Haz clic en Guardar.
Tabla de asignación de UDM
| Campo de registro | Asignación de UDM | Lógica | 
|---|---|---|
| darktraceUrl | security_result.url_back_to_product | El valor se toma del campo darktraceUrl. | 
| darktrace_host | observer.hostname | El valor se toma del campo darktrace_hostsi no es una dirección IP. | 
| darktrace_ip | observer.ip | El valor se toma del campo darktrace_ip. | 
| darktrace_user | observer.user.userid | El valor se toma del campo darktrace_user. | 
| description | security_result.summary, metadata.description | El valor se toma del campo description. | 
| device.customFields.DT-AUTO.macaddress | principal.mac | El valor se toma del campo device.customFields.DT-AUTO.macaddress. | 
| device.did | principal.asset.asset_id | El valor se toma del campo device.did, se convierte en una cadena y se le añade el prefijoDevice ID:. | 
| device.firstSeen | principal.asset.first_seen_time | El valor se toma del campo device.firstSeen, se convierte en una cadena y se analiza como una marca de tiempo de UNIX en milisegundos. | 
| device.hostname | principal.hostname, principal.asset.hostname | El valor se toma del campo device.hostname. | 
| device.ip | principal.ip, principal.asset.ip | El valor se toma del campo device.ipsi coincide con el formato de dirección IP. | 
| device.ips.0.subnet | additional.fields.subnet | El valor se toma del campo device.ips.0.subnety se le añade el prefijosubnet. | 
| device.ips.ip | principal.ip, principal.asset.ip | El valor se toma del campo device.ips.ipde cada dirección IP de la lista. | 
| device.lastSeen | principal.asset.last_discover_time | El valor se toma del campo device.lastSeen, se convierte en una cadena y se analiza como una marca de tiempo de UNIX en milisegundos. | 
| device.macaddress | principal.mac | El valor se toma del campo device.macaddress. | 
| device.objecttype | principal.asset.type | Si el valor es device, el campo de UDM se define comoWORKSTATION. | 
| device.sid | principal.resource.attribute.labels.sid | El valor se toma del campo device.sidy se convierte en una cadena. | 
| device.typelabel | principal.resource.attribute.labels.typelabel | El valor se toma del campo device.typelabel. | 
| device.typename | principal.resource.attribute.labels.typename | El valor se toma del campo device.typename. | 
| dst | target.ip, target.asset.ip | El valor se toma del campo dst. | 
| dpt | target.port | El valor se toma del campo dpty se convierte en un número entero. | 
| dvc | principal.ip, principal.asset.ip | Si el valor de dvces una dirección IP, se añade al campo UDM. | 
| dvchost | principal.hostname, principal.asset.hostname | El valor se toma del campo dvchost. | 
| punto final | target.url | El valor se toma del campo endpoint. | 
| event_time | metadata.event_timestamp | El valor se toma del campo event_timey se analiza como una marca de tiempo ISO8601. | 
| externalId | metadata.product_log_id | El valor se toma del campo externalId. | 
| incidentEventUrl | principal.url | El valor se toma del campo incidentEventUrl. | 
| ip | principal.ip, principal.asset.ip | El valor se toma del campo ipsi coincide con el formato de dirección IP. | 
| issue_msg | security_result.summary | El valor se toma del campo issue_msg. | 
| mensaje | security_result.description | El valor se toma del campo message. | 
| método | network.http.method | El valor se toma del campo method. | 
| model.description | metadata.description | El valor se toma del campo model.description. | 
| model.name | metadata.product_event_type | El valor se toma del campo model.name. | 
| model.now.category | security_result.severity | Si el valor es critical, el campo de UDM se define comoCRITICAL. Si el valor esInformational, el campo de UDM se define comoINFORMATIONAL. Si el valor esSuspicious, el campo UDM se define comoHIGHy la categoría comoNETWORK_SUSPICIOUS. | 
| model.now.description | metadata.description | El valor se toma del campo model.now.description. | 
| model.now.message | security_result.description | El valor se toma del campo model.now.message. | 
| model.now.name | metadata.product_event_type | El valor se toma del campo model.now.name. | 
| model.now.pid | principal.process.pid | El valor se toma del campo model.now.pidy se convierte en una cadena. | 
| model.now.uuid | principal.user.userid | El valor se toma del campo model.now.uuidy el tipo de evento se define comoUSER_UNCATEGORIZED. | 
| model.pid | principal.process.pid | El valor se toma del campo model.pidy se convierte en una cadena. | 
| model.then.description | principal.resource.attribute.labels.Model Then Description | El valor se toma del campo model.then.description. | 
| model.then.name | principal.resource.attribute.labels.Model Then Name | El valor se toma del campo model.then.name. | 
| model.then.pid | principal.resource.attribute.labels.Model Then Pid | El valor se toma del campo model.then.pidy se convierte en una cadena. | 
| model.then.uuid | principal.resource.attribute.labels.Model Then UUID | El valor se toma del campo model.then.uuid. | 
| model.uuid | principal.user.userid | El valor se toma del campo model.uuidy el tipo de evento se define comoUSER_UNCATEGORIZED. | 
| relatedBreaches.0.modelName | security_result.description | El valor se toma del campo relatedBreaches.0.modelName. | 
| puntuación | security_result.priority, security_result.priority_details | Si el valor está entre 0,8 y 1, la prioridad se establece en HIGH_PRIORITY. Si el valor está entre 0,5 y 0,79, la prioridad se establece enMEDIUM_PRIORITY. Si el valor está entre 0 y 0,49, la prioridad se establece enLOW_PRIORITY. Los detalles de la prioridad se definen comoScore :seguido del valor descoreconvertido en una cadena. | 
| gravedad | security_result.severity | Si el valor es 2, el campo de UDM se define como MEDIUM. Si el valor es superior a 2, el campo de UDM se define comoHIGH. | 
| shost | principal.hostname, principal.asset.hostname | El valor se toma del campo shost. | 
| smac | principal.mac | El valor se toma del campo smac. | 
| src | principal.ip, principal.asset.ip | El valor se toma del campo src. | 
| status | network.http.response_code | El valor se toma del campo statusy se convierte en una cadena. | 
| resumen | metadata.description | El valor se toma del campo summary. | 
| Tiempo | El valor se toma del campo time, se convierte en una cadena y se analiza como una marca de tiempo de UNIX en milisegundos. | |
| timestamp | El valor se toma del campo timestampy se analiza como una marca de tiempo ISO 8601 o una marca de tiempo de Unix en milisegundos. | |
| title | security_result.summary | El valor se toma del campo title. | 
| triggeredComponents.ip | intermediary.ip | El valor se toma del campo triggeredComponents.ipsi coincide con el formato de dirección IP. | 
| triggeredComponents.port | intermediary.port | El valor se toma del campo triggeredComponents.porty se convierte en un número entero. | 
| nombre de usuario | principal.user.userid | El valor se toma del campo username. | 
| metadata.vendor_name | Su valor debe ser DARKTRACE. | |
| metadata.product_name | Su valor debe ser DCIP. | |
| metadata.log_type | Su valor debe ser DARKTRACE. | |
| network.ip_protocol | Se define como TCPsiissue_msgno contieneUDP. De lo contrario, se asigna el valorUDP. | |
| security_result.action | Se asigna el valor BLOCKsistatuses401. De lo contrario, se asigna el valorALLOW. | |
| security_result.severity | Su valor debe ser INFORMATIONAL. | |
| network.application_protocol | Se asigna el valor HTTPsimethodno está vacío. | |
| metadata.event_type | Se asigna el valor NETWORK_HTTPsimethodno está vacío. Se establece enUSER_LOGINsidescriptioncontienelogged into \\\\S+ over ssh. Se asigna el valorNETWORK_CONNECTIONsitarget_ipno está vacío. De lo contrario, asigna el valorSTATUS_UPDATE. | |
| extensions.auth.type | Se establece en MACHINEsidescriptioncontienelogged into \\\\S+ over ssh. | |
| security_result.category | Se establece en DATA_EXFILTRATIONsiissue_msgcontieneExfiltration. Se establece enNETWORK_MALICIOUSsiissue_msgcontieneCompromise. De lo contrario, asigna el valorNETWORK_SUSPICIOUS. | 
¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.