Recopila registros de IBM Guardium

Compatible con:

En este documento, se explica cómo transferir registros de IBM Guardium a Google Security Operations con Bindplane.

IBM Guardium es una plataforma de supervisión de la actividad de las bases de datos y de protección de datos que proporciona supervisión, auditoría y protección en tiempo real para bases de datos y sistemas de archivos. Guardium ofrece funciones de evaluación de vulnerabilidades, descubrimiento y clasificación de datos, supervisión de la actividad de la base de datos y generación de informes de cumplimiento.

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
  • Conectividad de red entre el agente de Bindplane y el recopilador de IBM Guardium
  • 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
  • Acceso con privilegios a la CLI de IBM Guardium
  • IBM Guardium versión 9.1 o posterior para la compatibilidad con syslog encriptado (opcional)

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.

Configura el agente de BindPlane para transferir syslog y enviarlo 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:
      udplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/guardium:
        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: 'YOUR_CUSTOMER_ID'
        endpoint: chronicle.googleapis.com
        log_type: GUARDIUM
        raw_log_field: body
        ingestion_labels:
          log_source: guardium
    
    service:
      pipelines:
        logs/guardium_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/guardium
    

Parámetros de configuración

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

  • Configuración del receptor:

    • Usa udplog para el syslog de UDP (el más común para Guardium).
    • Usa tcplog para syslog de TCP si es necesario.
    • La dirección de escucha 0.0.0.0:514 escucha en todas las interfaces en el puerto 514.
  • Configuración 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.
    • log_type: Debe ser GUARDIUM.
    • ingestion_labels: Son etiquetas opcionales en formato YAML.

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/guardium:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: GUARDIUM
        raw_log_field: body
        ingestion_labels:
          log_source: guardium
    

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 el reenvío de syslog de IBM Guardium

Configura el destino de syslog a través de la CLI

Para crear un destino de syslog para eventos en IBM Guardium, debes acceder a la interfaz de línea de comandos y definir la dirección IP del host del agente de Bindplane.

  1. Con SSH, accede a IBM Guardium Collector como usuario de la CLI.
  2. Escribe los siguientes comandos para configurar el destino de syslog:

    • Para syslog de UDP (recomendado):

      store remotelog add non_encrypted daemon.all BINDPLANE_AGENT_IP udp
      
    • Para syslog de TCP:

      store remotelog add non_encrypted daemon.all BINDPLANE_AGENT_IP:514 tcp
      
    • Para niveles de gravedad específicos:

      store remotelog add non_encrypted daemon.alert BINDPLANE_AGENT_IP udp
      store remotelog add non_encrypted daemon.err BINDPLANE_AGENT_IP udp
      store remotelog add non_encrypted daemon.warning BINDPLANE_AGENT_IP udp
      
      • Reemplaza BINDPLANE_AGENT_IP por la dirección IP del host en el que está instalado el agente de Bindplane.
  3. Ejecuta el siguiente comando para verificar la configuración:

    show remotelog
    

    En el resultado, debería mostrarse el destino de syslog remoto que configuraste.

Configura el syslog encriptado (opcional)

Si necesitas un reenvío de syslog encriptado, la versión 9.1 y posteriores de IBM Guardium admiten la encriptación TLS a través de TCP.

  1. Obtén el certificado público en formato PEM de la autoridad certificadora que usa tu receptor de syslog remoto.
  2. Accede a la CLI en el recopilador de Guardium.
  3. Escribe el siguiente comando:

    store remotelog add encrypted daemon.all BINDPLANE_AGENT_IP:6514 tcp
    
  4. Cuando se te solicite, pega el certificado de la AC en formato PEM, incluidas las líneas BEGIN y END, y, luego, presiona Ctrl+D.

  5. Guardium almacena el certificado como /etc/pki/rsyslog/ca.pem.

Configura la plantilla de mensaje (opcional)

Guardium admite varios formatos de mensajes, incluidos CEF (formato de evento común) y LEEF (formato extendido de evento de registro). El formato predeterminado es adecuado para la mayoría de las implementaciones.

Para personalizar la plantilla de mensaje, sigue estos pasos:

  1. Accede a la GUI del dispositivo de Guardium como un usuario con privilegios de administrador.
  2. Ve a Consola de administración > Configuración > Perfil global.
  3. En la sección Plantilla de mensaje, edita la plantilla con el formato que desees.
  4. Haz clic en Guardar.

Configura la política para enviar alertas a syslog

Las políticas de IBM Guardium se encargan de reaccionar a los eventos y reenviar la información de los eventos al receptor de syslog remoto.

Configura la acción de alerta de la política

  1. Accede a la GUI del dispositivo de Guardium.
  2. Haz clic en la pestaña Herramientas.
  3. En el menú de navegación de la izquierda, selecciona Creador de políticas.
  4. En el panel Buscador de políticas, selecciona una política existente y haz clic en Editar reglas.
  5. Haz clic en Editar esta regla de forma individual.
  6. Se muestra la definición de la regla de acceso.
  7. Haz clic en Agregar acción.
  8. En la lista Acción, selecciona uno de los siguientes tipos de alerta:
    • Alerta por coincidencia: Se proporciona una notificación por cada incumplimiento de política.
    • Alerta diaria: Se proporciona una notificación la primera vez que se produce un incumplimiento de política ese día.
    • Alert Once Per Session: Se proporciona una notificación por incumplimiento de política para una sesión única.
    • Alerta por granularidad temporal: Se proporciona una notificación según el período que seleccionaste.
  9. En la lista Plantilla de mensaje, selecciona la plantilla que quieras o mantén la opción Predeterminada.
  10. En Tipo de notificación, selecciona SYSLOG.
  11. Haz clic en Agregar y, luego, en Aplicar.
  12. Haz clic en Guardar.
  13. Repite este proceso para todas las reglas de la política que quieras reenviar a Google SecOps.

Instala la política

Cualquier política nueva o editada en IBM Guardium debe instalarse antes de que se puedan realizar las acciones de alerta actualizadas o los cambios en las reglas.

  1. Haz clic en la pestaña Consola de administración.
  2. En el panel de navegación de la izquierda, selecciona Configuration > Policy Installation.
  3. En el panel Instalador de políticas, selecciona la política que modificaste en el paso anterior.
  4. En la lista desplegable, selecciona Instalar y anular.
  5. Se muestra una confirmación para instalar la política en todos los motores de inspección.
  6. Haz clic en Aceptar.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
deviceNtDomain about.administrative_domain Dominio administrativo de la entidad de la que se trata
deviceExternalId about.asset.asset_id Identificador de recurso
filePath, fileHash about.file.full_path Ruta de acceso completa del archivo
_hash, fileHash about.file.sha256 Hash SHA256 del archivo
fsize about.file.size Tamaño del archivo
dvchost about.hostname Nombre de host de la entidad de destino
dvc about.ip Dirección IP de la entidad de destino
smac, dmac, dvcmac about.mac Dirección MAC de la entidad de la que se trata
deviceProcessName, Subject, Emne, Path about.process.command_line Línea de comandos del proceso
dvcpid about.process.pid ID de proceso
filePermission about.resource.attribute.permissions Permisos asociados al recurso
extensions.auth.type Tipo de autenticación
sender_ip intermediary.ip Dirección IP del intermediario
intermediario Detalles de la entidad intermediaria
Received, Generated, timestamp metadata.collected_timestamp Marca de tiempo en la que se recopiló el evento
msg, signature_name metadata.description Descripción del evento
metadata.event_type Tipo de evento (p.ej., USER_LOGIN, NETWORK_CONNECTION)
device_event_class_id, event_name, eventType metadata.product_event_type Tipo de evento específico del producto
externalId metadata.product_log_id Identificador de registro de productos
metadata.product_version Versión del producto
network.application_protocol Es el protocolo de aplicación que se usa en la conexión de red.
deviceDirection network.direction Dirección del tráfico de red
requestMethod network.http.method Es el método HTTP que se usó en la solicitud.
requestClientApplication network.http.user_agent Es la cadena de usuario-agente de la solicitud HTTP.
protocolo network.ip_protocol Protocolo IP usado
en network.received_bytes Cantidad de bytes recibidos
descifrar? network.sent_bytes Cantidad de bytes enviados
session_id network.session_id Identificador de sesión para la conexión de red
sntdom, Domain, Domene principal.administrative_domain Dominio administrativo de la principal
sourceServiceName, source_program principal.application Es la aplicación asociada con la principal.
prin_host, Device_name, Enhetsnavn, shost, principal_hostname, client_hostname principal.asset.hostname Nombre de host del recurso principal
sender_ip, src_ip, src, principal_ip, client_ip principal.asset.ip Dirección IP del activo principal
Group_name, Gruppenavn principal.group.group_display_name Nombre visible del grupo principal
prin_host, Device_name, Enhetsnavn, shost, principal_hostname, client_hostname principal.hostname Nombre de host de la principal
sender_ip, src_ip, src, principal_ip, client_ip principal.ip Dirección IP del principal
smac principal.mac Dirección MAC de la principal
sourceTranslatedAddress principal.nat_ip Dirección IP de NAT de la principal
sourceTranslatedPort principal.nat_port Puerto NAT de la principal
spt, client_port principal.port Es el puerto que usa la principal.
sproc principal.process.command_line Línea de comandos del proceso principal
spid principal.process.pid Es el ID de proceso de la entidad principal.
spriv principal.user.attribute.roles Roles asociados con el usuario principal
suser, usrName, CustomerName principal.user.user_display_name Nombre visible del usuario principal
dbUser, usrName, db_user, os_user, suid, db_username principal.user.userid ID de usuario de la principal
security_result Detalles del resultado de seguridad
security_result.action Acción tomada en el resultado de seguridad
act, Action_Taken security_result.action_details Detalles de la medida que se tomó
cat security_result.category_details Detalles de la categoría del resultado de seguridad
msg_data_2, alert_description, Type, Scan_Type security_result.description Descripción del resultado de seguridad
operation_label, operasjon_label, permission_label, tillatelse_label, infection_channel_label, spyware_Grayware_Type_label, threat_probability_label security_result.detection_fields Campos que se usan para la detección en el resultado de seguridad
mwProfile, alert_name security_result.rule_name Es el nombre de la regla que activó el resultado de seguridad.
severity, event_severity security_result.severity Nivel de gravedad del resultado de seguridad
reason, ruleDesc, appcategory, Result security_result.summary Resumen del resultado de seguridad
Spyware, Virus_Malware_Name, Unknown_Threat security_result.threat_name Nombre de la amenaza detectada
oldFilePath src.file.full_path Ruta de acceso completa al archivo de origen
oldFileSize src.file.size Tamaño del archivo de origen
oldFilePermission src.resource.attribute.permissions Permisos del recurso de origen
os_user src.user.userid ID del usuario de origen
dntdom target.administrative_domain Dominio administrativo del destino
destinationServiceName, service_name target.application Aplicación asociada con el destino
prin_host, dest_host, server_hostname target.asset.hostname Nombre de host del recurso de destino
dst_ip, dest_ip, server_ip, IPv6_Address target.asset.ip Dirección IP del activo de destino
temp_dhost, dest_host, server_hostname target.hostname Nombre de host del destino
dst_ip, dst, dest_ip, server_ip, IPv6_Address target.ip Dirección IP del destino
dmac target.mac Dirección MAC del destino
destinationTranslatedAddress target.nat_ip Dirección IP de NAT del destino
destinationTranslatedPort target.nat_port Puerto NAT del destino
dpt, dstPort, dest_port, server_port target.port Es el puerto que usa el destino.
dproc, full_sql target.process.command_line Línea de comandos del proceso de destino
File_name, Object, Objekt, Infected_Resource target.process.file.full_path Ruta de acceso completa del archivo de proceso de destino
dpid, full_sql_id target.process.pid ID de proceso del destino
session_start target.resource.attribute.creation_time Hora de creación del recurso objetivo
additional_environment_name, additional_db_protocol_version, additional_dbProtocolVersion, additional_operation_name, additional_signature_id, resource_Type_label target.resource.attribute.labels Etiquetas asociadas con el recurso objetivo
session_end target.resource.attribute.last_update_time Hora de la última actualización del recurso objetivo
db_name, database_name target.resource.name Nombre del recurso objetivo
db_type, server_type target.resource.resource_subtype Subtipo del recurso objetivo
target.resource.resource_type Tipo de recurso objetivo
solicitud target.url URL asociada con el destino
dpriv, roles target.user.attribute.roles Roles asociados con el usuario objetivo
temp_duser, CustomerName target.user.user_display_name Nombre visible del usuario objetivo
temp_duid, User, Bruker, db_username target.user.userid ID de usuario del objetivo
metadata.product_name Nombre del producto
metadata.vendor_name Nombre del proveedor
query additional.fields 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.