Firewall-Integrationen

Q-Feeds mit UniFi Network Lists verbinden

UniFi Network 11 kann IP- und Domainlisten von einer URL importieren. In dieser Anleitung richten Sie fünf Dynamic Network Lists ein, die einmal am Tag Q-Feeds Threat Intelligence abrufen, vier für IPv4 und eine für IPv6, und dazu die Firewall-Policies, die den Verkehr blockieren. Bösartige Domains gehören in einen DNS-Filter; warum, steht weiter unten.

Sie benötigen ein UniFi-Gateway mit UniFi Network 11.0.83 oder neuer auf UniFi OS 6.0.10 oder neuer, Adminrechte in der Network-Anwendung und ein Q-Feeds API-Token. Siehe Ihre Threat Feeds abrufen. Installiert wird nichts: Das Gateway lädt die Listen selbst herunter.

Voraussetzungen

  • UniFi Network: 11.0.83 oder neuer
  • UniFi OS: 6.0.10 oder neuer
  • Firewall: zonenbasierte Firewall-Policies
  • Feed: Malware-IPs (feed_type=malware_ip)
  • Netzwerk: ausgehendes HTTPS vom Gateway zu api.qfeeds.com

Schritt 1: API-Token kopieren

Melden Sie sich im Threat Intelligence Portal an, öffnen Sie Manage API Keys und kopieren Sie Ihr Token. Jede Network List bekommt eine eigene URL mit diesem Token.

Öffnen Sie die Feed-URLs vorher nicht zum Testen im Browser. Die API erlaubt pro URL und Schlüssel einen Download innerhalb des Update-Fensters Ihrer Lizenz (24 Stunden bei Community). Ein Test im Browser kann deshalb dazu führen, dass der erste Download durch UniFi mit HTTP 429 scheitert. Falls das passiert, hilft der Abschnitt Fehlerbehebung weiter unten.

Eine IP-Liste in UniFi enthält entweder IPv4- oder IPv6-Adressen, nicht beides, und höchstens 100.000 Einträge. Alle Network Lists auf einem Gateway zusammen fassen höchstens 500.000 Einträge. Der Malware-IP-Feed wird deshalb in Seiten zu je 100.000 aufgeteilt: vier IPv4-Listen (Schritt 2) und eine IPv6-Liste (Schritt 3), zusammen 500.000 Einträge.

Schritt 2: Die vier IPv4-Listen anlegen

  1. Gehen Sie in UniFi Network zu Networks, Network Lists und wählen Sie Create New.
  2. Geben Sie der Liste einen Namen, zum Beispiel Q-Feeds malware IPv4 1.
  3. Setzen Sie Type auf IP und Source auf Dynamic.
  4. Fügen Sie diese URL ein, mit Ihrem eigenen Token anstelle von YOUR_TOKEN:
https://api.qfeeds.com/api?feed_type=malware_ip&ipv6=0&limit=100000&page=1&api_token=YOUR_TOKEN
  1. Wählen Sie als Aktualisierungsintervall 24 Stunden und speichern Sie.

Wiederholen Sie das für Q-Feeds malware IPv4 2, 3 und 4. In der URL ändert sich nur die Seitenzahl:

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 beschränkt die Listen auf IPv4-Adressen und IPv4-Bereiche in CIDR-Notation. limit=100000 teilt den Feed in Seiten zu je 100.000 auf, die neuesten zuerst: Seite 1 enthält die neuesten 100.000 Einträge, Seite 2 die nächsten 100.000 und so weiter.

Schritt 3: IPv6-Liste anlegen

Legen Sie auf dieselbe Weise eine fünfte Liste an, mit Type auf IP, einem Namen wie Q-Feeds malware IPv6 und dieser URL:

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

Wählen Sie wieder 24 Stunden. ipv6=only liefert nur die IPv6-Adressen und -Bereiche aus demselben Feed. Jede Liste lädt ihre eigene IP-Version und Seite herunter, die fünf Listen kommen sich also nicht in die Quere.

Schritt 4: Verkehr blockieren

Die Listen enthalten nur die Daten. Eine Firewall-Policy nimmt genau eine Liste auf, deshalb bekommt jede der fünf Listen eigene Policies. Legen Sie diese drei mit der Aktion Block an, jede einmal pro Liste: IP-Version IPv4 für Q-Feeds malware IPv4 1 bis 4 und IP-Version IPv6 für Q-Feeds malware IPv6.

  • Ausgehend zu bösartigen IPs: Quellzone Internal, Zielzone External, mit der Liste als Ziel. So bauen Geräte in Ihrem Netzwerk keine Verbindungen zu bekannten bösartigen Servern auf.
  • Eingehend in Ihr Netzwerk: Quellzone External mit der Liste als Quelle, Zielzone Internal. Das deckt Geräte ab, die Sie per Portweiterleitung aus dem Internet erreichbar machen.
  • Eingehend zum Gateway: Quellzone External mit der Liste als Quelle, Zielzone Gateway. UniFi behandelt Verkehr an das Gateway selbst als eigene Zone, die Policy darüber greift dort also nicht. So schützen Sie Dienste auf dem Gateway, etwa einen VPN-Server.

Fünf Listen mit je drei Policies ergeben 15 Block-Policies. Achten Sie darauf, dass keine Policy weiter oben denselben Verkehr vorher erlaubt, denn der erste Treffer gewinnt.

Neue Verbindungen aus dem Internet blockiert UniFi standardmäßig bereits. Die beiden eingehenden Policies decken ab, was Sie selbst öffnen, etwa Portweiterleitungen oder einen VPN-Server. Die meiste Arbeit leisten die ausgehenden Policies.

Die 15 Policies gehen davon aus, dass alle Ihre Geräte in der Zone Internal liegen. Nutzen Sie zusätzlich eine Hotspot-Zone, eine DMZ oder eine eigene Zone wie IoT, legen Sie die ausgehenden Policies auch mit dieser Zone als Quellzone an. Leiten Sie Ports an Geräte in einer solchen Zone weiter, brauchen Sie außerdem die eingehenden Policies mit dieser Zone als Zielzone.

Bösartige Domains

Diese Anleitung trägt den Malware-Domain-Feed nicht in UniFi ein. Eine Firewall-Policy mit einer Domainliste prüft nicht den Namen: Das Gateway ermittelt, zu welchen IP-Adressen die Domains auflösen, und blockiert diese Adressen. Bösartige Domains liegen oft auf Shared Hosting oder hinter einem CDN wie Cloudflare, wo dieselbe IP-Adresse auch legitime Websites ausliefert. Diese Websites wären dann ebenfalls gesperrt. Der Content Filter von UniFi blockiert zwar auf DNS-Ebene, seine Block List kann aber keine Liste von einer URL importieren.

Nutzen Sie den Domain-Feed deshalb in einem DNS-Filter, zum Beispiel Pi-hole, AdGuard Home oder Technitium. Er ist ein anderer Feed als die IP-Listen, zählt also nicht gegen sie, und Sie können dasselbe API-Token verwenden.

So funktioniert es

  • Aktualisierung: UniFi lädt jede Liste alle 24, 48 oder 72 Stunden neu. Q-Feeds aktualisiert die Indikatoren häufiger, mit 24 Stunden erhalten Sie also einmal täglich die neuesten Daten, die Ihre Lizenz abdeckt.
  • Bis zu 500.000 Indikatoren: Jeder Download enthält eine Seite des Feeds für Ihre Lizenz, und die fünf Listen fassen zusammen bis zu 500.000 Einträge, das Maximum von UniFi. Skripte oder differenzielle Updates sind nicht im Spiel.
  • Neueste zuerst: Die API sortiert die Indikatoren nach Alter, die neuesten zuerst. Hat der IPv4-Feed Ihrer Lizenz mehr als 400.000 Einträge, behalten die vier Listen die aktuellsten Bedrohungen.
  • Andere Network Lists: Listen, die Sie bereits nutzen, zählen ebenfalls zu den 500.000. Lassen Sie dann zuerst die Liste mit page=4 weg.
  • Warnungen: Seit 11.0.83 meldet UniFi Network, wenn eine Dynamic Network List nicht aktualisiert werden kann.
  • Ein Download pro Feed, IP-Version und Seite: Das Rate Limit gilt pro API-Schlüssel, pro Feed und beim IP-Feed pro IP-Version und Seite. Jede der fünf Listen hat ihren eigenen Download. Lassen Sie nicht zwei Listen mit demselben Schlüssel auf dieselbe URL zeigen.

Prüfen

Öffnen Sie nach dem Speichern alle fünf Listen unter Networks, Network Lists und prüfen Sie, ob sie Einträge enthalten und keine Update-Warnung anzeigen. Eine volle Seite enthält genau 100.000 Einträge. Schalten Sie für ein paar Tage das Logging der Block-Policies ein, wenn Sie sehen möchten, was sie abfangen.

Fehlerbehebung

  • Warnung zum fehlgeschlagenen Update oder HTTP 429: Der Feed wurde im Update-Fenster bereits mit demselben Schlüssel heruntergeladen, oft durch einen Browsertest oder eine zweite Liste mit derselben URL. Öffnen Sie im Portal den Schlüssel unter Manage API Keys und wählen Sie bei Rate Limit Override die Option Activate Override. Damit entfällt das Limit für fünf Minuten; aktualisieren Sie die Liste in UniFi innerhalb dieser Zeit.
  • Die Liste bleibt leer: Prüfen Sie das Token in der URL, ob Ihre Lizenz aktiv ist und ob das Gateway https://api.qfeeds.com erreicht.
  • Update-Warnung oder HTTP 404 bei einer höheren Seite: Der Feed Ihrer Lizenz hat für diese Seite keine Einträge mehr, zum Beispiel 300.000 IPv4-Einträge oder weniger bei page=4. Löschen Sie diese Liste und ihre Policies.
  • Die Listen werden nicht importiert oder das Gateway wird langsam: Entfernen Sie die Listen mit den höchsten Seiten und ihre Policies, beginnend mit page=4. Sie behalten die neuesten Indikatoren.
  • Eine Policy scheint nichts zu tun: Eine Policy weiter oben trifft den Verkehr zuerst. Schieben Sie die Block-Policies nach oben.
  • Geräte in einer anderen Zone sind nicht geschützt: Eine Policy gilt nur für die Zonen, die darin eingetragen sind. Legen Sie dieselben Block-Policies für Hotspot, DMZ oder eigene Zonen an, siehe Schritt 4.
  • Legitime Websites werden gesperrt: Prüfen Sie, ob eine Firewall-Policy eine Domainliste verwendet. Entfernen Sie sie und sperren Sie Domains stattdessen in einem DNS-Filter, siehe Bösartige Domains oben.
  • Support: support@qfeeds.com oder die Support-Seite.

Die Q-Feeds Feeds mit bösartigen URLs werden in UniFi Network Lists nicht unterstützt. Einen vollständigen URL-Pfad kann nur ein Proxy oder Webfilter prüfen. Nutzen Sie hier den IP-Feed und den Domain-Feed in einem DNS-Filter.

Ihre Feed-URLs abrufen Über die UniFi-Integration

Sie nutzen Q-Feeds bereits?

Öffnen Sie das Portal, um Ihre Feed-URLs und Ihren API-Schlüssel zu kopieren, oder vergleichen Sie die Pakete, wenn Sie mehr brauchen.