Recopila registros de Fortinet FortiMail

Compatible con:

En este documento, se explica cómo recopilar registros de Fortinet FortiMail con Bindplane. El analizador extrae pares clave-valor, normaliza varios campos, como marcas de tiempo y direcciones IP, y los asigna a un modelo de datos unificado (UDM) para las Operaciones de seguridad de Google, categorizando el tipo de evento según la información disponible.

Antes de comenzar

  • Asegúrate de tener una instancia de Google Security Operations.
  • Asegúrate de usar Windows 2016 o una versión posterior, o un host de Linux con systemd.
  • Si se ejecuta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos.
  • Asegúrate de tener acceso con privilegios a Fortinet Fortimail.

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

  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 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 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

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 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

Configura el agente de Bindplane para transferir Syslog y enviarlo a Google SecOps

  1. Accede al archivo de configuración:

    1. 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.
    2. 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:

    ```yaml
    receivers:
        udplog:
            # Replace the port and IP address as required
            listen_address: "0.0.0.0:5252"
    
    exporters:
        chronicle/chronicle_w_labels:
            compression: gzip
            # Adjust the path to the credentials file you downloaded in Step 1
            creds: '/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: SYSLOG
                namespace: fortinet_fortimail
                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 Obtén el archivo de autenticación de 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 Services o ingresar el siguiente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configura el syslog de Fortinet FortiMail

  1. Accede a la interfaz web del dispositivo FortiMail.
  2. Selecciona Registro y informe > Configuración de registro > Remoto.
  3. Haz clic en Nuevo para crear una entrada nueva.
  4. En el diálogo que aparece, selecciona Habilitar para permitir el acceso a un host remoto.
  5. Proporciona los siguientes detalles:
    • Nombre: Ingresa un nombre único y significativo.
    • Nombre o IP del servidor: Ingresa la dirección IP de Bindplane.
    • Puerto del servidor: Ingresa el número de puerto UDP de Bindplane.
    • Nivel: Selecciona Información como nivel de gravedad.
    • Instalaciones: Ingresa un identificador de instalaciones único y verifica que ningún otro dispositivo de red use el mismo identificador.
    • Anula la selección del formato CSV.
    • Protocolo de registro: Selecciona Syslog.
    • Configuración de la política de registro: Habilita todos los tipos de eventos o registros que se reenvían.
  6. Haz clic en Crear.

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
authid read_only_udm.target.user.email_addresses Si el campo authid contiene @, asócialo a este campo.
authid read_only_udm.target.user.userid Asigna el campo authid a este campo
algoritmo de cifrado read_only_udm.network.tls.cipher Asigna el campo cipher a este campo
client_ip read_only_udm.principal.ip Asigna el campo client_ip a este campo
client_name read_only_udm.principal.hostname Asigna el campo client_name a este campo
detalle read_only_udm.security_result.summary Asigna el campo detail a este campo
device_id read_only_udm.principal.resource.id Asigna el campo device_id a este campo
devname read_only_udm.principal.resource.name Asigna el campo devname a este campo
direction read_only_udm.network.direction Si el campo direction es igual a out, asigna el valor OUTBOUND. Si el campo direction es igual a in, asigna el valor INBOUND. De lo contrario, asigna el valor UNKNOWN_DIRECTION.
disposition read_only_udm.security_result.detection_fields.value Asigna el campo disposition a este campo cuando el campo de clave sea igual a Disposition.
dominio read_only_udm.principal.administrative_domain Asigna el campo domain a este campo
dst_ip read_only_udm.target.ip Asigna el campo dst_ip a este campo
de read_only_udm.network.email.from Si el campo from contiene @, asócialo a este campo.
log_id read_only_udm.metadata.product_log_id Asigna el campo log_id a este campo
message_id read_only_udm.network.email.mail_id Asigna el campo message_id a este campo
message_length read_only_udm.additional.fields.value.number_value Asigna el campo message_length a este campo cuando el campo clave sea igual a message_length
msg read_only_udm.security_result.description Asigna el campo msg a este campo
polid read_only_udm.security_result.detection_fields.value Asigna el campo polid a este campo cuando el campo clave sea igual a Polid.
retransmisión read_only_udm.intermediary.ip Asigna el campo relay a este campo
resuelto read_only_udm.security_result.detection_fields.value Asigna el campo resolved a este campo cuando el campo de clave sea igual a Resolved.
session_id read_only_udm.network.session_id Asigna el campo session_id a este campo
src_type read_only_udm.additional.fields.value.string_value Asigna el campo src_type a este campo cuando el campo clave sea igual a src_type
stat read_only_udm.metadata.description Asigna el campo stat a este campo
asunto read_only_udm.network.email.subject Asigna el campo subject a este campo
a read_only_udm.network.email.to Si el campo to contiene @, asócialo a este campo.
usuario read_only_udm.principal.user.userid Asigna el campo user a este campo
N/A read_only_udm.extensions.auth.mechanism El valor de este campo está codificado en el código del analizador como USERNAME_PASSWORD cuando existe el campo authid.
N/A read_only_udm.extensions.auth.type El valor de este campo está codificado en el código del analizador como AUTHTYPE_UNSPECIFIED cuando existe el campo authid.
N/A read_only_udm.metadata.event_type El valor de este campo se determina según la lógica del analizador en función de una combinación de campos disponibles. Si existe el campo from, el valor es EMAIL_TRANSACTION; de lo contrario, si existe el campo to, el valor es EMAIL_UNCATEGORIZED; de lo contrario, si existen los campos client_ip y dst_ip, el valor es NETWORK_CONNECTION; de lo contrario, si existe el campo authid, el valor es USER_LOGIN; de lo contrario, si existe el campo user, el valor es USER_UNCATEGORIZED; de lo contrario, si existe el campo client_ip, el valor es STATUS_UPDATE; de lo contrario, el valor es GENERIC_EVENT.
N/A read_only_udm.metadata.log_type El valor de este campo está codificado en el código del analizador como FORTINET_FORTIMAIL.
N/A read_only_udm.metadata.product_name El valor de este campo está codificado en el código del analizador como FORTINET_FORTIMAIL.
N/A read_only_udm.metadata.vendor_name El valor de este campo está codificado en el código del analizador como FORTINET.
N/A read_only_udm.principal.resource.resource_type El valor de este campo está codificado en el código del analizador como DEVICE.

Cambios

2023-09-06

Mejora:

  • Se agregó un patrón Grok para extraer los datos y analizar los registros de KV que fallan.

2023-05-23

  • Es un analizador creado recientemente.

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