Parcourir les docs

Getting Started

Format d'URL de flux et clés de licence

Construisez une URL de flux Cybora avec les paramètres requis pour la clé de licence et le type d'indicateur.

Dernière mise à jour: 15 juin 2026

Sur cette page

Les URLs de flux Cybora sont conçues pour être collées dans les champs de configuration firewall qui attendent une liste texte distante. Le firewall effectue une requête HTTPS et reçoit une réponse TXT simple avec un indicateur par ligne.

Cybora n’utilise pas de format de fichier spécifique à un firewall. La même structure d’URL est utilisée sur toutes les plateformes supportées ; la partie propre au firewall est l’endroit où vous collez l’URL et la manière dont le firewall consomme la liste retournée.

Create your feed URL

Paste your license key, select the indicator category, and copy the generated URL into your firewall.

Indicator category

This generator runs only in your browser. The key is not stored by this page and is not sent to Cybora.

URL de base

L’endpoint standard du flux est :

https://api.cybora.io/feed?key=<LICENSE_KEY>&type=<INDICATOR_TYPE>

L’URL contient trois parties :

  • https://api.cybora.io/feed est l’endpoint HTTPS qui retourne le flux TXT.
  • key autorise l’accès à l’abonnement au flux.
  • type sélectionne la catégorie d’indicateur à retourner.

Paramètres GET requis

ParamètreRequisExempleDescription
keyOuiABCDE-12345-FGHIJ-67890-KLMNOVotre clé de licence Cybora unique. Utilisez exactement la clé émise pour l’équipement firewall, l’edge ou le flux d’essai.
typeOuiipv4La catégorie d’indicateur à retourner. Les valeurs supportées sont ipv4, domain et url, selon votre plan.

Les clés de licence Cybora sont généralement émises en cinq blocs séparés par des tirets. Conservez les tirets lorsque vous collez la clé dans une URL de flux ou dans le générateur ci-dessus.

La valeur type doit correspondre à la catégorie d’indicateur que le firewall doit importer :

  • ipv4 retourne des adresses IPv4, sous-réseaux ou plages lorsque la liste les prend en charge.
  • domain retourne des indicateurs de domaine.
  • url retourne des indicateurs URL.

Pour les intégrations firewall normales, aucun paramètre de format supplémentaire n’est requis. Cybora retourne par défaut un flux TXT plat.

Exemples d’URLs

Flux IPv4 :

https://api.cybora.io/feed?key=ABCDE-12345-FGHIJ-67890-KLMNO&type=ipv4

Flux domaine :

https://api.cybora.io/feed?key=ABCDE-12345-FGHIJ-67890-KLMNO&type=domain

Flux URL :

https://api.cybora.io/feed?key=ABCDE-12345-FGHIJ-67890-KLMNO&type=url

Format de réponse TXT

Le corps de réponse est du texte brut. Il n’y a pas d’enveloppe JSON, de structure imbriquée ni d’enveloppe propre à un fournisseur firewall. Chaque ligne contient un indicateur.

Exemple de sortie IPv4 :

203.0.113.10
198.51.100.24
192.0.2.4

Exemple de sortie de type domaine :

malicious-example.test
scanner-control.test
phishing-host.test

Exemple de sortie URL :

https://malicious-example.test/login
http://scanner-control.test/payload
/wp-admin/setup-config.php

Choisir la catégorie d’indicateur

Choisissez la valeur type selon ce que votre plan inclut et ce que le firewall peut appliquer nativement :

  • Utilisez type=ipv4 pour les objets d’adresse firewall, alias, external dynamic lists ou blocklists.
  • Utilisez type=domain pour les policies DNS ou les fonctionnalités firewall qui supportent les objets domaine.
  • Utilisez type=url uniquement lorsque la plateforme dispose d’une application sensible aux URLs.

Si un firewall ne supporte que les listes externes basées sur IP, utilisez un flux IPv4 même si votre plan inclut aussi une couverture domaine ou URL. Les flux domaine et URL ne doivent être ajoutés qu’à des fonctionnalités capables de parser et d’appliquer ces catégories d’indicateurs.

Gestion des URLs dans les firewalls

Lorsque vous collez l’URL du flux dans un firewall, utilisez l’URL complète avec la query string :

https://api.cybora.io/feed?key=<LICENSE_KEY>&type=ipv4

Ne supprimez pas la partie ?key=...&type=.... Sans la clé, Cybora ne peut pas autoriser la requête. Sans le type, l’API ne peut pas savoir quelle catégorie d’indicateur retourner.

La plupart des firewalls stockent l’URL comme source de liste distante et l’interrogent selon un planning. Réglez l’intervalle de polling selon votre plan Cybora et les paramètres de refresh supportés par le fournisseur. Interroger plus souvent que votre plan ne l’autorise ne fournit pas de données plus fraîches et peut déclencher une protection contre les requêtes excessives.

Gestion des clés

Utilisez une clé de licence unique pour l’edge ou l’équipement firewall autorisé par votre plan. Ne réutilisez pas une même clé sur des équipements sans lien, sauf si votre accord commercial l’autorise explicitement.

Si une clé est exposée, faites-la tourner via le support et mettez à jour la configuration firewall avec la nouvelle URL de flux.