Recopilar registros del motor distribuido de Delinea
En este documento se explica cómo ingerir registros de Delinea Distributed Engine en Google Security Operations mediante Bindplane.
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 al portal de Delinea.
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: tcplog: # Replace the port and IP address as required listen_address: "0.0.0.0:5145" 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: 'DELINEA_DISTRIBUTED_ENGINE' raw_log_field: body ingestion_labels: 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.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 Syslog de Delinea
- Inicia sesión en la interfaz web del portal de Delinea.
- Vaya a Administrar > Aplicación.
- Haz clic en el botón Edit (Editar).
- Marca la casilla Enable Syslog/CEF Log Output (Habilitar salida de registro Syslog/CEF). Se muestra una sección Syslog.
- Introduce la dirección IP del agente de Bindplane.
- Introduce el número de puerto del agente de Bindplane.
- Haz clic en el menú Protocolo y selecciona TCP.
- Haz clic para seleccionar Lista de zonas horarias a hora UTC u Hora del servidor, según tus preferencias.
- Haga clic en el menú Sitio para seleccionar el Sitio relacionado en el que se ejecutará Syslog o CEF.
- Opcional (requiere permisos adicionales): selecciona Escribir Syslogs como eventos de Windows para escribir auditorías y suscripciones a eventos en el registro de eventos de Windows.
- Haz clic en Guardar.
Configurar el nivel de registro de los motores distribuidos
- Inicia sesión en la interfaz web del portal de Delinea.
- Vaya a Administrar > Distributed Engine.
- Haz clic en el icono de tres puntos situado sobre el motor correspondiente y selecciona Mostrar configuración.
- Selecciona el menú Nivel de registro y, a continuación, Información.
- Haz clic en Aceptar.
Tabla de asignación de UDM
Campo de registro | Asignación de UDM | Lógica |
---|---|---|
ACTION |
security_result.action |
Si ACTION_CODE es "1", asigna el valor "ALLOW". De lo contrario, si ACTION_CODE no está vacío, se asigna el valor "BLOCK". De lo contrario, se asigna el valor predeterminado "UNKNOWN_ACTION" del principio del analizador. |
ACTION_CODE |
security_result.action |
Se usa en la lógica para determinar security_result.action . |
APP_NAME |
network.http.user_agent |
Asignación directa. |
BYTES_RECVD |
network.received_bytes |
Asignado directamente y convertido en un entero sin signo. |
BYTES_SENT |
network.sent_bytes |
Asignado directamente y convertido en un entero sin signo. |
CLOUDGENIX_HOST |
principal.hostname |
Se asigna directamente si el campo NAME está vacío. Se usa como nombre de host intermediario si NAME está presente. |
CODE |
metadata.product_event_type |
Se concatena con FACILITY para formar metadata.product_event_type . También se usa para determinar metadata.event_type (por ejemplo, si CODE contiene "DOWN", metadata.event_type se asigna a "STATUS_SHUTDOWN"). |
DESTINATION_ZONE_NAME |
about.labels |
Se ha asignado directamente como una etiqueta con la clave "DESTINATION_ZONE_NAME". |
DEVICE_TIME |
metadata.event_timestamp |
Se asigna directamente después de analizarse como fecha. |
DST_INTERFACE |
target.hostname |
Asignación directa. |
DST_IP |
target.ip |
Asignación directa. |
DST_PORT |
target.port |
Asignado directamente, convertido en entero. |
ELEMENT_ID |
about.labels |
Se asigna directamente como una etiqueta con la clave "ELEMENT_ID". |
EVENT_TIME |
metadata.event_timestamp |
Se asigna directamente después de analizarse como fecha. |
FACILITY |
metadata.product_event_type |
Se concatena con CODE para formar metadata.product_event_type . |
FLOW_EVENT |
security_result.summary |
Se usa como parte de la cadena security_result.summary . |
IDENTIFIER |
about.labels |
Se asigna directamente como una etiqueta con la clave "IDENTIFIER". |
ION_HOST |
principal.hostname |
Se asigna directamente si los campos CLOUDGENIX_HOST y NAME están vacíos. |
MSG |
metadata.description |
Asignación directa. También se usa para buscar coincidencias con expresiones regulares para determinar metadata.event_type y extraer target.ip . |
NAME |
principal.hostname |
Asignación directa. Si está presente, CLOUDGENIX_HOST se convierte en intermediary.hostname . |
PROCESS_NAME |
principal.process.file.full_path |
Asignación directa. |
PROTOCOL_NAME |
network.ip_protocol |
Se asigna directamente y se convierte a mayúsculas. |
REMOTE_HOSTNAME |
target.hostname |
Asignación directa. |
REMOTE_IP |
target.ip |
Asignación directa. |
RULE_NAME |
security_result.rule_name |
Asignación directa. |
SEVERITY |
security_result.severity , security_result.severity_details |
Asignado a security_result.severity_details . También se usa para determinar security_result.severity (por ejemplo, si SEVERITY es "minor", security_result.severity se define como "LOW"). |
SOURCE_ZONE_NAME |
about.labels |
Se ha asignado directamente como una etiqueta con la clave "SOURCE_ZONE_NAME". |
SRC_INTERFACE |
principal.hostname |
Asignación directa. |
SRC_IP |
principal.ip |
Asignación directa. |
SRC_PORT |
principal.port |
Asignado directamente, convertido en entero. |
VPN_LINK_ID |
target.resource.id |
Asignación directa. |
(Lógica del analizador) | is_alert |
Se define como true si log_type es "alert" o "alarm". |
(Lógica del analizador) | is_significant |
Se define como true si log_type es "alert" o "alarm". |
(Lógica del analizador) | metadata.event_type |
Se determina mediante una serie de instrucciones condicionales basadas en los valores de CODE , MSG , src_ip y dest_ip . El valor predeterminado es "GENERIC_EVENT". |
(Lógica del analizador) | metadata.log_type |
Se ha definido como "CLOUDGENIX_SDWAN". |
(Lógica del analizador) | metadata.product_event_type |
El valor predeterminado es la concatenación de CODE y FACILITY . Se define como "cgxFlowLogV1" para los registros de flujo. |
(Lógica del analizador) | metadata.product_name |
Asigna el valor "CloudGenix SD-WAN". |
(Lógica del analizador) | metadata.vendor_name |
Selecciona "Palo Alto Networks". |
(Lógica del analizador) | principal.process.pid |
Se define como el valor de pid del registro sin procesar de los registros de flujo. |
(Lógica del analizador) | security_result.action |
El valor predeterminado es "UNKNOWN_ACTION". |
(Lógica del analizador) | security_result.severity |
El valor predeterminado es "UNKNOWN_SEVERITY". Se define en función del valor de SEVERITY . Se define como "INFORMATIONAL" para los registros de flujo. |
(Lógica del analizador) | security_result.summary |
Se define en función del valor de CODE para los mensajes syslog. Se asigna a una cadena descriptiva que incluye FLOW_EVENT , SRC_IP y DST_IP para los registros de flujo. |
¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.