Recoger registros de ForgeRock OpenAM

En este documento se explica cómo ingerir registros de ForgeRock OpenAM en Google Security Operations mediante Bindplane. El analizador extrae campos de los registros en formato CSV, Syslog + KV o JSON, los normaliza y los asigna al modelo de datos unificado (UDM). Gestiona varios tipos de eventos de OpenAM, como inicios y cierres de sesión, resultados de acceso y registros generales, y enriquece los datos con información de usuarios, grupos y redes. Además, realiza transformaciones específicas para diferentes formatos de registro y tipos de eventos. El analizador prioriza el análisis JSON, luego recurre a Syslog+KV y, por último, a CSV, descartando los registros de formatos no admitidos.

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 a Forgerock OpenAM (por ejemplo, amAdmin)

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 Bindplane

Instala el agente de Bindplane en tu sistema operativo Windows o Linux siguiendo las instrucciones que se indican a continuación.

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_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: 'OPENAM'
               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 el registro de auditoría en Forgerock OpenAM

1. Inicia sesión en la consola AM.
2. Vaya a Configurar > Servicios globales > Registro de auditoría.
3. Activa el registro de auditoría para iniciar la función.
4. En las listas Filtros de campos permitidos y Filtros de campos bloqueados, introduzca los valores que quiera incluir (lista de permitidos) o excluir (lista de bloqueados) de los registros de eventos de auditoría.
5. Haz clic en Guardar.

Configurar controladores Syslog para Forgerock OpenAM

1. Inicia sesión en la consola de AM como administrador (por ejemplo, amAdmin).
2. Para crear el controlador de eventos en la configuración global, vaya a Configurar > Servicios globales > Registro de auditoría.
3. Para crear el controlador de eventos en un realm, ve a Realms > Nombre del realm > Servicios > Registro de auditoría.
4. Haga clic en Añadir una configuración secundaria > Syslog.
5. Proporcione los siguientes detalles de configuración:
   • Nombre: introduce un nombre para el controlador de eventos (por ejemplo, Google SecOps Syslog Event Handler).
   • Nombre de host del servidor: introduce la dirección IP del agente de Bindplane.
   • Puerto del servidor: introduce el número de puerto del agente de Bindplane (por ejemplo, 514 para UDP).
   • Protocolo de transporte: selecciona UDP.
   • Tiempo de espera de conexión: introduce el número de segundos que se debe esperar para conectarse (por ejemplo, 120).
   • Opcional: Habilita la opción Búfer.
6. Haz clic en Crear.
7. Una vez creado el controlador de eventos de auditoría de syslog, aparecen varias pestañas de configuración.
8. En la pestaña General Handler Configuration (Configuración general del controlador), selecciona Enabled (Habilitado) para activar el controlador de eventos, si está inhabilitado.
9. Selecciona los temas de los registros de auditoría:
   • Acceso
   • Actividad
   • Autenticación
   • Configuración
10. Haz clic en Guardar.
11. En la pestaña Syslog Configuration (Configuración de Syslog), proporcione los siguientes detalles de configuración:
    • Nombre de host del servidor: introduce la dirección IP del agente de Bindplane.
    • Puerto del servidor: introduce el número de puerto del agente de Bindplane.
    • Tiempo de espera de conexión: introduce el número de segundos que se debe esperar para conectarse (por ejemplo, 120).
    • Protocolo de transporte: selecciona UDP.
    • Instalación: selecciona Local0.
    • En todos los temas, la gravedad es INFORMATIVA.
12. Haz clic en Guardar.

13. En la pestaña Almacenamiento en búfer, selecciona Almacenamiento en búfer habilitado para activarlo.

14. Haz clic en Guardar.

Tabla de asignación de UDM

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