Instalação
O console (Gate → Sensores) mostra o comando exato de cada sensor, com a URL de instalação e o token:
# 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 --enforceInstala o agente como serviço systemd, detecta nftables ou ufw e começa em modo de teste. Ou rode como contêiner (rede do host e NET_ADMIN só são necessários para aplicar bloqueios):
# Logs only (no firewall changes, unprivileged): configuration in /etc/prynt-gate/agent.json
docker run -d --name prynt-gate --restart unless-stopped \
-v /etc/prynt-gate:/etc/prynt-gate:ro -v prynt-gate-state:/var/lib/prynt-gate \
-v /var/log:/host/log:ro prynt-gate-agent
# With the nftables bouncer: host network namespace and only CAP_NET_ADMIN
docker run -d --name prynt-gate --restart unless-stopped --network host --cap-drop ALL --cap-add NET_ADMIN \
--user 0 -v /etc/prynt-gate:/etc/prynt-gate:ro -v prynt-gate-state:/var/lib/prynt-gate \
-v /var/log:/host/log:ro prynt-gate-agentA configuração fica em /etc/prynt-gate/agent.json (o script de instalação a escreve a partir das opções); o token fica em /etc/prynt-gate/token com permissão 0600:
{
"apiBase": "https://api.pryntid.com",
"tokenFile": "/etc/prynt-gate/token",
"sources": [
{"parser": "traccar", "path": "/opt/traccar/logs/tracker-server.log"},
{"parser": "sshd", "journal": {"unit": "ssh.service"}},
{"parser": "fail2ban", "path": "/var/log/fail2ban.log"}
],
"bouncer": {
"enabled": true,
"backend": "nftables",
"dryRun": true,
"allowlist": ["203.0.113.10/32"],
"useDefaultAllowlist": true
}
}Teste um parser em um arquivo sem enviar nada:
prynt-gate parse --parser traccar /opt/traccar/logs/tracker-server.log # prints events, sends nothing O que faz
- Lê os logs que você ativa e transforma cada linha relevante em um evento com um dos parsers.
- Envia lotes para
POST /v1/gate/events; se a API não responder, guarda em uma fila local e tenta de novo. - A cada 30 segundos lê
GET /v1/gate/blockse reconcilia o firewall com a lista completa de bloqueios ativos. - Envia um heartbeat, então Gate → Sensores mostra o agente online com versão, modo e bloqueios aplicados.
O bouncer
- nftables: uma tabela própria com sets IPv4 e IPv6 cujos elementos levam a expiração do bloqueio, então ele expira mesmo se o agente parar.
- ufw: regras
deny from <ip>marcadas com um comentário; o agente as remove quando o bloqueio expira ou é revogado. - Lista de permissões: a da conta e a do sensor (vindas da API) mais uma local. Endereços permitidos, faixas privadas, de loopback e CGNAT, os endereços do próprio host e os da API nunca são bloqueados, diga o que disser a API.
- Modo de teste: registra o que adicionaria ou removeria sem mexer no firewall. Use
--enforcena instalação (ou"dryRun": false) para aplicar bloqueios; o console também pode devolver um sensor ao modo de teste.
Atrás de um roteador que reescreve o endereço de origem (SNAT), toda conexão pode parecer vir do roteador. Confira se seus logs mostram IPs públicos reais e coloque o roteador na lista de permissões, ou cada bloqueio cairia no seu próprio gateway.
Atualizado 2026-11-15 · Referência da API