Recopilar registros del motor distribuido de Delinea

Disponible en:

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

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

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

  1. Inicia sesión en la interfaz web del portal de Delinea.
  2. Vaya a Administrar > Aplicación.
  3. Haz clic en el botón Edit (Editar).
  4. Marca la casilla Enable Syslog/CEF Log Output (Habilitar salida de registro Syslog/CEF). Se muestra una sección Syslog.
  5. Introduce la dirección IP del agente de Bindplane.
  6. Introduce el número de puerto del agente de Bindplane.
  7. Haz clic en el menú Protocolo y selecciona TCP.
  8. Haz clic para seleccionar Lista de zonas horarias a hora UTC u Hora del servidor, según tus preferencias.
  9. Haga clic en el menú Sitio para seleccionar el Sitio relacionado en el que se ejecutará Syslog o CEF.
  10. 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.
  11. Haz clic en Guardar.

Configurar el nivel de registro de los motores distribuidos

  1. Inicia sesión en la interfaz web del portal de Delinea.
  2. Vaya a Administrar > Distributed Engine.
  3. Haz clic en el icono de tres puntos situado sobre el motor correspondiente y selecciona Mostrar configuración.
  4. Selecciona el menú Nivel de registro y, a continuación, Información.
  5. 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.