مراجعة الأسرار المحتملة قبل الإيداع
قبل الإيداع أو الدفع قد يعرض GitTree أسرار محتملة في هذا الالتزام أو أسرار محتملة في عملية الدفع. الفحص محلي ومحدود. يمكنك إلغاء تجهيز الملف أو إضافة إلى .gitignore أو الالتزام على أي حال أو الدفع على أي حال. التحذير ليس إثباتًا أن سرًا موجود، والصمت ليس إثباتًا أنه غائب.
يعمل في GitTree المجاني: كل ميزات Git المحلية دون حاجة إلى حساب.
في هذه الصفحة
قبل أن تبدأ
- تحذيرات الأسرار جزء من الخطة المجانية. تكون مفعّلة حين تكون تحذيرات الأسرار المحلية على التحذير قبل المتابعة.
- يقرأ الفحص المحتوى المجهّز للإيداع، ونطاق إيداعات صادرًا مدعومًا للدفع. لا يرسل محتوى الملفات إلى GitTree.
أين تجده
- يُفتح التحذير من صندوق الإيداع عند الإيداع، أو من مسار الدفع عند الدفع.
- التفضيلات، إعداد تحذيرات الأسرار المحلية: التحذير قبل المتابعة أو متوقف.
| الإجراء | macOS | Windows وLinux |
|---|---|---|
| إيداع | ⌘Enter | Ctrl+Enter |
| التفضيلات | ⌘, | Ctrl+, |
الخطوات
أودع أو ادفع كالمعتاد
جهّز الملفات واكتب الرسالة، أو ابدأ الدفع. إن وجد الفحص سرًا محتملًا يوقف GitTree ويفتح الحوار بدل الإتمام. تُحفظ رسالتك وملفات عملك حين يكون الحوار حوار الإيداع. يقول حوار الدفع إن إصلاح سر سبق إيداعه يحتاج إيداعًا جديدًا أو إعادة كتابة.
يُفتح تحذير الإيداع من هذا الصندوق. اللقطة تعرض المحرّر لا حوار التحذير.واجهة GitTree مع مستودع للعرض. اقرأ التحذير
العنوان أسرار محتملة في هذا الالتزام أو أسرار محتملة في عملية الدفع. يسمّي كل صف قاعدة، مثل مفتاح خاص أو مفتاح وصول AWS أو رمز GitHub أو رمز GitLab أو رمز Slack أو مفتاح Stripe فعلي أو مفتاح Google API أو اسم ملف حساس، ورقم سطر إن وُجد. الرموز مقنّعة. يظهر المفتاح الخاص كـ ترويسة مفتاح خاص.
أبقِ السر خارج الإيداع
إلغاء تجهيز الملف يخرجه من الفهرس. إضافة إلى .gitignore تضيف قاعدة تجاهل. يقول الحوار إن قواعد التجاهل لا تزيل المحتوى المجهّز، فألغِ تجهيز الملف أيضًا. للسماح بسطر عن قصد أضف
gittree:allow-secretعلى ذلك السطر. يوقف التحذير عن السطر. لا يشفّر شيئًا.تابع فقط إن قصدت
الالتزام على أي حال أو الدفع على أي حال يتابع. إلغاء يعيدك إلى الصندوق أو الدفع من غير مشاركة. إن لم تُفحص بعض التغييرات يقول الحوار ذلك. عامل ذلك كفحص ناقص لا كنتيجة نظيفة.
النتيجة المتوقعة
إما أن السر لم يعد مجهّزًا، أو أنك اخترت المتابعة بعد قراءة التحذير. راجع فرق الإيداع التالي قبل الدفع. قاعدة في .gitignore لا تعيد كتابة إيداع يحتوي الملف أصلًا.
ما لا يغطيه الفحص
تقول تحذيرات الأسرار المحلية إن الفحص يبقى محليًا ومحدودًا، وإن إيقافه اختيارك على مستوى التطبيق. الفجوات التي قد يبلّغها هي تم بلوغ حد الفحص وتم تجاوز المحتوى الثنائي وتم تجاوز الأسطر الأطول من 4 KiB وتعذر فحص بعض المحتوى. تعذر الفحص الاختياري للأسرار يعني أن تراجع المحتوى بنفسك.
| الفجوة | ماذا تفعل |
|---|---|
| تم تجاوز المحتوى الثنائي | افتح الملف بنفسك. الفحص لا يقرأه. |
| تم تجاوز الأسطر الأطول من 4 KiB | ابحث في ذلك السطر بمحرّر. رمز في سطر مضغوط لا يُفحص. |
| تم بلوغ حد الفحص | أودع مجموعة أصغر من الملفات واقرأ الباقي. |
| الإعداد متوقف | لا شيء يُفحص حتى تختار التحذير قبل المتابعة. |
قواعد التجاهل والملفات المجهّزة
يقول الحوار قواعد التجاهل لا تزيل المحتوى المجهز. ألغِ تجهيز الملف أيضًا. قد يُظهر git check-ignore أن مسارًا يطابق .gitignore بينما git diff --cached ما زال يعرضه في الفهرس. ألغِ تجهيزه ثم أودع. إضافة قاعدة لا تزيل الملف من إيداعات موجودة.
git diff --cached -- path/to/file
git restore --staged -- path/to/file
git check-ignore -v path/to/fileإن كان السر على البعيد أصلًا، فتغيير .gitignore لا يكفي. تحتاج إيداعًا جديدًا يحذفه، وإعادة كتابة للسجل إن وجب ألا تحتويه الإيداعات الأقدم. لا يعد GitTree بمحو سر من كل نسخة. انظر تجاهل الملفات والخطافات إن أردت خطافًا يرفض الإيداع أيضًا.
السماح بسطر عن قصد
أضف gittree:allow-secret إلى السطر لإيقاف التحذير عنه. ضع العلامة على السطر الذي تريد إيداعه، مثل رمز تجريبي ليس اعتمادًا حقيقيًا. العلامة ظاهرة في الملف. لا تستخدمها لإخفاء مفتاح فعّال. الالتزام على أي حال يودع من غير العلامة.
تحذيرات الدفع تراجع الإيداعات التي توشك أن ترسلها. أسرار محتملة في عملية الدفع لا تلغي تجهيز ملف داخل إيداع أصلًا. أصلحه بإيداع جديد، أو أعد كتابة سجل غير منشور، ثم ادفع مجددًا. الدفع القسري مع الاستئجار هو دفع إعادة الكتابة الآمن حين يكون الفرع غير منشور. التعلّم يغطّي الإيداع اليومي قبل أن تحتاج هذا الحوار.
إن لم يسر الأمر كما توقعت
«تتطلب الأسرار المحتملة مراجعتك قبل المتابعة.»
الإيداع أو الدفع ينتظر الحوار. ألغِ التجهيز أو تجاهل أو اسمح بالسطر أو اختر الالتزام على أي حال أو الدفع على أي حال. الإلغاء يبقي الرسالة وملفات العمل لإيداع.
«قواعد التجاهل لا تزيل المحتوى المجهز. ألغِ تجهيز الملف أيضًا.»
إضافة إلى .gitignore تحدّث ملف التجاهل فقط. اضغط إلغاء تجهيز الملف، أو نفّذ git restore --staged، حتى لا يحوي الإيداع التالي المسار.
«لم تُفحص بعض التغييرات.»
توقف الفحص مبكرًا أو تجاوز ملفًا ثنائيًا أو سطرًا أطول من 4 KiB. اقرأ تلك الملفات بنفسك قبل المتابعة.
«تعذر الفحص الاختياري للأسرار. راجع المحتوى بنفسك.»
لم يستطع GitTree تشغيل الفحص. الإيداع غير معتمد نظيفًا. اقرأ الفرق ثم أودع فقط بعد أن تتحقق.
أسئلة
هل يرفع GitTree ملفاتي للبحث عن أسرار؟
لا. يقول الإعداد إن الفحص يبقى محليًا ومحدودًا. الحوار يراجع ما توشك أن تودعه أو تدفعه على هذا الحاسوب.
هل الحوار النظيف إثبات أنه لا يوجد سر؟
لا. يُتجاوز المحتوى الثنائي والأسطر الأطول من 4 KiB، وقد يبلغ الفحص حدًا، والأنماط لا تطابق كل سر. التحذير ليس ضمانًا أيضًا.
هل يزيل .gitignore سرًا جهّزته؟
لا. قواعد التجاهل لا تزيل المحتوى المجهّز. ألغِ تجهيز الملف أيضًا. القاعدة لا تعيد كتابة الإيداعات القديمة.
ماذا يفعل gittree:allow-secret؟
على سطر، يوقف التحذير عن ذلك السطر. السطر ما زال يُودع كنص. استخدمه فقط لقيمة تنوي مشاركتها.
هل أستطيع إيقاف التحذيرات؟
نعم. التفضيلات › تحذيرات الأسرار المحلية › متوقف. هذا اختيار على مستوى التطبيق. لا يعمل الفحص حتى تعيد التحذير قبل المتابعة.