Deep Dive: AIDE e rkhunter num host K3s – verificações de integridade sem se afogar em alarmes falsos
AIDE e rkhunter reportam cada mudança em arquivos de sistema. Num host Kubernetes, porém, algo muda o tempo todo. Como configurar os dois para que um alarme volte a significar algo – e os alarmes falsos que me levaram até lá.

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
Um verificador de integridade é tão bom quanto os e-mails que ele manda. Se ele reporta centenas de mudanças toda manhã, depois de uma semana ninguém lê mais — e o único achado real se perde junto. Esse era o meu problema com AIDE e rkhunter em três hosts K3s: os dois funcionavam, mas na maior parte do tempo reportavam coisas que eu mesmo tinha causado.
Este deep dive mostra o que as duas ferramentas fazem, de onde vem o ruído num host Kubernetes e como a baseline acompanha cada mudança intencional.
Índice
🧾 O que o AIDE faz
O AIDE (Advanced Intrusion Detection Environment) monta um banco de dados: para cada arquivo vigiado ele guarda checksums, permissões, dono, tamanho e timestamps. A verificação diária compara o sistema de arquivos com essa baseline. Se alguém muda um programa em /usr/bin ou uma configuração em /etc, isso aparece — mesmo que o atacante tenha limpado os logs.
O meu roda uma vez por dia e só manda e-mail quando o AIDE de fato encontra diferenças. Dois detalhes o tornam utilizável:
- Várias threads: o AIDE 0.19 consegue calcular hashes em paralelo. Com uma thread, uma execução levava de 38 segundos a um minuto e meio; agora ele usa uma thread por vCPU, com prioridade baixa.
- O exit code é uma bitmask: 1 = arquivos adicionados, 2 = removidos, 4 = alterados. Valores de 1 a 7 significam, portanto, “diferenças encontradas”; só 14 ou mais é erro do próprio AIDE. Trate isso como um código de erro comum e você aborta exatamente quando o AIDE fez o seu trabalho — que é o que a minha primeira versão fazia.
A lição: o AIDE não diz “bom” ou “ruim”, ele diz “diferente de ontem”. Se isso é um achado depende de a baseline estar atualizada.
🐳 De onde vem o ruído num host K3s
Um host Kubernetes muda o tempo todo sem que nada suspeito esteja acontecendo. Três lugares geravam alarmes falsos regularmente para mim:
/var/log/pods: o K3s cria um subdiretório a cada início de pod e a cada execução de CronJob. Isso muda a contagem de links do diretório pai — o AIDE reportava isso praticamente todo dia./var/log/containers: um symlink por container apontando para/var/log/pods. Se um pod de CronJob é limpo durante a verificação, o link fica pendurado, e o e-mail começava com “failed to access …”./boot/efi: um sistema de arquivos FAT que o AIDE não tem permissão de ler sob SELinux. Ele pulava a partição de qualquer jeito — mas cada execução produzia um lote de negações do SELinux, 13 por execução num dos hosts.
Os dois primeiros não são alvo de adulteração: são capturas efêmeras da saída dos containers, não programas nem configuração. Então foram excluídos, cada um com seu motivo no código. Para /boot/efi, excluir não basta: o AIDE ainda consulta as propriedades do sistema de arquivos com statfs(). Um pequeno módulo SELinux local permite exatamente essa única chamada — ler metadados do sistema de arquivos, nem um único arquivo nele. Os arquivos EFI vêm de pacotes, então o rpm -V os verifica se for preciso.
A lição: exclusões são ok, desde que cada uma tenha um motivo. “É irritante” não é motivo — “é efêmero e não é alvo de ataque” é.
🔄 A baseline precisa acompanhar
A maioria dos alarmes falsos, porém, vinha de mim. Toda mudança intencional — uma atualização de pacote, uma nova regra de firewall, um novo binário do K3s — é, de início, um desvio para o AIDE. Nos meus hosts existem três caminhos pelos quais arquivos vigiados mudam, e cada um precisa do seu próprio refresh:
- Execuções do Ansible: a última role de todo playbook é
common_aide_refresh. Ela rodaaide --update, que verifica e grava o novo banco numa única passada. Antes era uma verificação seguida de um update, ou seja, dois scans completos por execução. - Atualizações de segurança noturnas: o dnf-automatic instala atualizações à noite, sem Ansible. Depois de uma troca de kernel, o AIDE reportou na manhã seguinte 3.273 arquivos adicionados, 3.273 removidos e 364 alterados — kernel velho saiu, kernel novo entrou. Desde então um refresh separado roda às 04:00, depois da janela de atualização e do possível reboot às 03:30.
- Mudanças à mão: quem muda coisas fora desses dois caminhos precisa disparar o refresh por conta própria. Minha regra: depois de toda execução de playbook com
--tags, rodar também--tags common_rkhunter,common_aide_refresh— uma execução com tags pula a última role.
O terceiro caminho é o traiçoeiro. Quando instalei recentemente um kernel à mão à tarde, a verificação da meia-noite — antes do refresh das 04:00 — teria reportado exatamente esse kernel.
A lição: todo caminho pelo qual um sistema muda precisa de um refresh de baseline correspondente. Esqueça um e o alarme falso chega sem falta.
🦠 rkhunter: uma segunda opinião com suas próprias manias
O rkhunter (Rootkit Hunter) funciona de forma parecida, mas com outro foco: ele compara programas importantes do sistema com seu próprio banco de propriedades e procura vestígios de rootkits conhecidos. Ele também precisa de uma baseline atual, que o rkhunter --propupd cria.
Foram necessárias três coisas até ele ficar quieto:
- Um plugin do dnf em vez de um hook de timer: depois de cada transação do dnf que de fato alterou pacotes, um pequeno plugin roda
rkhunter --propupd. Minha primeira solução estava pendurada no serviço do dnf-automatic, então só disparava nas atualizações noturnas, não numdnf upgrademanual. - Um scan por noite: o pacote do EPEL traz seu próprio script em
/etc/cron.daily. Junto com a minha própria entrada no cron, cada host rodava dois scans completos por noite — e um aviso significava dois e-mails. O script do pacote foi removido, e uma configuração do rpm (%_netsharedpath) impede que a próxima atualização do rkhunter o coloque de volta. - Testes desativados, cada um com um motivo: alguns testes não combinam com AlmaLinux 9 ou K3s — o teste de configuração do SSH com um bug conhecido no rkhunter 1.4.6, por exemplo, ou os testes de módulos que procuram no caminho errado depois de uma troca de kernel. Cada teste desativado está listado com seu motivo na role.
Um detalhe para o princípio de drift: --propupd atualiza um banco derivado, não uma configuração. Por isso a task nunca reporta “changed” — senão toda execução de playbook pareceria drift.
A lição: um pacote às vezes traz sua própria ideia de como operar. Se você agenda as coisas por conta própria, desligue de propósito o agendamento que vem junto — e garanta que ele não volte.
💓 Quem verifica o verificador?
Uma verificação de integridade silenciosa só é boa se ela realmente roda. “Nenhum e-mail” pode significar duas coisas: está tudo bem — ou o job não roda mais. Por isso cada um desses jobs grava no final um timestamp (um heartbeat) para o Prometheus, e uma regra de alerta dispara quando algum deles fica velho demais.
Configurar os heartbeats trouxe à tona dois erros antigos:
- Num dos hosts, uma segunda verificação do AIDE feita à mão rodava às 05:00 — em nenhuma role e em nenhum repositório, com uma thread só e redundante.
- E-mails para o destinatário puro
rootnunca chegavam. O relay os aceitava, mas o msmtp não tem aliases locais, e sem domínio o e-mail não ia para lugar nenhum. Desde então todo alerta vai para um endereço completo.
A lição: silêncio não é prova. Uma ferramenta de verificação precisa da sua própria verificação de que ela roda e de que seus e-mails chegam.
🎯 As lições
- Um alarme precisa significar algo — senão ninguém lê.
- Exclusões só com motivo — logs efêmeros de containers sim, “irritante” não.
- Todo caminho de mudança precisa do seu refresh — Ansible, atualizações noturnas e trabalho manual.
- Confira agendamentos que vêm junto — um pacote pode trazer um segundo scan.
- Monitore o verificador — um heartbeat por job, e-mails para endereços reais.
Mais contexto sobre SELinux nesses hosts está no deep dive de SELinux, e o monitoramento dos jobs na parte 6 do Ansible tour.
