Recopila registros de ForgeRock OpenAM

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

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

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

Instala el agente de Bindplane en tu sistema operativo Windows o Linux según las siguientes instrucciones.

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: 'OPENAM'
               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
  

Configura el registro de auditorías en Forgerock OpenAM

1. Accede a la consola de AM.
2. Ve 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 lista de entidades permitidas de campos y Filtros de lista de bloqueo de campos, ingresa los valores que se incluirán (lista de entidades permitidas) o excluirán (lista de bloqueo) de los registros de eventos de auditoría.
5. Haz clic en Guardar.

Configura controladores de Syslog para Forgerock OpenAM

1. Accede a la consola de AM como administrador, por ejemplo, amAdmin.
2. Para crear el controlador de eventos en la configuración global, ve a Configurar > Servicios globales > Registro de auditoría.
3. Para crear el controlador de eventos en un dominio, ve a Dominios > Nombre del dominio > Servicios > Registro de auditoría.
4. Haz clic en Add a Secondary Configuration > Syslog.
5. Proporciona los siguientes detalles de configuración:
   • Nombre: Ingresa un nombre para el controlador de eventos (por ejemplo, Google SecOps Syslog Event Handler).
   • Nombre de host del servidor: Ingresa la dirección IP del agente de Bindplane.
   • Puerto del servidor: Ingresa el número de puerto del agente de Bindplane (por ejemplo, 514 para UDP).
   • Transport Protocol: Selecciona UDP.
   • Tiempo de espera de conexión: Ingresa la cantidad de segundos para conectarse (por ejemplo, 120).
   • Opcional: Habilita la opción Almacenamiento en búfer.
6. Haz clic en Crear.
7. Después de crear el controlador de eventos de auditoría de syslog, aparecerán varias pestañas de configuración.
8. En la pestaña General Handler Configuration, selecciona Enabled para activar el controlador de eventos, si está inhabilitado.
9. Selecciona los temas para los registros de auditoría:
   • Acceso
   • Actividad
   • Autenticación
   • Configuración
10. Haz clic en Guardar.
11. En la pestaña Configuración de Syslog, proporciona los siguientes detalles de configuración:
    • Nombre de host del servidor: Ingresa la dirección IP del agente de Bindplane.
    • Puerto del servidor: Ingresa el número de puerto del agente de Bindplane.
    • Tiempo de espera de conexión: Ingresa la cantidad de segundos para conectarse (por ejemplo, 120).
    • Protocolo de transporte: Selecciona UDP.
    • Instalación: Selecciona Local0.
    • Todos los temas establecen la gravedad en INFORMATIONAL.
12. Haz clic en Guardar.

13. En la pestaña Buffering, selecciona Buffering Enabled para activarlo.

14. Haz clic en Guardar.

Tabla de asignación de UDM

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