---
title: "ما هي قائمة عناوين IP المسموحة لمفتاح API؟ أمثلة CIDR"
description: "تقبل قائمة عناوين IP المسموحة الطلبات من العناوين أو نطاقات CIDR المدرجة فقط. كيف تحمي مفتاح LLM API، وكيف يعمل CIDR، وأخطاء عناوين الخروج السحابية."
url: https://broadrouter.com/ar/glossary/ip-allow-list/
lang: ar
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# قائمة عناوين IP المسموحة (IP allow list)

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

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

يُسمّى أيضًا: قائمة عناوين IP المسموحة، القائمة البيضاء لعناوين IP، عناوين IP المسموح بها، تقييد عناوين IP، IP allow list، IP allowlist، IP whitelist، allowed IPs، IP restriction، allowed\_ips

يعمل مفتاح 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](https://broadrouter.com/ar/glossary/api-key/) رموز حاملة (bearer tokens): من يحمل المفتاح يستطيع استخدامه. وتتسرّب المفاتيح عبر عمليات الإيداع (commits) والسجلات ولقطات الشاشة والحواسيب المحمولة. ومع القائمة المسموحة، يفشل المفتاح المسروق من شبكة المهاجم، فيتحول التسرّب من حادثة إنفاق إلى أمر لا يُذكر. فـ GitHub مثلًا يطبّق قائمته المسموحة على استدعاءات API ورموز الوصول الشخصية، إلى جانب تسجيل الدخول عبر الويب.

والثمن بعض العمل التشغيلي. فكل خادم أو منطقة أو مشغّل CI جديد يحتاج إلى إضافة عنوان خروجه، والعناوين المتغيرة تحتاج إلى مسار خروج ثابت.

## في BroadNet Inference

في صفحة الحساب، أضف عنوان IPv4 أو IPv6 واحدًا أو نطاق CIDR واحدًا في كل سطر، حتى 32 مُدخلًا. والقائمة الفارغة تعني عدم وجود قيود. وترث المفاتيح الجديدة قائمة الحساب. أما الحقل `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"]}'
```

تحصل الطلبات القادمة من عناوين أخرى على 403. وبعد أي تغيير أو إلغاء مفتاح، تتوقف الطلبات الجديدة خلال خمس ثوانٍ. الخطوات الكاملة في [مفاتيح API وقوائم عناوين IP المسموحة](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/)، وجدول الأخطاء في [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/). وللصورة الأوسع عن حماية البيانات، راجع [قائمة التحقق من عدم الاحتفاظ بالبيانات (ZDR)](https://broadrouter.com/ar/blog/zero-data-retention-llm-api-checklist/).

## أخطاء شائعة

-   إدراج العنوان الخاص للخادم، مثل `10.x.x.x`، بدل عنوان الخروج العام.
-   استخدام نطاق واسع جدًا لإخفاء الأخطاء. فالنطاق `/8` يغطي أكثر من 16 مليون عنوان.

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

### هل تكفي قائمة عناوين IP المسموحة لحماية مفتاح API؟

لا. هي طبقة واحدة. واصل إبقاء المفاتيح على الخوادم، بعيدًا عن الكود والسجلات، وامنح كل تطبيق مفتاحه الخاص، وألغِ المفاتيح سريعًا عند تسرّبها.

### تعمل خوادمي على بنية بلا خوادم (serverless) أو بتوسّع تلقائي. هل أستطيع استخدام قائمة مسموحة؟

فقط إن كانت الحركة الصادرة تخرج من عناوين معروفة. مرّرها عبر بوابة NAT أو وكيل خروج (egress proxy) بعناوين IP ثابتة، ثم أدرج تلك العناوين.

### ما الخطأ الذي أحصل عليه من عنوان IP غير مدرج في القائمة؟

في BroadNet Inference، الخطأ 403. وتُرجع واجهات API الأخرى عادةً 403 أيضًا.

## انظر أيضًا

-   [مفتاح API (API key)](https://broadrouter.com/ar/glossary/api-key/) (مصطلح)
-   [عدم الاحتفاظ بالبيانات (Zero data retention)](https://broadrouter.com/ar/glossary/zero-data-retention/) (مصطلح)
-   [حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/) (مصطلح)
-   [اربط مفاتيح API بخوادمك عبر قوائم عناوين IP المسموح بها](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/) (دليل)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/) (دليل)
-   [عدم الاحتفاظ بالبيانات في LLM API: قائمة تحقق من 10 أسئلة](https://broadrouter.com/ar/blog/zero-data-retention-llm-api-checklist/) (مقال)

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

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

**المصادر**

-   [RFC 4632: التوجيه بين النطاقات دون فئات (CIDR)](https://www.rfc-editor.org/rfc/rfc4632)
-   [توثيق GitHub، إدارة عناوين IP المسموحة لمؤسسة](https://docs.github.com/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)
-   [المرجع التقني لـ BroadNet Inference API، قوائم عناوين IP المسموحة (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-ip-allow-list&utm_content=sources#ip-allow-lists)
