Recopila registros de H3C Comware Platform Switch

Compatible con:

En este documento, se explica cómo transferir registros de H3C Comware Platform Switch a Google Security Operations con Bindplane.

Los switches de la plataforma Comware de H3C son switches de red de nivel empresarial que proporcionan capacidades de conmutación de capa 2 y capa 3, funciones de seguridad avanzadas y administración de red integral a través del sistema operativo Comware. Los switches admiten amplias capacidades de registro a través de la función de centro de información para supervisar las operaciones de red, los eventos de seguridad y los diagnósticos del sistema.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

  • Una instancia de Google SecOps
  • Windows Server 2016 o posterior, o host de Linux con systemd
  • Conectividad de red entre el agente de Bindplane y el interruptor de la plataforma H3C Comware
  • 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 H3C Comware Platform Switch a través de la consola, Telnet o SSH
  • Switch de plataforma Comware de H3C con la función de centro de información habilitada (habilitada de forma predeterminada)

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.
  1. Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
  2. Ve a IAM y administración > Cuentas de servicio.
  3. Haga 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 elige 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 descargará 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.

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

  1. Accede a la consola de Google SecOps.
  2. 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.
  3. Descarga el archivo de autenticación de transferencia.
  4. 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

  1. Accede a la consola de Google SecOps.
  2. Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > 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 en Windows

  1. Abre el símbolo del sistema o PowerShell como administrador.
  2. Ejecuta el comando siguiente:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. Espera a que se complete la instalación.

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

  1. Abre una terminal con privilegios de raíz o sudo.
  2. Ejecuta el comando siguiente:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. Espera a que se complete la instalación.

  4. 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/h3c_switch:
        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: H3C_SWITCH
        raw_log_field: body
        ingestion_labels:
          env: production
    
    service:
      pipelines:
        logs/h3c_to_chronicle:
          receivers:
            - udplog
          exporters:
            - chronicle/h3c_switch
    

Parámetros de configuración

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

    • Configuración del receptor:

      • listen_address: Se establece en 0.0.0.0:514 para escuchar en todas las interfaces en el puerto UDP 51. Puedes usar un puerto diferente, como 1514, si se ejecuta como no raíz en Linux.
    • 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: Reemplaza YOUR_CUSTOMER_ID por tu 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: Configúralo como H3C_SWITCH exactamente como se muestra.
      • 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/h3c_switch:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: 'YOUR_CUSTOMER_ID'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: H3C_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.

  • Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:

    sudo systemctl restart observiq-otel-collector
    
    1. Verifica que el servicio esté en ejecución:

        sudo systemctl status observiq-otel-collector
      
    2. Revisa los registros en busca de errores:

        sudo journalctl -u observiq-otel-collector -f
      
  • Para reiniciar el agente de Bindplane en Windows, elige una de las siguientes opciones:

    • Símbolo del sistema o PowerShell como administrador:

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • 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 la plataforma H3C Comware

Configura tu switch de plataforma H3C Comware para enviar mensajes de syslog al agente de Bindplane.

Accede a la CLI del switch

  1. Accede al switch de la plataforma H3C Comware con uno de los siguientes métodos:
    • Conexión de puerto de consola
    • Telnet
    • SSH
  2. Ingresa a la vista del sistema escribiendo el siguiente comando:

    <H3C> system-view
    

El mensaje cambia a [H3C], lo que indica que estás en la vista del sistema.

Verifica que el centro de información esté habilitado

  • El centro de información está habilitado de forma predeterminada en los switches de la plataforma Comware de H3C. Para verificar o habilitar el centro de información, ingresa el siguiente comando:

    [H3C] info-center enable
    
  • Si el centro de información ya está habilitado, el sistema muestra lo siguiente:

    Info: Information center is enabled.
    

Configura el formato de la marca de tiempo (opcional)

  • El formato de marca de tiempo predeterminado para la información del sistema que se envía al host de registro es la fecha. Para configurar el formato de la marca de tiempo, usa el siguiente comando:

    [H3C] info-center timestamp loghost date
    
  • Formatos de marca de tiempo disponibles:

    • date: El formato es "Mmm dd hh:mm:ss:ms aaaa" (por ejemplo, Dec 8 10:12:21:708 2012)
    • iso: Formato ISO 8601 (por ejemplo, 2012-09-21T15:32:55)
    • no-year-date: Fecha y hora actuales del sistema sin el año
    • none: No hay información de marca de tiempo

Configura el host de registros

  • Especifica el host del agente de Bindplane como el host de registro. El parámetro facility se puede establecer de local0 a local7, y el valor predeterminado es local7.

    [H3C] info-center loghost BINDPLANE_AGENT_IP port 514 facility local7
    
    • Reemplaza BINDPLANE_AGENT_IP por la dirección IP del host que ejecuta el agente de Bindplane.

      • Por ejemplo, si el agente de Bindplane se ejecuta en el host 192.168.1.100:

        [H3C] info-center loghost 192.168.1.100 port 514 facility local7
        
      • Parámetros:

        • BINDPLANE_AGENT_IP: Es la dirección IP del host del agente de Bindplane.
        • port 514: Es el número de puerto UDP (debe coincidir con el puerto configurado en el agente de Bindplane).
        • facility local7: Es la instalación de Syslog (los valores válidos son de local0 a local7; el valor predeterminado es local7).

Configura la interfaz de origen (opcional)

  • El comando info-center loghost source solo tiene efecto después de que se habilita el centro de información con el comando info-center enable. Para especificar una interfaz de origen para los mensajes de registro, haz lo siguiente:

    [H3C] info-center loghost source INTERFACE_TYPE INTERFACE_NUMBER
    
    • Por ejemplo, para usar la interfaz de VLAN 1 como origen, haz lo siguiente:

      [H3C] info-center loghost source vlan-interface 1
      

Inhabilita la salida de registro predeterminada para registrar el host

  • De forma predeterminada, el sistema envía información de todos los módulos al host de registro. Para controlar qué módulos envían registros, primero inhabilita el resultado predeterminado:

    [H3C] undo info-center source default loghost
    

Configura reglas de salida de registros

Configura qué módulos y niveles de gravedad deben enviar registros al host de registros. La información del sistema se clasifica en ocho niveles de gravedad, del 0 al 7, en orden descendente. El switch genera la información del sistema con un nivel de gravedad superior o igual al nivel especificado. Por ejemplo, si configuras una regla de salida con un valor de gravedad de 6 (informativo), se generará la información con un valor de gravedad de 0 a 6.

  • Niveles de gravedad (0-7):

    • 0: emergencias
    • 1: Alertas
    • 2: Crítica
    • 3: errores
    • 4: Advertencias
    • 5: Notificaciones
    • 6: Informativo
    • 7: Depuración
  • Para configurar la salida de registros de todos los módulos en el nivel informativo o superior, haz lo siguiente:

    [H3C] info-center source default loghost level informational
    
  • Para configurar la salida de registros de módulos específicos (por ejemplo, ARP e IP), haz lo siguiente:

    [H3C] info-center source arp loghost level informational
    [H3C] info-center source ip loghost level informational
    
  • Para ver los módulos de origen disponibles, usa lo siguiente:

    [H3C] info-center source ?
    

Guarda la configuración

  1. Guarda la configuración para asegurarte de que persista después de un reinicio:

    [H3C] save
    
  2. Cuando se te solicite, ingresa Y para confirmar.

Verifica la configuración

  • Para verificar la configuración del centro de información, usa el siguiente comando:

    [H3C] display info-center
    

Este comando muestra la configuración actual del centro de información, incluidos los parámetros de configuración del host de registro, las reglas de salida y los parámetros de configuración del canal.

Ejemplo de configuración completa

  • En el siguiente ejemplo, se muestra una configuración completa para enviar registros de todos los módulos con un nivel informativo o superior a un host de registro en 192.168.1.100:

    <H3C> system-view
    [H3C] info-center enable
    [H3C] info-center timestamp loghost date
    [H3C] info-center loghost 192.168.1.100 port 514 facility local7
    [H3C] undo info-center source default loghost
    [H3C] info-center source default loghost level informational
    [H3C] save
    

Ejemplo de configuración para módulos específicos

  • En el siguiente ejemplo, se muestra la configuración para enviar registros de módulos de ARP y de IP a nivel informativo a un host de registros:

    <H3C> system-view
    [H3C] info-center enable
    [H3C] info-center loghost 192.168.1.100 port 514 facility local7
    [H3C] undo info-center source default loghost
    [H3C] info-center source arp loghost level informational
    [H3C] info-center source ip loghost level informational
    [H3C] save
    

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
extensions.auth.type Tipo de autenticación que se usó en el evento
Nombre de host intermediary.asset.hostname Nombre de host del recurso asociado con el intermediario
Nombre de host intermediary.hostname Nombre de host de la entidad intermediaria
inter_ip intermediary.asset.ip Dirección IP del activo asociado con el intermediario
inter_ip intermediary.ip Dirección IP de la entidad intermediaria
IPAddr, prin_ip principal.asset.ip Es la dirección IP del recurso asociado con la principal.
IPAddr, prin_ip principal.ip Dirección IP de la entidad principal
prin_port principal.port Es el número de puerto asociado con la principal.
Usuario, usuario principal.user.userid ID de usuario de la principal
tar_host target.asset.hostname Nombre de host del activo asociado con el destino
tar_host target.hostname Nombre de host de la entidad de destino
tar_ip target.asset.ip Es la dirección IP del activo asociado con el destino.
tar_ip target.ip Dirección IP de la entidad de destino
tar_port target.port Número de puerto asociado con el destino
tar_user target.user.userid ID de usuario del objetivo
Line, OperateType, OperateTime, OperateState, OperateEndTime, EventIndex, CommandSource, ConfigSource, ConfigDestination additional.fields Campos de metadatos adicionales que no están cubiertos por los campos de UDM estándar
desc metadata.description Descripción del evento
timestamp metadata.event_timestamp Marca de tiempo del momento en que ocurrió el evento
metadata.event_type Tipo de evento (p.ej., USER_LOGIN, NETWORK_CONNECTION)
event_type metadata.product_event_type Identificador del tipo de evento específico del producto
metadata.product_name Es el nombre del producto que genera el evento.
metadata.vendor_name Nombre del proveedor del producto
observer_asset_id event.idm.read_only_udm.observer.asset_id Asignado desde el registro de cambios
observer_hostname event.idm.read_only_udm.observer.hostname y event.idm.read_only_udm.observer.asset.hostname Asignado desde el registro de cambios
severity event.idm.read_only_udm.security_result.severity_details Asignado desde el registro de cambios
severityName event.idm.read_only_udm.security_result.severity Asignado desde el registro de cambios
duplicate_ip event.idm.read_only_udm.principal.ip y event.idm.read_only_udm.principal.asset.ip Asignado desde el registro de cambios
facility event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
facilityName event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
id event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
interface event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
host event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
device_type event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
dev_ip event.idm.read_only_udm.target.ip y event.idm.read_only_udm.target.asset.ip Asignado desde el registro de cambios
program event.idm.read_only_udm.metadata.product_event_type Asignado desde el registro de cambios
security_result event.idm.read_only_udm.security_result Asignado desde el registro de cambios
product_event_type event.idm.read_only_udm.metadata.product_event_type Asignado desde el registro de cambios
src_ip event.idm.read_only_udm.principal.ip Asignado desde el registro de cambios
src_ip event.idm.read_only_udm.principal.asset.ip Asignado desde el registro de cambios
dest_ip event.idm.read_only_udm.target.ip Asignado desde el registro de cambios
dest_ip event.idm.read_only_udm.target.asset.ip Asignado desde el registro de cambios
hostname event.idm.read_only_udm.intermediary.hostname Asignado desde el registro de cambios
hostname event.idm.read_only_udm.intermediary.asset.hostname Asignado desde el registro de cambios
timestamp event.idm.read_only_udm.metadata.event_timestamp Asignado desde el registro de cambios
inter_ip event.idm.read_only_udm.metadata.intermediary.ip Asignado desde el registro de cambios
inter_ip event.idm.read_only_udm.metadata.intermediary.asset.ip Asignado desde el registro de cambios
Line event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
OperateType event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
OperateTime event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
OperateState event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
OperateEndTime event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
EventIndex event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
CommandSource event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
ConfigSource event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
ConfigDestination event.idm.read_only_udm.additional.fields Asignado desde el registro de cambios
IPAddr event.idm.read_only_udm.principal.ip Asignado desde el registro de cambios
IPAddr event.idm.read_only_udm.principal.asset.ip Asignado desde el registro de cambios
User event.idm.read_only_udm.principal.user.userid Asignado desde el registro de cambios
prin_ip event.idm.read_only_udm.principal.ip Asignado desde el registro de cambios
prin_ip event.idm.read_only_udm.principal.asset.ip Asignado desde el registro de cambios
prin_port event.idm.read_only_udm.principal.port Asignado desde el registro de cambios
tar_ip event.idm.read_only_udm.target.ip Asignado desde el registro de cambios
tar_ip event.idm.read_only_udm.target.asset.ip Asignado desde el registro de cambios
tar_host event.idm.read_only_udm.target.hostname Asignado desde el registro de cambios
tar_port event.idm.read_only_udm.target.port Asignado desde el registro de cambios
tar_user event.idm.read_only_udm.target.user.userid Asignado desde el registro de cambios
user event.idm.read_only_udm.principal.user.userid Asignado desde el registro de cambios

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.