Feed URL format और license keys

Cybora feed URLs उन firewall configuration fields में paste करने के लिए बनाए गए हैं जो remote text list expect करते हैं। Firewall HTTPS request करता है और हर line में एक indicator वाली plain TXT response प्राप्त करता है।

Cybora firewall-specific file formats का उपयोग नहीं करता। Supported firewall platforms में वही URL structure उपयोग होता है; firewall-specific हिस्सा यह है कि URL कहां paste होता है और firewall returned list को कैसे consume करता है।

Create your feed URL

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

License key

Indicator category

IPv4 Domain URL

Generated feed URL

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

Base URL

Standard feed endpoint है:

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

URL के तीन हिस्से हैं:

https://api.cybora.io/feed HTTPS endpoint है जो TXT feed return करता है।
key feed subscription तक access authorize करता है।
type return की जाने वाली indicator category चुनता है।

Required GET parameters

Parameter	Required	Example	Description
`key`	Yes	`ABCDE-12345-FGHIJ-67890-KLMNO`	आपकी unique Cybora license key. Firewall device, edge या trial feed के लिए जारी की गई exact key उपयोग करें.
`type`	Yes	`ipv4`	Return की जाने वाली indicator category. Supported values आपके plan के अनुसार `ipv4`, `domain` और `url` हैं.

Cybora license keys आम तौर पर hyphen-separated पांच blocks के रूप में जारी होती हैं। Key को feed URL या ऊपर दिए generator में paste करते समय hyphens बनाए रखें।

type value उस indicator category से match होनी चाहिए जिसे आप firewall से import कराना चाहते हैं:

ipv4 IPv4 addresses return करता है।
domain domain indicators return करता है।
url URL indicators return करता है।

Normal firewall integrations के लिए कोई additional format parameter required नहीं है। Cybora default रूप से flat TXT feed return करता है।

Example 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 response format

Response body plain text है। कोई JSON wrapper, nested structure या firewall-vendor-specific envelope नहीं है। हर line में एक indicator होता है।

Example IPv4 output:

203.0.113.10
198.51.100.24
192.0.2.4

Example domain-style output:

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

Example URL output:

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

Indicator category चुनना

type value इस आधार पर चुनें कि आपका plan क्या include करता है और firewall natively क्या enforce कर सकता है:

Firewall address objects, aliases, external dynamic lists या blocklists के लिए type=ipv4 उपयोग करें।
DNS-layer policy या domain objects support करने वाली firewall features के लिए type=domain उपयोग करें।
type=url केवल वहां उपयोग करें जहां platform URL-aware enforcement रखता हो।

यदि firewall केवल IP-based external lists support करता है, तो IPv4 feed उपयोग करें, भले ही आपका plan domain या URL coverage भी include करता हो। Domain और URL feeds सिर्फ ऐसी firewall features में जोड़ें जो उन indicator categories को parse और enforce कर सकती हों।

Firewalls में URL handling

जब आप feed URL firewall में paste करें, तो query string सहित full URL उपयोग करें:

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

?key=...&type=... हिस्सा न हटाएं। Key के बिना Cybora request authorize नहीं कर सकता। Type के बिना API यह नहीं जान सकती कि कौन सी indicator category return करनी है।

अधिकांश firewalls URL को remote list source के रूप में store करते हैं और schedule पर poll करते हैं। Polling interval को अपने Cybora plan और firewall vendor के supported refresh settings के अनुसार set करें। Plan से अधिक frequent polling fresh data नहीं देता और excessive requests के खिलाफ protection trigger कर सकता है।

Key handling

अपने plan द्वारा allowed firewall edge या device के लिए unique license key उपयोग करें। जब तक commercial agreement स्पष्ट रूप से allow न करे, unrelated devices में एक key reuse न करें।

यदि key expose हो जाए, तो support के माध्यम से rotate करें और firewall configuration को नए feed URL से update करें।