Saltar al contenido principal

Agentes

Un agente (hagent) es un binario ligero que ejecutas dentro de tu propia red para escanear activos que no son accesibles desde internet público — hosts internos, bloques de red privados y cualquier cosa detrás de un firewall. Los hallazgos de agentes aparecen junto a los hallazgos detectados externamente y se pueden filtrar por separado usando el filtro de fuente Agente en el Panel.

Conectar un nuevo agente​

  1. Ve a Agentes y haz clic en Nuevo agente.

  2. Cada agente pertenece a un proyecto — se completa automáticamente con tu proyecto seleccionado actualmente, o se te pedirá elegir uno si estás viendo Todos los proyectos. Opcionalmente, establece un Nombre y Etiquetas para identificar el agente — útil cuando tienes más de uno.

  3. Crea el agente. HoundER genera un token de registro de un solo uso y lo muestra en un diálogo — cópialo ahora, no se vuelve a mostrar, y expira después de 1 hora si no se usa.

  4. Descarga el binario hagent para tu plataforma desde la página de versiones del agente, o usa la imagen de Docker.

  5. Ejecútalo con el token, usando la forma que corresponda a tu entorno:

    # Linux / macOS
    HOUNDER_AGENT_TOKEN=<token> ./hagent
    # Windows PowerShell
    $env:HOUNDER_AGENT_TOKEN = "<token>"; .\hagent.exe
    # Docker
    docker run -e HOUNDER_AGENT_TOKEN=<token> registry.gitlab.com/hounder/agent:latest

El agente intercambia el token por una identidad en ejecución y aparece en la tabla de Agentes con estado pending, pasando a online una vez que establece un heartbeat.

Requisitos​

  • Linux (amd64/arm64), macOS (Intel o Apple Silicon), o Windows 10/11 (amd64).
  • Mínimo 2 CPU / 4GB RAM.
  • Acceso de red saliente a https://agents.hounder.io:443 — no se requieren puertos entrantes.

Gestionar agentes​

La tabla de Agentes muestra el estado, nombre/etiquetas, versión, SO, IP externa y última conexión de cada agente. Desde aquí puedes renombrar un agente, ver sus registros (una vez en línea) o eliminarlo.

Valores de estado del agente:

  • online — conectado activamente y disponible para ejecutar escaneos.
  • offline — estuvo conectado pero no ha enviado un heartbeat recientemente.
  • pending — registrado pero aún no se ha conectado (o su token de registro expiró antes de conectarse — en ese caso, elimínalo y registra uno nuevo).

Un agente debe estar online antes de que puedas seleccionarlo al lanzar un escaneo.