مفاتيح API وكلمات السر: لا تضعها في ملفات موقعك أو في المحادثات
باختصار: مفتاح API مسرّب يسمح لأي شخص يحمله بأن يستخدم حسابك في الخدمة، وقد يكلفك فاتورة كبيرة أو يفتح بيانات الزبائن. أخطر أماكن التسريب هي الكود المرفوع إلى مستودع عام، وملفات الواجهة التي يقرأها المتصفح، ولقطات الشاشة، والمحادثات مع الفريق. احفظ المفاتيح في مكان خاص بالخادم أو في خدمة إدارة الأسرار التي تقدمها منصة الاستضافة، ولا تكتبها داخل الكود نفسه. اطلب من مطوّرك أن يؤكد لك كتابةً أين يوجد كل مفتاح، ومن يملك صلاحية الوصول إليه. وعند الشك في تسريب، دوّر المفتاح فوراً، ثم راجع من استخدمه قبل ذلك.
أين تتسرب المفاتيح عادة
التسريب نادراً ما يكون بقصد. أكثر الطرق شيوعاً:
- مستودع عام على GitHub: يرفع المطوّر ملفاً فيه المفتاح ظناً منه أنه مؤقت، ثم تبقى النسخة في السجل حتى بعد حذفها.
- كود الواجهة الأمامية: أي مفتاح يوضع في ملف JavaScript يصل إلى كل زائر، لأن المتصفح يحمّل الملف كاملاً.
- لقطات الشاشة: صورة لشاشة الإعدادات أو لملف فيه المفتاح تُرسل في مجموعة واتساب أو تُرفع إلى موقع لشرح المشكلة.
- المحادثات: رسالة يكتب فيها أحدهم المفتاح لتسهيل الأمر على زميل، وتبقى في سجل الدردشة لسنوات.
- سجلات الخادم: طباعة الطلبات الكاملة في السجل قد تكشف الترويسات التي تحمل المفتاح.
مثال توضيحي: صاحب متجر طلب من مطوّر مستقل أن يربط موقعه بخدمة شحن، فأرسل المطوّر الكود كاملاً بالمفتاح في رسالة، ثم انتقل الكود إلى مستودع عام لمشاركته مع فريق آخر. لم يُكتشف الأمر إلا بعد أن بدأت فواتير الخدمة ترتفع بلا سبب.
ما تطلبه من المطوّر كتابةً
لا تكتفِ بقول "احفظ المفاتيح بأمان". اطلب من المطوّر أن يسلّمك ورقة بسيطة فيها:
- قائمة بكل مفتاح، والخدمة التي يخصها، والمكان الذي يُحفظ فيه (الخادم، أو خدمة الأسرار).
- من يملك صلاحية الوصول إلى كل مفتاح، ومتى أُعطيت له.
- هل المفتاح يُستخدم من الواجهة الأمامية؟ إن كانت الإجابة نعم، فهذه مشكلة تحتاج إعادة تصميم.
- هل يوجد سجل لاستخدام المفتاح يمكن مراجعته عند الشك؟
- ما الإجراء المتبع لتدوير المفتاح دون توقف الموقع؟
إذا تهرب المطوّر من أي بند، فاسأله عن السبب بهدوء. الجواب الصريح يكشف إن كان يعرف أصول العمل أم لا.
الفصل بين الكود والأسرار
الفكرة الأساسية أن الكود يُعرض ويُنسخ ويُراجع، أما المفاتيح فتبقى في مكان آخر. في الخادم، يقرأ الكود المفتاح من متغير بيئة مضبوط في إعدادات الاستضافة:
// في الخادم فقط، لا في ملفات الواجهة
const apiKey = process.env.SHIPPING_API_KEY;
if (!apiKey) {
throw new Error('مفتاح خدمة الشحن غير مضبوط في إعدادات الخادم');
}
الكود يرفض العمل إذا كان المفتاح غائباً، بدل أن يعمل بقيمة افتراضية أو يطبع المفتاح في السجل. ولا تضع قيمة افتراضية حقيقية في الكود أبداً، حتى لو كانت للتجربة.
خطوات عند الشك في تسريب
إذا وصلك إشعار بنشاط غريب، أو وجدت المفتاح في مكان عام، فتصرف بسرعة وبهذا الترتيب:
- دوّر المفتاح فوراً من لوحة الخدمة، وأنشئ مفتاحاً جديداً وضعه في إعدادات الخادم.
- راجع سجل الاستخدام وابحث عن طلبات من أماكن أو أوقات لا تعرفها، وتابع الفواتير لأيام.
- أبلغ المزوّد إن كانت الخدمة تقدم خاصية الإبلاغ عن إساءة الاستخدام، وأبلغ من يدير حساب الفوترة.
ثم اكتب ما حدث وكيف اكتُشف، حتى لا يتكرر. الخطوة الثالثة كثيراً ما تُنسى، لكن الخدمة قد تعوّض الفواتير الناتجة عن الاستخدام غير المشروع إن أُبلغت مبكراً.
روتين التدوير
المفاتيح تحتاج تدويراً دورياً، حتى لو لم يحدث تسريب. الجدول التالي يصلح نقطة بداية:
| الحدث | الإجراء |
|---|---|
| مغادرة شخص لديه وصول | دوّر كل المفاتيح التي كان يعرفها |
| تغيير مزوّد أو مطوّر | دوّر المفاتيح وراجع من يملك صلاحيات |
| كل ستة أشهر | دوّر المفاتيح الحساسة، مثل الدفع والبريد |
| تغيير الاستضافة أو الدومين | تحقق من مكان كل مفتاح وحدّثه |
التدوير لا يعني توقف الموقع. الطريقة الجيدة أن يُضاف المفتاح الجديد أولاً، ثم يُحدّث الخادم، ثم يُلغى القديم بعد التأكد من عمل الخدمة.
ما الذي لا يجب أن تفعله
- لا ترسل المفتاح في رسالة نصية أو بريد أو مجموعة فريق.
- لا تضع المفتاح في ملف يُرفع إلى مستودع، حتى لو كان المستودع خاصاً، لأن الملفات الخاصة تُنسخ وتُشارك أحياناً.
- لا تستخدم المفتاح الرئيسي لكل شيء، بل أنشئ مفاتيح منفصلة لكل تطبيق أو خدمة.
- لا تترك المفاتيح القديمة مفعّلة بعد تغيير الخدمة.
صلاحيات أقل لكل مفتاح
اطلب من المزوّد أن يتيح لك مفاتيح بصلاحيات محددة، مثل قراءة البيانات فقط للتقارير، أو إرسال الرسائل فقط للإشعارات. المفتاح الذي يقرأ ولا يكتب يقلل الضرر إذا تسرب، والمفتاح الذي لا يملك صلاحية الحذف لا يستطيع أن يمحو شيئاً. أنشئ مفاتيح منفصلة لكل مهمة، واكتب بجانب كل مفتاح ما يستطيع فعله، حتى تعرف عند التسريب حجم الخطر الفعلي دون تخمين.
قائمة تحقق
- ☐ عندي قائمة مكتوبة بكل مفتاح، ومكانه، ومن يملك صلاحيته.
- ☐ لا يوجد مفتاح في ملف واجهة أمامية أو في مستودع.
- ☐ الكود يقرأ المفتاح من إعدادات الخادم ويرفض العمل إن غاب.
- ☐ لكل تطبيق مفتاح منفصل بأقل صلاحيات ممكنة.
- ☐ جدول التدوير مكتوب، ومسؤوله معروف بالاسم.
أسئلة شائعة
هل يكفي أن يكون المستودع خاصاً؟
لا يكفي. المستودعات الخاصة قد تُنسخ إلى أجهزة كثيرة، والمطوّرون يرسلون الملفات لبعضهم. المفتاح يجب أن يبقى خارج المستودع تماماً، بغض النظر عن الإعداد.
هل يصح وضع المفتاح في الواجهة إذا كانت الخدمة مجانية؟
لا. حتى الخدمات المجانية لها حدود، وأي شخص يقرأ المفتاح يستطيع استهلاكها على حسابك. إن كان المفتاح مخصصاً للواجهة بطبيعته فاسأل المزوّد عن مفتاح عام محدود الصلاحيات.
ماذا أفعل إذا لم أعد أعرف أين وُضع المفتاح؟
اطلب من المطوّر تتبع الكود والإعدادات، ثم دوّر المفتاح بعد أن تحدد مكانه. أن تجهل مكان المفتاح معناه أن أحداً قد يعرفه ولا تعرفه أنت.
هل تحتاج الحماية إلى أدوات مدفوعة؟
ليس بالضرورة. كثير من الحماية تأتي من الانضباط في المكان والصلاحيات والتدوير، وهذا لا يكلف مالاً. الأدوات تفيد عندما يكبر الفريق ويكثر عدد الأسرار.
إذا أردت مراجعة طريقة حفظ مفاتيح موقعك ومزوّديك، فأرسل لنا وصفاً بسيطاً للخدمات التي تستخدمها من صفحة التواصل ونرتب الأمر معك.