Integraciones de firewall

Conectar Q-Feeds con las Network Lists de UniFi

UniFi Network 11 puede importar listas de IPs y dominios desde una URL. Esta guía configura cinco Dynamic Network Lists que descargan la threat intelligence de Q-Feeds una vez al día, cuatro para IPv4 y una para IPv6, además de las políticas de firewall que bloquean el tráfico. Los dominios maliciosos van en un filtro DNS, como se explica más abajo.

Necesita un gateway UniFi con UniFi Network 11.0.83 o posterior sobre UniFi OS 6.0.10 o posterior, acceso de administrador a la aplicación Network y un token API de Q-Feeds. Consulte Obtener sus threat feeds. No hay nada que instalar: el gateway descarga las listas por sí mismo.

Requisitos

  • UniFi Network: 11.0.83 o posterior
  • UniFi OS: 6.0.10 o posterior
  • Firewall: políticas de firewall basadas en zonas
  • Feed: IPs maliciosas (feed_type=malware_ip)
  • Red: HTTPS saliente desde el gateway hacia api.qfeeds.com

Paso 1: copie su token API

Inicie sesión en el Threat Intelligence Portal, abra Manage API Keys y copie su token. Cada Network List tiene su propia URL con ese token.

No abra antes las URL de los feeds en un navegador para probarlas. La API permite una descarga por URL y por clave dentro de la ventana de actualización de su licencia (24 horas en Community), así que una prueba en el navegador puede hacer que la primera descarga de UniFi falle con HTTP 429. Si aun así ocurre, consulte el apartado Diagnóstico más abajo.

En UniFi, una lista de IPs contiene direcciones IPv4 o IPv6, no las dos a la vez, y como máximo 100.000 entradas. Todas las Network Lists de un gateway juntas admiten como máximo 500.000 entradas. Por eso el feed de IPs maliciosas se reparte en páginas de 100.000: cuatro listas IPv4 (paso 2) y una lista IPv6 (paso 3), 500.000 entradas en total.

Paso 2: cree las cuatro listas IPv4

  1. En UniFi Network, vaya a Networks, Network Lists y seleccione Create New.
  2. Ponga un nombre a la lista, por ejemplo Q-Feeds malware IPv4 1.
  3. Ajuste Type en IP y Source en Dynamic.
  4. Pegue esta URL con su propio token en lugar de YOUR_TOKEN:
https://api.qfeeds.com/api?feed_type=malware_ip&ipv6=0&limit=100000&page=1&api_token=YOUR_TOKEN
  1. Elija un intervalo de actualización de 24 horas y guarde.

Repita lo mismo para Q-Feeds malware IPv4 2, 3 y 4. En la URL solo cambia el número de página:

https://api.qfeeds.com/api?feed_type=malware_ip&ipv6=0&limit=100000&page=2&api_token=YOUR_TOKEN
https://api.qfeeds.com/api?feed_type=malware_ip&ipv6=0&limit=100000&page=3&api_token=YOUR_TOKEN
https://api.qfeeds.com/api?feed_type=malware_ip&ipv6=0&limit=100000&page=4&api_token=YOUR_TOKEN

ipv6=0 limita las listas a direcciones IPv4 y rangos IPv4 en notación CIDR. limit=100000 reparte el feed en páginas de 100.000, primero las más recientes: la página 1 contiene las 100.000 entradas más nuevas, la página 2 las 100.000 siguientes, y así sucesivamente.

Paso 3: cree la lista IPv6

Cree una quinta lista de la misma forma, con Type en IP, un nombre como Q-Feeds malware IPv6 y esta URL:

https://api.qfeeds.com/api?feed_type=malware_ip&ipv6=only&limit=100000&page=1&api_token=YOUR_TOKEN

Vuelva a elegir 24 horas. ipv6=only devuelve solo las direcciones y rangos IPv6 del mismo feed. Cada lista descarga su propia versión IP y su propia página, así que las cinco listas no se estorban entre sí.

Paso 4: bloquee el tráfico

Las listas solo contienen los datos. Una política de firewall admite una sola lista, así que cada una de las cinco listas lleva sus propias políticas. Cree estas tres con la acción Block, una vez por cada lista: versión IP IPv4 para Q-Feeds malware IPv4 1 a 4, y versión IP IPv6 para Q-Feeds malware IPv6.

  • Salida hacia IPs maliciosas: zona de origen Internal, zona de destino External, con la lista como destino. Así los dispositivos de su red no pueden conectar con servidores maliciosos conocidos.
  • Entrada hacia su red: zona de origen External con la lista como origen, zona de destino Internal. Cubre los dispositivos que hace accesibles desde internet con una redirección de puertos.
  • Entrada hacia el gateway: zona de origen External con la lista como origen, zona de destino Gateway. UniFi trata el tráfico dirigido al propio gateway como una zona aparte, así que la política anterior no lo cubre. Protege los servicios del gateway, como un servidor VPN.

Cinco listas con tres políticas cada una suman 15 políticas de bloqueo. Compruebe que ninguna política situada más arriba permita antes el mismo tráfico, porque se aplica la primera coincidencia.

UniFi ya bloquea por defecto las conexiones nuevas desde internet. Las dos políticas de entrada cubren lo que usted mismo abre, como una redirección de puertos o un servidor VPN. Las políticas de salida hacen la mayor parte del trabajo.

Las 15 políticas parten de una configuración en la que todos sus dispositivos están en la zona Internal. Si también usa una zona Hotspot, una DMZ o una zona propia como IoT, cree también las políticas de salida con esa zona como zona de origen. Si redirige puertos a dispositivos de esa zona, añada además las políticas de entrada con esa zona como zona de destino.

Dominios maliciosos

Esta guía no pone el feed de dominios maliciosos en UniFi. Una política de firewall con una lista de dominios no compara el nombre: el gateway averigua a qué direcciones IP resuelven los dominios y bloquea esas direcciones. Los dominios maliciosos suelen estar en hosting compartido o detrás de una CDN como Cloudflare, donde la misma dirección IP sirve también sitios legítimos. Esos sitios quedarían bloqueados igualmente. El Content Filter de UniFi sí bloquea a nivel de DNS, pero su Block List no puede importar una lista desde una URL.

Use el feed de dominios en un filtro DNS, por ejemplo Pi-hole, AdGuard Home o Technitium. Es un feed distinto del de las listas de IPs, así que no se estorban, y puede usar el mismo token API.

Cómo funciona

  • Actualización: UniFi vuelve a descargar cada lista cada 24, 48 o 72 horas. Q-Feeds actualiza sus indicadores con más frecuencia, así que con 24 horas recibe una vez al día los datos más recientes que cubre su licencia.
  • Hasta 500.000 indicadores: cada descarga trae una página del feed de su licencia, y las cinco listas juntas guardan hasta 500.000 entradas, el máximo de UniFi. No intervienen scripts ni actualizaciones diferenciales.
  • Primero los más recientes: la API ordena los indicadores por antigüedad, los más nuevos primero. Si el feed IPv4 de su licencia supera las 400.000 entradas, las cuatro listas conservan las amenazas más recientes.
  • Otras Network Lists: las listas que ya usa también cuentan para las 500.000. En ese caso, prescinda primero de la lista con page=4.
  • Alertas: desde la 11.0.83, UniFi Network le avisa cuando una Dynamic Network List no consigue actualizarse.
  • Una descarga por feed, versión IP y página: el límite de peticiones se aplica por clave API, por feed y, en el feed de IPs, por versión IP y por página. Cada una de las cinco listas tiene su propia descarga. No haga que dos listas apunten a la misma URL con la misma clave.

Comprobar

Después de guardar, abra las cinco listas en Networks, Network Lists y compruebe que tienen entradas y no muestran ninguna alerta de actualización. Una página completa tiene exactamente 100.000 entradas. Active el registro de las políticas de bloqueo durante unos días si quiere ver lo que detienen.

Diagnóstico

  • Alerta de actualización fallida o HTTP 429: el feed ya se descargó con la misma clave dentro de la ventana de actualización, a menudo por una prueba en el navegador o una segunda lista con la misma URL. En el portal, abra la clave en Manage API Keys y seleccione Activate Override en Rate Limit Override. El límite se levanta durante cinco minutos; actualice la lista en UniFi dentro de ese plazo.
  • La lista sigue vacía: revise el token de la URL, que su licencia esté activa y que el gateway pueda llegar a https://api.qfeeds.com.
  • Alerta de actualización o HTTP 404 en una página alta: el feed de su licencia ya no tiene entradas para esa página, por ejemplo con 300.000 entradas IPv4 o menos en page=4. Elimine esa lista y sus políticas.
  • Las listas no se importan o el gateway va lento: elimine las listas de las páginas más altas y sus políticas, empezando por page=4. Conserva los indicadores más recientes.
  • Una política parece no hacer nada: otra política situada más arriba coincide antes con el tráfico. Suba las políticas de bloqueo.
  • Los dispositivos de otra zona no están protegidos: una política solo se aplica a las zonas que indica. Cree las mismas políticas de bloqueo para las zonas Hotspot, DMZ o propias, vea el paso 4.
  • Se bloquean sitios legítimos: compruebe si alguna política de firewall usa una lista de dominios. Elimínela y bloquee los dominios en un filtro DNS, vea Dominios maliciosos más arriba.
  • Soporte: support@qfeeds.com o la página de soporte.

Los feeds de URL maliciosas de Q-Feeds no son compatibles con las Network Lists de UniFi. Solo un proxy o un filtro web puede inspeccionar la ruta completa de una URL. Use aquí el feed de IPs, y el feed de dominios en un filtro DNS.

Obtener sus URL de feeds Sobre la integración con UniFi

¿Ya usa Q-Feeds?

Abra el portal para copiar las URL de sus feeds y su clave API, o compare los paquetes si necesita más.