Recopila registros de Forcepoint Email Security

Versión del analizador: 2.0

Compatible con:

Google SecOps SIEM

En este documento, se explica cómo ingerir registros de Forcepoint Email Security en Google Security Operations con BindPlane. Primero, el analizador extrae campos de los registros con formato JSON y, luego, inicializa algunos campos de UDM con valores vacíos. Luego, asigna los campos extraídos a sus campos correspondientes dentro de la estructura de UDM de Chronicle en función de condiciones específicas y manipulaciones de datos, lo que, en última instancia, crea una representación unificada del evento de seguridad del correo electrónico.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

• Una instancia de Google SecOps
• Un host de Windows 2016 o versiones posteriores, o de Linux con systemd
• 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 con privilegios al dispositivo o a la consola de administración de Forcepoint Email Security

Obtén las credenciales de Google SecOps para el agente de Bindplane

Para autenticar el agente de Bindplane en Google SecOps, elige uno de los siguientes métodos:

• Implementaciones nuevas: Usa la API de Chronicle (opción 1).
• Implementaciones heredadas: Continúa usando el archivo de autenticación de ingesta (opción 2) hasta que se descontinúe la API de Ingestion el 20 de julio de 2027.

Opción 1: Crea una cuenta de servicio para la API de Chronicle (recomendada)

1. Accede a la Google Cloud consola y selecciona el Google Cloud proyecto vinculado a tu instancia de Google SecOps.
2. Ve a IAM y administración > Cuentas de servicio.
3. Haz clic en Crear cuenta de servicio.
4. Proporciona los siguientes detalles de configuración:
   • Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo, bindplane-ingest).
   • Descripción de la cuenta de servicio: Ingresa una descripción (por ejemplo, Bindplane agent log ingestion).
5. Haz clic en Crear y continuar.
6. En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y selecciona Editor de Chronicle.
7. Haz clic en Continuar y, luego, en Listo.
8. Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
9. Haz clic en Agregar clave > Crear clave nueva.
10. Selecciona JSON y haz clic en Crear. El archivo de claves se descarga en tu computadora.
11. Guarda el archivo de claves como ingestion-auth.json en el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.json en Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json en Windows) o actualiza creds_file_path en config.yaml para que coincida con la ruta de acceso en la que lo guardas.
12. Ve a IAM y administración > Configuración y copia el Número de proyecto. Lo necesitarás para la configuración del exportador.

Nota: La clave JSON es una credencial. Restringe el acceso al archivo en el host de Bindplane y rota la clave según la política de tu organización.

Opción 2: Descarga el archivo de autenticación de ingesta (heredado)

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

Nota: Este archivo autentica el agente en la API de Ingestion heredada (malachiteingestion-pa.googleapis.com), que Google programó para el final de su ciclo de vida el 20 de julio de 2027. Planifica cambiar a la opción 1 antes de esa fecha.

Obtén el ID de cliente de Google SecOps

1. Accede a 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.

Instala el agente de BindPlane

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

Instalación de 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 de Linux

1. Abre una terminal con privilegios 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 opciones de instalación adicionales, consulta esta guía de instalación.
• Alternativa: También puedes usar el flujo de trabajo de instalación administrada de BindPlane OP para la administración centralizada de agentes.

Nota: La configuración del exportador de la API de Chronicle requiere el recopilador de Bindplane v1.106.0 o versiones posteriores. Los comandos anteriores instalan la versión más reciente. Si actualizas una instalación existente, actualiza el recopilador antes de cambiar la configuración.

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

1. Accede al archivo de configuración:

   • Busca el archivo config.yaml. Por lo general, se encuentra en el directorio /opt/observiq-otel-collector/ en Linux o en el directorio de instalación en Windows.
   • Abre el archivo con un editor de texto (por ejemplo, nano, vi o el 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:
       protocol: https
       # Region of your instance, for example us, europe, asia-southeast1
       location: <LOCATION>
       # Project number of the Google Cloud project linked to the instance
       project: '<PROJECT_NUMBER>'
       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: chronicle.googleapis.com
       # Add optional ingestion labels for better organization
       log_type: 'FORCEPOINT_EMAILSECURITY'
       raw_log_field: body
       ingestion_labels:
   
   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 <LOCATION> por la región de tu instancia de Google SecOps (por ejemplo, us, europe, o asia-southeast1). El exportador antepone chronicle.googleapis.com con este valor.

5. Reemplaza <PROJECT_NUMBER> por el número de proyecto de IAM y administración > Configuración.

6. Reemplaza <CUSTOMER_ID> por el ID de cliente real.

7. Actualiza /path/to/ingestion-authentication-file.json a la ruta de acceso del archivo en la que se guardó el archivo de claves de la cuenta de servicio (opción 1) en el paso 1.

Exportador de la API de Ingestion heredada

• Si usas el archivo de autenticación de ingesta de la opción 2, reemplaza el bloque exporters por lo siguiente. Establece creds_file_path en la ruta de acceso al archivo de autenticación de ingesta y, si tu instancia está fuera de EE.UU., reemplaza malachiteingestion-pa.googleapis.com por tu extremo regional (por ejemplo, europe-malachiteingestion-pa.googleapis.com).

  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
      log_type: 'FORCEPOINT_EMAILSECURITY'
      raw_log_field: body
      ingestion_labels:
  

Nota: Este exportador dejará de funcionar cuando se descontinúe la API de Ingestion el 20 de julio de 2027.

Reinicia el agente de BindPlane para aplicar los cambios

1. Para reiniciar el agente de BindPlane en Linux, ejecuta el siguiente comando:

   sudo systemctl restart observiq-otel-collector
   

2. Para reiniciar el agente de BindPlane en Windows, puedes usar la consola de Servicios o ingresar el siguiente comando:

   net stop observiq-otel-collector && net start observiq-otel-collector
   

Configura el reenvío de Syslog en Forcepoint Email Security

1. Accede a la consola de administración de Forcepoint Email Security.
2. Ve a Configuración > Integraciones > Integración de SIEM.
3. Haz clic en Habilitar la integración de SIEM.

4. Proporciona los siguientes detalles de configuración:

   • Formato: Selecciona LEEF (formato extendido de eventos de registro).
   • Servidor Syslog: Ingresa la dirección IP del agente de BindPlane.
   • Puerto Syslog: Ingresa el número de puerto del agente de BindPlane (por ejemplo, 514).
   • Protocolo: Selecciona UDP o TCP, según la configuración real del agente de BindPlane.
   • Facility: Selecciona el código de instalación de Syslog (por ejemplo, Local0).
   • Gravedad: Selecciona el nivel de gravedad para los eventos de registro.

5. Haz clic en Guardar.

Tabla de asignación de UDM

Campo de registro	Asignación de UDM	Lógica
Acción	security_result.action_details	Se asigna directamente desde el campo "Action" en el registro sin procesar.
AttachmentFilename	additional.fields.value.list_value.values.string_value (clave: Attachments_FileNames)	El campo "AttachmentFilename" se divide por comas y, luego, cada valor se agrega como string_value al array "additional.fields" con la clave "Attachments_FileNames".
AttachmentFileType	additional.fields.value.list_value.values.string_value (clave: AttachmentsFileType)	El campo "AttachmentFileType" se divide por comas y, luego, cada valor se agrega como string_value al array "additional.fields" con la clave "AttachmentsFileType".
AttachmentSize	additional.fields.value.list_value.values.string_value (clave: AttachmentsSize)	El campo "AttachmentSize" se divide por comas y, luego, cada valor se agrega como string_value al array "additional.fields" con la clave "AttachmentsSize".
DateTime		No se asigna en el UDM proporcionado.
EnvelopeSender	network.email.from	Se asigna directamente desde el campo "EnvelopeSender" en el registro sin procesar.
EventReceivedTime	metadata.event_timestamp	Se analiza en un formato de marca de tiempo y se asigna a "metadata.event_timestamp".
FilteringReason	security_result.category_details	Se asigna directamente desde el campo "FilteringReason" en el registro sin procesar.
MessageSandboxing	security_result.detection_fields.value (clave: MessageSandboxing)	Se asigna directamente desde el campo "MessageSandboxing" en el registro sin procesar y se agrega como un par clave-valor al array "security_result.detection_fields".
MessageSize	security_result.detection_fields.value (clave: MessageSize)	Se asigna directamente desde el campo "MessageSize" en el registro sin procesar y se agrega como un par clave-valor al array "security_result.detection_fields".
nxlog_filename	additional.fields.value.string_value (clave: nxlog_filename)	Se asigna directamente desde el campo "nxlog_filename" en el registro sin procesar y se agrega como un par clave-valor al array "additional.fields".
RecipientAddress	network.email.to	Se asigna directamente desde el campo "RecipientAddress" en el registro sin procesar.
SenderIP	principal.asset.ip, principal.ip	Se asigna directamente desde el campo "SenderIP" en el registro sin procesar.
SenderIPCountry	principal.location.country_or_region	Se asigna directamente desde el campo "SenderIPCountry" en el registro sin procesar.
SourceModuleName	principal.resource.attribute.labels.value (clave: SourceModuleName)	Se asigna directamente desde el campo "SourceModuleName" en el registro sin procesar y se agrega como un par clave-valor al array "principal.resource.attribute.labels".
SourceModuleType	principal.resource.attribute.labels.value (clave: SourceModuleType)	Se asigna directamente desde el campo "SourceModuleType" en el registro sin procesar y se agrega como un par clave-valor al array "principal.resource.attribute.labels".
SpamScore	security_result.detection_fields.value (clave: SpamScore)	Se asigna directamente desde el campo "SpamScore" en el registro sin procesar y se agrega como un par clave-valor al array "security_result.detection_fields".
Asunto	network.email.subject	Se asigna directamente desde el campo "Subject" en el registro sin procesar.
VirusName	security_result.detection_fields.value (clave: VirusName)	Se asigna directamente desde el campo "VirusName" en el registro sin procesar y se agrega como un par clave-valor al array "security_result.detection_fields".
	metadata.event_type	El valor se determina en función de la presencia de otros campos. Si "has_network_email_data" es verdadero, el valor se establece en "EMAIL_TRANSACTION". Si "has_principal" es verdadero, el valor se establece en "STATUS_UPDATE". De lo contrario, el valor predeterminado es "GENERIC_EVENT".
	metadata.product_name	El valor se establece en "FORCEPOINT EMAILSECURITY".
	metadata.vendor_name	El valor se establece en "FORCEPOINT EMAILSECURITY".

Registro de cambios

Consulta el registro de cambios de este analizador

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