رموز Analytics API بيانات اعتماد وليست معرّفات
يمنح رمز API صلاحية الوصول إلى البيانات. تعامل معه كسِر له دورة حياة: اعرضه مرة واحدة، وخزّن قيمة تحقق، وقيّد الصلاحيات، وأتح إلغاءه.
رمز API ليس تسمية لمستخدم أو موقع؛ بل هو بيانات اعتماد. قد يتمكن أي شخص يحصل على رمز صالح من التصرف بصفة مالكه. والتعامل معه كأنه معرّف عادي يجعله يظهر في السجلات وعناوين URL ولقطات شاشة الدعم وإعدادات طويلة الأجل لا يعرف أحد كيف يلغيها.
حدّثت أفضل الممارسات الأمنية لـ OAuth 2.0 الصادرة عن IETF في يناير 2025 نموذج التهديدات والإرشادات الأمنية لعمليات نشر OAuth. قد لا يكون رمز API الشخصي رمز وصول OAuth، لكن المبدأ الهندسي نفسه ينطبق: بيانات الاعتماد القائمة على الحيازة يجب حمايتها أثناء النقل، وقصرها على الخدمة المقصودة، ومنحها الصلاحيات التي يحتاجها المستدعي فقط.
اعرض السر مرة واحدة فقط
أنشئ الرموز باستخدام مولّد عشوائي آمن تشفيرياً وبقدر كافٍ من الإنتروبيا لمنع التخمين العملي. أعد الرمز كاملاً عند الإنشاء فقط، ثم خزّن بادئة غير سرية للتعرّف عليه وقيمة تحقق أحادية الاتجاه للبحث لاحقاً. إذا نُسخت قاعدة البيانات، فقيمة التحقق أكثر أماناً من بيانات اعتماد قابلة لإعادة الاستخدام بنص واضح. لا تخلط بين hash عام وhash كلمات المرور: تحتاج رموز API إلى عشوائية عالية، بينما تتطلب كلمات المرور البشرية دالة hash بطيئة عمداً.
وضّح في واجهة المنتج واستجابة API أن الرمز سيظهر مرة واحدة فقط. بعد مغادرة المستخدم شاشة الإنشاء، أتح له إلغاء الرمز وإصدار بديل بدلاً من استرجاع السر الأصلي. لا تضع الرموز مطلقاً في معاملات الاستعلام أو عناوين الصفحات أو أحداث Analytics أو تقارير الأخطاء أو لقطات الشاشة. تصل عناوين URL إلى سجل المتصفح وحقول Referer وسجلات الوكلاء وتذاكر الدعم أسهل من ترويسات التفويض.
أرسل بيانات الاعتماد في المكان الصحيح
في واجهات HTTP API، اقبل الرموز في ترويسة Authorization عبر TLS. تصف RFC 6750 رموز bearer بأنها قابلة للاستخدام من أي شخص يحوزها، وتحذر من أن كشفها أثناء التخزين أو النقل يتيح إساءة استخدامها. كما لا توصي بوضع بيانات bearer في معاملات URI لأنها غالباً ما تُسجّل. ارفض الرموز في سلاسل الاستعلام وأجسام الطلبات، ما لم يفرض بروتوكول محدد وسيلة نقل أخرى ويكن لها نموذج تهديد موثق.
تحقق من الرمز على الخادم قبل معالجة العملية المطلوبة. استخرج المالك والصلاحيات من تخزين موثوق، ولا تقبل المستخدم أو مالك الموقع الوارد في الطلب بوصفه مصدراً للصلاحية. أبعد الأسرار عن سجلات التطبيق والتتبعات ورسائل الاستثناء. وعند الحاجة إلى ربط العمليات لأغراض التشغيل، سجّل معرّف الرمز أو بادئته غير السرية، لا بيانات الاعتماد نفسها.
قيّد الصلاحيات وحدد الانتهاء والإلغاء
ينبغي أن يمنح الرمز أقل مجموعة مفيدة من الصلاحيات. إذا كان المنتج يدعم ذلك، اسمح للمستخدم بتقييده بمواقع محددة وبعمليات القراءة أو عمليات بعينها. لا تمنح نصاً برمجياً آلياً صلاحية الكتابة على الحساب كله لمجرد حاجته إلى جلب تقرير واحد. تناقش أفضل ممارسات OAuth تقييد صلاحيات الرمز والجمهور المستهدف؛ وهي مرجع تصميم مفيد حتى عندما تستخدم API تنسيقاً معتماً خاصاً بها.
اجعل انتهاء الصلاحية والإلغاء من الضوابط الأساسية. تقلل المدد الأقصر الفترة التي تبقى فيها بيانات الاعتماد المسربة صالحة؛ ويعالج الإلغاء الحوادث والتغييرات في الفريق أو التكامل. إذا تطلب التدوير فترة تداخل، فحدّد مدتها وأظهر الرمز النشط. يجب أن يعمل الإلغاء عند حد API، لا أن يقتصر على إخفاء الرمز من لوحة التحكم.
في واجهة Monoid البرمجية، تكون رموز mnd_live_… التي ينشئها المستخدم معتمة، وتُعاد مرة واحدة بنص واضح، وتُخزّن كقيم SHA-256 مع انتهاء صلاحية اختياري وإلغاء منطقي. يحمي هذا التصميم القيمة الأصلية من القراءة المباشرة لقاعدة البيانات، لكنه لا يجعل الرمز النشط المسرب عديم الضرر. أبقه خارج نظام التحكم بالمصادر ومخرجات CI وحزم المتصفح وسجل الطرفية المشترك؛ وعند الاشتباه بالتسريب، أصدر بديلاً وألغِ الرمز القديم.
اجعل دورة الحياة قابلة للاختبار
اختبر التسلسل كاملاً: الإنشاء، والاستخدام بالصلاحيات المقصودة، ورفض الرمز غير الصالح أو المنتهي، والإلغاء، ثم التأكد من أن الرمز نفسه لم يعد يعمل. تحقّق من أن الرمز لا يتجاوز الحسابات أو المواقع وأن كل endpoint يطبق قواعد المصادقة والتفويض نفسها. أضف فحوصاً تشغيلية تضمن تنقيح الأسرار من السجلات وعدم إعادة استجابة API لمادة الرمز المخزنة.
تشمل دورة إدارة الأسرار الإنشاء والتحكم في الوصول والتدوير والتدقيق والإلغاء، لا التخزين الآمن فقط. يظل رمز API محمياً عندما يستطيع النظام تحديد مالكه، وتقييد ما يمكنه فعله، واكتشاف انكشافه من دون تسجيل السر، وتعطيله بسرعة.
Comments
Loading comments…