Recopila registros de la base de datos de Oracle
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
- Accede a la consola de Google SecOps.
- Ve a SIEM Settings > Collection Agents.
- 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
- Accede a la consola de Google SecOps.
- Ve a SIEM Settings > Profile.
- 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
- 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 en Linux
- Abre una terminal con privilegios de raíz 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 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
- 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).
- Ubica el archivo
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
Reemplaza el puerto y la dirección IP según sea necesario en tu infraestructura.
Reemplaza
<customer_id>
por el ID de cliente real.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
- Conéctate a la base de datos de Oracle con SQL*Plus.
Cierra la base de datos con el siguiente comando:
shutdown immediate
Para detener el servicio de escucha de Oracle, escribe el siguiente comando:
lsnrctl stop
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
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
Conéctate a la base de datos de Oracle con SQL*Plus.
Reinicia la base de datos con el siguiente comando:
startup
Reinicia el servicio de escucha de Oracle con el siguiente comando:
lsnrctl start
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
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';
Verifica que el comando devuelva una fila con el valor VALUE igual a "TRUE".
Configura Syslog para la base de datos de Oracle
- Accede a la instancia de Oracle.
Abre el siguiente archivo con
vi
:vi ${ORACLE_HOME}/dbs/init${ORACLE_SID}.ora
Ingresa los siguientes comandos para la configuración de syslog:
*.audit_trail='os' *.audit_syslog_level='local0.info'
Asegúrate de que el daemon syslog en el host de Oracle esté configurado para reenviar el registro de auditoría.
En Red Hat Enterprise, abre el siguiente archivo
/etc/syslog.conf
convi
y, luego, ingresa la siguiente línea:local0.info @ <bindplane-ip>:514
Guarda y sal del archivo:
:wq
En Red Hat Enterprise, escribe el siguiente comando para volver a cargar la configuración de syslog:
kill -HUP /var/run/syslogd.pid
Conéctate a SQLplus y accede como sysdba para reiniciar:
sys as sysdba
Cierra la base de datos con el siguiente comando:
shutdown immediate
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.