انتقل إلى المحتوى

أمان مفاتيح API: أين تحفظها وماذا تفعل إذا انكشفت

كيف تحمي مفاتيح API وحسابك في خبير: أين تحفظ المفتاح، والحدود التي تضعها لكل مفتاح، وما تفعله إذا انكشف مفتاح، وما لن نطلبه منك أبدًا.

آخر تحديث 3 أكتوبر 2026
في هذه الصفحة

مفتاح API يعمل مثل كلمة المرور: من يملكه يستطيع إرسال طلبات تُخصم من رصيدك. احفظه في مكان آمن، وضع لكل مفتاح حدودًا تناسب استخدامه.

احفظ المفتاح في مكان آمن#

  • احفظه في متغير البيئة KHABEER_API_KEY أو في مخزن الأسرار على خادمك، لا داخل الكود نفسه. التفاصيل في احفظ المفتاح في متغير بيئة.
  • لا تضعه في كود يعمل داخل المتصفح أو داخل تطبيق للهاتف، فأي زائر يستطيع قراءته. أرسل الطلبات من الخادم.
  • لا ترفعه إلى مستودع الكود. احفظه في ملف .env وأضف الملف إلى .gitignore.
  • لا تلصقه في لقطة شاشة أو محادثة أو رسالة إلى الدعم.

ضع حدودًا لكل مفتاح#

تحكّم في كل مفتاح: حد للإنفاق، وتاريخ انتهاء، وقائمة عناوين IP المسموح بها.

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

تضبط هذه الحدود عند إنشاء المفتاح أو من إعداداته لاحقًا، كما في تحكّم في كل مفتاح.

إذا انكشف مفتاح#

  1. أوقف المفتاح فورًا#

    افتح صفحة المفاتيح في لوحة التحكم، واختر تدوير المفتاح ليُنشأ مفتاح جديد بدلًا منه ويتوقف الحالي فور نجاح العملية. أو اختر تعطيل المفتاح لتوقفه الآن.

  2. حدّث أدواتك#

    ضع المفتاح الجديد في متغير البيئة وفي كل أداة أو خادم كان يستخدم المفتاح القديم.

  3. راجع الاستخدام#

    راجع استخدام المفتاح وتكلفته في لوحة التحكم. وإذا رأيت استخدامًا لا تعرفه، تواصل معنا واذكر اسم المفتاح، لا المفتاح نفسه.

احمِ حسابك#

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

ما لن نطلبه منك أبدًا#

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