Recopila registros de H3C Comware Platform Switch
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.
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).
- Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo,
- 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.jsonen el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsonen Linux oC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonen Windows) o actualizacreds_file_pathenconfig.yamlpara 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.
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" /quietEspera 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.shEspera 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.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Edita el archivo de configuración
Reemplaza todo el contenido de
config.yamlpor 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 en0.0.0.0:514para escuchar en todas las interfaces en el puerto UDP 51. Puedes usar un puerto diferente, como1514, 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
- Linux:
customer_id: ReemplazaYOUR_CUSTOMER_IDpor tu ID de cliente del paso anterior.location: Reemplaza<LOCATION>por la región de tu instancia de Google SecOps (por ejemplo,us,europeoasia-southeast1). El exportador agrega el prefijochronicle.googleapis.comcon 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 comochronicle.googleapis.com.log_type: Configúralo comoH3C_SWITCHexactamente 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
exporterspor lo siguiente. Establececreds_file_pathen la ruta de acceso al archivo de autenticación de transferencia y, si tu instancia está fuera de EE.UU., reemplazamalachiteingestion-pa.googleapis.compor 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, luegoEntery, 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-collectorVerifica que el servicio esté en ejecución:
sudo systemctl status observiq-otel-collectorRevisa 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-collectorConsola de servicios:
- Presiona
Win+R, escribeservices.mscy presiona Intro. - Busca observIQ OpenTelemetry Collector.
Haz clic con el botón derecho y selecciona Reiniciar.
Verifica que el servicio esté en ejecución:
sc query observiq-otel-collectorRevisa los registros en busca de errores:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Presiona
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
- Accede al switch de la plataforma H3C Comware con uno de los siguientes métodos:
- Conexión de puerto de consola
- Telnet
- SSH
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 enableSi 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 dateFormatos 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ñonone: 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 local7Reemplaza
BINDPLANE_AGENT_IPpor 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 local7Pará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_NUMBERPor 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 informationalPara 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 informationalPara ver los módulos de origen disponibles, usa lo siguiente:
[H3C] info-center source ?
Guarda la configuración
Guarda la configuración para asegurarte de que persista después de un reinicio:
[H3C] saveCuando se te solicite, ingresa
Ypara 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.