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 --enforceAgente 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
- Agente e bouncer: instalação, configuração, nftables ou ufw, modo de teste.
- Fontes de logs: parsers, Vector e Fluent Bit.
- Referência da API: eventos, logs, bloqueios, heartbeat, detectores, regras, webhooks.
- Exemplo: rastreadores GPS e um receptor de alarmes.
Atualizado 2026-11-15 · Referência da API