Documentación de Prynt Gate

Agente y bouncer

Un agente pequeño por equipo: lee tus logs, envía eventos por lotes y aplica los bloqueos en el firewall del equipo.

Instalación

La consola (Gate → Sensores) muestra el comando exacto de cada sensor, con su URL de instalación y su token:

# Console → Gate → Sensors → New sensor shows this command with your token
curl -fsSL https://api.pryntid.com/v1/gate/agent/install.sh | sudo sh -s -- \
  --token gk_live_YOUR_SENSOR_TOKEN \
  --parser traccar:/opt/traccar/logs/tracker-server.log \
  --parser sshd:journal:ssh.service \
  --bouncer nftables            # dry-run until you pass --enforce

Instala el agente como servicio de systemd, detecta nftables o ufw y arranca en modo de prueba. O ejecútalo como contenedor (la red del host y NET_ADMIN solo hacen falta para aplicar bloqueos):

# Logs only (no firewall changes, unprivileged): configuration in /etc/prynt-gate/agent.json
docker run -d --name prynt-gate --restart unless-stopped \
  -v /etc/prynt-gate:/etc/prynt-gate:ro -v prynt-gate-state:/var/lib/prynt-gate \
  -v /var/log:/host/log:ro  prynt-gate-agent

# With the nftables bouncer: host network namespace and only CAP_NET_ADMIN
docker run -d --name prynt-gate --restart unless-stopped --network host --cap-drop ALL --cap-add NET_ADMIN \
  --user 0 -v /etc/prynt-gate:/etc/prynt-gate:ro -v prynt-gate-state:/var/lib/prynt-gate \
  -v /var/log:/host/log:ro  prynt-gate-agent

La configuración está en /etc/prynt-gate/agent.json (el script de instalación la escribe a partir de sus opciones); el token se guarda en /etc/prynt-gate/token con permisos 0600:

{
  "apiBase": "https://api.pryntid.com",
  "tokenFile": "/etc/prynt-gate/token",
  "sources": [
    {"parser": "traccar", "path": "/opt/traccar/logs/tracker-server.log"},
    {"parser": "sshd", "journal": {"unit": "ssh.service"}},
    {"parser": "fail2ban", "path": "/var/log/fail2ban.log"}
  ],
  "bouncer": {
    "enabled": true,
    "backend": "nftables",
    "dryRun": true,
    "allowlist": ["203.0.113.10/32"],
    "useDefaultAllowlist": true
  }
}

Prueba un parser sobre un archivo sin enviar nada:

prynt-gate parse --parser traccar /opt/traccar/logs/tracker-server.log   # prints events, sends nothing

Qué hace

  1. Lee los logs que activas y convierte cada línea relevante en un evento con uno de los parsers.
  2. Envía lotes a POST /v1/gate/events; si no llega a la API, los guarda en una cola local y reintenta.
  3. Cada 30 segundos lee GET /v1/gate/blocks y reconcilia el firewall con la lista completa de bloqueos activos.
  4. Envía un latido, así Gate → Sensores lo muestra en línea con su versión, modo y bloqueos aplicados.

El bouncer

  • nftables: una tabla propia con sets IPv4 e IPv6 cuyos elementos llevan la caducidad del bloqueo, así que expira aunque el agente se detenga.
  • ufw: reglas deny from <ip> marcadas con un comentario; el agente las quita cuando el bloqueo caduca o se revoca.
  • Lista de permitidos: la de la cuenta y la del sensor (desde la API) más una local. Nunca se bloquean las direcciones permitidas, los rangos privados, de loopback y CGNAT, las direcciones del propio equipo ni las de la API, diga lo que diga la API.
  • Modo de prueba: registra qué añadiría o quitaría sin tocar el firewall. Pasa --enforce al instalar (o "dryRun": false) para aplicar bloqueos; la consola también puede devolver un sensor al modo de prueba.

Detrás de un router que reescribe la dirección de origen (SNAT), todas las conexiones pueden parecer del router. Comprueba que tus logs muestran IPs públicas reales y añade el router a la lista de permitidos, o cada bloqueo caería sobre tu propia puerta de enlace.

Siguiente: Fuentes de logs

Actualizado 2026-11-15 · Referencia de la API