
ماسح أسرار دون اتصال يجمع بين قواعد regex والتحليل الدلالي القائم على lexer ومطابقة القيم المجزأة (hashed) لاكتشاف بيانات الاعتماد المكشوفة في الشيفرة مع إخراج SARIF.
على الإطلاق!
في عصر الضجة الكبيرة حول النماذج اللغوية الضخمة (LLM)، لا تزال DeepSecrets تعمل بالكامل على جهازك — لتمنحك نتائج ممتازة دون اتصال بالإنترنت، وبأمان، ومجانًا.
معظم أدوات الفحص الموجودة لا "تفهم" الشيفرة فعليًا. بل تقتصر على تحليل النصوص وتعاني من تغطية ضعيفة.
تسدّ DeepSecrets الفجوة بين أدوات الفحص الكلاسيكية القائمة على التعبيرات النمطية (regex) وأدوات SAST التجارية المتكاملة. فهي توسّع استراتيجية الفحص الكلاسيكية القائمة على التعبيرات النمطية بالاعتماد بشكل كبير على التحليل الدلالي للشيفرة، واكتشاف المتغيرات الخطرة، وتحليل الإنتروبيا المدرك للسياق. تأتي المرشّحات للأسرار مما تقوله الشيفرة، وأسمائها، وإسناداتها واستدعاءاتها، وليس من النص وحده. تقرأ DeepSecrets الشيفرة باستخدام محلّلات معجمية (lexers) لنحو 600 لغة وصيغة (Pygments)، وتجد المتغيرات بقواعد كشف لـ 14 لغة وقاعدة عامة لما تبقى.
تقدم DeepSecrets أيضًا طريقة جديدة لاكتشاف بيانات الاعتماد دون أي معرفة مسبقة: محرك HashedSecret. ما عليك سوى تقديم القيم المُجزّأة (hashed) لأسرارك الإنتاجية المعروفة، وستجدها الأداة مكشوفة كنص صريح داخل شيفرتك.
تم تقييم DeepSecrets 2.3 (نوفمبر 2026) على معيار SecretBench: كل ملف تم فحصه، وكل صف مُصنّف تم احتسابه.
عند الاحتساب بالطريقة التي اعتمدها تقييم يونيو 2026، على مجموعة صفوفه الخاصة، يحقق الإصدار 2.3 استدعاءً بنسبة 94% ودقة بنسبة 85% (الإصدار 2.0 في يونيو 2026: 93% و67%).
تأتي هذه الأرقام من dsbench، وهو إطار عمل مفتوح المصدر للمعايير المرجعية يشغّل أداة فحص كصندوق أسود على مجموعة بيانات مُصنّفة ويحتسب ما تُبلغ عنه. باستخدام SecretBench (المتاح من مؤلفيه عند الطلب) وdsbench، يمكن لأي شخص إعادة إنتاج الأرقام لكل صف المذكورة أعلاه والمقارنة أدناه:
dsbench prepare # load SecretBench's labels and the corpus listing
dsbench run --tool-ref v2.3.0 # DeepSecrets 2.3.0 from its tag, in a venv from its own poetry.lock
dsbench tools fetch # the pinned gitleaks and Betterleaks releases, checked by SHA-256
dsbench run --tool gitleaks
dsbench run --tool betterleaks
dsbench compare RUN RUN ... # side by side, with 95% intervals
كل تشغيل يفحص كل ملف، مع تعطيل استثناءات المسارات الخاصة بكل أداة. تحتاج أرقام طريقة يونيو أيضًا إلى جدول الصفوف الخاص بتقييم يونيو 2026، كما يحتاج عدد الأسرار التي تتجاوز التسميات إلى أحكامنا المُقيَّمة؛ وكلاهما غير منشور، لأن كليهما يشير إلى بيانات اعتماد مسربة.
(يمكنك قراءة القصة الكاملة وراء الكواليس وتفصيل المعايير في مقالي على HackerNoon هنا)
من Github عبر pip
$ pip install git+https://github.com/ntoskernel/deepsecrets.git
من PyPi
$ pip install deepsecrets
يحتاج DeepSecrets إلى Python 3.11 أو أحدث.
أسهل طريقة لتشغيل فحص:
$ deepsecrets --target-dir /path/to/your/code --outformat dojo-sarif --outfile report.json
سيؤدي هذا إلى تشغيل فحص على /path/to/your/code باستخدام التكوين الافتراضي:
سيتم حفظ تقرير بصيغة SARIF (متوافق مع DefectDojo وGitHub Security) في report.json.
الأمر --help جاهز دائمًا لإرشادك، لكن إليك أهم الخيارات التي يمكنك استخدامها لتخصيص الفحص وفقًا لبيئتك:
--regex-rules /path/to/rules.json: قدّم مجموعة قواعد regex مخصصة خاصة بك.--hashed-values /path/to/hashes.json: قدّم قائمة بالأسرار الإنتاجية المعروفة والمُجزّأة مسبقًا للبحث عنها بأمان.--excluded-paths /path/to/exclusions.json: تجاوز المسارات الافتراضية التي يتم تجاهلها أثناء الفحص أو توسيعها.--deep-max-size BYTES: الملفات الأكبر من هذا الحجم (الافتراضي 250,000 بايت) تحصل على التحليل السريع: قواعد regex والبحث عن المتغيرات، دون محلل اللغة المعجمي. الملفات الكبيرة تكون في الغالب مولّدة أو مصغّرة، ويكلّف المحلل المعجمي معظم وقت الفحص عليها ونادرًا ما يجد فيها المزيد. القيمة 0 تمنح كل ملف التحليل الكامل.--skip-bundles: تخطَّ ملفات JavaScript المصغّرة وخرائط المصدر والحزم (*.min.js، *.map، *.bundle.js) بالكامل، إضافةً إلى استثناءات المسارات الأخرى.--confidence-level {all,low,medium,high,very-high}: أدنى مستوى ثقة يتم الإبلاغ عنه (الافتراضي low، أي كل النتائج). تحتفظ medium وhigh وvery-high بمستويات الثقة 5 و6 و9 أو أكثر، أي نتائج مستويات SARIF التي تحمل الأسماء نفسها وما فوقها؛ كما تُبلغ all عن مطابقات regex التي رأى الماسح أنها ليست أسرارًا (عناصر نائبة، أمثلة)، بمعرّف قاعدة -INFO.--min-confidence N: الإبلاغ عن النتائج ذات مستوى الثقة N أو أكثر، حيث N من 0 إلى 10: أي حد قطع، بينما توفّر --confidence-level الحدود الدنيا للمستويات. مثل كل مستوى عدا all، فإنه يستبعد مطابقات regex التي حُكم عليها بأنها ليست أسرارًا. استخدم أحد الخيارين أو الآخر، وليس كليهما.--exclude-tags TAG [TAG ...]: استبعد النتائج التي تحمل أيًا من هذه الوسوم. يوضّح الوسم نوع السر الذي تمثله النتيجة، بينما يوضّح مستوى ثقتها مدى احتمال كونها سرًا: weak-password (قيمة ضعيفة تحت اسم يشبه كلمة المرور)، publishable (مفتاح مصمم للتسليم إلى العملاء: مفاتيح reCAPTCHA ومفاتيح المواقع الأخرى، ومفاتيح Stripe pk_، ورموز Mapbox pk.، ومفاتيح المشغّلات والتحليلات والخرائط)، test-context (مسار اختبار أو spec أو fixture أو mock أو مثال أو عينة، نسبةً إلى الدليل الهدف)، recorded-traffic (أشرطة VCR وتسجيلات الجلسات وملفات HAR)، identifier (معرّف AWS لمستخدم أو دور أو سياسة، لا يمنح أي شيء) وweb-page (صفحة HTML). لا يزال يتم الإبلاغ عن كل نتيجة افتراضيًا؛ على سبيل المثال --exclude-tags test-context عند البحث عن أسرار حقيقية.--report-diagnostics: أضف كل ملف موجود تحت الهدف إلى تقرير SARIF، مع حالته ووقت الفحص وسبب التخطي وعمق التحليل.--regex-candidate-scoring-rules /path/to/rules.json: قدّم قواعدك الخاصة للحكم على مطابقات regex قبل الإبلاغ عنها. أعطِ الخيار دون قيمة للإبلاغ عن مطابقات regex دون الحكم عليها.--multiprocessing-context {forkserver,spawn,fork}: كيفية بدء عمليات العامل. الافتراضي هو forkserver حيثما توفره المنصة (Linux، macOS): يتشارك العمال الماسح المحمّل مسبقًا في عملية خادم. يستخدم Windows الخيار spawn. جميع الخيارات الثلاثة تعطي النتائج نفسها.--disable-masking: أبقِ الأسرار المحتملة غير مقنّعة في تقرير المخرجات (انظر التحذير أدناه).--ci / --no-ci: تشغيل وضع CI أو إيقافه. يطبع وضع CI سطر تقدّم بسيطًا كل 30 ثانية بدلًا من عرض التقدّم المباشر. يتم تشغيله تلقائيًا داخل خدمات CI (GitHub Actions، GitLab CI، Jenkins وغيرها) وكلما لم تكن المخرجات طرفية.مثال .github/workflows/deepsecrets.yml
name: DeepSecrets Scan
on: [push, pull_request]
jobs:
scan:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: '3.14'
- name: Install DeepSecrets
run: pip install deepsecrets
- name: Run Scan
run: deepsecrets --target-dir . --outformat dojo-sarif --outfile report.sarif
continue-on-error: true
- name: Upload SARIF report
uses: github/codeql-action/upload-sarif@v3
with:
sarif_file: report.sarif
اعتبارًا من الإصدار v1.3.0، تُخفى الأسرار المحتملة تلقائيًا داخل التقارير لحماية مخرجات خط أنابيبك (pipeline artifacts). أوقف هذا الخيار عبر العلامة --disable-masking إذا لزم الأمر.