Tela: Configurações do Sistema

Para que serve

Central de preferências gerais da appliance: idioma do painel, token de acesso para integrações externas, retenção dos dados de flow no banco (ClickHouse) e a lista de IPs autorizados a acessar o painel. As alterações só têm efeito depois de clicar em 💾 Salvar no rodapé.

Seção Sistema

• IP de vinculação e IP do painel: apenas leitura (campos desabilitados). Mostram em qual endereço/porta o serviço está escutando. A porta e o bind são definidos na instalação do serviço, não dá para mudar por aqui.
• Idioma padrão: Português (pt-BR), English ou Español. Vale para novos acessos — quem já está logado só vê a mudança no próximo login.

Seção 🔑 Token da API

Interruptor que habilita o acesso externo por token. Com ele ligado, integrações podem chamar /api enviando o cabeçalho Authorization: Bearer <token>. Usuários logados no painel continuam funcionando normalmente, sem precisar do token.

• Campo do token (somente leitura) mostra a chave atual.
• Botão ↻ (Gerar novo): cria um novo token e já liga o interruptor. Aviso: gerar um token novo invalida o anterior — qualquer integração que usava o token antigo para de funcionar até ser atualizada.
• Botão ⧉ (Copiar): copia o token para a área de transferência.

Seção Retenção de dados

Define por quantos dias os fluxos são mantidos antes de serem apagados automaticamente (via TTL no ClickHouse). Campo Manter últimos (dias): vazio ou 0 = manter tudo, sem expiração.

⚠️ Aviso legal (provedores): o Marco Civil da Internet exige guardar registros de conexão por 1 ano. Se você digitar um valor entre 1 e 364, a tela mostra um alerta vermelho avisando que pode violar a retenção legal. O mínimo recomendado para ISP é 365 dias. Lembre que reter mais dias exige mais disco.

Seção 🛡️ IPs Permitidos

Lista branca de acesso ao painel: um CIDR por linha (IPv4 ou IPv6). A tela mostra o seu IP atual para referência.

• Vazio = libera todos (qualquer origem acessa o painel).
• Com uma ou mais linhas, só esses blocos conseguem abrir o painel.
• localhost é sempre liberado, mesmo que não esteja na lista.

⚠️ Cuidado: um CIDR errado pode bloquear o seu próprio acesso. Antes de salvar, confira se o seu IP atual (mostrado na tela) está contido em algum dos blocos que você digitou.

Passo a passo

1. Ajuste os campos desejados (idioma, retenção, IPs, token).
2. Se for restringir por IP, confirme que o seu IP atual está coberto.
3. Clique em 💾 Salvar. A mensagem ✓ Salvo confirma; erros aparecem em vermelho ao lado do botão.