Recoger registros de MySQL

Disponible en:

En este documento se explica cómo ingerir registros de MySQL en Google Security Operations mediante Bindplane. El analizador primero extrae los campos comunes de los mensajes SYSLOG de MySQL mediante grok. A continuación, usa ramificaciones condicionales (if, else if) y coincidencias de expresiones regulares para identificar tipos de eventos específicos en los mensajes de registro, extraer y asignar información relevante al esquema del modelo de datos unificado (UDM).

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, los puertos del cortafuegos están abiertos
  • Acceso privilegiado al host de MySQL
  • Base de datos MySQL y Rsyslog instalados

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 Bindlane

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: '/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: 'MYSQL'
                raw_log_field: body
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    
  3. Sustituye el puerto y la dirección IP según sea necesario en tu infraestructura.

  4. Sustituye <customer_id> por el ID de cliente real.

  5. 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 en MySQL

  1. Inicia sesión en el host de MySQL mediante SSH.

  2. Conéctate a la base de datos MySQL:

    mysql -u root -p
    
  3. Verifica el complemento de auditoría server_audit.so:

    show variables like 'plugin_dir';
    
  4. Si no encuentras el archivo del complemento en el directorio del complemento, instálalo con el siguiente comando:

    install plugin server_audit soname 'server_audit.so';
    
  5. Confirma que el complemento esté instalado y habilitado:

    show plugins;
    
  6. Edita el archivo /etc/my.cnf con vi, habilita lo siguiente y guarda el archivo:

    server_audit_events='CONNECT,QUERY,TABLE'
    server_audit_file_path=server_audit.log
    server_audit_logging=ON
    server_audit_output_type=SYSLOG
    server_audit_syslog_facility=LOG_LOCAL6
    
  7. Verifica las variables de auditoría con el siguiente comando:

    show global variables like "server_audit%";
    
  8. Verifica que la auditoría esté habilitada con el siguiente comando:

    Show global status like 'server_audit%';
    
  9. Edita el archivo /etc/rsyslog.conf con vi para habilitar el uso de UDP y guardar el archivo:

    *.* @@<bindplane-agent-ip>:<bindplane-agent-port>
    
  10. Sustituye <bindplane-agent-ip> y <bindplane-agent-port> por la configuración de tu agente Bindplane.

  11. Reinicia el servicio MySQL y conéctate a la base de datos MySQL.

    /etc/init.d/mysqld restart
    

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
acción read_only_udm.metadata.event_type Si el valor es Created, se asigna FILE_CREATION; si el valor es Deleted, se asigna FILE_DELETION. En cualquier otro caso, no se produce ningún cambio.
base de datos read_only_udm.target.resource.parent
db_hostname read_only_udm.target.hostname
db_user read_only_udm.target.user.userid
description read_only_udm.security_result.description
error_details Se trata de una variable temporal, así que ignórala.
error_level read_only_udm.security_result.severity Si el valor es error, se mostrará ERROR; si es warning, se mostrará MEDIUM; si es note, se mostrará INFORMATIONAL. En caso contrario, no se producirá ningún cambio.
error_message read_only_udm.security_result.summary
file_path read_only_udm.target.file.full_path
file_size read_only_udm.target.file.size
nombre de host read_only_udm.principal.hostname
inner_message read_only_udm.security_result.description
resumen read_only_udm.metadata.product_event_type
tabla read_only_udm.target.resource.name
table_not_found Se trata de una variable temporal, así que ignórala.
timestamp read_only_udm.metadata.event_timestamp
read_only_udm.extensions.auth.type Valor estático: MACHINE
read_only_udm.metadata.event_type Valor estático: USER_LOGIN, GENERIC_EVENT, STATUS_UPDATE, FILE_CREATION o FILE_DELETION
read_only_udm.metadata.log_type Valor estático: MYSQL
read_only_udm.metadata.product_name Valor estático: MySQL
read_only_udm.metadata.vendor_name Valor estático: Oracle Corporation
read_only_udm.security_result.action Valor estático: BLOCK
read_only_udm.target.resource.resource_type Valor estático: DATABASE y TABLE

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