المفتاح المسرّب هو أكثر طريقة شيوعًا لانفلات فاتورة 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 المسموح بها في المسرد الفكرة بعبارات عامة.

