# كيف يمكنني تدوير أو إلغاء مفاتيح واجهة برمجة التطبيقات (API)؟

> في لوحة التحكم، انتقل إلى مفاتيح API، وقم بإنشاء مفتاح جديد، ثم قم بتطبيقه في تطبيقاتك، وبعد ذلك قم بإلغاء المفتاح القديم. عملية الإلغاء فورية، ولا يتم تسجيل المفاتيح أبداً، لذا فإن تدوير المفتاح سيؤدي إلى توقفه عن العمل فوراً دون أي مخاطر متبقية. قم بتدوير المفاتيح وفق جدول زمني (على سبيل المثال كل ربع سنة) وفور الاشتباه في أي تسريب، وعامل الرمز (token) المستخرج من بيانات اعتماد الاختبار كسرّ من أسرار بيئة الإنتاج: لأنه يتصل بنقطة النهاية (endpoint) الخاصة ببيئة الإنتاج. راجع /developers/authentication.

- الرابط الأساسي: https://www.broadnet.me/ar/answers/rotate-api-keys
- اللغة: ar
- آخر مراجعة: 2026-09-29
- الناشر: BroadNet (https://www.broadnet.me)

## قم بالتدوير دون توقف

أنشئ مفتاحًا جديدًا في لوحة التحكم (مفاتيح واجهة برمجة التطبيقات ← إنشاء) بينما لا يزال المفتاح الحالي نشطًا. انشر المفتاح الجديد على تطبيقاتك وتأكد من تدفق البيانات عليه، ثم ألغِ المفتاح القديم. ولأن كلا المفتاحين صالحان خلال فترة التداخل، فلن يكون هناك انقطاع في الخدمة - وهذا هو نمط التناوب القياسي بدون توقف.

## إلغاء مفتاح

يُصبح إلغاء مفتاح في لوحة التحكم ساري المفعول فورًا: أي طلب يُقدّم المفتاح المُلغى يُرفض. ولأن BroadNet لا تُسجّل المفاتيح الخام أبدًا، فإن إلغاء المفتاح لا يُخلّف أي بيانات قابلة للتسريب. يُنصح بالإلغاء فورًا إذا كان من المحتمل أن يكون المفتاح قد أُضيف إلى نظام التحكم في الإصدار، أو أُلصق في تذكرة، أو تم كشفه بأي شكل آخر.

## عامل بيانات اعتماد الاختبار كأسرار خاصة ببيئة الإنتاج

تعمل بيانات اعتماد الاختبار مع نقطة النهاية (endpoint) الخاصة ببيئة الإنتاج، https://api.broadnet.me، لذا احمِها كأي سر من أسرار بيئة الإنتاج منذ اليوم الأول: احتفظ بالرمز (token) في متغير بيئة أو في مدير أسرار، ولا تضعه أبداً في نظام التحكم في الإصدار (source control) أو في كود جانب العميل أو في ملفات الاختبار المشتركة، وقم بتدويره إذا تعرض للتسريب. راجع /answers/what-is-sandbox-vs-production.

## متى يتم التدوير

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

## المفاتيح قابلة للإلغاء

مفاتيح API قابلة للإلغاء في أي وقت، وهو ما يجعل التدوير الدوري آمناً ومنخفض التكلفة. ادمج عملية التدوير مع استخدام المفاتيح وفق مبدأ الحد الأدنى من الصلاحيات بحيث لا يحمل كل تطبيق إلا بيانات الاعتماد التي يحتاجها فعلياً. راجع /developers/authentication.

## ذو صلة

- [جميع الإجابات](https://www.broadnet.me/ar/answers)
- [مسرد المصطلحات](https://www.broadnet.me/ar/answers)
- [بيانات اعتماد الاختبار أم بيئة الإنتاج: ما الذي يتغير عند الإطلاق؟](https://www.broadnet.me/ar/answers/what-is-sandbox-vs-production)
- [كيف أقوم بتفعيل حسابي في BroadNet؟](https://www.broadnet.me/ar/answers/activate-account)
- [ما هي واجهة برمجة تطبيقات رسائل SMS (SMS API)؟](https://www.broadnet.me/ar/answers/what-is-sms-api)
- [Authentication](https://www.broadnet.me/ar/developers/authentication)
- [Developer docs](https://www.broadnet.me/ar/developers)
