BroadRouter
ابدأ الآن

اربط مفاتيح API بخوادمك عبر قوائم عناوين IP المسموح بها

آخر تحديث

أضف عناوين IPv4 أو IPv6 الصادرة من خوادمك، أو نطاقات CIDR، إلى قائمة الحساب المسموح بها، بحد أقصى 32 إدخالًا. ترث المفاتيح الجديدة هذه القائمة ما لم تمرّر allowed_ips عند إنشاء المفتاح. تتلقى الطلبات من العناوين الأخرى الخطأ 403، وتسري تغييرات القائمة وإلغاء المفاتيح خلال خمس ثوانٍ.

المفتاح المسرّب هو أكثر طريقة شيوعًا لانفلات فاتورة API. تمنحك BroadNet Inference أداتَي تحكم: قائمة عناوين IP مسموح بها، وإلغاء سريع للمفاتيح.

نوعان من بيانات الاعتماد

نوع الاعتماد استخدامه تعامل معه على أنه
مفتاح استدلال طلبات النماذج إلى /v1/* سرّ لتطبيق أو وكيل واحد
بيانات اعتماد البوابة أتمتة الحساب: المفاتيح وعناوين IP المسموح بها والمشتريات صلاحية كاملة على الحساب

يُعرض كلاهما مرة واحدة فقط. لا تحتفظ البوابة إلا ببصمة SHA-256، فلا يمكنها عرض المفتاح مرة أخرى. ويدوم مفتاح الاستدلال بالدفع حسب الاستخدام سنة واحدة من تاريخ إنشائه، ويمكن للحساب أن يحمل حتى عشرة مفاتيح فعّالة.

اضبط القائمة المسموح بها

في صفحة الحساب، أضف عنوان IPv4 أو IPv6 واحدًا أو نطاق CIDR في كل سطر، بحد أقصى 32 إدخالًا. القائمة الفارغة تعني عدم وجود أي تقييد لعناوين IP. ترث المفاتيح الجديدة قائمة الحساب هذه. وتتحقق الحافة من عنوان IP العميل الذي يبلّغ عنه Cloudflare في كل طلب API.

لإدارة قائمة الحساب من سكربت، يستبدلها PUT /portal/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"]}'

تحلّ قيمة allowed_ips الخاصة بالمفتاح محل قائمة الحساب الموروثة لذلك المفتاح. وتحتوي الاستجابة على المفتاح الخام مرة واحدة فقط؛ فاحفظه فورًا.

ألغِ المفتاح المسرّب بسرعة

يلغي DELETE /portal/keys/{alias} مفتاح الدفع حسب الاستخدام، ويلغي DELETE /portal/keys/hourly/{alias} المفتاح بالساعة (وتبقى رسوم الشراء الأصلية). بعد الإلغاء أو تغيير القائمة المسموح بها، تتوقف الطلبات الجديدة خلال خمس ثوانٍ.

curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"

اضبط KEY_ALIAS على الاسم المستعار الظاهر للمفتاح في صفحة الحساب أو في GET /portal/keys. الاسم المستعار ليس المفتاح السري. وإن تسرّبت بيانات اعتماد البوابة، فألغِها عبر DELETE /portal/credentials/{id}: فهي قادرة على فعل كل ما يستطيعه حسابك.

حل المشكلات

  • 403 من خادم أدرجته. ترى الحافة عنوانك العام الصادر، لا عنوان IP الخاص للخادم. فالخوادم خلف بوابة NAT أو وكيل (proxy) أو موازن أحمال تخرج بعنوان ذلك الجهاز. وقد يخرج خادم يدعم IPv6 عبر IPv6 حتى لو أدرجت عنوان IPv4 الخاص به فقط. أدرج العنوان الذي يخرج منه الطلب فعلًا، أو نطاق CIDR يغطيه.
  • مفتاح جديد يتجاهل قائمة الحساب. مصفوفة allowed_ips الخاصة بالمفتاح تحلّ محل قائمة الحساب الموروثة لذلك المفتاح. تحقّق مما مرّرته عند الإنشاء.
  • 409 key_limit_reached. يحمل الحساب بالفعل عشرة مفاتيح فعّالة. ألغِ مفتاحًا لم تعد تستخدمه.
  • الطلبات لا تزال تنجح بعد الإلغاء ببضع ثوانٍ. هذا متوقع لمدة تصل إلى خمس ثوانٍ ريثما تُحدَّث الذاكرة المؤقتة.

الطلب من عنوان غير موجود في القائمة يتلقى 403. راجع جميع رموز أخطاء BroadNet ومتى تعيد المحاولة. ولإرسال أول طلب بمفتاح جديد، اتبع دليل OpenAI Python SDK. ويشرح مدخل قائمة عناوين IP المسموح بها في المسرد الفكرة بعبارات عامة.

A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."

أسئلة شائعة

كيف أقيّد مفتاح API لنموذج لغوي بعنوان IP خادمي؟

أضف العنوان العام الصادر من الخادم، أو نطاق CIDR، إلى قائمة الحساب المسموح بها في صفحة الحساب على BroadNet، أو مرّر allowed_ips عند إنشاء المفتاح عبر POST /portal/keys. وتُرفض الطلبات من أي عنوان آخر بالخطأ 403.

هل تحظر القائمة الفارغة كل شيء؟

لا. القائمة الفارغة تعني عدم وجود أي تقييد لعناوين IP، فيعمل المفتاح من أي عنوان. أضف إدخالًا واحدًا على الأقل لتفعيل التقييد.

هل يمكنني استخدام مفتاح استدلال لإنشاء مفاتيح أخرى؟

لا. مفاتيح الاستدلال تستدعي مسارات النماذج /v1/* فقط. أما إنشاء المفاتيح وإلغاؤها وتغيير عناوين IP المسموح بها وشراء المفاتيح بالساعة فتحتاج إلى بيانات اعتماد البوابة، وهي تحمل صلاحية كاملة على الحساب.

ما سرعة إلغاء مفتاح مسرّب؟

يقول توثيق BroadNet إن الطلبات الجديدة تتوقف خلال خمس ثوانٍ من الإلغاء أو من تغيير القائمة المسموح بها، لأن قرارات التفويض قد تبقى في ذاكرة مؤقتة منسوخة طوال هذه المدة.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity