مركز تعلّم الذكاء الاصطناعيEnglish
ترجمة عربية جديدة ✦ نراجعها باستمرار لتحسينها.

الأسرار والمفاتيح ببساطة

⁧المفتاح كلمة مرور لتطبيقك — ملقاة كنص مكشوف⁩⁧كل خدمة خارجية يستخدمها تطبيقك — ذكاء اصطناعي، بريد، مدفوعات — تعطيك مفتاحًا يُثبت أن التطبيق هو أنت⁩⁧ما هو المفتاح فعلًا⁩⁧sk-live-9f2a4bd117c8…c41⁩⁧كل ما يُسمّى مفتاحًا أو رمزًا مميزًا أو سرًّا يعمل هكذا⁩⁧من يملك هذا النص يستطيع فعل كل ما تستطيعه،⁩⁧وعلى حسابك — بلا شاشة دخول، بلا تحقق ثانٍ،⁩⁧بلا بريد تأكيد — الخدمة تفترض أنه أنت⁩⁧ليس في الكود أبدًا⁩⁧الكود يُنسخ، ويُلصق في⁩⁧المحادثات، ويُضغط ويُشارك —⁩⁧والمفتاح ينتقل معه،⁩⁧دون أن يُرى⁩⁧«مؤقتًا فقط» تصبح للأبد⁩⁧ليس في مجلد عام أبدًا⁩⁧مجلدات المشاريع العامة⁩⁧تفحصها برامج آلية على مدار⁩⁧الساعة، بحثًا عن مفاتيح⁩⁧مكشوفة⁩⁧الانكشاف يحدث في دقائق، لا أيام⁩⁧المكان الصحيح⁩⁧صفحة إعدادات منصتك⁩⁧(تُسمّى غالبًا «Secrets»):⁩⁧الصقه مرة واحدة وسيتمكن⁩⁧التطبيق العامل من قراءته⁩⁧لا يُحفظ في أي ملف⁩⁧إذا تسرّب مفتاح — افترض أنه رُئي، حتى لو بدا كل شيء سليمًا⁩⁧ألغِ المفتاح القديم⁩⁧أنشئ مفتاحًا جديدًا⁩⁧ضعه في صفحة الإعدادات⁩⁧راجع الاستخدام والفواتير⁩⁧حذف الملف لا يفيد — النسخ والسجل يبقيان؛ وحده استبدال المفتاح يُنهي الأمر⁩⁧ألغِه بسرعة ولا تخجل — كل مهندس وقع في هذا⁩⁧النسخة السيئة الوحيدة من هذا الخطأ هي البطيئة⁩
⁧المفتاح كلمة مرور تستخدمها البرامج — احفظه في إعدادات منصتك لا في الكود، وألغِه بسرعة إن تسرّب.⁩

ما هو المفتاح فعلًا

حين يستخدم تطبيقك خدمة خارجية — خدمة ذكاء اصطناعي، أو خدمة لإرسال البريد، أو قاعدة بيانات (Database)، أو مزوّد دفع — فإنه يحتاج إلى إثبات أنه أنت. ويفعل ذلك بمفتاح، يُسمّى غالبًا مفتاح API (API key). المفتاح سلسلة طويلة من الحروف والأرقام تعمل تمامًا مثل كلمة المرور، إلا أن البرنامج هو من يستخدمها لا شخص يكتبها. أي شخص يملك هذه السلسلة يستطيع فعل كل ما تستطيع فعله بتلك الخدمة، على حسابك، دون أي تحقّق إضافي. لا عامل ثانٍ للتحقق، ولا شاشة تسجيل دخول، ولا بريد تأكيد. هذا هو المفهوم كله، وهو كافٍ لتفهم لماذا يهمّ باقي هذا الدرس. المفتاح كلمة مرور ملقاة بنص مكشوف، والخدمة تعامله على أنه أنت دون أي شك.

  • المفتاح كلمة مرور يستخدمها برنامج بدل شخص
  • من يملكه يستطيع التصرف باسمك، وعلى حسابك، دون أي تحقّق ثانٍ
  • لا توجد خطوة تحقق إضافية تحميه
  • تعامل مع أي سلسلة تحمل اسم key أو token أو secret كأنها كلمة مرور مكشوفة

أين يجب ألا تكون أبدًا

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

  • لا تكتب مفتاحًا داخل الكود أبدًا — الكود ينتقل والمفتاح ينتقل معه
  • المستودعات العامة تُفحص آليًا وباستمرار
  • استخدم متغيّرات البيئة أو مخزن الأسرار في المنصة بدلًا من ذلك
  • احذر أي اقتراح بلصق مفتاح داخل الكود «مؤقتًا فقط»

إذا تسرّب أحدها

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

  • ألغِ المفتاح واستبدله فورًا — افترض أن أحدًا رآه
  • حذف الملف لا يفيد؛ السجل وأي نسخ أخرى تبقى
  • راجع الاستخدام والفواتير في تلك الخدمة بحثًا عن نشاط غريب
  • الجميع يقع في هذا يومًا ما؛ الاستجابة البطيئة وحدها هي ما يجعله مكلفًا