Documentação do Prynt Gate

Agente e bouncer

Um agente pequeno por host: lê seus logs, envia eventos em lotes e aplica os bloqueios no firewall do host.

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

Instala 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-agent

A 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

  1. Lê os logs que você ativa e transforma cada linha relevante em um evento com um dos parsers.
  2. Envia lotes para POST /v1/gate/events; se a API não responder, guarda em uma fila local e tenta de novo.
  3. A cada 30 segundos lê GET /v1/gate/blocks e reconcilia o firewall com a lista completa de bloqueios ativos.
  4. 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 --enforce na 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.

Próximo: Fontes de logs

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