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 --enforceInstala 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-agentLa 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
- Lee los logs que activas y convierte cada línea relevante en un evento con uno de los parsers.
- Envía lotes a
POST /v1/gate/events; si no llega a la API, los guarda en una cola local y reintenta. - Cada 30 segundos lee
GET /v1/gate/blocksy reconcilia el firewall con la lista completa de bloqueos activos. - 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
--enforceal 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.
Actualizado 2026-11-15 · Referencia de la API