Feed-URL-Format und Lizenzschlüssel

Cybora Feed-URLs sind dafür ausgelegt, in Firewall-Konfigurationsfelder kopiert zu werden, die eine entfernte Textliste erwarten. Die Firewall führt eine HTTPS-Abfrage aus und erhält eine Plain-TXT-Antwort mit einem Indikator pro Zeile.

Cybora verwendet keine firewall-spezifischen Dateiformate. Dieselbe URL-Struktur wird für unterstützte Firewall-Plattformen verwendet. Der firewall-spezifische Teil ist, wo Sie die URL einfügen und wie die Firewall die zurückgegebene Liste nutzt.

Basis-URL

Der Standard-Feed-Endpunkt ist:

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

Die URL besteht aus drei Teilen:

• https://api.cybora.io/feed ist der HTTPS-Endpunkt, der den TXT-Feed ausliefert.
• key autorisiert den Zugriff auf das Feed-Abonnement.
• type wählt die Indikator-Kategorie aus, die zurückgegeben werden soll.

Erforderliche GET-Parameter

Cybora-Lizenzschlüssel werden normalerweise als fünf Blöcke mit Bindestrichen ausgegeben. Behalten Sie die Bindestriche bei, wenn Sie den Key in eine Feed-URL oder in den Generator oben einfügen.

Der Wert für type muss zur Indikator-Kategorie passen, die Ihre Firewall importieren soll:

• ipv4 gibt IPv4-Adressen zurück.
• domain gibt Domain-Indikatoren zurück.
• url gibt URL-Indikatoren zurück.

Für normale Firewall-Integrationen ist kein zusätzlicher Formatparameter erforderlich. Cybora liefert standardmässig einen flachen TXT-Feed aus.

Beispiel-URLs

IPv4-Feed:

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

Domain-Feed:

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

URL-Feed:

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

TXT-Antwortformat

Der Response-Body ist Plain Text. Es gibt keine JSON-Hülle, keine verschachtelte Struktur und keinen firewall-herstellerspezifischen Umschlag. Jede Zeile enthält einen Indikator.

Beispiel für IPv4-Ausgabe:

203.0.113.10
198.51.100.24
192.0.2.4

Beispiel für Domain-Ausgabe:

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

Beispiel für URL-Ausgabe:

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

Indikator-Kategorie wählen

Wählen Sie den Wert für type danach aus, was Ihr Plan enthält und was Ihre Firewall nativ durchsetzen kann:

• Verwenden Sie type=ipv4 für Address Objects, Aliases, External Dynamic Lists oder Blocklists.
• Verwenden Sie type=domain für DNS-Layer-Policies oder Firewall-Funktionen mit Domain-Objekten.
• Verwenden Sie type=url nur dort, wo die Plattform URL-bewusste Durchsetzung unterstützt.

Wenn eine Firewall nur IP-basierte externe Listen unterstützt, verwenden Sie einen IPv4-Feed, auch wenn Ihr Plan zusätzlich Domain- oder URL-Abdeckung enthält. Domain- und URL-Feeds sollten nur in Firewall-Funktionen hinterlegt werden, die diese Indikator-Kategorien parsen und durchsetzen können.

URL-Nutzung in Firewalls

Wenn Sie die Feed-URL in eine Firewall einfügen, verwenden Sie die vollständige URL inklusive Query-String:

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

Entfernen Sie den Teil ?key=...&type=... nicht. Ohne Key kann Cybora die Anfrage nicht autorisieren. Ohne Type weiss die API nicht, welche Indikator-Kategorie sie zurückgeben soll.

Die meisten Firewalls speichern die URL als Remote-List-Quelle und rufen sie nach einem Zeitplan ab. Setzen Sie das Polling-Intervall gemäss Ihrem Cybora-Plan und den Refresh-Möglichkeiten des Firewall-Herstellers. Häufigeres Polling als erlaubt liefert keine frischeren Daten und kann Schutzmechanismen gegen übermässige Abfragen auslösen.

Umgang mit Keys

Verwenden Sie einen eindeutigen Lizenzschlüssel für den Firewall-Edge oder das Gerät, das Ihr Plan erlaubt. Nutzen Sie einen Key nicht über unabhängige Geräte hinweg, sofern dies nicht ausdrücklich in Ihrer Vereinbarung enthalten ist.

Wenn ein Key offengelegt wurde, rotieren Sie ihn über den Support und aktualisieren Sie die Firewall-Konfiguration mit der neuen Feed-URL.