Documentación de Prynt Gate

Inicio rápido de Prynt Gate

Prynt Gate registra cada conexión a tus servidores y puertos, comprueba la identidad que declara cada equipo y decide permitir, marcar o bloquear.

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 --enforce

Agente 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

Siguiente: Agente y bouncer

Actualizado 2026-11-15 · Referencia de la API