Implementa el agente de BindPlane para la recopilación

Compatible con:

En este documento, se describe Bindplane para Google Security Operations.

Bindplane es una canalización de telemetría que puede recopilar, definir mejor y exportar registros de cualquier fuente a Google SecOps.

Bindplane ofrece dos ediciones especialmente para Google.

Bindplane incluye los siguientes componentes principales:

  • Recopilador de Bindplane. Un agente de código abierto, basado en el recopilador de OpenTelemetry (OTel). Recopila registros de varias fuentes, incluidos los registros de eventos de Microsoft Windows, y los envía a Google SecOps. Puedes instalar los recopiladores de forma local o en la nube.

    Este componente también se puede denominar recopilador de BindPlane Distribution para OpenTelemetry (BDOT), agente de BindPlane, agente de recopilación, recopilador o agente.

  • Servidor de Bindplane. Es una plataforma integral y unificada para administrar tus implementaciones de recopiladores de OTel. Estas implementaciones pueden residir en Google SecOps y Google Cloud. Muchos clientes de Google SecOps usan Bindplane Server, pero su uso es opcional. Bindplane Server puede ejecutarse de forma local o en la nube de Bindplane. Para obtener más información sobre el servidor, consulta Servidor de BindPlane.

    Este componente también se puede denominar consola de administración de la canalización de observabilidad (OP) de Bindplane o consola de administración de Bindplane.

Ediciones de Google de BindPlane

Bindplane ofrece dos ediciones especialmente para Google: Bindplane (Google Edition) y Bindplane Enterprise (Google Edition).

Bindplane (Google Edition)

Bindplane (Google Edition) se proporciona a todos los clientes de Google SecOps.

Puedes usar BindPlane (Google Edition) en la nube de BindPlane.

Para comenzar a instalar y alojar de forma automática BindPlane (Google Edition) o generar tu clave para un servidor de BindPlane local, consulta BindPlane (Google Edition).

Bindplane Enterprise (Google Edition): para clientes de Google SecOps Enterprise Plus y Google Unified Security (GUS)

Bindplane Enterprise (Google Edition) se incluye para los clientes de Google SecOps Enterprise Plus y GUS.

Se recomienda Bindplane Enterprise (Google Edition) para implementaciones a gran escala.

Descarga tu clave de licencia de Bindplane Enterprise

Los clientes de Google SecOps Enterprise Plus y GUS pueden descargar su clave de licencia de Bindplane Enterprise (Google Edition) directamente desde la consola de la plataforma:

  1. En la consola de Google SecOps, ve a Configuración > Administración de datos > Agentes de recopilación.
  2. En la tarjeta Licencia de BindPlane, haz clic en Descargar licencia para guardar el archivo de clave de licencia.
  3. Aplica la clave de licencia descargada a tu instalación de Bindplane Server. Para obtener más información, consulta Aplica una licencia de Bindplane.

Diferencias entre las ediciones de BindPlane para Google

En la siguiente tabla, se enumeran las diferencias en las ediciones de Bindplane Google:

Tema o función Bindplane (Google Edition) Bindplane Enterprise (Google Edition)
Costo Se incluye sin cargo adicional para todos los clientes de Google SecOps Se incluye sin cargo para los clientes de Google SecOps Enterprise Plus
Enrutamiento y destinos Solo Google, incluidos Google SecOps, Cloud Logging, BigQuery y Cloud Storage a través de Google SecOps Google, incluidos 12 meses de enrutamiento a un destino que no sea de Google para las migraciones de SIEM
Filtrado Filtro básico con expresión regular Procesadores de filtrado avanzados (por ejemplo, filtrar por condición, campo, gravedad, etcétera), reducción de datos, muestreo de registros y desduplicación
Ocultación N/A Enmascaramiento de PII
Transformación Agregar campo, mover campo, analizar datos (KV, JSON, CSV, XML, marca de tiempo, analizar por expresión regular), cambiar nombre de campo, separador de eventos Incluye todas las funciones compatibles con Bindplane (Google Edition) además de borrar campo, borrar valores vacíos y fusionar
Funciones generales a nivel de la plataforma Puerta de enlace (datos agregados de recopiladores), recopiladores de Bindplane, servidor de Bindplane (capa de administración de Bindplane) local o alojado en la nube, todas las fuentes, supervisión de host silencioso a través del procesador de Google SecOps, cola persistente, enriquecimiento de telemetría, alta disponibilidad, RBAC, compatibilidad con ambas APIs de transferencia de Google SecOps, ofuscación de credenciales, administración avanzada de flotas, incluida la agrupación de recopiladores, asignación dinámica de tipos de registros Todas las funciones compatibles con Bindplane (Google Edition)

Arquitectura del recopilador de BindPlane

Bindplane usa el recopilador de BDOT, que se conoce de forma genérica como recopilador, para estandarizar la administración de telemetría con el Protocolo de administración de agentes abierto (OpAMP). También puedes crear y administrar distribuciones personalizadas de OpenTelemetry Collector con BindPlane.

El recopilador se puede ejecutar en Linux o Docker como un servidor web ligero sin dependencias externas.

Para obtener más información sobre la arquitectura de implementación de los recopiladores de OpenTelemetry de Bindplane, consulta Implementación.

En las siguientes secciones, se describen las opciones de arquitectura disponibles.

Los recopiladores envían registros a un recopilador que actúa como puerta de enlace

Para implementaciones a gran escala, te recomendamos que uses recopiladores que actúen como puertas de enlace. Estas puertas de enlace reciben telemetría de otros recopiladores a través de la red, realizan un procesamiento adicional de forma opcional y enrutan los datos a Google SecOps.

Un recopilador que actúa como puerta de enlace usa el mismo objeto binario que todos los demás recopiladores.

En el siguiente diagrama, se muestran los recopiladores que envían registros a un recopilador que actúa como puerta de enlace:

Los recopiladores envían registros a un recopilador que actúa como puerta de enlace

Los recopiladores envían registros directamente a la API de transferencia de Google SecOps

En el siguiente diagrama, se muestran los recopiladores que envían registros directamente a la API de transferencia de Google SecOps:

Los recopiladores envían registros directamente a la API de transferencia de Google SecOps

Los recopiladores envían registros directamente a Cloud Logging

En el siguiente diagrama, se muestran los recopiladores que envían registros directamente a Cloud Logging:

Los recopiladores envían registros directamente a Cloud Logging

Los recopiladores envían registros a varios destinos

En el siguiente diagrama, se muestran los recopiladores que envían registros a varios destinos:

El colector envía registros a varios destinos

Servidor de Bindplane

El servidor de Bindplane ofrece las siguientes funciones clave:

  • Administración centralizada. El servidor te permite administrar todas tus implementaciones de recopiladores de OTel en Google Cloud. Puedes ver el estado de cada implementación y realizar tareas de administración comunes, como iniciar, detener y reiniciar recopiladores.
  • Supervisión en tiempo real. El servidor proporciona una supervisión en tiempo real de tus implementaciones del recopilador de OTel. Puedes hacer un seguimiento de métricas como el uso de CPU, el uso de memoria y la capacidad de procesamiento. También puedes ver registros y seguimientos para solucionar problemas.
  • Alertas y notificaciones. El servidor te permite configurar alertas y notificaciones para eventos importantes, como cuando un recopilador deja de funcionar o cuando se supera un umbral de métrica.
  • Administración de configuraciones. El servidor te permite administrar de forma centralizada la configuración de tus recopiladores de OTel. Puedes editar archivos de configuración, establecer variables de entorno y aplicar políticas de seguridad a todas tus implementaciones.
  • Integración en Google Cloud. Puedes crear y administrar implementaciones del recopilador de OTel en Google Cloud y usar el servidor para acceder a tus recursos de Google Cloud .

Bindplane ofrece opciones de implementación en la nube y locales. Para obtener más información, consulta Usa el servidor de Bindplane.

Requisitos técnicos y recomendaciones

En esta sección, se describen los requisitos técnicos y las recomendaciones para instalar y ejecutar Bindplane con Google SecOps.

Requisitos de ancho de banda

Bindplane mantiene las conexiones de red para lo siguiente:

  • Administración de recopiladores
  • Mediciones de la capacidad de procesamiento del recopilador
  • Interfaces de usuario web y de línea de comandos

Requisitos de conectividad

Bindplane escucha en el puerto 3001 de forma predeterminada. Este puerto se puede configurar.

El puerto de Bindplane se usa para lo siguiente:

  • Comando y control del recopilador con OpAMP (WebSocket)
  • Solicitudes de medición de la capacidad de procesamiento del recopilador (solicitud HTTP POST)
  • Usuarios de navegadores y de la CLI (HTTP y WebSocket)

Los recopiladores deben poder iniciar conexiones con Bindplane para OpAMP (WebSocket) y mediciones de capacidad de procesamiento (HTTP).

Bindplane nunca inicia conexiones con los recopiladores. Puedes configurar un firewall para evitar que Bindplane llegue a las redes de recopiladores. Sin embargo, las redes de recopiladores deben poder llegar a Bindplane en el puerto configurado.

Requisitos técnicos generales del recopilador de Bindplane

Para conocer los requisitos técnicos generales del recopilador de Bindplane, consulta lo siguiente:

Requisitos de recursos del recopilador

Los requisitos de recursos de Bindplane varían según la cantidad de recopiladores administrados. A medida que aumenta la cantidad de recopiladores administrados, también aumentan el uso de CPU, memoria, capacidad de procesamiento/IOPS de disco y consumo de red.

Usa la siguiente tabla para determinar el tamaño de la CPU, la memoria y la capacidad de almacenamiento:

Recuento de recopiladores Nodos de Bindplane Tolerancia a errores Núcleos de CPU Memoria Base de datos
Entre 1 y 100 1 N/A 2 4 GB bbolt
De 100 a 25,000 1 N/A 4 16 GB postgres
1-60,000 3 1 2 8 GB postgres
De 60,001 a 125,000 5 1 2 8 GB postgres
De 125,001 a 250,000 10 2 2 8 GB postgres

Planifica la instalación y la implementación

En las siguientes secciones, se incluyen recomendaciones y prácticas recomendadas que debes tener en cuenta cuando planifiques tu implementación de Bindplane.

Considera el escalamiento y la tolerancia a errores

Se prefiere el escalamiento horizontal porque proporciona tolerancia a errores y puede eliminar los cuellos de botella del exportador.

Cuando ejecutes recopiladores de Bindplane en el modo de puerta de enlace, te recomendamos que los vincules con un balanceador de cargas para proporcionar tolerancia a errores y escalamiento horizontal.

Calcula cuántos recopiladores necesitas

Cuando calcules la cantidad de recopiladores necesarios para tu carga de trabajo, ten en cuenta la capacidad de procesamiento o la tasa de registros previstas y usa la siguiente tabla. En esta tabla, se supone que cada recopilador tiene cuatro núcleos de CPU y 16 GB de memoria. La tabla no incluye cálculos con procesadores; cuando se agregan procesadores, aumentan los requisitos de procesamiento.

Capacidad de procesamiento de telemetría Registros por segundo Recopiladores
5 GB/m 250,000 2
10 GB/mes 500,000 3
20 GB/m 1,000,000 5
100 GB/mes 5,000,000 25

Aprovisiona en exceso la flota de recopiladores para la tolerancia a errores

Aprovisiona en exceso la flota de recopiladores para garantizar la tolerancia a errores. En caso de que uno o más sistemas de recopilación fallen o se desconecten para realizar tareas de mantenimiento, los recopiladores restantes deben tener suficiente capacidad para administrar la capacidad de procesamiento de telemetría.

Si trabajas con una cantidad fija de recopiladores, puedes implementar el escalamiento vertical de su CPU y memoria para aumentar la capacidad de procesamiento.

Descarga la sobrecarga de procesamiento

En general, te conviene que tus recopiladores realicen la menor cantidad de trabajo posible. Si tienes requisitos de procesamiento intensivo, puede ser útil descargar ese procesamiento en una flota de recopiladores de puerta de enlace. Por ejemplo, en lugar de filtrar la telemetría con una operación de expresión regular costosa, puedes hacer que los recopiladores de la puerta de enlace realicen esa tarea. Por lo general, los recopiladores de puerta de enlace se ejecutan en un sistema dedicado. Esto justifica la sobrecarga de procesamiento, ya que no consume la potencia de procesamiento de otros servicios que se ejecutan en el mismo sistema, a diferencia de un recopilador que no es de puerta de enlace y que puede ejecutarse en un servidor de base de datos.

Prácticas recomendadas para el modo de puerta de enlace

Cuando ejecutes recopiladores de Bindplane en el modo de puerta de enlace, te recomendamos que planifiques tu implementación con las siguientes prácticas recomendadas:

  • Coloca al menos dos recopiladores detrás de un balanceador de cargas.
  • Cada recopilador debe tener un mínimo de dos núcleos.
  • Cada recopilador debe tener un mínimo de 8 GB de memoria.
  • Cada recopilador debe tener 60 GB de espacio utilizable para una cola persistente.

Usa un balanceador de cargas cuando sea necesario

Se requiere un balanceador de cargas cuando operas Bindplane en modo de alta disponibilidad.

Cuando ejecutes recopiladores de Bindplane en modo de puerta de enlace, usa un balanceador de cargas para aumentar el rendimiento y la redundancia. El balanceo de cargas también permite el escalamiento horizontal de tu flota de puertas de enlace y la capacidad de soportar fallas sin causar interrupciones.

El recopilador de Bindplane puede funcionar con una amplia variedad de balanceadores de cargas.

Para obtener más información, consulta Configuración del balanceador de cargas.

Puerto y protocolos de balanceo de cargas

Bindplane escucha en el puerto 3001 de forma predeterminada.

Para admitir la amplia gama de receptores basados en la red en OpenTelemetry, el balanceador de cargas debe admitir lo siguiente:

  • Protocolos de transporte TCP/UDP
  • Protocolos de aplicación HTTP y gRPC

Dimensionamiento del balanceo de cargas

Los nodos de Bindplane no deben administrar más de 30,000 recopiladores para obtener la máxima tolerancia a errores. Cada recopilador abre dos conexiones a BindPlane (una para la administración remota de OpAMP y otra para publicar métricas de capacidad de procesamiento). Este límite ayuda a garantizar que no excedas el límite de conexiones de aproximadamente 65,535 por instancia de backend que imponen la mayoría de los balanceadores de cargas.

Si una organización tiene 100,000 recopiladores, un tamaño de clúster de tres sería insuficiente. Cada nodo sería responsable de aproximadamente 33,000 recopiladores, lo que se traduce en 66,000 conexiones TCP por instancia de Bindplane. Esta situación empeora si se quita un nodo para mantenimiento, ya que cada instancia de Bindplane restante administraría 50,000 recopiladores o 100,000 conexiones TCP.

Prácticas recomendadas para el dimensionamiento del balanceo de cargas

  • Implementa verificaciones de estado. Configura el balanceador de cargas para asegurarte de que el recopilador esté listo para recibir tráfico.
  • Distribuye las conexiones de manera uniforme. Las conexiones deben distribuirse de manera uniforme entre los recopiladores.
  • Admite los protocolos requeridos. Para admitir la amplia gama de receptores basados en la red en OpenTelemetry, el balanceador de cargas debe admitir lo siguiente:

    • Protocolos de transporte TCP/UDP
    • Protocolos de aplicación HTTP y gRPC

Para obtener más información, consulta Resiliencia del recopilador.

Balanceo de cargas basado en el tipo de origen

Cualquier tipo de fuente que reciba telemetría de sistemas remotos a través de la red es un candidato adecuado para el balanceo de cargas, incluidos los siguientes:

  • OTLP
  • Syslog
  • TCP/UDP
  • HEC de Splunk
  • Fluent Forward

Usa el modo de alta disponibilidad en entornos de producción

Puedes implementar una instancia de Bindplane en una configuración de instancia única o de varias instancias. Para las implementaciones de producción que requieren alta disponibilidad (HA) y resiliencia, te recomendamos que uses un modelo de implementación de instancias múltiples (HA).

Cuando Bindplane administra más de 25,000 recopiladores, te recomendamos que lo operes en modo de alta disponibilidad (HA).

Para obtener información sobre la alta disponibilidad en BindPlane, consulta Alta disponibilidad.

Calcula la cantidad de recopiladores y servidores de Bindplane para la alta disponibilidad

Cuando operas Bindplane en modo de HA, debes considerar cuántos recopiladores esperas que maneje cada servidor de Bindplane.

Toma la cantidad total de instancias de Bindplane y resta la cantidad máxima de nodos que esperas que no estén disponibles debido al mantenimiento. Asegúrate de que cada nodo no administre más de 30,000 recopiladores durante una interrupción del nodo.

Postgres para alta disponibilidad

Postgres es un requisito previo cuando operas Bindplane en modo de alta disponibilidad.

Prometheus para alta disponibilidad

Prometheus es obligatorio cuando operas Bindplane en modo de HA.

Para obtener más información, consulta Prometheus.

Bus de eventos para HA

Bindplane usa un bus de eventos para comunicarse entre los componentes de Bindplane. Cuando operas Bindplane en modo de alta disponibilidad, puedes usar el bus de eventos para enviar eventos entre los servidores de Bindplane.

Para obtener más información, consulta Bus de eventos.

Usa una implementación de instancia única para un entorno de pruebas o una prueba de concepto

Para un entorno de pruebas o una prueba de concepto, te recomendamos que uses una implementación de instancia única.

Para obtener más información, consulta Instancia única.

Aísla las credenciales de backend

En lugar de implementar credenciales en todos tus sistemas de recopiladores, puedes mantener las credenciales exclusivamente en los recopiladores de puerta de enlace. Esto simplifica la rotación de credenciales y reduce la superficie de ataque de seguridad, ya que limita la implementación de credenciales a un subconjunto de tus sistemas.

Protege con un firewall tus recopiladores de puerta de enlace

Puedes colocar recopiladores de puerta de enlace dentro de una red perimetral, protegida por un firewall de la red interna. Puedes configurar tu red para permitir que los otros recopiladores reenvíen datos a los recopiladores de puerta de enlace y, al mismo tiempo, bloquear el acceso de estos últimos a la red de tu aplicación. Esto te permite enviar telemetría a un backend basado en la nube sin otorgar a tus extremos acceso directo a Internet.

El firewall debe permitir que el tráfico HTTP llegue a Bindplane en el puerto configurado.

Verifica la configuración del firewall (API de Ingestion)

Cualquier firewall o proxy autenticado entre el recopilador y la Internet requiere reglas para abrir el acceso a los siguientes hosts:

Tipo de conexión Destino Puerto
TCP malachiteingestion-pa.googleapis.com 443
TCP asia-northeast1-malachiteingestion-pa.googleapis.com 443
TCP asia-south1-malachiteingestion-pa.googleapis.com 443
TCP asia-southeast1-malachiteingestion-pa.googleapis.com 443
TCP australia-southeast1-malachiteingestion-pa.googleapis.com 443
TCP europe-malachiteingestion-pa.googleapis.com 443
TCP europe-west2-malachiteingestion-pa.googleapis.com 443
TCP europe-west3-malachiteingestion-pa.googleapis.com 443
TCP europe-west6-malachiteingestion-pa.googleapis.com 443
TCP europe-west12-malachiteingestion-pa.googleapis.com 443
TCP me-central1-malachiteingestion-pa.googleapis.com 443
TCP me-central2-malachiteingestion-pa.googleapis.com 443
TCP me-west1-malachiteingestion-pa.googleapis.com 443
TCP northamerica-northeast2-malachiteingestion-pa.googleapis.com 443
TCP accounts.google.com 443
TCP oauth2.googleapis.com 443

Requisitos previos para la transferencia de Google SecOps con Bindplane

En esta sección, se describen los requisitos previos necesarios para transferir datos correctamente a Google SecOps con Bindplane, en especial cuando se aprovecha la API de Chronicle Ingestion.

Requisitos de red para la API de Chronicle (HTTPS)

Cuando uses Bindplane con la API de Chronicle Ingestion, que usa HTTPS, asegúrate de que las configuraciones de red y firewall permitan conexiones salientes a los extremos de la API de Chronicle.

Si tu organización emplea restricciones de firewall basadas en IP, debes tener en cuenta la naturaleza dinámica de las direcciones IP de Google Cloud . Dado que Google SecOps no admite la inclusión de direcciones IP estáticas en la lista de entidades permitidas para las APIs de Ingestion, no se recomienda depender únicamente de las IPs estáticas, ya que esto puede provocar fallas en la transferencia.

Para mantener la ingesta de datos continua, ten en cuenta lo siguiente:

  • Lista de entidades permitidas basada en dominios: La práctica recomendada es configurar el firewall para habilitar el tráfico HTTPS saliente (puerto 443) a todo el dominio *.chronicle.googleapis.com.
  • Extremos regionales: Bindplane debe configurarse para usar el extremo regional adecuado para tu instancia de Google SecOps, como us-chronicle.googleapis.com, europe-chronicle.googleapis.com, etc. En la documentación de Migra de la API de SIEM heredada a la API de Chronicle, encontrarás una lista completa de los extremos regionales.
  • Actualizaciones automáticas de IP: Si no es posible crear una lista de entidades permitidas basada en dominios, debes implementar un sistema automatizado para recuperar y actualizar periódicamente los rangos de IP asociados con *.chronicle.googleapis.com. Los rangos de IP actuales para las APIs de Google se pueden obtener de los archivos goog.json y cloud.json, como se describe en la documentación de las direcciones IP de Google. Implementa un sistema para actualizar de forma dinámica tus reglas de firewall según estas fuentes.

Usa PostgreSQL para implementaciones de producción

Se requiere Postgres para las implementaciones de producción de Bindplane.

Postgres es un requisito previo para que operes Bindplane en modo de alta disponibilidad.

La cantidad de núcleos de CPU y la memoria disponible suelen limitar el rendimiento de los backends de almacenamiento de PostgreSQL. Recomendamos respaldar el almacenamiento de PostgreSQL con almacenamiento de baja latencia y alta capacidad de procesamiento, como las unidades de estado sólido (SSD).

Recuento de recopiladores Núcleos de CPU Memoria
1-60,000 4 16 GB
De 60,001 a 125,000 8 32 GB
De 125,001 a 250,000 16 64 GB

Para obtener más información, consulta lo siguiente:

Implementa la autenticación adecuada

Bindplane admite la autenticación con los siguientes protocolos y servicios. Asegúrate de que estén implementados correctamente:

Usa el servidor de Bindplane

La mayoría de los clientes de Google SecOps usan el servidor de Bindplane, pero su uso es opcional. Si instalas el servidor de Bindplane, necesitas acceso a storage.googleapis.com. Si solo instalas un recopilador, no se requiere este acceso.

Para ver una demostración de cómo configurar el servidor de Bindplane para estandarizar los registros y exportarlos a Google SecOps, ve a Demostraciones de casos de uso de Bindplane y, luego, selecciona Configuración de Google SecOps.

Usa el servidor de Bindplane Cloud

Bindplane Cloud está disponible para los clientes de Google.

Accede a la edición de Google.

Si tienes algún problema relacionado con Bindplane Cloud Server, comunícate con el equipo de asistencia de Bindplane. Si tienes problemas relacionados con el servidor de Bindplane local, comunícate con el equipo de asistencia de Google SecOps.

Usa el servidor de Bindplane en tu Google Cloud

Para obtener información sobre cómo ejecutar el servidor de BindPlane en tu Google Cloud, consulta BindPlane Enterprise Edition.

Usa el servidor local de Bindplane

El uso del servidor de Bindplane local se rige por las Condiciones del Servicio deGoogle Cloud existentes.

Instala el servidor local en Linux

Puedes instalar el servidor de Bindplane local en Linux ejecutando una secuencia de comandos (recomendado) o descargando un archivo binario y realizando la instalación de forma manual. Para obtener más información, consulta Instala el servidor de BindPlane.

Para instalar el servidor de Bindplane local en Linux con una secuencia de comandos, haz lo siguiente:

  1. Ejecuta esta secuencia de comandos:

    curl -fsSlL https://downloads.bindplane.com/bindplane/latest/install-linux.sh -o install-linux.sh && bash install-linux.sh --init && rm install-linux.sh

  2. Sigue las instrucciones, que te guiarán hasta la inicialización del servidor.

Para instalar el servidor de BindPlane local en Linux con un archivo binario, haz lo siguiente:

  1. Descarga uno de los siguientes archivos:

  2. Actualiza el archivo de configuración con las instrucciones que se indican en Configura el servidor de Bindplane.

Distribuciones de Linux compatibles:
  • Red Hat, Centos, Oracle Linux 7, 8, 9
  • Debian 11 y 12
  • Ubuntu LTS 20.04 y 22.04
  • SUSE Linux 12 y 15
  • Alma y Rocky Linux

Para obtener más información, consulta lo siguiente:

Implementaciones locales de Docker

Para obtener más información, consulta Instala el servidor de BindPlane.

Puedes encontrar imágenes de contenedores de Docker de Bindplane en las siguientes ubicaciones:

  • Paquetes de GitHub: ghcr.io/observiq/Bindplane-ee
  • Repositorio de artefactos de Google: us-central1-docker.pkg.dev/observiq-containers/bindplane/bindplane-ee
  • Docker Hub: observiq/bindplane-ee

Las imágenes de contenedor se etiquetan con la versión de actualización: por ejemplo, la versión v1.35.0 tendrá la etiqueta observiq/bindplane-ee:1.35.0.

Instala el recopilador de Bindplane

En esta sección, se describe cómo instalar el recopilador de Bindplane para Google SecOps en varios sistemas.

Por lo general, los recopiladores usan recursos mínimos. Sin embargo, cuando manejes grandes volúmenes de registros, ten en cuenta el consumo de recursos para evitar afectar a otros servicios. Para obtener más información, consulta Requisitos técnicos y recomendaciones, Planifica la instalación y la implementación y Ajuste de tamaño y escalamiento del agente.

Para obtener información sobre cómo instalar el recopilador (es decir, el agente de OTel), consulta Recopilador de OTel de Bindplane.

También puedes consultar la documentación de GitHub bindplane-otel-collector.

Para instalar el recopilador, necesitas lo siguiente:

  • Archivo de autenticación de transferencia de Google SecOps

    Para descargar el archivo de autenticación, sigue estos pasos:

    1. Abre la consola de Google SecOps.
    2. Ve a Configuración > Administración de datos > Agentes de recopilación.
    3. Descarga el archivo de autenticación de transferencia de Google SecOps. El siguiente paso depende del método de transferencia:
      • gRPC: Usa el archivo de autenticación descargado.
      • HTTPS: Crea una cuenta de servicio en el proyecto de Google Cloud vinculado a Google SecOps y asígnale el rol de editor de Chronicle.
  • ID de cliente de Google SecOps

    Para encontrar el ID de cliente, sigue estos pasos:

    1. Abre la consola de Google SecOps.
    2. Ve a Configuración > Administración > Perfil.
    3. Copia el ID de cliente de la sección Detalles de la organización.
  • Windows 2012 SP2 o posterior o host de Linux con systemd

  • Conexión a Internet

  • Acceso a GitHub

Herramientas de implementación

En esta sección, se describen las herramientas de implementación para Bindplane.

GitOps

Implementar recursos de Bindplane con un modelo de GitOps, que incluye lo siguiente:

  • Autenticación de Bindplane
  • CLI de Bindplane
  • Acceso a la red
  • Integración en un repositorio de GitHub y GitHub Actions
  • Exporta recursos existentes
  • Administra valores sensibles
  • Establece un flujo de trabajo de GitHub Actions
  • Instrucciones paso a paso para confirmar y probar la configuración, habilitar los lanzamientos automáticos y actualizar los recursos con ediciones directas o el método de exportación de la IU
  • Actualiza valores sensibles y emplea RBAC

Para obtener más información, consulta GitOps.

Ansible

Para obtener información sobre cómo implementar Bindplane con Ansible, consulta bindplane-agent-ansible.

CLI de Bindplane

Para obtener información sobre la CLI de Bindplane, consulta GitOps.

Terraform

Para obtener información sobre cómo usar Terraform para configurar tus recursos de Bindplane, consulta Proveedor de Bindplane.

Kubernetes

Para obtener información sobre Kubernetes con Bindplane, consulta los siguientes vínculos:

Instala el recopilador de Bindplane en Windows

Para instalar el recopilador de Bindplane en Windows, ejecuta el siguiente comando de PowerShell:

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

Como alternativa, para instalar con un asistente de instalación, descarga el instalador más reciente para Windows. Después de descargar el instalador, abre el asistente de instalación y sigue las instrucciones para configurar e instalar el recopilador de Bindplane.

Para obtener más información sobre cómo instalar el recopilador de Bindplane en Windows, consulta Instalación en Windows.

Instala el recopilador de Bindplane en Linux

Puedes instalar el recopilador en Linux con una secuencia de comandos que determine automáticamente qué paquete instalar. También puedes usar la misma secuencia de comandos para actualizar una instalación existente.

Para instalar con la secuencia de comandos de instalación, ejecuta la siguiente secuencia de comandos:

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

Instalación desde un paquete local

Para instalar el recopilador desde un paquete local, usa -f con la ruta de acceso al paquete.

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

Instalación de RPM

Descarga el paquete RPM para tu arquitectura desde la página de versiones y, luego, instálalo con rpm. Consulta el siguiente ejemplo para instalar el paquete amd64:

sudo rpm -U ./observiq-otel-collector_v${VERSION}_linux_amd64.rpm
sudo systemctl enable --now observiq-otel-collector

Reemplaza VERSION por la versión del paquete que descargaste.

Instalación de DEB

Descarga el paquete DEB para tu arquitectura desde la página de versiones y, luego, instálalo con dpkg. Consulta el siguiente ejemplo para instalar el paquete amd64:

sudo dpkg -i --force-overwrite ./observiq-otel-collector_v${VERSION}_linux_amd64.deb
sudo systemctl enable --now observiq-otel-collector

Reemplaza VERSION por la versión del paquete que descargaste.

Configura el recopilador de Bindplane

Después de instalar el recopilador, el servicio observiq-otel-collector se ejecuta y está listo para la configuración.

Puedes configurar el recopilador de forma manual o con el servidor de Bindplane.

Si configuras el recopilador de forma manual, debes actualizar los parámetros del exportador para asegurarte de que el recopilador se autentique con Google SecOps.

Archivo de configuración del recopilador de OTel

En Linux, el archivo de configuración del recopilador se puede encontrar en /opt/observiq-otel-collector/config.yaml.

Servicio y registros del recopilador de OTel

De forma predeterminada, el recopilador registra en C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log.

El registro de errores estándar para el proceso del recopilador se puede encontrar en C:\Program Files\observIQ OpenTelemetry Collector\log\observiq_collector.err.

En Linux, para ver los registros del recopilador, ejecuta sudo tail -F /opt/observiq-otel-collector/log/collector.log.

Comandos comunes del servicio de recopilador de OTel de Linux:

  • Para detener el servicio del recopilador de OTel, ejecuta sudo systemctl stop observiq-otel-collector.

  • Para iniciar el servicio del recopilador de OTel, ejecuta sudo systemctl start observiq-otel-collector.

  • Para reiniciar el servicio del recopilador de OTel, ejecuta sudo systemctl restart observiq-otel-collector.

  • Para habilitar el servicio del recopilador de OTel en el inicio, ejecuta sudo systemctl enable observiq-otel-collector.

Reinicia el servicio del recopilador para que se apliquen los cambios de configuración

Cuando cambies la configuración, debes reiniciar el servicio del recopilador para que se apliquen los cambios de configuración (sudo systemctl restart observiq-otel-collector).

Usa un archivo de configuración de muestra predeterminado

De forma predeterminada, el archivo de configuración del recopilador se encuentra en C:\Program Files\observIQ OpenTelemetry Collector\config.yaml.

Para descargar un archivo de configuración de muestra y un token de autenticación que usa el recopilador, haz lo siguiente:

  • Abre la consola de Google SecOps y ve a Configuración > Administración de datos > Agentes de recopilación.

Personaliza las siguientes dos secciones en el archivo de configuración:

  • Receptor: Especifica qué registros debe recopilar y enviar el recopilador a Google SecOps.
  • Exportador: Especifica el destino al que el recopilador envía los registros. Se admiten los siguientes exportadores:
    • Exportador de Google SecOps: Envía registros directamente a la API de transferencia de Google SecOps.
    • Exportador de reenvío de Google SecOps: Envía registros al reenviador de Google SecOps.
    • Exportador de Cloud Logging: envía registros a Cloud Logging.

En el exportador, personaliza lo siguiente:

  • customer_id: Es el ID de cliente de Google SecOps.
  • endpoint: Es tu extremo regional de Google SecOps.
  • creds: Es tu token de autenticación.

    Como alternativa, puedes usar creds_file_path para hacer referencia al archivo de credenciales directamente. Para la configuración de Windows, escapa la ruta con barras inversas.

  • log_type: Es el tipo de registro. Te recomendamos que selecciones WINDOWS_DNS como el Tipo de registro.

  • ingestion_labels: Son las etiquetas de transferencia. Estas etiquetas identifican los registros en Google SecOps.

  • namespace: Es el espacio de nombres opcional.

    Cada tipo de registro requiere que configures un exportador.

Muestras de configuración de la recopilación de registros

En las siguientes secciones, se incluyen ejemplos de configuración para la recopilación de registros.

Envía eventos de Windows y sysmon directamente a Google SecOps

Configura estos parámetros en la muestra:

Configuración de ejemplo

receivers:
  windowseventlog/sysmon:
    channel: Microsoft-Windows-Sysmon/Operational
    raw: true
  windowseventlog/security:
    channel: security
    raw: true
  windowseventlog/application:
    channel: application
    raw: true
  windowseventlog/system:
    channel: system
    raw: true

processors:
  batch:

exporters:
  chronicle/sysmon:
    endpoint: malachiteingestion-pa.googleapis.com
    creds: '{
  "type": "service_account",
  "project_id": "malachite-projectname",
  "private_key_id": "abcdefghijklmnopqrstuvwxyz123456789",
  "private_key": "-----BEGIN PRIVATE KEY-----abcdefg-----END PRIVATE KEY-----\n",
  "client_email": "account@malachite-projectname.iam.gserviceaccount.com",
  "client_id": "123456789123456789",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/account%40malachite-projectname.iam.gserviceaccount.com",
  "universe_domain": "googleapis.com"
}' 
    log_type: 'WINDOWS_SYSMON'
    override_log_type: false
    raw_log_field: body
    customer_id: 'dddddddd-dddd-dddd-dddd-dddddddddddd'
  chronicle/winevtlog:
    endpoint: malachiteingestion-pa.googleapis.com
    creds: '{
  "type": "service_account",
  "project_id": "malachite-projectname",
  "private_key_id": "abcdefghijklmnopqrstuvwxyz123456789",
  "private_key": "-----BEGIN PRIVATE KEY-----abcdefg-----END PRIVATE KEY-----\n",
  "client_email": "account@malachite-projectname.iam.gserviceaccount.com",
  "client_id": "123456789123456789",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/account%40malachite-projectname.iam.gserviceaccount.com",
  "universe_domain": "googleapis.com"
}'
    log_type: 'WINEVTLOG'
    override_log_type: false
    raw_log_field: body
    customer_id: 'dddddddd-dddd-dddd-dddd-dddddddddddd'

service:
  pipelines:
    logs/sysmon:
      receivers: [windowseventlog/sysmon]
      processors: [batch]
      exporters: [chronicle/sysmon]
    logs/winevtlog:
      receivers: 
        - windowseventlog/security
        - windowseventlog/application
        - windowseventlog/system
      processors: [batch]
      exporters: [chronicle/winevtlog]

Envía eventos de Windows y syslog directamente a Google SecOps

Configura estos parámetros en la muestra:

Configuración de ejemplo

receivers:
    tcplog:
      listen_address: "0.0.0.0:54525"
    windowseventlog/source0__application:
        attributes:
            log_type: windows_event.application
        channel: application
        max_reads: 100
        poll_interval: 1s
        raw: true
        start_at: end
    windowseventlog/source0__security:
        attributes:
            log_type: windows_event.security
        channel: security
        max_reads: 100
        poll_interval: 1s
        raw: true
        start_at: end
    windowseventlog/source0__system:
        attributes:
            log_type: windows_event.system
        channel: system
        max_reads: 100
        poll_interval: 1s
        raw: true
        start_at: end
exporters:
    chronicle/chronicle_w_labels:
        compression: gzip
        creds: '{ json blob for creds }'
        customer_id: <customer_id>
        endpoint: malachiteingestion-pa.googleapis.com
        ingestion_labels:
            env: dev
        log_type: <applicable_log_type>
        namespace: testNamespace
        raw_log_field: body
service:
    pipelines:
        logs/source0__chronicle_w_labels-0:
            receivers:
                - windowseventlog/source0__system
                - windowseventlog/source0__application
                - windowseventlog/source0__security
            exporters:
                - chronicle/chronicle_w_labels
        logs/source1__chronicle_w_labels-0:
            receivers:
                - tcplog
            exporters:
                - chronicle/chronicle_w_labels

Envía eventos de Windows y syslog al agente de reenvío de Google SecOps

Configura estos parámetros en la muestra:

Configuración de ejemplo

receivers:
tcplog:
    listen_address: "0.0.0.0:54525"
    windowseventlog/source0__application:
        attributes:
            log_type: windows_event.application
        channel: application
        max_reads: 100
        poll_interval: 1s
        raw: true
        start_at: end
    windowseventlog/source0__security:
        attributes:
            log_type: windows_event.security
        channel: security
        max_reads: 100
        poll_interval: 1s
        raw: true
        start_at: end
    windowseventlog/source0__system:
        attributes:
            log_type: windows_event.system
        channel: system
        max_reads: 100
        poll_interval: 1s
        raw: true
        start_at: end
exporters:
    chronicleforwarder/forwarder:
        export_type: syslog
        raw_log_field: body
        syslog:
            endpoint: 127.0.0.1:10514
            transport: udp
service:
    pipelines:
        logs/source0__forwarder-0:
            receivers:
                - windowseventlog/source0__system
                - windowseventlog/source0__application
                - windowseventlog/source0__security
            exporters:
                - chronicleforwarder/forwarder
        logs/source1__forwarder-0:
            receivers:
                - tcplog
            exporters:
                - chronicleforwarder/forwarder

Envía syslog directamente a Google SecOps

Configura estos parámetros en la muestra:

Configuración de ejemplo

receivers:
  tcplog:
    listen_address: "0.0.0.0:54525"

exporters:
    chronicle/chronicle_w_labels:
        compression: gzip
        creds: '{ json blob for creds }'
        customer_id: <customer_id>
        endpoint: malachiteingestion-pa.googleapis.com
        ingestion_labels:
            env: dev
        log_type: <applicable_log_type>
        namespace: testNamespace
        raw_log_field: body
service:
    pipelines:
        logs/source0__chronicle_w_labels-0:
            receivers:
                - tcplog
            exporters:
                - chronicle/chronicle_w_labels

Recopila eventos de Windows de forma remota y envíalos directamente a Google SecOps

Configura estos parámetros en la muestra:

  • windowseventlogreceiver
    • username
    • password
    • server
  • chronicleexporter
    • namespace
    • ingestion_labels
    • log_type
    • customer_id
    • creds

Configuración de ejemplo

receivers:
    windowseventlog/system:
        channel: system
        max_reads: 100
        start_at: end
        poll_interval: 10s
        raw: true
        remote:
            username: "username"
            password: "password"
            server: "remote-server"
    windowseventlog/application:
        channel: application
        max_reads: 100
        start_at: end
        poll_interval: 10s
        raw: true
        remote:
            username: "username"
            password: "password"
            server: "server-ip"
    windowseventlog/security:
        channel: security
        max_reads: 100
        start_at: end
        poll_interval: 10s
        raw: true
        remote:
            username: "username"
            password: "password"
            server: "server-ip"
exporters:
    chronicle/chronicle_w_labels:
        compression: gzip
        creds: '{ json blob for creds }'
        customer_id: <customer_id>
        endpoint: malachiteingestion-pa.googleapis.com
        ingestion_labels:
            env: dev
        log_type: WINEVTLOG
        namespace: testNamespace
        raw_log_field: body
service:
    pipelines:
        logs/source0__chronicle_w_labels-0:
            receivers:
                - windowseventlog/system
                - windowseventlog/application
                - windowseventlog/security
            exporters:
                - chronicle/chronicle_w_labels

Envía datos a Cloud Logging

Configura el parámetro credentials_file en la muestra.

Configuración de ejemplo

exporters:
  googlecloud:
    credentials_file: /opt/observiq-otel-collector/credentials.json

Consulta una base de datos SQL y envía los resultados a Google SecOps

Configura estos parámetros en la muestra:

Configuración de ejemplo

receivers:
  sqlquery/source0:
    datasource: host=localhost port=5432 user=postgres password=s3cr3t sslmode=disable
    driver: postgres
    queries:
      - logs:
          - body_column: log_body
        sql: select * from my_logs where log_id > $$1
        tracking_column: log_id
        tracking_start_value: "10000"
processors:
  transform/source0_processor0__logs:
    error_mode: ignore
    log_statements:
      - context: log
        statements:
          - set(attributes["chronicle_log_type"], "POSTGRESQL") where true
exporters:
  chronicle/chronicle_sql:
    compression: gzip
    creds: '{
  "type": "service_account",
  "project_id": "malachite-projectname",
  "private_key_id": "abcdefghijklmnopqrstuvwxyz123456789",
  "private_key": "-----BEGIN PRIVATE KEY-----abcdefg-----END PRIVATE KEY-----\n",
  "client_email": "account@malachite-projectname.iam.gserviceaccount.com",
  "client_id": "123456789123456789",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/account%40malachite-projectname.iam.gserviceaccount.com",
  "universe_domain": "googleapis.com"
}' 
    customer_id: customer_id
    endpoint: malachiteingestion-pa.googleapis.com
    log_type: POSTGRESQL
    namespace: null
    raw_log_field: body
    retry_on_failure:
      enabled: false
    sending_queue:
      enabled: false
service:
  pipelines:
    logs/source0_chronicle_sql-0:
      receivers:
        - sqlquery/source0
      processors:
        - transform/source0_processor0__logs
      exporters:
        - chronicle/chronicle_sql

Descarta los registros que coincidan con una expresión regular

Puedes configurar el recopilador para que descarte los registros que coincidan con una expresión regular. Esto es útil para filtrar registros no deseados, como errores conocidos o mensajes de depuración.

Para descartar los registros que coincidan con una expresión regular, agrega un procesador de tipo filter/drop-matching-logs-to-Chronicle a tu configuración. Este procesador usa la función IsMatch para evaluar el cuerpo del registro con la expresión regular. Si la función devuelve true, se descarta el registro.

En el siguiente ejemplo de configuración, se descartan los registros que contienen las cadenas <EventID>10</EventID> o <EventID>4799</EventID> en el cuerpo del registro.

Puedes personalizar la expresión regular para que coincida con cualquier patrón que necesites. La función IsMatch usa la sintaxis de expresión regular RE2.

Configuración de ejemplo

processors:
    filter/drop-matching-logs-to-Chronicle:
        error_mode: ignore
        logs:
            log_record:
                - (IsMatch(body, "<EventID>10</EventID>")) or (IsMatch(body, "<EventID>4799</EventID>"))

En el siguiente ejemplo, se agrega el procesador a la canalización en la misma configuración:

service:
  pipelines:
    logs/winevtlog:
      receivers: 
        - windowseventlog/security
        - windowseventlog/application
        - windowseventlog/system
      processors: 
      - filter/drop-matching-logs-to-Chronicle # Add this line
      - batch
      exporters: [chronicle/winevtlog]

Operación y mantenimiento de BindPlane

En esta sección, se describen las acciones de operación y mantenimiento de rutina.

Verifica una configuración de OTel

Para obtener información sobre cómo verificar la configuración de OTel de Bindplane, consulta OTelBin.

Actualizaciones de versiones del recopilador

Bindplane puede sondear bindplane-otel-collector/releases para detectar nuevas versiones del recopilador. Esta función es opcional.

Para inhabilitar el sondeo de GitHub, establece agentVersions.syncInterval en 0 en tu configuración de Bindplane:

agentVersions:
syncInterval: 0

Copia de seguridad y recuperación ante desastres

Para obtener información sobre la copia de seguridad y la recuperación ante desastres con Bindplane, consulta Recursos de Bindplane.

Copia de seguridad y recuperación ante desastres de PostgreSQL

Para obtener información sobre la copia de seguridad y la recuperación ante desastres de PostgreSQL con Bindplane, consulta la documentación de PostgreSQL.

Copia de seguridad y recuperación ante desastres de BBolt

Para obtener información sobre la copia de seguridad y la recuperación ante desastres de BBolt (obsoleto) con Bindplane, consulta la documentación de BBolt Store.

Resiliencia y reintentos

Los reintentos están habilitados de forma predeterminada en todos los destinos que los admiten. De forma predeterminada, las solicitudes con errores se reintentan después de cinco segundos y se retiran de forma progresiva durante un máximo de 30 segundos. Después de cinco minutos, las solicitudes se descartan de forma permanente.

Para obtener más información, consulta Resiliencia del recopilador.

Reduce el volumen de registros con el filtro de gravedad

Para aprender a reducir el volumen de registros, consulta Reduce el volumen de registros con el filtro de gravedad.

Integraciones de Bindplane con recopiladores de terceros

Aunque Bindplane es más potente cuando usas el recopilador de Bindplane para la recopilación en el perímetro, en la mayoría de los casos, Bindplane puede permanecer dentro de tu infraestructura existente. Por ejemplo, si ya usas Fluent Bit o Splunk Universal Forwarders, puedes seguir haciéndolo.

Integración de Bindplane con Splunk

Para obtener información sobre Splunk con BindPlane, consulta lo siguiente:

Integraciones de Bindplane con otros recopiladores de terceros

Para obtener información sobre las integraciones de BindPlane con recopiladores de terceros, consulta Conecta otros recopiladores de OpenTelemetry con la extensión de OpAMP.

Supervisión silenciosa de hosts

La supervisión de hosts silenciosos de Google Security Operations te permite crear alertas para los cambios en la tasa de transferencia con Google Cloud Monitoring. Genera alertas por recopilador y te notifica cuando la tasa de transferencia cae por debajo del umbral definido, lo que indica posibles detenciones del recopilador.

Para obtener información sobre el uso de Bindplane para la supervisión de hosts silenciosos, consulta lo siguiente:

Actualiza Bindplane en Linux

Ejecutar el comando de instalación sin la marca --init al final es suficiente para actualizar Bindplane. Ejecuta esta secuencia de comandos en tu servidor de Bindplane para actualizarlo. Para obtener más información, consulta Actualiza, cambia a una versión anterior o desinstala Bindplane Server.

Supervisa Bindplane

Para obtener información sobre cómo supervisar Bindplane, consulta Supervisa Bindplane.

Supervisa Kubernetes en Bindplane

Para obtener información sobre cómo supervisar Kubernetes en Bindplane, consulta Supervisión de Kubernetes.

Documentación adicional

Para obtener más información sobre Bindplane (antes conocido como observIQ), consulta los siguientes vínculos:

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