Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Recopila registros de Fortinet Switch

Versión del analizador: 1.0

Compatible con:

Google SecOps SIEM

En esta guía, se explica cómo transferir registros de Fortinet Switch a Google Security Operations con el agente de Bindplane.

Fortinet Switch es una línea de conmutadores Ethernet seguros y de alto rendimiento diseñados para redes empresariales. FortiSwitch proporciona capacidades de conmutación de capa 2 y capa 3, compatibilidad con VLAN, agregación de vínculos, alimentación a través de Ethernet (PoE) y funciones de seguridad integradas. Las unidades de FortiSwitch pueden funcionar en modo independiente o administrarse con firewalls de FortiGate a través de FortiLink.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

Instancia de Google SecOps.
Windows Server 2016 o posterior, o un host de Linux con systemd.
Conectividad de red entre el agente de Bindplane y el switch de Fortinet
Si se ejecuta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos según los requisitos del agente de Bindplane.
Acceso con privilegios a la consola de administración de Fortinet Switch o a la consola de FortiGate (para switches administrados)
Switch de Fortinet que ejecuta FortiSwitchOS 7.0 o una versión posterior

Obtén 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: Sigue usando el archivo de autenticación de transferencia (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 (recomendado)

Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
Ve a IAM y administración > Cuentas de servicio.
Haga clic en Crear cuenta de servicio.
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).
Haz clic en Crear y continuar.
En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y elige Editor de Chronicle.
Haz clic en Continuar y, luego, en Listo.
Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
Haz clic en Agregar clave > Crear clave nueva.
Selecciona JSON y haz clic en Crear. El archivo de claves se descargará en tu computadora.
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.
Ve a IAM y administración > Configuración y copia el Número de proyecto. Lo necesitarás para la configuración del exportador.

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

Accede a la consola de Google SecOps.
Ve a Configuración > Administración de datos > Agentes de recopilación. Si estás en una plataforma solo de SIEM, ve a Configuración > Agentes de recopilación.
Descarga el archivo de autenticación de transferencia.
Guarda el archivo de forma segura en el sistema en el que se instalará el agente de Bindplane.

Obtén el ID de cliente de Google SecOps

Accede a la consola de Google SecOps.
Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > Perfil.
Copia y guarda el ID de cliente de la sección Detalles de la organización.

Nota: El ID de cliente es obligatorio para configurar el exportador del agente de Bindplane.

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

Abre el símbolo del sistema o PowerShell como administrador.

Ejecuta el comando siguiente:

msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet

Espera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
```
sc query observiq-otel-collector
```
El servicio debería mostrarse como RUNNING.

Instalación en Linux

Abre una terminal con privilegios de raíz o sudo.

Ejecuta el comando siguiente:

sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh

Espera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
```
sudo systemctl status observiq-otel-collector
```
El servicio debería mostrarse como active (running).

Recursos de instalación adicionales

Para obtener más opciones de instalación y solución de problemas, consulta la guía de instalación del agente de Bindplane.

Configura el agente de BindPlane para transferir syslog y enviarlo a Google SecOps

Ubica el archivo de configuración

Linux:

sudo nano /opt/observiq-otel-collector/config.yaml

Windows:

notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"

Edita el archivo de configuración

Reemplaza todo el contenido de config.yaml por la siguiente configuración:

receivers:
  udplog:
    listen_address: "0.0.0.0:514"

exporters:
  chronicle/fortiswitch:
    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
    creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
    customer_id: 'YOUR_CUSTOMER_ID'
    endpoint: chronicle.googleapis.com
    log_type: FORTINET_SWITCH
    raw_log_field: body
    ingestion_labels:
      env: production

service:
  pipelines:
    logs/fortiswitch_to_chronicle:
      receivers:
        - udplog
      exporters:
        - chronicle/fortiswitch

Parámetros de configuración

Reemplaza los marcadores de posición que se indican más abajo:

Configuración del receptor:

El receptor está configurado para escuchar en el puerto UDP 514 los mensajes de syslog del switch de Fortinet.
Para escuchar en todas las interfaces, usa 0.0.0.0:514.
Para usar un puerto sin privilegios en Linux, cambia a 0.0.0.0:1514 y configura el switch de Fortinet para que envíe al puerto 1514.

Configuración del exportador:

creds_file_path: Ruta de acceso completa al archivo de claves JSON de la cuenta de servicio (opción 1):
- Linux: /opt/observiq-otel-collector/ingestion-auth.json
- Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
customer_id: Es el ID de cliente del paso anterior.
location: Reemplaza <LOCATION> por la región de tu instancia de Google SecOps (por ejemplo, us, europe o asia-southeast1). El exportador agrega el prefijo chronicle.googleapis.com con este valor. Consulta Extremos regionales para obtener la lista completa.
project: Reemplaza <PROJECT_NUMBER> por el número de proyecto de IAM y administración > Configuración.
endpoint: Mantén la configuración como chronicle.googleapis.com.
log_type: Debe ser exactamente FORTINET_SWITCH.
ingestion_labels: Son etiquetas opcionales en formato YAML (por ejemplo, env: production).

Exportador de la API de transferencia heredada

Si usas el archivo de autenticación de transferencia 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 transferencia 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/fortiswitch:
    compression: gzip
    creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
    customer_id: 'YOUR_CUSTOMER_ID'
    endpoint: malachiteingestion-pa.googleapis.com
    log_type: FORTINET_SWITCH
    raw_log_field: body
    ingestion_labels:
      env: production
```

Guarda el archivo de configuración

Después de editarlo, guarda el archivo:

Linux: Presiona Ctrl+O, luego Enter y, por último, Ctrl+X.
Windows: Haz clic en Archivo > Guardar.

Reinicia el agente de Bindplane para aplicar los cambios

Linux

sudo systemctl restart observiq-otel-collector

Verifica que el servicio esté en ejecución:

sudo systemctl status observiq-otel-collector

Revisa los registros en busca de errores:

sudo journalctl -u observiq-otel-collector -f

Windows

Elige una de las siguientes opciones:
- Usa el símbolo del sistema o PowerShell como administrador:
```
net stop observiq-otel-collector && net start observiq-otel-collector
```
- Usa la consola de Servicios:
  1. Presiona Win+R, escribe services.msc y presiona Intro.
  2. Busca observIQ OpenTelemetry Collector.
  3. Haz clic con el botón derecho y selecciona Reiniciar.
  4. Verifica que el servicio esté en ejecución:
```
sc query observiq-otel-collector
```
  5. Revisa los registros en busca de errores:
```
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
```

Configura el reenvío de syslog del switch de Fortinet

Configura el switch de Fortinet para enviar registros al agente de Bindplane. Los pasos de configuración varían según si el switch es independiente o si lo administra FortiGate.

Para FortiSwitch independiente (configuración de GUI)

Accede a la interfaz web de FortiSwitch.
Ve a Registro > Configuración.
En Syslog, selecciona Habilitar.
Selecciona la gravedad de los eventos que se registrarán (por ejemplo, Información o superior).
En el campo Servidor, ingresa la dirección IP o el nombre de dominio completamente calificado del host del agente de Bindplane.
En el campo Puerto, ingresa 514 (o el puerto configurado en el agente de Bindplane).
En el menú desplegable Facility, selecciona local7.
Haz clic en Aplicar.

Para FortiSwitch independiente (configuración de la CLI)

Accede a la CLI de FortiSwitch a través de SSH o la consola.

Ingresa los siguientes comandos:

config log syslogd setting
    set status enable
    set server <BINDPLANE_AGENT_IP>
    set port 514
    set facility local7
end

config log syslogd filter
    set severity information
end

Reemplaza <BINDPLANE_AGENT_IP> por la dirección IP del host del agente de Bindplane.

Verifica la configuración:
```
show log syslogd setting
```

Para FortiSwitch administrado por FortiGate

Cuando FortiGate administra FortiSwitch, configura el reenvío de syslog desde la CLI de FortiGate.

Accede a la CLI de FortiGate a través de SSH o la consola.

Ingresa los siguientes comandos para configurar el syslog remoto para el FortiSwitch administrado:

config switch-controller remote-log
    edit "chronicle-syslog"
        set status enable
        set server <BINDPLANE_AGENT_IP>
        set port 514
        set severity information
        set facility local7
    next
end

Reemplaza <BINDPLANE_AGENT_IP> por la dirección IP del host del agente de Bindplane.

Verifica la configuración:
```
show switch-controller remote-log
```
Asegúrate de que la política de firewall de FortiGate permita el tráfico de syslog desde la interfaz de FortiLink hasta la interfaz en la que se encuentra el agente de Bindplane. Si es necesario, crea una política:
```
config firewall policy
    edit 0
        set srcintf <fortilink_interface>
        set dstintf <bindplane_interface>
        set srcaddr "all"
        set dstaddr "all"
        set action accept
        set schedule "always"
        set service "SYSLOG"
    next
end
```
Reemplaza <fortilink_interface> por el nombre de la interfaz de FortiLink y <bindplane_interface> por la interfaz en la que se puede acceder al agente de Bindplane.

Nota: De forma predeterminada, los registros de FortiSwitch se envían al puerto 514 del Servidor Syslog remoto.

Tabla de asignación de UDM

Campo de registro	Asignación de UDM	Lógica
	metadata.event_type	Es el tipo de evento que representa este registro.
evento	metadata.product_event_type	Es el tipo de evento según lo informado por el producto.
log_id	metadata.product_log_id	Es el identificador único de la entrada de registro que asigna el producto.
device_id	principal.asset.asset_id	Es el identificador único del activo.
devname	principal.asset.hostname	Es el nombre de host del activo asociado con la principal.
devname	principal.hostname	Es el nombre de host asociado con la principal.
vd	principal.user.attribute.labels	Es la lista de etiquetas asociadas con el usuario.
oldrole	principal.user.attribute.roles	Es la lista de roles asociados con el usuario.
unidad	principal.user.role_description	Descripción del rol del usuario.
usuario	principal.user.userid	Es el identificador único del usuario.
acción	security_result.action_details	Son los detalles sobre la medida que se tomó.
msg	security_result.description	Es la descripción del resultado de seguridad.
type, subtype, switch.physical-port, instanceid	security_result.detection_fields	Es la lista de campos que se usaron para la detección.
pri	security_result.priority_details	Son los detalles sobre la prioridad del evento.
estado	security_result.summary	Es el resumen del resultado de seguridad.
newrole	target.user.attribute.roles	Es la lista de roles asociados con el usuario de destino.
	metadata.product_name	Es el nombre del producto que generó el evento.
	metadata.vendor_name	Es el nombre del proveedor que fabricó el producto.

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.