---
title: "تقييد مفتاح API لنموذج لغوي بعناوين IP لخوادمك | BroadRouter"
description: "احمِ مفاتيح BroadNet Inference بقوائم عناوين IP المسموح بها، وافصل مفاتيح الاستدلال عن بيانات اعتماد البوابة، وألغِ أي مفتاح مسرّب خلال ثوانٍ. مع أمثلة curl."
url: https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/
lang: ar
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/guides/api-keys-ip-allow-lists/) (حُدّث في 2026-11-16).

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

آخر تحديث 2026-11-16

أضف عناوين 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` باستدعاء واحد (يتطلب بيانات اعتماد البوابة).

ولمنح مفتاح واحد قائمته الخاصة، حدّدها عند إنشائه ببيانات اعتماد البوابة:

```bash
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}` المفتاح بالساعة (وتبقى رسوم الشراء الأصلية). بعد الإلغاء أو تغيير القائمة المسموح بها، تتوقف الطلبات الجديدة خلال خمس ثوانٍ.

```bash
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 ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/). ولإرسال أول طلب بمفتاح جديد، اتبع [دليل OpenAI Python SDK](https://broadrouter.com/ar/guides/openai-python-sdk/). ويشرح [مدخل قائمة عناوين IP المسموح بها في المسرد](https://broadrouter.com/ar/glossary/ip-allow-list/) الفكرة بعبارات عامة.

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

## مصطلحات في هذا الدليل

[مفتاح API (API key)](https://broadrouter.com/ar/glossary/api-key/)

مفتاح API هو سلسلة نصية سرية تعرّف العميل الذي يستدعي الواجهة وتخوّله. تتوقعه واجهات LLM API عادةً في الترويسة Authorization: Bearer، وكل من يملك المفتاح يستطيع إرسال طلبات تُحتسب تكلفتها على الحساب المالك له.

[الدفع حسب الاستخدام (Pay-as-you-go)](https://broadrouter.com/ar/glossary/pay-as-you-go/)

الدفع حسب الاستخدام هو نموذج تسعير تدفع فيه مقابل ما تستخدمه فقط، مقيسًا بوحدات مثل الرموز (التوكنات) أو الطلبات أو دقائق الصوت، دون اشتراك أو حد أدنى للالتزام. وتحتسب معظم واجهات LLM API تكلفتها بهذه الطريقة، من رصيد مدفوع مسبقًا أو بفاتورة دورية.

[الرمز (التوكن، Token)](https://broadrouter.com/ar/glossary/token/)

الرمز (التوكن) هو وحدة النص التي يقرؤها نموذج اللغة ويكتبها: كلمة، أو جزء من كلمة، أو علامة ترقيم، أو تسلسل بايتات ينتجه مجزّئ النموذج (tokenizer). وتَعُدّ واجهات LLM API الاستهلاك بالرموز، وتضع حدودها بها، وتحتسب تكلفتها بها عادةً.

[قائمة عناوين IP المسموحة (IP allow list)](https://broadrouter.com/ar/glossary/ip-allow-list/)

قائمة عناوين IP المسموحة (IP allow list) ضابط أمني يقبل الطلبات من عناوين IP أو نطاقات CIDR المدرجة فقط ويرفض كل ما عداها. وفي واجهات API تحدّ من ضرر تسرّب المفتاح، لأن المفتاح لا يعمل من شبكات غير مدرجة في القائمة.

## أسئلة شائعة

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

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

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

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

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

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

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

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

## أدلة ذات صلة

-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-api-keys-ip-allow-lists&utm_content=page-cta) ·

**المصادر**

-   [المرجع التقني لـ BroadNet Inference API، قوائم عناوين IP المسموح بها (رُوجع في 2026-11-16) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-api-keys-ip-allow-lists&utm_content=sources#ip-allow-lists)
-   [المرجع التقني لـ BroadNet Inference API، المفاتيح بالساعة وبيانات اعتماد البوابة (رُوجع في 2026-11-16) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-api-keys-ip-allow-lists&utm_content=sources#hourly-keys)
-   [المرجع التقني لـ BroadNet Inference API، الحدود (عمر المفتاح والمفاتيح الفعّالة) (رُوجع في 2026-11-16) (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-guides-api-keys-ip-allow-lists&utm_content=sources#limits)
