Recoger registros de Fortinet FortiMail

Disponible en:

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

Antes de empezar

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

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

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

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

  1. Accede al archivo de configuración:

    1. 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.
    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. 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 syslog de Fortinet FortiMail

  1. Inicia sesión en la interfaz web del dispositivo FortiMail.
  2. Selecciona Registro e informe > Configuración de registro > Remoto.
  3. Haz clic en Nueva para crear una entrada.
  4. En el cuadro de diálogo que aparece, selecciona Habilitar para permitir el registro en un host remoto.
  5. Proporcione los siguientes datos:
    • Nombre: introduce un nombre único y descriptivo.
    • Nombre de servidor o IP: introduce la dirección IP de Bindplane.
    • Puerto del servidor: introduce el número de puerto UDP de Bindplane.
    • Nivel: selecciona Información como nivel de gravedad.
    • Instalación: introduce un identificador de instalación único y comprueba que ningún otro dispositivo de red use el mismo identificador.
    • Desmarca el formato CSV.
    • Protocolo de registro: selecciona Syslog.
    • Configuración de la política de registro: habilita el reenvío de todos los tipos de eventos o registros.
  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 @, asigna este campo
authid read_only_udm.target.user.userid Asignar el campo authid a este campo
cifrado read_only_udm.network.tls.cipher Asignar el campo cipher a este campo
client_ip read_only_udm.principal.ip Asignar el campo client_ip a este campo
client_name read_only_udm.principal.hostname Asignar el campo client_name a este campo
detail read_only_udm.security_result.summary Asignar el campo detail a este campo
device_id read_only_udm.principal.resource.id Asignar el campo device_id a este campo
devname read_only_udm.principal.resource.name Asignar 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.
disposición read_only_udm.security_result.detection_fields.value Asigna el campo disposition a este campo cuando el campo clave sea igual a Disposition.
dominio read_only_udm.principal.administrative_domain Asignar el campo domain a este campo
dst_ip read_only_udm.target.ip Asignar el campo dst_ip a este campo
de read_only_udm.network.email.from Si el campo from contiene @, asigna este campo
log_id read_only_udm.metadata.product_log_id Asignar el campo log_id a este campo
message_id read_only_udm.network.email.mail_id Asignar 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 Asignar 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.
relay read_only_udm.intermediary.ip Asignar 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 clave sea igual a Resolved.
session_id read_only_udm.network.session_id Asignar 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 Asignar el campo stat a este campo
subject read_only_udm.network.email.subject Asignar el campo subject a este campo
a read_only_udm.network.email.to Si el campo to contiene @, asigna este campo
usuario read_only_udm.principal.user.userid Asignar 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 mediante la lógica del analizador en función de una combinación de los campos disponibles. Si existe el campo from, el valor es EMAIL_TRANSACTION. Si existe el campo to, el valor es EMAIL_UNCATEGORIZED. Si existen los campos client_ip y dst_ip, el valor es NETWORK_CONNECTION. Si existe el campo authid, el valor es USER_LOGIN. Si existe el campo user, el valor es USER_UNCATEGORIZED. 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.

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