Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Recopila registros de IBM CICS

Se admite en los siguientes sistemas operativos:

Google SecOps SIEM

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

IBM CICS (Customer Information Control System) es una plataforma de procesamiento de transacciones para aplicaciones de mainframe. Genera registros de auditoría para la ejecución de transacciones, el acceso a recursos, las violaciones de seguridad y los eventos del sistema. Los registros usan el formato LEEF y capturan la identidad del usuario, los detalles de la transacción y los atributos de la red de origen.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

Una instancia de Google SecOps
Windows Server 2016 o versiones posteriores, o host de Linux con systemd
Conectividad de red entre el agente de Bindplane y el host del reenviador de registros de CICS
Si se ejecuta detrás de un proxy, asegúrate de que los puertos de firewall estén abiertos según los requisitos del agente de Bindplane.
Acceso privilegiado a la región de IBM CICS o al sistema de mainframe con autoridad para configurar el registro de SMF y la exportación de registros

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

Accede a la consola de Google SecOps.
Ve a Configuración de SIEM > Agentes de recopilación.
Descarga el archivo de autenticación de transferencia.
Guarda el archivo de forma segura en el sistema en el que se instalará Bindplane.

Nota: Este archivo JSON contiene credenciales para autenticar el agente de Bindplane en Google SecOps.

Obtén el ID de cliente de Google SecOps

Accede a la consola de Google SecOps.
Ve a Configuración de SIEM > Perfil.
Copia y guarda el ID de cliente de la sección Detalles de la organización.

Nota: Se requiere el ID del cliente para configurar el exportador del agente de Bindplane.

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

Abre el símbolo del sistema o PowerShell como administrador.

Ejecuta el comando siguiente:

msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet

Espera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
```
sc query observiq-otel-collector
```
El servicio debe mostrarse como RUNNING.

Instalación en Linux

Abre una terminal con privilegios de raíz o sudo.

Ejecuta el comando siguiente:

sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh

Espera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
```
sudo systemctl status observiq-otel-collector
```
El servicio debería mostrarse como activo (en ejecución).

Recursos de instalación adicionales

Para obtener más opciones de instalación y solucionar problemas, consulta la guía de instalación del agente de Bindplane.

Configura el agente de BindPlane para transferir el registro del sistema 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:
    tcplog:
        listen_address: "0.0.0.0:514"

exporters:
    chronicle/ibm_cics:
        compression: gzip
        creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
        customer_id: '<customer_id>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: IBM_CICS
        raw_log_field: body
        ingestion_labels:
            env: production

service:
    pipelines:
        logs/cics_to_chronicle:
            receivers:
                - tcplog
            exporters:
                - chronicle/ibm_cics

Parámetros de configuración

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

Configuración del receptor:
- tcplog: Es el tipo de receptor según el protocolo:
  - udplog para Syslog a través de UDP
  - tcplog para el registro del sistema TCP
- 0.0.0.0: Dirección IP en la que se realizará la escucha:
  - 0.0.0.0 para escuchar en todas las interfaces (recomendado)
  - Dirección IP específica para escuchar en una interfaz
- 514: Número de puerto en el que se debe escuchar (por ejemplo, 514, 1514, 6514)
Configuración del exportador:
- ibm_cics: Nombre descriptivo del exportador
- creds_file_path: Ruta de acceso completa al archivo de autenticación de la transferencia:
  - Linux: /etc/bindplane-agent/ingestion-auth.json
  - Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- <customer_id>: ID del cliente del paso anterior
- endpoint: URL del endpoint regional:
  - EE.UU.: malachiteingestion-pa.googleapis.com
  - Europa: europe-malachiteingestion-pa.googleapis.com
  - Asia: asia-southeast1-malachiteingestion-pa.googleapis.com
  - Consulta Extremos regionales para obtener la lista completa.
- IBM_CICS: Tipo de registro tal como aparece en Chronicle
- ingestion_labels: Etiquetas opcionales en formato YAML (por ejemplo, env: production)
Configuración de la canalización:
- cics_to_chronicle: Nombre descriptivo de la canalización

Cómo guardar el archivo de configuración

Después de editarlo, guarda el archivo:
- Linux: Presiona Ctrl+O, luego Enter y, después, 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 CICS

IBM CICS escribe datos de auditoría y transacciones en registros de SMF (System Management Facilities) en el mainframe. Para reenviar estos registros al agente de Bindplane con syslog, usa un reenviador de syslog en un host de middleware.

Identifica los tipos de registros de SMF que contienen datos de CICS (por lo general, el tipo 110 de SMF).
Usa una utilidad de mainframe, como DFHSTUP (programa de utilidad de estadísticas de CICS) o programas de volcado de SMF, para extraer los registros pertinentes.
Convierte los registros de SMF extraídos al formato LEEF con IBM CICS Performance Analyzer, una secuencia de comandos REXX personalizada o una solución de ETL de terceros.
Configura el reenviador de syslog en el host de middleware para enviar los registros convertidos al agente de Bindplane:
- Servidor Syslog: Ingresa la dirección IP del host del agente de BindPlane (por ejemplo, 192.168.1.100).
- Puerto: Ingresa 514 (debe coincidir con el puerto del receptor del agente de BindPlane).
- Protocolo: Selecciona TCP (recomendado para la entrega confiable de registros de mainframe).
- Formato: Asegúrate de usar el formato LEEF.
Verifica que se reciban los mensajes de syslog consultando los registros del agente de Bindplane.

Nota: Debido a que CICS se ejecuta en computadoras centrales de z/OS, la salida directa de syslog no está disponible de forma nativa. Debes usar un retransmisor de middleware (por ejemplo, el daemon syslog del servidor de comunicaciones de IBM z/OS o un transportador de registros de terceros) para retransmitir los datos de auditoría de CICS en formato LEEF al agente de Bindplane.

Tabla de asignación de UDM

Campo de registro	Asignación de UDM	Lógica
`kv.sum`	`metadata.description`	Se cambió el nombre o se asignó
`kv.devTime`	`metadata.event_timestamp`	Se analizó como `yyyy-MM-ddTHH:mm:ss.SSSZ`
`event_type`	`metadata.product_event_type`	Se cambió el nombre o se asignó
`version`	`metadata.product_version`	Se cambió el nombre o se asignó
`kv.terminal`	`principal.hostname`	Asignada directamente
`kv.src`	`principal.ip`	Combinado
`firstname`	`principal.user.first_name`	Se cambió el nombre o se asignó
`lastname`	`principal.user.last_name`	Se cambió el nombre o se asignó
`kv.name`	`principal.user.user_display_name`	Se cambió el nombre o se asignó
`kv.usrName`	`principal.user.userid`	Se cambió el nombre o se asignó
`kv.appl`	`target.application`	Se cambió el nombre o se asignó
`kv.tran`	`target.process.product_specific_process_id`	Asignada directamente
N/A	`metadata.event_type`	Constante: `PROCESS_UNCATEGORIZED`
N/A	`metadata.product_name`	Constante: `CICS`
N/A	`metadata.vendor_name`	Constante: `IBM`

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