يعمل مفتاح API من أي مكان افتراضيًا. والقائمة المسموحة تربطه بالأماكن التي تشغّل منها الكود فعلًا.
كيف تعمل
تفحص حافة الواجهة (edge) عنوان IP المصدر لكل طلب وتقارنه بقائمة. فإن كان العنوان في القائمة، أو داخل نطاق مدرج، انتقل الطلب إلى فحص المفتاح المعتاد. وإلا رُفض.
تُكتب النطاقات بترميز CIDR: عنوان، ثم شرطة مائلة، ثم طول البادئة. ويشرح RFC 4632 أن طول البادئة هو عدد البتات الأولى الثابتة. في IPv4:
| المُدخل | ما يغطيه |
|---|---|
203.0.113.7 |
عنوان واحد |
198.51.100.0/24 |
256 عنوانًا، من 198.51.100.0 إلى 198.51.100.255 |
10.0.0.0/16 |
65,536 عنوانًا |
ويستخدم IPv6 الفكرة نفسها مع عناوين من 128 بتًا، مثل 2001:db8::/48.
العنوان المهم هو عنوان الخروج (egress) لديك: العنوان العام الذي تخرج منه حركة خادمك. وخلف NAT أو موازن أحمال أو وكيل مؤسسي، كثيرًا ما لا يكون هذا هو العنوان الذي يُظهره الجهاز لنفسه.
لماذا تهم
مفاتيح API رموز حاملة (bearer tokens): من يحمل المفتاح يستطيع استخدامه. وتتسرّب المفاتيح عبر عمليات الإيداع (commits) والسجلات ولقطات الشاشة والحواسيب المحمولة. ومع القائمة المسموحة، يفشل المفتاح المسروق من شبكة المهاجم، فيتحول التسرّب من حادثة إنفاق إلى أمر لا يُذكر. فـ GitHub مثلًا يطبّق قائمته المسموحة على استدعاءات API ورموز الوصول الشخصية، إلى جانب تسجيل الدخول عبر الويب.
والثمن بعض العمل التشغيلي. فكل خادم أو منطقة أو مشغّل CI جديد يحتاج إلى إضافة عنوان خروجه، والعناوين المتغيرة تحتاج إلى مسار خروج ثابت.
في BroadNet Inference
في صفحة الحساب، أضف عنوان IPv4 أو IPv6 واحدًا أو نطاق CIDR واحدًا في كل سطر، حتى 32 مُدخلًا. والقائمة الفارغة تعني عدم وجود قيود. وترث المفاتيح الجديدة قائمة الحساب. أما الحقل allowed_ips الخاص بكل مفتاح فيحل محلها لذلك المفتاح:
curl -X POST https://inference.broadnet.ai/portal/keys \
-H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
-H "Content-Type: application/json" \
-d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
تحصل الطلبات القادمة من عناوين أخرى على 403. وبعد أي تغيير أو إلغاء مفتاح، تتوقف الطلبات الجديدة خلال خمس ثوانٍ. الخطوات الكاملة في مفاتيح API وقوائم عناوين IP المسموحة، وجدول الأخطاء في الأخطاء وإعادة المحاولة. وللصورة الأوسع عن حماية البيانات، راجع قائمة التحقق من عدم الاحتفاظ بالبيانات (ZDR).
أخطاء شائعة
- إدراج العنوان الخاص للخادم، مثل
10.x.x.x، بدل عنوان الخروج العام. - استخدام نطاق واسع جدًا لإخفاء الأخطاء. فالنطاق
/8يغطي أكثر من 16 مليون عنوان.