Documentação do Prynt Gate

Início rápido do Prynt Gate

O Prynt Gate registra cada conexão aos seus servidores e portas, verifica a identidade que cada equipamento declara e decide permitir, sinalizar ou bloquear.

1. Crie um sensor

No console abra Gate → Sensores → Novo sensor. Um sensor é uma máquina ou serviço que envia eventos. O token (gk_live_…) aparece uma vez: copie, só o hash é guardado.

Os tokens são por ambiente (live, test, staging). A chave secreta do ambiente (sk_live_…) também funciona, com o nome do sensor no corpo.

2. Instale o agente

No host Linux, rode o comando que o console mostra. O agente começa em modo de teste (dry-run): envia eventos e calcula o que bloquearia, sem mudar o 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 e bouncer tem a variante Docker, a configuração e como passar a aplicar.

3. Envie um evento de teste

Sem o agente, de qualquer 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"}]}'

Ele aparece em Gate → Ao vivo com país, rede, pontuação e motivos. Repita com o mesmo eventId e ele conta como duplicado.

4. Ajuste e depois aplique

  • Adicione sua LAN, roteador e IPs de monitoramento à lista de permissões (Gate → Configurações): nunca são bloqueados.
  • Acompanhe as decisões por alguns dias; ajuste limites ou adicione regras.
  • Mude o sensor para aplicar (enforce); o bouncer começa a aplicar os bloqueios com expiração.
  • Adicione canais de alerta (e-mail, Slack, Telegram) e webhooks.

Próximos passos

Próximo: Agente e bouncer

Atualizado 2026-11-15 · Referência da API