Connecter Q-Feeds aux Network Lists UniFi

Prérequis

• UniFi Network : 11.0.83 ou plus récent
• UniFi OS : 6.0.10 ou plus récent
• Pare-feu : règles de pare-feu par zones
• Flux : IP malveillantes (feed_type=malware_ip) et domaines malveillants (feed_type=malware_domains)
• Réseau : HTTPS sortant de la passerelle vers api.qfeeds.com

Étape 1 : copier votre jeton API

Connectez-vous au Threat Intelligence Portal, ouvrez Manage API Keys et copiez votre jeton. Chaque Network List reçoit sa propre URL contenant ce jeton.

Étape 2 : créer la liste d'IP

1. Dans UniFi Network, allez dans Networks, Network Lists et choisissez Create New.
2. Nommez la liste, par exemple Q-Feeds malware IPs.
3. Réglez Type sur IP et Source sur Dynamic.
4. Collez cette URL en remplaçant YOUR_TOKEN par votre propre jeton :

https://api.qfeeds.com/api?feed_type=malware_ip&ipv6=0&api_token=YOUR_TOKEN

5. Choisissez un intervalle de rafraîchissement de 24 heures et enregistrez.

ipv6=0 limite la liste aux adresses IPv4 et aux plages IPv4 en notation CIDR. Une deuxième liste avec la partie IPv6 du même flux compterait comme un nouveau téléchargement de malware_ip dans la même fenêtre et serait refusée. Ce guide s'en tient donc à l'IPv4. Contactez le support si vous avez besoin de l'IPv6 sur UniFi.

Étape 3 : créer la liste de domaines

Répétez les étapes avec Type sur Domain, un nom comme Q-Feeds malware domains et cette URL :

https://api.qfeeds.com/api?feed_type=malware_domains&api_token=YOUR_TOKEN

Choisissez de nouveau 24 heures. La liste d'IP et la liste de domaines sont des flux distincts, elles ne se gênent donc pas.

Étape 4 : bloquer le trafic

Les listes ne contiennent que les données. Créez ces règles de pare-feu avec l'action Block :

• Sortant vers les IP malveillantes : zone source Internal, zone de destination External, avec la liste Q-Feeds malware IPs comme destination.
• Entrant depuis les IP malveillantes : zone source External avec la liste Q-Feeds malware IPs comme source, zone de destination Internal. Créez la même règle avec la zone de destination Gateway pour protéger la passerelle elle-même.
• Domaines malveillants : zone source Internal, zone de destination External, et faites correspondre la destination à la liste Q-Feeds malware domains.

Vérifiez qu'aucune règle placée plus haut n'autorise le même trafic avant, car c'est la première correspondance qui s'applique.

Le fonctionnement

• Rafraîchissement : UniFi retélécharge chaque liste toutes les 24, 48 ou 72 heures. Q-Feeds met ses indicateurs à jour plus souvent, donc avec 24 heures vous recevez une fois par jour les données les plus récentes couvertes par votre licence.
• Liste complète : chaque téléchargement contient le flux complet de votre licence. Aucun script ni mise à jour différentielle n'entre en jeu.
• Les plus récents d'abord : l'API trie les indicateurs par âge, les plus récents en tête. Si vous plafonnez une liste avec &limit=, vous gardez les menaces les plus récentes.
• Alertes : depuis la 11.0.83, UniFi Network vous prévient quand une Dynamic Network List ne parvient pas à se mettre à jour.
• Un téléchargement par flux : la limite de débit s'applique par clé API et par flux. Ne faites donc pas pointer deux listes vers le même flux avec la même clé.

Vérifier

Après l'enregistrement, ouvrez les deux listes dans Networks, Network Lists et vérifiez qu'elles contiennent des entrées et n'affichent aucune alerte de mise à jour. Activez la journalisation des règles de blocage pendant quelques jours si vous voulez voir ce qu'elles arrêtent.

Dépannage

• Alerte d'échec de mise à jour ou HTTP 429 : le flux a déjà été téléchargé avec la même clé dans la fenêtre de mise à jour, souvent par un test dans le navigateur ou une deuxième liste. Dans le portail, ouvrez la clé dans Manage API Keys et choisissez Activate Override sous Rate Limit Override. La limite est levée pendant cinq minutes ; rafraîchissez la liste dans UniFi pendant ce délai.
• La liste reste vide : vérifiez le jeton dans l'URL, que votre licence est active et que la passerelle peut joindre https://api.qfeeds.com.
• La liste ne s'importe pas ou la passerelle ralentit : ajoutez un plafond à l'URL, par exemple &limit=50000, et baissez-le jusqu'à ce que l'import passe. Vous conservez les indicateurs les plus récents.
• Une règle semble sans effet : une règle placée plus haut intercepte le trafic en premier. Remontez les règles de blocage.
• Le blocage des domaines rate certains appareils : ces clients contournent le DNS de la passerelle. Voir l'astuce DNS de l'étape 4.
• Assistance : support@qfeeds.com ou la page support.

Obtenir vos URL de flux À propos de l'intégration UniFi