نظرة عامة

قائمة عناوين IP المسموح بها هي ميزة أمان اختيارية تتيح لك تحديد عناوين IP التي يمكنها الوصول إلى واجهة OpenAI API الخاصة بك.

عند تفعيلها، لا يُسمح إلا بالطلبات الواردة من عناوين IP أو نطاقاتها المحددة في الإعدادات. تُرفض الطلبات الواردة من جميع عناوين IP الأخرى، حتى إذا تضمنت مفتاح API صالحًا.

تهدف هذه الميزة إلى المساعدة في تقليل مخاطر الاستخدام غير المصرّح به لواجهة API من خلال قصر الوصول على بيئات الشبكة الموثوقة.

ملاحظة: تنطبق قائمة عناوين IP المسموح بها على طلبات API فقط. ولا تؤثر في الوصول إلى platform.openai.com أو تسجيل دخول المستخدمين.

لماذا تستخدم قائمة عناوين IP المسموح بها

يمكن أن تساعدك قائمة عناوين IP المسموح بها على:

• قصر الوصول إلى واجهة API على بنية تحتية معروفة (مثل خوادمك أو بيئاتك السحابية)

• تقليل المخاطر في حال تسرّب مفتاح API

• إضافة طبقة أخرى من التحكم في مصادر حركة بيانات API

يشيع استخدام قائمة عناوين IP المسموح بها في بيئات الإنتاج التي تصدر فيها حركة بيانات API من نطاقات شبكة ثابتة أو محددة بوضوح.

آلية العمل

تُعدّ قائمة بعناوين IP أو نطاقات CIDR المسموح بها.

• تُقبل الطلبات الواردة من عناوين IP المسموح بها.

• تُرفض الطلبات الواردة من عناوين IP غير المدرجة في قائمة السماح.

يمكن تطبيق قائمة عناوين IP المسموح بها على:

• مستوى المؤسسة، أو

• مستوى المشروع

التوفر

تتوفر ميزة قائمة عناوين IP المسموح بها لجميع عملاء واجهة API.

لإعداد قائمة عناوين IP المسموح بها، اتبع الخطوات أدناه.

إعداد قائمة عناوين IP المسموح بها

ملاحظة: يمكنك إضافة ما يصل إلى 50 عنوان IP أو نطاق CIDR.

1. افتح الإعدادات.

2. اختر الأمان.

3. اختر قائمة عناوين IP المسموح بها.

4. أضف عنوان IP أو نطاق CIDR واحدًا أو أكثر.

5. (اختياري) استخدم أداة التحقق لمعرفة ما إذا كان عنوان IP مدرجًا في قائمة السماح.

6. فعّل قائمة السماح على مستوى:

   • مشروع محدد، أو

   • مؤسستك بأكملها.

7. اختبر الطلبات من البيئات التي تتوقع استخدامها.

نوصي بالبدء بمشروع واحد قبل تطبيق القيود على مستوى المؤسسة بأكملها.

قد يستغرق سريان التغييرات بعد إجرائها ما يصل إلى 15 دقيقة.


ملاحظة: يجب أن تتوفر لديك الصلاحيات المناسبة في المؤسسة لضبط إعدادات قائمة عناوين IP المسموح بها.

استكشاف الأخطاء وإصلاحها

إذا فشلت الطلبات على نحو غير متوقع:

• تأكد من أن الطلب صادر من عنوان IP مسموح به.

• تحقق مما إذا كانت عناوين IP الخاصة ببنيتك التحتية قد تغيّرت.

• راجع نطاقات IP المحددة في الإعدادات للتأكد من دقتها.

• انتظر ما يصل إلى 15 دقيقة حتى تسري تغييرات الإعدادات.

• استخدم أداة التحقق لمعرفة ما إذا كان عنوان IP مسموحًا به.

ماذا يحدث عند حظر طلب

إذا ورد طلب من عنوان IP غير مدرج في قائمة السماح، فسيفشل الطلب وتُرجع الاستجابة ما يلي:

• حالة HTTP: 401 Unauthorized

• رمز الخطأ: ip_not_authorized

مثال على الاستجابة:

{

 "error": {

   "message": "Your IP is not authorized to access this organization.",

   "type": "ip_not_authorized"

 }

}

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

هل تمنع قائمة عناوين IP المسموح بها جميع أشكال الاستخدام غير المصرّح به لمفتاح API الخاص بي؟

لا. يمكن أن تساعد قائمة عناوين IP المسموح بها في تقليل المخاطر عبر تقييد مصادر طلبات API، لكنها لا تمنع جميع أشكال إساءة الاستخدام منعًا كاملًا. ينبغي استخدامها إلى جانب أفضل ممارسات الأمان الأخرى، مثل تخزين المفاتيح بأمان وتغييرها دوريًا وتعزيز أمان الحساب. لمزيد من الأمان، راجع دليلَي مركز المساعدة حول أفضل الممارسات للحفاظ على أمان مفتاح API ومنع الاستخدام غير المصرّح به.

هل تؤثر قائمة عناوين IP المسموح بها في زمن الاستجابة؟

قد تؤدي قائمة عناوين IP المسموح بها إلى تأخير طفيف في بعض الحالات، عادةً عند إرسال الطلبات الأولى. ولا يُتوقع أن تؤثر تأثيرًا ملحوظًا في الأداء العام لواجهة API.

كيف أعرف ما إذا كان فشل الطلب ناتجًا عن قائمة عناوين IP المسموح بها؟

تُرجع الطلبات التي تفشل بسبب قائمة عناوين IP المسموح بها ما يلي:

• HTTP status: 401 Unauthorized

• Error code: ip_not_authorized