Skip to content

📊 LightSquid - Relatórios de Acesso Web no OpenFW

O LightSquid é o Addon responsável por gerar relatórios detalhados, visuais e de alto desempenho sobre o consumo de internet e tráfego HTTP/HTTPS processados pelo Proxy do OpenFW UTM Community.

📝 Visão Geral

Por padrão, o OpenFW UTM Community processa as requisições de navegação através do motor do Squid, registrando tudo em arquivos de texto puros (logs). O LightSquid atua mapeando esses logs brutos e transformando-os em uma interface gráfica de fácil leitura, permitindo auditorias por usuário, por IP, por sites mais acessados, horários de pico e consumo de banda.

O gerenciamento deste recurso pode ser feito de forma simples através da Interface Web, ou em modo avançado via Linha de Comando (CLI).

📥 1. Instalação do Addon

🌐 Método Padrão: Via Interface Web

A maneira mais rápida e recomendada para instalar o gerador de relatórios é utilizando a loja de módulos integrada:

  • ⏱️ Acesse o menu superior e navegue até System > Addons and Packages.
  • 🔍 Localize o addon lightsquid na lista de módulos disponíveis. Se não estiver visível, clique em Update Repo.
  • 🚀 Clique em instalar e aguarde o processo automatizado ser concluído pelo painel.

💻 Método Avançado: Via Linha de Comando (CLI / SSH)

Caso prefira realizar a auditoria da instalação em tempo real pelo terminal, conecte-se via SSH com o usuário root e execute os comandos abaixo de forma separada:

  1. Atualize a lista de pacotes do repositório: 

    smart update

  2. Prossiga com a instalação do pacote do LightSquid: 

    smart install lightsquid -y

Confirmação

Após o término da instalação por qualquer um dos métodos, um novo menu visual e link de acesso serão liberados em: Logs and Reports > LightSquid.

⚙️ 2. Ativação e Configuração Geral

Diferente de ferramentas de relatórios pesadas, o LightSquid é extremamente leve pois trabalha com geração estática. Para que ele funcione corretamente, realize os ajustes abaixo na Interface Web:

  1. 🧭 Acesse o menu superior: Logs and Reports > LightSquid.
  2. ⚡ Configurações: Ative a opção Ativar logs somente por usuário caso o seu Proxy Web esteja trabalhando com autenticação ativa.

Comportamento do Filtro

Ao ligar a chave Ativar logs somente por usuário, o sistema processará exclusivamente os relatórios dos acessos que foram devidamente autenticados no Proxy. Qualquer tráfego realizado ou mapeado com base apenas no endereço IP da estação será completamente descartado e não constará nos gráficos.

👥 3. Controle de Acesso e Permissões Administrativas

Caso outros colaboradores da empresa (como gestores, profissionais de RH ou auditores) necessitem auditar os relatórios de navegação sem possuir acesso total às configurações de rede e segurança do firewall, o sistema oferece um controle granular:

  • 👤 Criação de Usuários: Através das abas superiores Usuários e Grupo, é possível provisionar contas exclusivas e restritas para terceiros.
  • 👥 Grupo de Acesso Específico: Adicione os usuários criados ao grupo dedicado ao LightSquid. Dessa forma, ao se autenticarem, eles terão visibilidade e acesso restrito apenas às telas de relatórios, mantendo o restante do ecossistema UTM protegido e inacessível.

⏳ 4. Geração e Agendamento de Relatórios

O LightSquid lê o arquivo de logs do Squid e gera as páginas de relatórios consolidadas.

  • 🔄 Geração Manual via Web: Na aba principal do menu Logs and Reports > LightSquid, localize a seção Gerar relatório agora e clique no botão Gerar Relatório.
  • ⏰ Agendamento Automático: O sistema já cria nativamente uma tarefa agendada para processar e atualizar os relatórios de tempos em tempos de forma automatizada.

🔍 5. Diagnóstico e Processamento via Linha de Comando (CLI)

Se os relatórios estiverem desatualizados ou caso precise forçar a leitura e indexação imediata dos logs do Proxy de forma manual via terminal SSH, utilize o script nativo de parseamento do sistema:

/var/www/lightsquid/parser.sh

O que observar no diagnóstico:

  • ✅ Sucesso: Se o script rodar sem retornar erros e retornar ao prompt padrão do terminal, os logs foram reindexados. Clique no link Acessar os relatórios na interface WEB para visualizar os dados updated.
  • ❌ Falha ou Gráficos Vazios: Se o processamento manual não gerar dados, certifique-se no menu Proxy se os logs de navegação HTTP/HTTPS estão devidamente ativados e retendo tráfego. O LightSquid depende obrigatoriamente da escrita ativa de logs do Proxy para gerar dados estruturados.