Recopila registros de la base de datos de Oracle

Compatible con:

En este documento, se explica cómo transferir registros de Oracle DB a Google Security Operations con Bindplane. El analizador extrae campos de los mensajes de SYSLOG y controla varios formatos con patrones de Grok y análisis de pares clave-valor. Luego, asigna estos campos extraídos al modelo de datos unificado (UDM), enriquece los datos con metadatos estáticos, como nombres de proveedores y productos, y establece de forma dinámica los tipos de eventos según valores de campos específicos, como ACTION y USERID. El analizador también controla varias operaciones de limpieza de datos, como el reemplazo de caracteres y la conversión de tipos de datos.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Instancia de Google SecOps
  • Windows 2016 o versiones posteriores, o un host de Linux con systemd
  • Si se ejecuta detrás de un proxy, los puertos de firewall están abiertos.
  • Acceso con privilegios (rol AUDIT_SYSTEM) a la base de datos de Oracle

Obtén el archivo de autenticación de transferencia de Google SecOps

  1. Accede a la consola de Google SecOps.
  2. Ve a SIEM Settings > Collection Agents.
  3. Descarga el archivo de autenticación de transferencia. Guarda el archivo de forma segura en el sistema en el que se instalará BindPlane.

Obtén el ID de cliente de Google SecOps

  1. Accede a la consola de Google SecOps.
  2. Ve a SIEM Settings > Profile.
  3. Copia y guarda el ID de cliente de la sección Detalles de la organización.

Instala el agente de BindPlane

Instalación en Windows

  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 en Linux

  1. Abre una terminal con privilegios de raíz 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 obtener más opciones de instalación, consulta la guía de instalación.

Configura el agente de BindPlane para transferir Syslog y enviarlo a Google SecOps

  1. Accede al archivo de configuración:
    • Ubica el archivo config.yaml. Por lo general, 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_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
            ingestion_labels:
                log_type: 'ORACLE_DB'
                raw_log_field: body
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    
  3. Reemplaza el puerto y la dirección IP según sea necesario en tu infraestructura.

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

  5. Actualiza /path/to/ingestion-authentication-file.json a la ruta de acceso en la que se guardó el archivo de autenticación en la sección Cómo obtener el archivo de autenticación de la transferencia 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 de Servicios o ingresar el siguiente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Habilita la auditoría para la base de datos de Oracle

  1. Conéctate a la base de datos de Oracle con SQL*Plus.
  2. Cierra la base de datos con el siguiente comando:

    shutdown immediate
    
  3. Para detener el servicio de escucha de Oracle, escribe el siguiente comando:

    lsnrctl stop
    
  4. Opcional: Solo si corresponde, detén Enterprise Manager con los siguientes comandos:

    cd /u01/app/oracle/product/middleware/oms
    
    export OMS_HOME=/u01/app/oracle/product/middleware/oms
    
    $OMS_HOME/bin/emctl stop oms
    
  5. Vincula la base de datos de Oracle con la opción uniaud usando los siguientes comandos:

    cd $ORACLE_HOME/rdbms/lib
    
    make -f ins_rdbms.mk uniaud_on ioracle
    
  6. Conéctate a la base de datos de Oracle con SQL*Plus.

  7. Reinicia la base de datos con el siguiente comando:

    startup
    
  8. Reinicia el servicio de escucha de Oracle con el siguiente comando:

    lsnrctl start
    
  9. Opcional: Solo si corresponde, reinicia Enterprise Manager con los siguientes comandos:

    cd /u01/app/oracle/product/middleware/oms
    
    export OMS_HOME=/u01/app/oracle/product/middleware/oms
    
    $OMS_HOME/bin/emctl start oms
    
  10. Verifica que la auditoría unificada esté habilitada, conéctate a la base de datos de Oracle con SQL*Plus y, luego, escribe el siguiente comando:

    select * from v$option where PARAMETER = 'Unified Auditing';
    
  11. Verifica que el comando devuelva una fila con el valor VALUE igual a "TRUE".

Configura Syslog para la base de datos de Oracle

  1. Accede a la instancia de Oracle.
  2. Abre el siguiente archivo con vi:

    vi ${ORACLE_HOME}/dbs/init${ORACLE_SID}.ora
    
  3. Ingresa los siguientes comandos para la configuración de syslog:

    *.audit_trail='os'
    *.audit_syslog_level='local0.info'
    
  4. Asegúrate de que el daemon syslog en el host de Oracle esté configurado para reenviar el registro de auditoría.

  5. En Red Hat Enterprise, abre el siguiente archivo /etc/syslog.conf con vi y, luego, ingresa la siguiente línea:

    local0.info @ <bindplane-ip>:514
    
  6. Guarda y sal del archivo:

    :wq
    
  7. En Red Hat Enterprise, escribe el siguiente comando para volver a cargar la configuración de syslog:

    kill -HUP /var/run/syslogd.pid
    
  8. Conéctate a SQLplus y accede como sysdba para reiniciar:

    sys as sysdba
    
  9. Cierra la base de datos con el siguiente comando:

    shutdown immediate
    
  10. Reinicia la base de datos con el siguiente comando:

    startup
    

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
ACTION security_result.action_details El valor de ACTION del registro sin procesar se asigna directamente a este campo de UDM. Se aplica lógica adicional para determinar security_result.action y security_result.description en función del valor de ACTION (p.ej., 100 se asigna a ALLOW y Success).
ACTION_NAME metadata.product_event_type Se asigna directamente.
ACTION_NUMBER additional.fields[action_number].value.string_value Se asigna directamente con la clave Source Event. También se usa en combinación con otros campos para derivar metadata.event_type y metadata.product_event_type.
APPLICATION_CONTEXTS additional.fields[application_contexts_label].value.string_value Se asigna directamente con la clave APPLICATION_CONTEXTS.
AUDIT_POLICY additional.fields[audit_policy_label].value.string_value o additional.fields[AUDIT_POLICY_#].value.string_value Si AUDIT_POLICY contiene una coma, se divide en varias etiquetas con claves como AUDIT_POLICY_0, AUDIT_POLICY_1, etcétera. De lo contrario, se asigna directamente con la clave AUDIT_POLICY.
AUDIT_TYPE additional.fields[audit_type_label].value.string_value Se asigna directamente con la clave AUDIT_TYPE.
AUTHENTICATION_TYPE metadata.event_type, extensions.auth.type Se usa para derivar metadata.event_type como USER_LOGIN si auth_type (extraído de AUTHENTICATION_TYPE) no está vacío y se cumplen otras condiciones. extensions.auth.type se establece en AUTHTYPE_UNSPECIFIED.
CLIENT_ADDRESS principal.ip, principal.port, network.ip_protocol, intermediary[host].user.userid La IP, el puerto y el protocolo se extraen con patrones de Grok. Si hay un nombre de usuario en el campo CLIENT_ADDRESS, se asigna a intermediary[host].user.userid.
CLIENT_ID target.user.userid Se asigna directamente.
CLIENT_PROGRAM_NAME additional.fields[client_program_name_label].value.string_value Se asigna directamente con la clave CLIENT_PROGRAM_NAME.
CLIENT_TERMINAL additional.fields[CLIENT_TERMINAL_label].value Se asigna directamente con la clave CLIENT_TERMINAL.
CLIENT_USER target.user.user_display_name Se asigna directamente.
COMMENT$TEXT additional.fields[comment_text_label].value.string_value Se asigna directamente con la clave comment_text después de reemplazar "+" por ":".
CURRENT_USER additional.fields[current_user_label].value.string_value Se asigna directamente con la clave current_user.
CURUSER additional.fields[current_user_label].value.string_value Se asigna directamente con la clave current_user.
DATABASE_USER principal.user.user_display_name Se asigna directamente si no está vacío o es /.
DBID metadata.product_log_id Se asigna directamente después de quitar las comillas simples.
DBNAME target.resource.resource_type, target.resource.resource_subtype, target.resource.name Establece resource_type en DATABASE, resource_subtype en Oracle Database y asigna DBNAME a name.
DBPROXY_USERRNAME intermediary[dbproxy].user.userid Se asigna directamente.
DBUSERNAME target.user.user_display_name Se asigna directamente.
ENTRYID target.resource.attribute.labels[entry_id_label].value Se asigna directamente con la clave Entry Id.
EXTERNAL_USERID additional.fields[external_userid_label].value.string_value Se asigna directamente con la clave EXTERNAL_USERID.
LENGTH additional.fields[length_label].value.string_value Se asigna directamente con la clave length.
LOGOFF$DEAD target.resource.attribute.labels[LOGOFFDEAD_label].value Se asigna directamente con la clave LOGOFFDEAD.
LOGOFF$LREAD target.resource.attribute.labels[LOGOFFLREAD_label].value Se asigna directamente con la clave LOGOFFLREAD.
LOGOFF$LWRITE target.resource.attribute.labels[LOGOFFLWRITE_label].value Se asigna directamente con la clave LOGOFFLWRITE.
LOGOFF$PREAD target.resource.attribute.labels[LOGOFFPREAD_label].value Se asigna directamente con la clave LOGOFFPREAD.
NTIMESTAMP# metadata.event_timestamp Se analiza y convierte al formato RFC 3339 o ISO8601.
OBJCREATOR target.resource.attribute.labels[obj_creator_label].value Se asigna directamente con la clave OBJ Creator.
OBJNAME target.resource.attribute.labels[obj_name_label].value Se asigna directamente con la clave OBJ Name.
OS_USERNAME principal.user.user_display_name Se asigna directamente.
OSUSERID target.user.userid Se asigna directamente.
PDB_GUID principal.resource.product_object_id Se asigna directamente.
PRIV$USED additional.fields[privused_label].value.string_value Se asigna directamente con la clave privused.
PRIVILEGE principal.user.attribute.permissions.name Se asigna directamente.
RETURN_CODE security_result.summary Se asigna directamente. Se aplica la lógica para derivar security_result.action y security_result.description.
RETURNCODE security_result.summary Se asigna directamente. Se aplica la lógica para derivar security_result.action y security_result.description.
RLS_INFO additional.fields[rls_info_label].value.string_value Se asigna directamente con la clave RLS_INFO.
SCHEMA additional.fields[schema_label].value.string_value Se asigna directamente con la clave schema.
SESSIONCPU target.resource.attribute.labels[SESSIONCPU_label].value Se asigna directamente con la clave SESSIONCPU.
SESSIONID network.session_id Se asigna directamente.
SESID network.session_id Se asigna directamente.
SQL_TEXT target.process.command_line Se asigna directamente.
SQLTEXT target.process.command_line Se asigna directamente.
STATEMENT target.resource.attribute.labels[statement_label].value Se asigna directamente con la clave STATEMENT.
STATUS security_result.summary Se asigna directamente. Se aplica la lógica para derivar security_result.action y security_result.description.
SYSTEM_PRIVILEGE_USED additional.fields[system_privilege_used_label].value.string_value Se asigna directamente con la clave SYSTEM_PRIVILEGE_USED.
TARGET_USER additional.fields[target_user_label].value.string_value Se asigna directamente con la clave TARGET_USER.
TERMINAL additional.fields[CLIENT_TERMINAL_label].value Se asigna directamente con la clave CLIENT_TERMINAL.
TYPE additional.fields[type_label].value.string_value Se asigna directamente con la clave type.
USERHOST principal.hostname, principal.administrative_domain El nombre de host y el dominio se extraen con patrones de Grok.
USERID principal.user.userid Se asigna directamente.
device_host_name target.hostname Se asigna directamente.
event_name metadata.product_event_type Se asigna directamente después de convertir a mayúsculas.
file_name target.file.full_path Se asigna directamente.
hostname principal.hostname Se asigna directamente.
length additional.fields[length_label].value.string_value Se asigna directamente con la clave length.
log_source_name principal.application Se asigna directamente.
message Varios Se usa para el análisis de Grok y para extraer varios campos.
returncode RETURNCODE Se asigna directamente.
src_ip principal.ip Se asigna directamente.
t_hostname target.hostname Se asigna directamente.
(Lógica del analizador) metadata.vendor_name Se codificó como Oracle.
(Lógica del analizador) metadata.product_name Se codificó como Oracle DB.
(Lógica del analizador) metadata.event_type Se determina según los valores de ACTION, ACTION_NUMBER, source_event, OSUSERID, USERID, SQLTEXT, AUTHENTICATION_TYPE, DBUSERNAME, device_host_name y database_name. El valor predeterminado es USER_RESOURCE_ACCESS si no se cumple ninguna condición específica.
(Lógica del analizador) metadata.product_event_type Se determina según los valores de ACTION, ACTION_NUMBER, source_event, p_event_type y ACTION_NAME.
(Lógica del analizador) metadata.log_type Se codificó como ORACLE_DB.
(Lógica del analizador) extensions.auth.mechanism Se establece en USERNAME_PASSWORD en ciertas condiciones según ACTION, ACTION_NUMBER, source_event y OSUSERID.
(Lógica del analizador) extensions.auth.type Se establece en AUTHTYPE_UNSPECIFIED en ciertas condiciones según ACTION, ACTION_NUMBER y AUTHENTICATION_TYPE.
(Lógica del analizador) security_result.description Se deriva de RETURNCODE o STATUS.
(Lógica del analizador) security_result.action Se deriva de RETURNCODE o STATUS.
(Lógica del analizador) target.resource.attribute.labels Se agregan varias etiquetas según la presencia y los valores de varios campos de registro.
(Lógica del analizador) additional.fields Se agregan varios campos como pares clave-valor según la presencia y los valores de varios campos de registro.
(Lógica del analizador) intermediary Se crea y se completa en función de la presencia y los valores de DBPROXY_USERRNAME y CLIENT_ADDRESS.
(Lógica del analizador) network.ip_protocol Se deriva de protocol extraído de CLIENT_ADDRESS con un archivo de inclusión parse_ip_protocol.include.

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.