تصفح الوثائق

Getting Started

صيغة Feed URL ومفاتيح الترخيص

أنشئ Cybora feed URL باستخدام معلمات license key ونوع المؤشر المطلوبة.

آخر تحديث: 15 يونيو 2026

في هذه الصفحة

صُممت Cybora feed URLs ليتم لصقها في حقول إعدادات firewall التي تتوقع قائمة نصية بعيدة. ينفذ firewall طلب HTTPS ويتلقى استجابة TXT بسيطة تحتوي على مؤشر واحد في كل سطر.

لا يستخدم Cybora صيغ ملفات خاصة بكل firewall. تُستخدم بنية URL نفسها عبر منصات firewall المدعومة؛ الجزء الخاص بالـ firewall هو المكان الذي تلصق فيه URL وكيف يستهلك firewall القائمة الراجعة.

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.

Base URL

نقطة النهاية القياسية للموجز هي:

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

يتكون URL من ثلاثة أجزاء:

  • https://api.cybora.io/feed هي HTTPS endpoint التي تعيد TXT feed.
  • key يصرح بالوصول إلى اشتراك الموجز.
  • type يحدد فئة المؤشر التي يجب إرجاعها.

معلمات GET المطلوبة

المعلمةمطلوبةمثالالوصف
keyنعمABCDE-12345-FGHIJ-67890-KLMNOمفتاح ترخيص Cybora الفريد لديك. استخدم المفتاح كما صدر تماماً لجهاز firewall أو edge أو trial feed.
typeنعمipv4فئة المؤشر التي يجب إرجاعها. القيم المدعومة هي ipv4 وdomain وurl بحسب خطتك.

عادةً تصدر مفاتيح ترخيص Cybora كخمس كتل مفصولة بشرطات. احتفظ بالشرطات عند لصق المفتاح في feed URL أو في المولد أعلاه.

يجب أن تطابق قيمة type فئة المؤشر التي تريد من firewall استيرادها:

  • ipv4 تعيد عناوين IPv4.
  • domain تعيد مؤشرات نطاقات.
  • url تعيد مؤشرات URL.

في تكاملات firewall العادية، لا يلزم أي parameter إضافي للصيغة. يعيد Cybora بشكل افتراضي TXT feed مسطحاً.

أمثلة URLs

موجز IPv4:

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

موجز نطاقات:

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

موجز URL:

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

صيغة استجابة TXT

جسم الاستجابة نص عادي. لا يوجد JSON wrapper، ولا بنية متداخلة، ولا غلاف خاص بمورد firewall. يحتوي كل سطر على مؤشر واحد.

مثال لمخرجات IPv4:

203.0.113.10
198.51.100.24
192.0.2.4

مثال لمخرجات نطاقات:

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

مثال لمخرجات URL:

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

اختيار فئة المؤشر

اختر قيمة type بناءً على ما تتضمنه خطتك وما يستطيع firewall تطبيقه أصلياً:

  • استخدم type=ipv4 لكائنات عناوين firewall أو aliases أو external dynamic lists أو blocklists.
  • استخدم type=domain لسياسات DNS-layer أو ميزات firewall التي تدعم كائنات النطاق.
  • استخدم type=url فقط عندما تملك المنصة enforcement مدركاً للـ URL.

إذا كان firewall يدعم فقط قوائم خارجية مبنية على IP، فاستخدم IPv4 feed حتى لو كانت خطتك تشمل أيضاً تغطية domain أو URL. يجب إضافة domain وURL feeds فقط إلى ميزات تستطيع parsing وتطبيق تلك الفئات.

التعامل مع URLs في firewalls

عند لصق feed URL في firewall، استخدم URL كاملاً بما في ذلك query string:

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

لا تزل جزء ?key=...&type=.... من دون المفتاح لا يستطيع Cybora التصريح بالطلب. ومن دون النوع لا تستطيع API معرفة فئة المؤشر التي يجب إرجاعها.

تخزن معظم firewalls هذا URL كمصدر قائمة بعيد وتستعلم عنه وفق جدول. اضبط polling interval بحسب خطة Cybora وإعدادات refresh التي يدعمها المورد. الاستعلام بوتيرة أعلى مما تسمح به الخطة لا يعطي بيانات أحدث، وقد يفعّل حماية ضد الطلبات المفرطة.

التعامل مع المفاتيح

استخدم license key فريداً للـ firewall edge أو الجهاز المسموح به في خطتك. لا تعد استخدام مفتاح واحد عبر أجهزة غير مرتبطة إلا إذا كان اتفاقك التجاري يسمح بذلك صراحة.

إذا انكشف مفتاح، فقم بتدويره عبر الدعم وحدّث إعداد firewall باستخدام feed URL الجديد.