Plugin para WHM

El plugin aparece en WHM » Plugins » InfraFence. Está incluido en los planes Basic, Pro y AutoMode y se instala desde tu panel de InfraFence. Con Starter, o tras la parada de 72 horas cuando falla un pago, no muestra datos hasta que haya un plan de pago activo. Consulta Planes. La versión actual es la 1.0.2.

Requisitos#

• Una organización de InfraFence con Basic, Pro o AutoMode y el agente de InfraFence en el servidor (el plugin se instala sin él, y entonces muestra cómo añadir el servidor).
• cPanel & WHM 11.110 o posterior, como root.
• Para el mapa de ataques y la puntuación de seguridad del Resumen: el agente 1.0.33 o posterior. Con un agente más antiguo todo lo demás funciona, y el Resumen indica que hay que actualizar el agente.
• Para los problemas abiertos y resueltos: el agente 1.0.34 o posterior y el plugin 1.0.2. Con un agente más antiguo todos los eventos cuentan como abiertos, como antes.
• Para el aviso de actualización: el agente 1.0.35 o posterior y el plugin 1.0.3. Con un agente más antiguo el plugin no muestra el aviso; los Detalles técnicos muestran igualmente las dos versiones.

Instalación#

1. En el panel de InfraFence, abre Plugins de paneles › cPanel & WHM.
2. Elige el sistema del servidor y copia el comando de instalación:
   • RPM para AlmaLinux 8, 9 y 10, CloudLinux y Rocky (dnf install, o yum install donde no hay dnf);
   • .deb para Ubuntu 24.04 (apt install);
   • Tarball, descomprimido e instalado con ./install.sh.
3. Ejecútalo en el servidor como root.

El comando descarga el paquete y el SHA256SUMS de la versión con un enlace válido durante una hora, comprueba el paquete con sha256sum -c y solo lo instala si el checksum coincide. Cuando el enlace ha caducado, Nuevo enlace en la misma página te da un comando nuevo.

El instalador comprueba primero el servidor (versión de cPanel, root, espacio libre, los módulos Perl que proporciona WHM): si una comprobación falla, no se cambia nada. Con el tarball, ./install.sh --check solo ejecuta las comprobaciones. Los servicios nunca se reinician. Volver a ejecutarlo sustituye el plugin en su sitio, y así también se actualiza: consulta Actualizar el plugin.

Actualizar el plugin#

El plugin se actualiza desde el panel de InfraFence, aparte del agente: actualizar el agente, a mano o automáticamente, nunca actualiza el plugin. La versión del agente y la del plugin son números distintos: los Detalles técnicos del Resumen muestran las dos, Versión del agente y Versión del plugin.

Para actualizar el plugin:

1. En el panel de InfraFence, abre Plugins de paneles › cPanel & WHM.
2. Copia un comando de instalación nuevo para el sistema del servidor. El enlace que contiene funciona durante una hora; Nuevo enlace da otro.
3. Ejecútalo en el servidor como root. Comprueba el paquete y sustituye el plugin en su sitio; se conserva el idioma que eligió cada usuario de WHM y no se reinicia ningún servicio.

Cuando hay una actualización (agente 1.0.35 o posterior, plugin 1.0.3 o posterior): el agente lee la versión del plugin instalado (solo lectura, de /usr/local/share/infrafence-whm/VERSION) y la comunica al panel, y el panel envía al agente la última versión publicada. Entonces:

• en WHM, cada pantalla del plugin muestra Hay una nueva versión del plugin disponible (1.0.4). Actualízalo desde el panel de InfraFence › Plugins de paneles, y Versión del plugin indica 1.0.4 disponible;
• en el panel, la página del servidor dice Plugin para WHM 1.0.3 — actualización disponible (1.0.4) con Actualizar el plugin, y en Servidores el servidor tiene la etiqueta Actualización del plugin de WHM. Cuando el plugin está al día, la página del servidor dice Plugin para WHM 1.0.4 — actualizado.

El aviso y el botón solo aparecen con los planes que incluyen el plugin.

El Resumen#

El Resumen dice primero si el servidor está bien:

• De un vistazo: el estado de la protección, la puntuación de seguridad sobre 100 con su nota, y una línea que dice si algo requiere tu atención. Abrir en InfraFence abre el servidor en el panel de InfraFence.
• Las cifras clave: ataques y eventos críticos de las últimas 24 horas, bloqueos activos, hallazgos por revisar.
• Requiere tu atención: los eventos críticos de las últimas 24 horas, y lo que resta puntos a la puntuación de seguridad, con su cambio en 30 días y Corregir en InfraFence.
• De dónde llegan los ataques: un mapa del mundo con los países de los que llegaron los ataques a este servidor, en las últimas 24 h o los últimos 7 días, con los principales orígenes y los tipos de ataque. Recuentos por país: no se muestra ninguna dirección.
• Detalles técnicos: versión del agente y versión del plugin, servicio, último heartbeat y última sincronización, conexión, ID del servidor, panel de hosting, plan, modo y AutoMode.

Problemas resueltos (agente 1.0.34 o posterior): un problema resuelto en el panel de InfraFence o por el agente, como un puerto de base de datos cerrado o un archivo en cuarentena, deja de contar en las cifras clave, en los eventos críticos y en Requiere tu atención. Debajo de los abiertos, el Resumen muestra los tres problemas resueltos más recientes de las últimas 24 horas, cada uno con una línea verde que dice cómo y cuándo, por ejemplo Resuelto · puerto cerrado · 10:50 UTC; Mostrar resueltos (N) abre el resto en la página Eventos. Cuando todo lo de las últimas 24 horas está resuelto, dice Nada abierto: los problemas de las últimas 24 horas están resueltos.

El panel de InfraFence calcula el mapa y la puntuación a partir de los informes de este servidor. El plugin se los pide al agente (panel map y panel score); el agente los obtiene del panel de InfraFence y guarda una copia, y pregunta como mucho cada 5 minutos por el mapa y cada 15 minutos por la puntuación. Si no se puede llegar al panel de InfraFence, el Resumen muestra la última copia y cuándo se hizo. El plugin sigue sin guardar ningún token y no hace peticiones a ningún otro sitio: el mapa se dibuja en el servidor y no necesita JavaScript.

Eventos tiene una columna Estado: Abierto, Resuelto con cómo y cuándo, o un guion para los eventos que no son problemas, como ataques y escaneos. Filtra por estado, Todos, Abiertos o Resueltos, y por gravedad, Todos, Aviso o superior o Críticos. Hallazgos marca un hallazgo resuelto con una etiqueta verde Resuelto, cómo y cuándo.

Planes#

El plugin muestra datos solo cuando la organización está en Basic, Pro o AutoMode y la protección está activa. Si no, cada pantalla dice arriba por qué, con todas las cifras a 0, listas vacías, sin mapa ni puntuación, y las acciones desactivadas:

El plugin lee el plan de panel status del agente (con el agente 1.0.34 o posterior, del entitlement del propio agente), después no le pide nada más al agente y rechaza cualquier acción antes de que llegue al agente. Esto nunca cambia la protección del servidor. El agente guarda el último plan recibido, así que una caída del panel de InfraFence no vacía el plugin.

Qué instala#

Todo pertenece a root y solo root puede escribirlo.

Quién puede abrirlo#

Solo root (y los usuarios de WHM con el privilegio all). Los revendedores y los usuarios de cPanel nunca lo ven: los datos del agente cubren todo el servidor. El plugin sigue el idioma de WHM: inglés, italiano, español, francés, alemán o portugués. Cada usuario de WHM puede elegir otro con Idioma en la parte superior del plugin; Igual que WHM vuelve al de WHM. La elección se guarda por usuario de WHM, y solo root puede leerla.

Seguridad#

• Cada cambio muestra primero una página de confirmación y solo se ejecuta con el token de seguridad de la sesión de WHM.
• El agente se ejecuta directamente, sin shell, con un entorno limpio y un límite de tiempo; su binario debe pertenecer a root.
• Abrir en InfraFence abre el panel de InfraFence sin enviar el referrer.
• El plugin no guarda ningún token de InfraFence ni abre conexiones de red: el agente le responde por un socket local, y es el agente quien obtiene el mapa y la puntuación del panel de InfraFence.

Desinstalación#

dnf remove infrafence-whm

apt remove infrafence-whm

Para la instalación desde el tarball: /usr/local/share/infrafence-whm/uninstall.sh (--check muestra lo que eliminaría). Quitar el plugin nunca toca el agente.