Skip to content

🔍 Auditoria de Configuração (Configuration Audit) no OpenFW

O recurso de Auditoria de Configuração do OpenFW UTM Community monitora, rastreia e registra em tempo real todas as alterações efetuadas nas configurações do sistema. Ele permite identificar quem alterou, qual arquivo foi modificado, qual o endereço IP de origem e quais alterações exatas (Diff) foram aplicadas.

Ademais, o serviço que roda sob o nome config-audit se integra nativamente ao módulo de Backup, gerando snapshots automáticos a cada modificação para possibilitar a restauração pontual e rápida de um único recurso alterado, sem a necessidade de restaurar um backup completo do UTM.


⚙️ 1. Visualização de Logs e Histórico de Alterações (History & Diff)

A tela principal de auditoria reúne o histórico detalhado das ações executadas na plataforma, oferecendo visibilidade completa sobre modificações e criação de arquivos de parametrização.

  1. 🧭 Acesse o menu superior: REGISTROS E RELATÓRIOS (ou LOGS AND REPORTS).
  2. 📂 No menu lateral esquerdo, selecione a opção Configuration Audit.
  3. 📂 Aba Configuration Audit: Nesta visualização, é exibida a tabela Configuration Audit Logs (History & Diff) com as colunas:
    • Data: Data e hora exatas da modificação.
    • User: Usuário responsável pela ação (ex: admin ou system).
    • IP: Endereço IP do administrador que efetuou a alteração.
    • Arquivo: Caminho absoluto do arquivo modificado (ex: /var/efw/openvpn/settings).
    • Ação: Tipo de alteração efetuada (created, modified, baseline, etc.).
    • Diff / Changes: Clique no ícone de informação ℹ️ para visualizar as diferenças detalhadas entre a versão anterior e a versão atualizada do recurso.
  4. 🔎 Filtro de Consulta: Utilize os campos de intervalo de tempo (Time interval) e o campo de busca (Filtro) para localizar eventos específicos e exportar os registros em arquivo .log.

📧 2. Notificações por E-mail e Integração com EmailRelay

Você pode configurar o OpenFW para enviar alertas instantâneos por e-mail a cada alteração efetuada nas configurações do UTM.

  1. 🧭 Na mesma tela de auditoria, acesse a aba superior Email Notifications.
  2. 🔌 Integração com o Addon EmailRelay: Caso você já possua o addon EmailRelay instalado e configurado no sistema, marque a opção Use EmailRelay Smarthost Settings. O OpenFW detectará e utilizará automaticamente as configurações de SMTP já parametrizadas no Smarthost.
  3. ✉️ Ativação: Marque a opção Enable Notifications para ativar o envio de alertas.
  4. 📝 Parâmetros de E-mail:
    • Sender Email (From): Endereço de e-mail que figurará como remetente.
    • Recipient Email(s) (To): Endereço de e-mail (ou lista de e-mails) que receberá os alertas de auditoria.
    • Subject Prefix: Prefixo para o assunto das mensagens (ex: [OpenFW Audit]).
  5. 🧪 Teste de Envio: Clique no botão Send Test Email para validar as configurações de entrega antes de salvar.

🔄 3. Integração com Snapshots de Backup e Restauração Pontual

A grande vantagem do serviço config-audit é o seu acoplamento ao motor de backup do OpenFW. Toda vez que um arquivo de configuração é alterado, o serviço cria automaticamente um snapshot de segurança específico daquele arquivo.

Isso permite desfazer alterações indesejadas em um único serviço sem afetar as demais configurações do UTM e sem precisar restaurar um arquivo de backup global.

Como Restaurar um Snapshot Pontual:

  1. 🧭 Acesse o menu superior: SISTEMA (ou SYSTEM).
  2. 📂 No menu lateral esquerdo, selecione a opção Cópia de Segurança (ou Backup).
  3. 📂 Acesse a aba superior Restore Snapshots (ou Restore Snapshots Config).
  4. 📋 Lista de Snapshots disponíveis: A tabela exibirá todos os arquivos salvos pelo serviço config-audit, detalhando:
    • Snapshot File: Nome do arquivo de backup do snapshot gerado com carimbo de data/hora (ex: var_efw_openvpn_settings.20261006_192334.bak).
    • Target Destination: O caminho de destino exato onde o recurso será restaurado (ex: /var/efw/openvpn/settings).
    • Date / Time / Tamanho: Informações temporais e dimensões do arquivo.
  5. ⏪ Executar a Restauração: Localize o snapshot do recurso que deseja reverter e utilize as ações da tabela para restaurar apenas as configurações daquele item específico para o estado anterior.

Lembrete Obrigatório: Reinício do Serviço via CLI (jobcontrol)

A restauração do snapshot sobrescreve o arquivo de configuração no disco, mas não aplica as alterações em memória nem reinicia automaticamente o serviço correspondente.

Para que a configuração restaurada entre em vigor, você deve acessar o terminal (SSH ou Console) como root e reiniciar o serviço correspondente utilizando o comando jobcontrol.

1. Listar os serviços disponíveis:

jobcontrol list

2. Reiniciar o serviço do recurso restaurado (Sintaxe: jobcontrol restart <nome-do-servico>): * Exemplo para Regras de Firewall/Zonas:

jobcontrol restart setzonefw
* Exemplo para o OpenVPN:
jobcontrol restart openvpnjob
* Exemplo para o Suricata (IDS/IPS):
jobcontrol restart suricata