Bologu

تسرّب مفتاح API في موقعك: كيف تتحقق وماذا تفعل فورًا

تاريخ التحديث · فريق Bologu

اطلب من الذكاء الاصطناعي «اربط OpenAI» وستحصل غالبًا على كود يستدعي OpenAI مباشرة من صفحة الويب والمفتاح مكتوب فيه. يعمل التطبيق فورًا، لكن كل من يفتح الموقع يحصل على مفتاحك أيضًا. روبوتات البحث عن المفاتيح تعمل على مدار الساعة، والمفاتيح المسرّبة كثيرًا ما تتسبب في فواتير ضخمة خلال أيام.

كيف تصل المفاتيح إلى صفحة الويب

  • متغيرات ذات بادئة عامة: ‏NEXT_PUBLIC_, VITE_, REACT_APP_, EXPO_PUBLIC_ تُضمَّن في ملفات JavaScript المرسلة إلى كل متصفح. ما إن تسمّي متغيرًا هكذا حتى يستطيع أي أحد رؤية قيمته.
  • مفاتيح مكتوبة مباشرة في الكود: يضعها الذكاء الاصطناعي «مؤقتًا» ثم لا يزيلها أحد.
  • ملفات source map متروكة: ملفات .map تكشف الكود المصدري الأصلي بما فيه التعليقات والقيم التي لا ينبغي أن يراها أحد.
  • ملفات .env مرفوعة إلى GitHub: خاصة في المستودعات العامة.

أي المفاتيح يجوز وجودها في الصفحة وأيها لا

ليس كل مفتاح تراه في الصفحة مشكلة، فبعضها مصمم ليكون علنيًا:

  • لا بأس بها في الصفحة: مفتاح Stripe القابل للنشر (pk_live_…)، ومفتاح Supabase القابل للنشر / anon (بشرط ضبط RLS بشكل صحيح)، وإعدادات Firebase للويب، ومفتاح Google Maps المقيّد بنطاقك.
  • ممنوعة في الصفحة تمامًا: مفتاح Stripe السري (sk_live_…)، وOpenAI (sk-…)، وAnthropic، ومفتاح Supabase السري / service_role، ورموز GitHub، ومفاتيح خدمات الرسائل النصية أو البريد، وكلمات مرور قواعد البيانات.

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

افحص بنفسك هل تسرّب مفتاح

  1. افتح موقعك في Chrome، واضغط F12 وانتقل إلى تبويب Sources.
  2. اضغط Ctrl+Shift+F (في Mac: Cmd+Option+F) للبحث في كل الملفات، وجرّب كلًا من: sk- وsk_live وservice_role وsecret وapi_key.
  3. تحقق هل يمكن تحميل ملفات تنتهي بـ .map، فإن أمكن فعطّل source map في بيئة الإنتاج.
  4. في GitHub ابحث في المستودع عن الكلمات نفسها وتأكد من عدم وجود ملف .env فيه.

إن تسرّب مفتاح فاتبع هذا الترتيب

  1. ألغِ المفتاح أو غيّره لدى مزوّد الخدمة أولًا: افتح صفحة API keys لدى المزوّد واضغط Revoke أو Roll. حذف المفتاح من الكود وحده لا يفيد، فمن حصل عليه ما زال يستطيع استخدامه.
  2. راجع الاستخدام السابق: افتح صفحة Usage أو Billing وابحث عن استخدام ليس لك، وإن وجدته فتواصل مع المزوّد فورًا.
  3. ضع حدًا للإنفاق: حدّد سقفًا شهريًا وتنبيهات بالبريد في صفحة Billing.
  4. انقل الاستدعاء إلى الخادم: اجعل الصفحة تستدعي واجهة API الخاصة بك (مثل /api/chat)، ودع الخادم يستدعي OpenAI بمفتاح محفوظ في متغير بيئة دون بادئة عامة.
  5. قيّد الاستخدام على الخادم: اشترط تسجيل الدخول، وحدّد عدد الطلبات لكل مستخدم، واضبط max_tokens، وإلا ظل الآخرون يستخدمون واجهتك للحصول على ذكاء اصطناعي مجاني.
  6. نظّف سجل git إن كان المفتاح قد رُفع: استخدم git filter-repo أو BFG، لكن اعتبر المفتاح مسرّبًا حتى بعد التنظيف، ولهذا كانت الخطوة الأولى هي الأهم.

موجّه للذكاء الاصطناعي

My frontend calls the OpenAI API directly with the key in browser code.
1. Move every AI call to a server route (e.g. /api/chat) that reads the key from a
   server-only environment variable (no NEXT_PUBLIC_ / VITE_ prefix).
2. In that route: require login, rate-limit per user, cap input length and set max_tokens.
3. Remove the key from all client code and .env files that are bundled for the browser.
Do not print or log the key anywhere.

دع Bologu يفحص لك

يبحث فحص الموقع (مجانًا) عن مفاتيح أكثر من 20 خدمة شائعة في كل ملفات JavaScript وsource map التي تحمّلها صفحاتك، ويخبرك بأي المفاتيح يمكن كشفها وأيها يجب استبداله فورًا. أما فحص كود GitHub فيجد المفاتيح المرفوعة إلى المستودع وملفات .env التي لا ينبغي وجودها فيه.