InfraFenceInfraFence

Live Security Operations

Empezar

Referencia de comandos

Todos los comandos del binario infrafence-agent - preflight, version, check, register, start, uninstall --clean y los comandos panel que usan los plugins de WHM y Plesk.

Última actualización:

El binario del agente es /usr/local/bin/infrafence-agent. Ejecuta sus comandos como root.

preflight

bash
sudo infrafence-agent preflight
sudo infrafence-agent preflight --json

La comprobación de solo lectura del servidor: firewall, otras herramientas de seguridad, servidores web, paneles de hosting, gestión de la configuración, operaciones de paquetes y recursos. No cambia nada. Sin --json termina con el código 2 cuando un hallazgo impide la protección, y con 0 en caso contrario. Consulta Qué hace el instalador.

version

bash
infrafence-agent version

Imprime la versión instalada, infrafence-agent v<version>. --version y -v hacen lo mismo. Necesita el agente 1.0.34 o posterior; en un agente más antiguo, infrafence-agent check también imprime la versión.

check

bash
infrafence-agent check

La autoprueba que usan las actualizaciones y el script de recuperación: imprime infrafence-agent v<version> OK y termina con 0.

register

bash
sudo infrafence-agent register <server_url> <agent_name> <install_token>

Registra el servidor y escribe /etc/infrafence/config.json. El instalador lo ejecuta por ti; solo lo necesitas después de install.sh --install-only, por ejemplo:

bash
sudo infrafence-agent register https://infrafence.com web-01 <YOUR_TOKEN>
sudo systemctl start infrafence-agent

Si funciona imprime Agent registered successfully; si falla, Registration failed: seguido de la respuesta del panel.

start

bash
infrafence-agent start

Ejecuta el agente en primer plano. El servicio ejecuta este comando; no necesitas lanzarlo a mano. Sin un archivo de configuración se detiene con Run 'infrafence-agent register' first.

uninstall --clean

bash
sudo infrafence-agent uninstall --clean

Elimina todo lo que el agente añadió al sistema (cadenas y conjuntos del firewall, cambios en el servidor web y de hardening) e imprime una línea removed … por elemento, y después InfraFence changes removed from this host. No elimina el binario ni el servicio: install.sh --uninstall lo hace todo. Consulta Desinstalar.

panel

bash
sudo infrafence-agent panel status --json

La interfaz de los plugins de los paneles de hosting: un objeto JSON en la salida estándar, {"ok": true, …} o {"ok": false, "error": "<code>", "message": "…"}, y código de salida 0 solo cuando ok. Solo root.

Comando Qué hace
status Versión, estado de ejecución, último heartbeat, conexión, plan, AutoMode, y si el plugin puede mostrar datos (entitled, entitlement).
bans [--limit N] Bloqueos activos con motivo, origen y caducidad.
unban <ip> --actor <user> Levanta un bloqueo solo en este servidor, durante 30 días como máximo.
allow <ip> [--note …] --actor <user> Añade una dirección a la lista blanca.
allowlist La lista blanca, del panel de hosting y del panel de InfraFence.
disallow <ip> --actor <user> Quita una dirección que añadió el panel de hosting.
findings [--limit N] Hallazgos de malware y de integridad de archivos, cada uno abierto o resuelto.
events [--limit N] [--since 24h] Eventos recientes; los problemas, abiertos o resueltos.
coexistence Otras herramientas de seguridad encontradas, y qué hace InfraFence junto a cada una.
sites Cuentas, dominios y raíces de documentos, con la cobertura de escaneo.
scan <document root> --actor <user> Inicia un escaneo de malware de un sitio.
map [--hours N] De dónde llegaron los ataques a este servidor, por país y tipo de ataque, en las últimas 24 horas (--hours 24, el valor por defecto) o los últimos 7 días (--hours 168).
score La puntuación de seguridad del servidor, su nota, lo que le resta puntos y su evolución en 30 días.

Los comandos que cambian algo necesitan --actor, y el agente los notifica al panel de InfraFence como eventos con origen panel. El comando habla con el agente en ejecución a través de /run/infrafence/panel.sock (solo root, modo 0600, sin escuchar en la red). Sin un agente en ejecución, status, coexistence y sites siguen respondiendo; los demás devuelven agent_not_running. Consulta Paneles de hosting.

map y score necesitan el agente 1.0.33 o posterior. Los calcula el panel de InfraFence; el agente le pregunta como mucho cada 5 minutos por un mapa y cada 15 minutos por la puntuación, y guarda la respuesta. Si el panel de InfraFence no responde, el agente da su última copia con "stale": true, o not_connected si no tiene ninguna.

Solo planes de pago (agente 1.0.34 o posterior). Los plugins están incluidos en los planes Basic, Pro y AutoMode. status siempre responde, con entitled (true o false) y entitlement:

entitlement Cuándo
ok El plan es Basic, Pro o AutoMode, y la protección no está desactivada.
plan_required Otro plan, como Starter.
unpaid La protección está desactivada: el panel de InfraFence ha rechazado el servidor durante 24 horas, por ejemplo porque la suscripción no está activa.
unknown El plan aún no se conoce: el agente no se ha sincronizado desde que se instaló o actualizó.

Cuando no es ok, todos los demás comandos responden solo con un error con el mismo código (plan_required, unpaid o unknown), sin datos, y no cambian nada: se rechazan unban, allow, disallow y scan. El agente guarda el plan de la última sincronización correcta también tras un reinicio y lo usa mientras no puede contactar con el panel de InfraFence, así que una caída no vacía el plugin. El control se aplica solo a las respuestas: nunca cambia la protección del servidor.

Abierto o resuelto (agente 1.0.34 o posterior). En events y findings, cada problema (un puerto de base de datos expuesto, un archivo del sistema modificado, un ajuste de PHP arriesgado, malware...) tiene un subject, la clave de lo que trata (port:tcp/3306, file:/etc/passwd...), y un state, open o resolved, con resolved_at y resolved_how (port_closed, fix_applied, quarantined, package_updated, marked_expected, marked_resolved...). Los eventos que no son problemas, como ataques y escaneos, tienen state null. Un problema se resuelve en el panel de InfraFence, o lo resuelve el propio agente cuando lo ha arreglado; una nueva ocurrencia vuelve a estar abierta. Consulta Problemas abiertos y resueltos.