Prynt Gate docs

Prynt Gate quick start

Prynt Gate records every connection to your servers and ports, checks the identity each device claims and decides allow, flag or block.

1. Create a sensor

In the console open Gate → Sensors → New sensor. A sensor is one machine or service that sends events. Its token (gk_live_…) is shown once: copy it, it is stored only as a hash.

Tokens are per environment (live, test, staging). The environment's secret key (sk_live_…) also works, with the sensor name in the body.

2. Install the agent

On the Linux host, run the command the console shows. The agent starts in dry-run: it sends events and computes what it would block, but changes no firewall rule.

# 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

Agent and bouncer has the Docker variant, the configuration and how to switch to enforce.

3. Send a test event

Without the agent, from any machine:

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"}]}'

It appears in Gate → Live with its country, network, score and reasons. Repeat it with the same eventId and it counts as a duplicate.

4. Tune, then enforce

  • Add your LAN, router and monitoring IPs to the allowlist (Gate → Settings): they are never blocked.
  • Watch the decisions for a few days; adjust thresholds or add rules.
  • Switch the sensor to enforce; the bouncer starts applying blocks with their TTL.
  • Add alert channels (email, Slack, Telegram) and webhooks.

Next steps

Next: Agent and bouncer

Updated 2026-11-15 · API reference