Plugin WHM

O plugin aparece em WHM » Plugins » InfraFence. Ele está incluído nos planos Basic, Pro e AutoMode e é instalado pelo seu painel do InfraFence. No Starter, ou depois da parada de 72 horas quando um pagamento é recusado, ele não mostra dados até haver um plano pago ativo. Veja Planos. A versão atual é a 1.0.2.

Requisitos#

• Uma organização do InfraFence no Basic, Pro ou AutoMode e o agente InfraFence no servidor (o plugin é instalado sem ele e, nesse caso, mostra como adicionar o servidor).
• cPanel & WHM 11.110 ou posterior, como root.
• Para o mapa de ataques e a pontuação de segurança na Visão geral: o agente 1.0.33 ou posterior. Com um agente mais antigo todo o resto funciona, e a Visão geral avisa para atualizar o agente.
• Para os problemas abertos e resolvidos: o agente 1.0.34 ou posterior e o plugin 1.0.2. Com um agente mais antigo, todo evento conta como aberto, como antes.
• Para o aviso de atualização: o agente 1.0.35 ou posterior e o plugin 1.0.3. Com um agente mais antigo o plugin não mostra o aviso; os Detalhes técnicos mostram as duas versões mesmo assim.

Instalação#

1. No painel do InfraFence, abra Plugins de painéis › cPanel & WHM.
2. Escolha o sistema do servidor e copie o comando de instalação:
   • RPM para AlmaLinux 8, 9 e 10, CloudLinux e Rocky (dnf install, ou yum install onde não há dnf);
   • .deb para Ubuntu 24.04 (apt install);
   • Tarball, descompactado e instalado com ./install.sh.
3. Rode o comando no servidor como root.

O comando baixa o pacote e o SHA256SUMS da versão com um link válido por uma hora, verifica o pacote com sha256sum -c e só o instala se o checksum bater. Quando o link expirar, Novo link na mesma página gera um comando novo.

O instalador verifica o servidor antes (versão do cPanel, root, espaço livre, os módulos Perl que o WHM fornece): se uma verificação falhar, nada é alterado. Com o tarball, ./install.sh --check só executa as verificações. Os serviços nunca são reiniciados. Executá-lo de novo substitui o plugin no lugar, e é assim também que você o atualiza: veja Atualizar o plugin.

Atualizar o plugin#

O plugin é atualizado pelo painel do InfraFence, separado do agente: atualizar o agente, manualmente ou de forma automática, nunca atualiza o plugin. A versão do agente e a do plugin são números diferentes: os Detalhes técnicos da Visão geral mostram as duas, Versão do agente e Versão do plugin.

Para atualizar o plugin:

1. No painel do InfraFence, abra Plugins de painéis › cPanel & WHM.
2. Copie um novo comando de instalação para o sistema do servidor. O link dentro dele funciona por uma hora; Novo link gera outro.
3. Execute-o no servidor como root. Ele verifica o pacote e substitui o plugin no lugar; o idioma escolhido por cada usuário do WHM é mantido, e nenhum serviço é reiniciado.

Quando há uma atualização (agente 1.0.35 ou posterior, plugin 1.0.3 ou posterior): o agente lê a versão do plugin instalado (somente leitura, de /usr/local/share/infrafence-whm/VERSION) e a informa ao painel, e o painel envia ao agente a versão mais recente. Então:

• no WHM, toda tela do plugin mostra Há uma nova versão do plugin disponível (1.0.4). Atualize-o pelo painel do InfraFence › Plugins de painéis, e Versão do plugin mostra 1.0.4 disponível;
• no painel, a página do servidor mostra Plugin para WHM 1.0.3 — atualização disponível (1.0.4) com Atualizar o plugin, e em Servidores o servidor tem o selo Atualização do plugin para WHM. Quando o plugin está em dia, a página do servidor mostra Plugin para WHM 1.0.4 — atualizado.

O aviso e o botão aparecem só nos planos que incluem o plugin.

A Visão geral#

A Visão geral diz primeiro se o servidor está bem:

• De relance: o status da proteção, a pontuação de segurança de 0 a 100 com a nota, e uma linha que diz se algo precisa da sua atenção. Abrir no InfraFence abre o servidor no painel InfraFence.
• Os números principais: ataques e eventos críticos das últimas 24 horas, banimentos ativos, detecções a revisar.
• Precisa da sua atenção: os eventos críticos das últimas 24 horas, e o que tira pontos da pontuação de segurança, com a variação em 30 dias e Corrigir no InfraFence.
• De onde vêm os ataques: um mapa-múndi dos países de onde vieram os ataques a este servidor, nas últimas 24 h ou nos últimos 7 dias, com as principais origens e os tipos de ataque. Contagens por país: nenhum endereço é mostrado.
• Detalhes técnicos: versão do agente e versão do plugin, serviço, último heartbeat e última sincronização, conexão, ID do servidor, painel de hospedagem, plano, modo e AutoMode.

Problemas resolvidos (agente 1.0.34 ou posterior): um problema resolvido no painel InfraFence ou pelo agente, como uma porta de banco de dados fechada ou um arquivo em quarentena, deixa de contar nos números principais, nos eventos críticos e em Precisa da sua atenção. Abaixo dos abertos, a Visão geral lista os três problemas resolvidos mais recentes das últimas 24 horas, cada um com uma linha verde que diz como e quando, por exemplo Resolvido · porta fechada · 10:50 UTC; Mostrar resolvidos (N) abre o resto na página Eventos. Quando tudo das últimas 24 horas está resolvido, ela diz Nada aberto: os problemas das últimas 24 horas estão resolvidos.

O painel InfraFence calcula o mapa e a pontuação a partir dos relatórios deste servidor. O plugin os pede ao agente (panel map e panel score); o agente os busca no painel InfraFence e guarda uma cópia, perguntando no máximo a cada 5 minutos pelo mapa e a cada 15 minutos pela pontuação. Quando o painel InfraFence não responde, a Visão geral mostra a última cópia e quando ela foi feita. O plugin continua sem guardar nenhum token e não faz requisições a nenhum outro site: o mapa é desenhado no servidor e não precisa de JavaScript.

Eventos tem uma coluna Estado: Aberto, Resolvido com como e quando, ou um traço para os eventos que não são problemas, como ataques e varreduras. A página filtra por estado, Todos, Abertos ou Resolvidos, e por gravidade, Todos, Aviso ou acima ou Críticos. Ocorrências marca uma detecção resolvida com uma etiqueta verde Resolvido, como e quando.

Planos#

O plugin só mostra dados quando a organização está no Basic, Pro ou AutoMode e a proteção está ligada. Caso contrário, cada tela diz no topo o motivo, com todos os números em 0, listas vazias, sem mapa e sem pontuação, e as ações desligadas:

O plugin lê o plano no panel status do agente (com o agente 1.0.34 ou posterior, no entitlement do próprio agente), depois não pede mais nada ao agente e recusa qualquer ação antes que ela chegue ao agente. Isso nunca altera a proteção do servidor. O agente guarda o último plano recebido, então uma queda do painel InfraFence não esvazia o plugin.

O que ele instala#

Tudo pertence ao root e só o root pode gravar.

Quem pode abri-lo#

Só o root (e os usuários do WHM com o privilégio all). Revendedores e usuários do cPanel nunca o veem: os dados do agente cobrem o servidor inteiro. O plugin segue o idioma do WHM: inglês, italiano, espanhol, francês, alemão ou português. Cada usuário do WHM pode escolher outro em Idioma, no topo do plugin; Igual ao WHM volta ao do WHM. A escolha fica salva por usuário do WHM, e só o root pode lê-la.

Segurança#

• Toda alteração mostra antes uma página de confirmação e só é executada com o token de segurança da sessão do WHM.
• O agente é executado diretamente, sem shell, com um ambiente limpo e um limite de tempo; o binário dele precisa pertencer ao root.
• Abrir no InfraFence abre o painel InfraFence sem enviar o referrer.
• O plugin não guarda nenhum token do InfraFence e não abre conexões de rede: o agente responde a ele por um socket local, e é o agente que busca o mapa e a pontuação no painel InfraFence.

Remoção#

dnf remove infrafence-whm

apt remove infrafence-whm

Para a instalação pelo tarball: /usr/local/share/infrafence-whm/uninstall.sh (--check mostra o que ele removeria). Remover o plugin nunca mexe no agente.