مطورالأمانكلمات المرور

كيف يسرّب المطورون الأسرار في CI/CD وGitHub

وكيفية التوقف عن

تم التحديث 17 يوليو 2026قراءة 7 دقائقPrivateNote.ai

توقف عن إرسال ملفات .env، ولصق الرموز (tokens) في طلبات السحب (pull requests)، وتكرار الأسرار في سجلات CI. تعلم أين تتسرب بيانات الاعتماد في GitHub وخطوط الأنابيب (pipelines)—وكيف تساهم الروابط المشفرة لمرة واحدة في سير عمل أكثر أماناً للمطورين.

جهاز كمبيوتر محمول للمطور على مكتب في الليل يظهر واجهة سطر أوامر وملفات تكوين تحت ضوء مكتب أزرق بارد
تبدأ معظم تسريبات الأسرار من باب الراحة: ملف .env تم إرساله، أو متغير CI تم لصقه، أو مفتاح لم يغادر تاريخ Git أبدًا.

أهم النقاط

  • Never commit `.env` files or cloud keys to Git.
  • Assume leaked history is public until rotated and purged carefully.
  • Use the platform secret store for CI/CD—not chat pastebins.
  • Scan early and rotate immediately when a leak is found.

مفاتيح API لا تتسرب عادةً من خلال هجمات التشفير الذكية. بل تتسرب من خلال سير عمل المطورين—ملفات `.env` التي يتم فحصها في Git، والأسرار التي تظهر في سجلات CI، وبيانات الاعتماد التي يتم لصقها في طلبات السحب "لمجرد الآن".

إذا كنت تعرف بالفعل كيفية مشاركة مفتاح API بشكل آمن، فإن هذا الدليل هو الطبقة التالية: أين تهرب تلك المفاتيح فعليًا في عمليات تسليم البرمجيات الحديثة، وكيف تمنع GitHub وCI/CD والتكوينات المحلية من أن تصبح أرشيفًا دائمًا لوصولك إلى بيئة الإنتاج.

النمط هو نفسه في كل مرة. يدخل سر في نظام مصمم للاحتفاظ بالتاريخ. وبعد أشهر، يؤدي فرع (fork)، أو تصدير سجل، أو جهاز كمبيوتر مخترق، أو فحص مستودع عام إلى تحويل تلك الراحة إلى حادث أمني.

لماذا تعد ملفات .env وCI/CD مغناطيسًا لتسريب بيانات المطورين

توجد ملفات البيئة المحلية وخطوط الأنابيب (pipelines) لنقل التكوينات بسرعة. هذه السرعة مفيدة—وخطيرة—لأن الأسرار غالبًا ما تنتقل مع نفس الأدوات التي تستخدمها لمراجعة الكود، ومخرجات البناء، والأتمتة.

ملف `.env` يبدو مؤقتًا. السر المخزن في CI يبدو "مُعالجًا". ملف `echo $DATABASE_URL` للتصحيح يبدو غير ضار في مستودع خاص. لكن المهاجمين—وفاحصي الأسرار الآليين—لا يهتمون بما إذا كان الكشف متعمدًا. هم يهتمون بالديمومة، وقابلية البحث، ونطاق الضرر.

عامل كل سر يلمس Git أو CI كما لو أنه سيتم نسخه أو محاكاته أو فهرسته في النهاية. صمم سير العمل بحيث يكون هذا الافتراض قابلاً للتعامل معه: بيانات اعتماد قصيرة العمر، ومخازن أسرار مناسبة، وعمليات تسليم بشرية لا تترك نصًا صريحًا في الدردشة أو التذاكر.

كيف تهرب الأسرار عبر GitHub

ملفات .env وملفات التكوين التي تم إرسالها (committed)

لا يزال التسريب الكلاسيكي هو الأكثر شيوعاً: `cp .env.example .env`، ملء قيم الإنتاج، ثم `git add .` دون ملاحظة ذلك. حتى لو حذفت الملف في الالتزام (commit) التالي، يظل السر في سجل Git حتى تعيد كتابته—وقد يتم فحص المستودعات العامة بحثاً عن بيانات الاعتماد المكشوفة بسرعة كبيرة. كما أن إعادة كتابة السجل لا تمحو كل نسخة: فالتفرعات (forks)، والمرايا (mirrors)، وذاكرة التخزين المؤقت لـ CI، والنسخ المحلية (clones) لا تزال قادرة على الاحتفاظ بالالتزامات القديمة.

تشمل المتغيرات `docker-compose.yml` مع كلمات مرور مكتوبة برمجياً، وحالة Terraform مع مخرجات حساسة، وملفات Kubernetes manifests التي تخزن "أسراراً" مشفرة بـ base64 (علماً أن base64 هو ترميز وليس تشفيراً—أي شخص يمكنه قراءة الملف يمكنه فك تشفير القيمة)، وخلايا دفتر الملاحظات (notebook cells) التي تطبع الرموز (tokens). إذا بدا الشيء كأنه إعدادات تكوين، فافترض أن الماسحات الضوئية ستعامله ككشف لبيانات الاعتماد.

طلبات السحب (Pull requests)، والمشكلات (issues)، والتعليقات

يقوم المطورون بلصق مفاتيح بيئة الاختبار (staging keys) في أوصاف طلبات السحب (PR) لـ "مساعدة المراجع على إعادة إنتاج الخطأ". ترث تعليقات التذاكر و GitHub Discussions نفس المشكلة: الديمومة القابلة للبحث، والإشعارات، وملخصات البريد الإلكتروني، وعمليات التصدير.

تقلل المستودعات الخاصة بشكل كبير من التعرض العرضي، لكنها لا تزال ليست مخزناً مناسباً للأسرار. يمكن لتغيرات الوصول، والمقاولين، والحسابات المخترقة، والنسخ المحلية، والنسخ الاحتياطية، والتكاملات أن تعيد ظهور النصوص الصريحة التاريخية. لتسليم مفاتيح API بين البشر، استخدم رابطاً لمرة واحدة مشفراً من جانب العميل—وليس تعليقاً في طلب سحب (PR).

التفرعات، والمرايا، والسجل الذي لا يموت أبداً

المفتاح الذي يتم الالتزام به مرة واحدة يمكن أن ينجو في التفرعات، والمرايا، وذاكرة التخزين المؤقت لـ CI، والنسخ المحلية لفترة طويلة بعد تنظيف الفرع الرئيسي. تدوير الأسرار (Secret rotation) هو العلاج الحقيقي؛ أما إعادة كتابة السجل فهي مجرد وسيلة للحد من الأضرار.

إذا تم تفعيل تنبيه من GitHub Secret Scanning، أو TruffleHog، أو gitleaks، أو مزود سحابي، فقم بالتدوير أولاً. ثم قم بإزالة السر من الفروع النشطة. عندها فقط قرر ما إذا كانت إعادة كتابة السجل تستحق تكلفة التنسيق.

قاعدة صارمة

لا تقم أبداً بالالتزام بأسرار حية في Git—حتى بيانات اعتماد بيئة الاختبار المؤقتة. إذا كان لا بد من نقل سر بين الأشخاص، فاستخدم قناة تسليم آمنة مناسبة، مثل رابط لمرة واحدة مشفر من جانب العميل. إذا كانت الأتمتة بحاجة إلى السر، فاستخدم آلية الأسرار الأصلية لمنصة CI، أو مدير أسرار مخصص، أو الأفضل من ذلك، بيانات اعتماد قصيرة العمر يتم الحصول عليها من خلال workload identity أو OIDC—وليس المستودع.

كيف تتسرب الأسرار عبر CI/CD

النصوص الصريحة في ملفات سير العمل (workflow files)

وضع `API_KEY: sk-...` مباشرة في `.github/workflows/*.yml`، أو GitLab CI YAML، أو إعدادات CircleCI هو مجرد التزام بسر بخطوات إضافية. ملفات سير العمل هي كود برمجي؛ يتم مراجعتها، ونسخها، والاحتفاظ بها للأبد.

استخدم آلية الأسرار الأصلية للمنصة (GitHub Actions secrets، ومتغيرات GitLab CI/CD، وما يعادلها) وقم بالإشارة إليها كروابط بيئية (environment bindings)—وليس كـ YAML مكتوب برمجياً. أسرار CI الأصلية أفضل بكثير من المستودع، لكنها ليست سحرية: فمنطق سير العمل الخبيث، والتبعية المخترقة، والتسجيل غير الحذر يمكن أن تظل تكشف القيم أثناء التشغيل. فضل استخدام OIDC أو غيرها من اتحادات هوية أعباء العمل (workload identity federation) مع مزودي السحابة حتى لا تحتاج إلى مفاتيح سحابية طويلة العمر في CI على الإطلاق.

سجلات خط الأنابيب (Pipeline logs) ومخرجات التصحيح

سجلات البناء هي أرشيف يُستهان به. إن طباعة متغيرات البيئة "لتصحيح عملية النشر"، أو تفريغ `process.env`، أو تشغيل مخرجات Terraform/Helm مفصلة يمكن أن يكتب بيانات الاعتماد في تخزين السجلات التي تعيش لفترة أطول من المهمة نفسها.

افترض أن السجلات قابلة للقراءة من قبل أي شخص لديه صلاحية الوصول إلى CI—وأحياناً من قبل أي شخص يمكنه تنزيل الملحقات (artifacts). قم بحجب الأسرار (mask secrets)، وتجنب تفريغ البيئة، وعامل سطر السجل المسرب كأنه كلمة مرور مسربة: قم بتدويرها.

طلبات السحب من التفرعات (Forks)

طلبات السحب من التفرعات هي فخ كلاسيكي لـ CI: كود غير موثوق يعمل مع أسرار. تفرض معظم المنصات قيوداً على توفر الأسرار في سير عمل التفرعات لهذا السبب تحديداً. حافظ على هذا الوضع. لا تقم أبداً بـ "تمكين الأسرار فقط" للمساهمين الخارجيين لجعل علامة التحقق خضراء.

بالنسبة للمستودعات الداخلية، افصل دائماً مهام النشر ذات الامتيازات عن فحوصات طلبات السحب (PR checks). قم بالبناء والاختبار بأقل امتيازات ممكنة؛ وانشر فقط من الفروع الموثوقة مع منح أسرار بشكل صريح.

المشغلات المشتركة وتسريب الملحقات (Artifact leakage)

يمكن للمشغلات المستضافة ذاتياً (Self-hosted runners)، وذاكرة التخزين المؤقت المشتركة، والملحقات المرفوعة أن تحتفظ بالرموز لفترة أطول من المهمة التي أنشأتها. قم بتنظيف مساحات العمل، وحدد نطاق مفاتيح التخزين المؤقت بعناية، ولا تقم أبداً بتعبئة ملفات `.env` في ملحقات البناء "من أجل الراحة".

نموذج ذهني أكثر أماناً: ثلاثة أماكن يمكن أن تعيش فيها الأسرار

يحدث الارتباك عندما تستخدم الفرق أداة واحدة لكل مهمة. قم بتقسيم المشكلة حسب دورة الحياة.

المكانالأنسب لـليس لـ
ملف .env المحلي / dotenvإعدادات التطوير المحلي التي تبقى على الكمبيوتر المحمول ويتم تجاهلها بشكل صحيح عبر gitignoreمشاركة الأسرار مع أعضاء الفريق، أو CI، أو Git، أو أسرار الإنتاج طويلة الأمد كنص مجرد
أسرار CI الأصلية / Vault / مدير أسرار السحابةأتمتة النشر والتشغيل من آلة إلى آلةتسليم المهام عبر الدردشة البشرية أو رسائل "مرر هذا للمقاول" طويلة الأمد
ملاحظة لمرة واحدة مشفرة من جانب العميلالتسليم من إنسان إلى إنسان لمفتاح، أو رمز (token)، أو مقتطف .envتخزين أسرار الإنتاج للتطبيقات أو مسارات العمل (pipelines)

يعد استخدام `.env` متجاهل في git fine للتطوير المحلي. ومن الناحية المثالية، لا ينبغي لأسرار الإنتاج الحساسة أن تظل لفترة طويلة كنص مجرد على أجهزة المطورين أيضًا—يفضل استخدام مدير كلمات المرور أو الوصول قصير الأمد حيثما كان ذلك عمليًا. يقع PrivateNote في الصف الثالث: التسليم الآمن بين الأشخاص. وهو ليس بديلًا لـ GitHub Actions secrets، أو HashiCorp Vault، أو AWS Secrets Manager، أو مدير كلمات المرور الخاص بك. لعمليات تسليم API-key اليومية، استخدم هذا مع كيفية مشاركة مفتاح API بشكل آمن.

سير عمل عملي: إبقاء الأسرار بعيدًا عن Git والدردشة

عندما يحتاج زميل أو مقاول أو عميل إلى قيمة ستستقر في النهاية في CI أو `.env` محلي، استخدم هذا التسلسل:

  1. 1

    الخطوة 1

    إنشاء اعتماد (credential) محدد النطاق وقصير الأمد

    يفضل استخدام مفاتيح بيئة الاختبار (staging keys)، ونطاقات القراءة فقط، والقوائم البيضاء لعناوين IP، وتاريخ انتهاء الصلاحية. تجنب منح مفتاح الإنتاج الأساسي "لأنه أسرع".

  2. 2

    الخطوة 2

    التسليم عبر ملاحظة لمرة واحدة مشفرة من جانب العميل

    قم بتشفير السر (أو أسطر `.env` القليلة المطلوبة) محليًا باستخدام PrivateNote—عبر تطبيق الويب، أو CLI، أو إضافة VS Code / Cursor، أو إضافة Chrome. حدد تاريخ انتهاء صلاحية قصير أو خاصية الحرق بعد القراءة، ثم أرسل رابط الملاحظة—وليس النص المجرد—عبر Slack، أو البريد الإلكتروني، أو تذكرة الدعم (ticket).

  3. 3

    الخطوة 3

    التثبيت في المخزن الصحيح

    يقوم المستلم بنسخ القيمة إلى `.env` محلي متجاهل في git (للتطوير)، أو مدير كلمات المرور، أو مخزن أسرار CI/السحابة. لا تقم بلصقها مرة أخرى في طلب السحب (PR)، أو سلسلة الدردشة، أو مستند مشترك.

  4. 4

    الخطوة 4

    التدوير عند انتهاء المهمة

    قم بإلغاء مفاتيح المقاولين، وقم بتدوير المفاتيح بعد الحوادث، واستبدل أي اعتماد ظهر في السجلات (logs)، أو Git، أو تذكرة دعم. الراحة دون تدوير هي مجرد استجابة متأخرة للاختراق.

هل تحتاج إلى تسليم رمز CI أو بضعة أسطر من .env لشخص ما الآن؟ أرسل ملاحظة لمرة واحدة مشفرة من جانب العميل بدلاً من إرسال أو لصق نص مجرد.

إنشاء ملاحظة خاصة

شارك من المكان الذي تعمل فيه بالفعل

لا تحتاج إلى مغادرة الطرفية (terminal)، أو المحرر، أو علامة تبويب المتصفح لإنشاء ملاحظة لمرة واحدة مشفرة من جانب العميل. اختر واجهة PrivateNote التي تناسب اللحظة—يحدث التشفير دائمًا محليًا على جهازك قبل الرفع. لمراجعة كاملة، راجع PrivateNote للمطورين.

CLI

القراءة من ملف أو عبر pipe لـ stdin بحيث لا يستقر السر أبدًا في سجل الأوامر (shell history) كمعامل `echo`: `npx privatenote-cli --expire 1h --output-url-only .env.local` أو `cat secret.txt | npx privatenote-cli --expire 1h --output-url-only`. مفيد في سير عمل shell، والسكربتات، وعمليات التسليم السريعة عبر الطرفية. الإعداد والأعلام: PrivateNote CLI.

VS Code و Cursor

قم بتثبيت إضافة VS Code / Cursor، ثم قم بالتشفير من الشريط الجانبي، أو تحديد المحرر، أو قائمة السياق—مثالي عندما يكون السر موجودًا بالفعل على الشاشة في `.env` أو ملف تكوين ولا ينبغي أبدًا أن يصل إلى Slack كنص مجرد.

إضافة Chrome

عندما يظهر الاعتماد في البريد الإلكتروني، أو المستندات، أو تذكرة الدعم، تقوم إضافة Chrome بتحويل النص المحدد إلى ملاحظة لمرة واحدة مشفرة في المتصفح دون مغادرة علامة التبويب.

قائمة مراجعة المطور قبل كل عملية دفع (push) وتغيير في مسار العمل (pipeline)

نقطة تفتيشما يجب التحقق منه
قبل git commit`.env`, `*.pem`, `credentials.json`, والملفات السرية المحلية مستبعدة عبر gitignored؛ `git status` لا يظهر أي إضافات مفاجئة
قبل فتح PRلا توجد مفاتيح في الوصف، أو لقطات الشاشة، أو ملفات التثبيت (fixtures)، أو ملفات تصحيح الأخطاء "المؤقتة"
قبل تعديل سير العمل (workflows)تأتي الأسرار من آلية الأسرار الأصلية للمنصة أو عبر OIDC/workload identity—وليس عبر كتابتها مباشرة في ملفات YAML
قبل تصحيح أخطاء CIلا توجد `env`، أو `printenv`، أو عمليات تفريغ بيانات (dumps) مطولة قد تكتب الأسرار في السجلات (logs)
بعد أي تسريبقم بتدوير المفاتيح أولاً، ثم قم بتنظيف السجل/الفروع؛ تعامل مع أدوات الفحص كمحفزات للحوادث
أضف فحص الأسرار إلى المسار الافتراضي: خطافات pre-commit (gitleaks)، وفحص CI، و GitHub Secret Scanning / حماية الدفع (push protection). الوقاية تتفوق على محاولات إعادة كتابة السجل البطولية.

ماذا تفعل إذا كان السر موجوداً بالفعل في GitHub

اتبع هذا الترتيب: قم بتدوير أو إلغاء صلاحية الاعتماد لدى المزود، أبطل الجلسات أو الـ webhooks المرتبطة، احذف السر من الفرع الافتراضي، ثم قرر ما إذا كانت إعادة كتابة السجل مطلوبة للامتثال أو بسبب التسريب العلني. حتى بعد إعادة الكتابة، افترض أن النسخ المتفرعة (forks)، والمرايا (mirrors)، والذاكرة المؤقتة (caches)، والنسخ المستنسخة (clones) قد لا تزال تحتفظ بنسخ حتى يتم التعامل معها بشكل منفصل.

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

بالنسبة للأسرار ذات القيمة العالية للغاية مثل عبارات استرداد العملات الرقمية (seed phrases)، تجنب نقلها قدر الإمكان. بالنسبة لاعتمادات الجذر الأخرى التي لا يمكن تعويضها، لا تكتبها في أي موقع إلكتروني على الإطلاق—قم بتشفيرها محلياً أولاً وشارك النص المشفر فقط عند الضرورة. هذا النموذج مغطى في دليل عبارات استرداد العملات الرقمية الخاص بنا.

أسئلة شائعة

هل مستودع GitHub الخاص آمن بما يكفي لملفات .env؟

لا. المستودع الخاص يحد من التعرض بشكل كبير، لكنه لا يزال ليس مخزناً مناسباً للأسرار. تغييرات الوصول، والحسابات المخترقة، والنسخ المستنسخة، والنسخ الاحتياطية، وتكاملات الطرف الثالث يمكن أن تعيد ظهور النصوص الصريحة التاريخية. أبقِ الأسرار بعيدة عن Git تماماً.

هل أسرار GitHub Actions كافية؟

إنها المكان الصحيح للعديد من قيم وقت تشغيل CI—وهي أفضل بكثير من ملفات YAML أو ملفات المستودع. ومع ذلك، فهي لا تحل مشكلات التسليم البشري، أو تسريب السجلات، أو الأذونات الواسعة للغاية، أو مخاطر الـ fork-PR، أو التعرض من خلال خطوات سير العمل الخبيثة والاعتمادات المخترقة. ادمج آلية الأسرار الأصلية للمنصة مع مبدأ الحد الأدنى من الصلاحيات، والتسجيل الدقيق، ويفضل استخدام اعتمادات قصيرة العمر عبر OIDC أو workload identity.

هل يجب أن أقوم بعمل commit لملف .env.example محذوف البيانات (redacted)؟

نعم. قم بعمل commit لأسماء المتغيرات والنائبات الوهمية (dummy placeholders) فقط. لا تقم أبداً بعمل commit لقيم حقيقية، أو مفاتيح بيئة تجريبية "شبه حقيقية"، أو سلاسل اتصال الإنتاج مع إزالة كلمة المرور مع بقاء المضيف واسم المستخدم إذا كان هذا المزيج حساساً في نموذج التهديد الخاص بك.

هل ملف .env المحلي مقبول؟

للتطوير المحلي، نعم—عندما يتم استبعاده بشكل صحيح عبر gitignored ولا يتم عمل commit له أبداً. من الناحية المثالية، لا ينبغي لأسرار الإنتاج الحساسة أن تبقى إلى أجل غير مسمى كنصوص صريحة في ملفات `.env` على أجهزة المطورين؛ استخدم مدير كلمات مرور، أو وصولاً قصير العمر، أو مدير أسرار حيثما كان ذلك ممكناً.

هل يمكن لـ PrivateNote استبدال Vault أو أسرار GitHub؟

لا. PrivateNote مخصص للتسليم الآمن من إنسان إلى إنسان. استخدم آلية الأسرار الأصلية لمنصة CI ومديري الأسرار المخصصين للأتمتة. استخدم PrivateNote عندما يحتاج شخص ما إلى استلام مفتاح، أو رمز (token)، أو مقتطف .env دون ترك نص صريح في Slack، أو البريد الإلكتروني، أو GitHub.

ما هي أسرع طريقة آمنة لتسليم رمز CI token؟

أنشئ رمزاً بنطاق ضيق، وقم بتسليمه عبر ملاحظة لمرة واحدة مشفرة من جانب العميل (عبر الويب، CLI, VS Code, أو Chrome)، واطلب من المستلم تخزينه في مخزن أسرار CI أو مدير كلمات مرور، ثم قم بإلغاء الرمز عند انتهاء العمل.

خواطر ختامية

GitHub و CI/CD ممتازون في حفظ العمل. وهذا هو بالضبط السبب في أنها أماكن سيئة لحفظ الأسرار.

حافظ على ملفات `.env` محلية، ومستبعدة من git، ومقتصرة على بيئة التطوير قدر الإمكان. ضع بيانات اعتماد الأتمتة في أسرار CI الأصلية، أو مدير أسرار، أو بيانات اعتماد OIDC قصيرة العمر. عندما يحتاج شخص ما إلى قيمة، استخدم ملاحظة لمرة واحدة مشفرة من جانب العميل—ثم قم بتدويرها.

إذا كان فريقك لا يزال يلصق المفاتيح في طلبات السحب (PRs) أو يرسل بيانات اعتماد "بيئة الاختبار فقط"، فابدأ بـ سير عمل مشاركة مفاتيح API وقائمة التحقق أعلاه. للوصول إلى الخادم، استخدم كيفية مشاركة مفاتيح SSH بأمان. قم بدمج CLI، أو إضافة VS Code، أو إضافة Chrome في مسار العمل الأسهل ليكون الخيار الآمن هو الخيار الأسرع أيضًا.

شارك السر—لا نسخة دائمة

قم بتشفير رمز CI أو مقتطف .env محليًا باستخدام PrivateNote—باستخدام تطبيق الويب، أو CLI، أو VS Code / Cursor، أو إضافة Chrome—قبل وصوله إلى الدردشة أو Git. استخدم مدة انتهاء قصيرة أو خاصية

إنشاء ملاحظة خاصة
الصورة: Léna Le Roy · Unsplash.