شرح كيفية حماية مفاتيح البرمجة (API Keys) ومنع استنزاف رصيدك في تطبيقات الذكاء الاصطناعي

الرُمح

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

img1.webp

القاعدة الأولى: المفتاح لا يغادر الخادم​

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

القاعدة الثانية: لا مفاتيح داخل الكود أبدًا​

خزّن مفاتيح API في متغيرات البيئة أو في مدير أسرار مثل الخدمات التي توفرها منصات السحابة أو أدوات مثل Doppler وHashiCorp Vault، ولا تكتبها في ملفات الكود. وإذا استخدمت ملف .env محليًا فأضفه فورًا إلى .gitignore قبل أول عملية commit:

Bash:
# .gitignore
.env
.env.*
!.env.example

واحتفظ بملف .env.example يحتوي أسماء المتغيرات بقيم وهمية ليعرف بقية الفريق ما يحتاجون إليه. وفعّل أدوات فحص الأسرار مثل ميزة Secret Scanning وحماية الدفع في GitHub، أو أدوات مثل gitleaks في مسار التكامل المستمر، لتمنع أي مفتاح من الوصول إلى المستودع أصلًا. وتذكر أن حذف المفتاح في commit لاحق لا يكفي، فهو يبقى في تاريخ المستودع.

القاعدة الثالثة: قلّل الضرر المحتمل​

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

القاعدة الرابعة: احمِ خادمك من إساءة الاستخدام​

حتى لو بقيت مفاتيح API آمنة على الخادم، يمكن للمهاجم أن يستنزف رصيدك عبر تطبيقك نفسه، بإرسال آلاف الطلبات إلى الشات بوت المفتوح في موقعك. لذلك أضف حدودًا لعدد الطلبات لكل مستخدم ولكل عنوان IP، واطلب تسجيل الدخول للميزات المكلفة، وحدد طولًا أقصى للمدخلات والمخرجات، وأضف حماية من الروبوتات على النماذج العامة. وهذا مثال بسيط لتحديد المعدل في تطبيق Node.js:

JavaScript:
import rateLimit from "express-rate-limit";

app.use("/api/chat", rateLimit({
  windowMs: 60 * 1000,   // دقيقة واحدة
  max: 10,               // عشرة طلبات كحد أقصى لكل مستخدم
  message: { error: "عدد كبير من الطلبات، حاول بعد قليل" }
}));

إذا تسرب المفتاح: ماذا تفعل فورًا؟​

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

حماية مفاتيح API ليست تعقيدًا إضافيًا في تطوير تطبيقات الذكاء الاصطناعي، بل جزء أساسي من أي تطبيق احترافي. هل تعرضت أنت أو أحد معارفك لتسريب مفتاح؟ وما الدرس الذي خرجت به؟ شاركنا في الردود.
 

رأيك جزء من المعرفة.

أضف تجربتك أو سؤالك، فالنقاش يكمل الفكرة.

عودة
أعلى