Integraciones de cortafuegos
import { Steps, Tabs, TabItem, Aside } from ‘@astrojs/starlight/components’;
Suricatavel se integra directamente con cortafuegos perimetrales para aplicar contención de red y bloquear tráfico malicioso detectado por los sensores de Suricata o feeds de amenazas.
Integraciones soportadas
Sección titulada «Integraciones soportadas»Suricatavel soporta las siguientes plataformas de cortafuegos:
- pfSense: Se integra mediante la API REST de pfSense (requiere el paquete
pfsense-api). - OPNsense: Se integra mediante la API REST nativa de OPNsense (gestiona Alias de firewall).
- OpenWrt: Se integra mediante SSH/LuCI y comandos
uci/nftables. - MikroTik RouterOS: Se integra mediante la API REST de RouterOS v7+ (gestiona entradas dinámicas en
address-listy reglas de filtrado). - Linux genérico: Se integra mediante SSH para gestionar conjuntos
nftablesoipset.
Conexión de un cortafuegos
Sección titulada «Conexión de un cortafuegos»Para registrar un nuevo cortafuegos en Suricatavel:
Suricatavel prueba la conexión inmediatamente para verificar credenciales y comprobar el estado de salud del adaptador.
Acciones de cortafuegos
Sección titulada «Acciones de cortafuegos»Puede aplicar bloqueos de contención de forma manual o automática a través de Políticas y Drongo.
Bloqueo de una dirección IP
Sección titulada «Bloqueo de una dirección IP»Para bloquear una dirección manualmente:
- Navegue a Firewalls > Actions (o pulse Block IP directamente desde cualquier Evento o Alerta).
- Haga clic en New action.
- Seleccione el Firewall de destino.
- Elija el alcance de la regla:
- Source IP: Bloquea tráfico entrante procedente de la dirección hostil.
- Destination IP: Bloquea tráfico saliente hacia la dirección objetivo.
- Both: Restringe ambas direcciones de tráfico.
- Configure el TTL (Time to live):
- Introduzca una duración en segundos para un baneo temporal (ejemplo:
3600para 1 hora). - Déjelo vacío o en
0para un bloqueo permanente.
- Introduzca una duración en segundos para un baneo temporal (ejemplo:
- Haga clic en Save.
La acción se despacha al cortafuegos seleccionado de inmediato y su estado queda registrado en Firewalls > History.
Expiración automática y purga por TTL
Sección titulada «Expiración automática y purga por TTL»Los bloqueos temporales se gestionan con marcas de tiempo de expiración:
- Los cortafuegos con soporte nativo de TTL (como los conjuntos nftables en OpenWrt o listas con timeout en MikroTik) expiran las entradas automáticamente en el dispositivo.
- Suricatavel ejecuta una tarea periódica de mantenimiento (
php artisan suricatavel:prune-expired-firewall-blocks) para sincronizar y purgar bloqueos expirados en el panel y en el historial.
Desbloqueo de una dirección
Sección titulada «Desbloqueo de una dirección»Para retirar un bloqueo activo:
- Navegue a Firewalls > Actions.
- Localice la regla activa en el listado.
- Haga clic en Unblock.
La regla se elimina de inmediato en el cortafuegos y el historial se actualiza en consecuencia.
Feeds de dominios
Sección titulada «Feeds de dominios»Suricatavel expone un endpoint de feed de dominios maliciosos detectados por alertas e inteligencia de amenazas. Este feed está diseñado para herramientas como pfBlockerNG en pfSense, Alias en OPNsense o listas DNS en MikroTik.
Endpoint del feed
Sección titulada «Endpoint del feed»GET /api/v1/feeds/domains?token=YOUR_PERSONAL_ACCESS_TOKENLa respuesta devuelve una lista en texto plano con un dominio por línea.