1. Crea un sensor
En la consola abre Gate → Sensores → Nuevo sensor. Un sensor es una máquina o servicio que envía eventos. Su token (gk_live_…) se muestra una vez: cópialo, solo se guarda su hash.
Los tokens son por entorno (live, test, staging). La clave secreta del entorno (sk_live_…) también sirve, con el nombre del sensor en el cuerpo.
2. Instala el agente
En el equipo Linux, ejecuta el comando que muestra la consola. El agente arranca en modo de prueba (dry-run): envía eventos y calcula qué bloquearía, sin tocar el firewall.
# 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 --enforceAgente y bouncer tiene la variante con Docker, la configuración y cómo pasar a aplicar.
3. Envía un evento de prueba
Sin el agente, desde cualquier máquina:
curl https://api.pryntid.com/v1/gate/events \
-H "Authorization: Bearer gk_live_YOUR_SENSOR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"events":[{"eventId":"test-1","port":22,"protocol":"ssh",
"srcIp":"203.0.113.7","claimedIdentity":{"type":"username","value":"root"},
"outcome":"auth_fail"}]}'Aparece en Gate → En vivo con su país, red, puntuación y motivos. Si lo repites con el mismo eventId cuenta como duplicado.
4. Ajusta y luego aplica
- Añade tu LAN, router e IPs de monitorización a la lista de permitidos (Gate → Ajustes): nunca se bloquean.
- Observa las decisiones unos días; ajusta umbrales o añade reglas.
- Pasa el sensor a aplicar (enforce); el bouncer empieza a aplicar los bloqueos con su caducidad.
- Añade canales de alerta (correo, Slack, Telegram) y webhooks.
Siguientes pasos
- Agente y bouncer: instalación, configuración, nftables o ufw, modo de prueba.
- Fuentes de logs: parsers, Vector y Fluent Bit.
- Referencia de la API: eventos, logs, bloqueos, heartbeat, detectores, reglas, webhooks.
- Ejemplo: rastreadores GPS y un receptor de alarmas.
Actualizado 2026-11-15 · Referencia de la API