
قائمة أنماط regex لرموز oauth / api مع المصدر المرفق
ماسح ضوئي مُوثّق ومُختبَر ومُثبَت دون اتصال للرموز والأسرار الخاصة بـ OAuth / API. كل نمط مُوثّق (من وثائق المزوّد الأساسية)، ومُختبَر (عينات إيجابية + سلبية)، ومُثبَت (متوافق مع RE2، ومفحوص ضد ReDoS). يأتي مع واجهة سطر أوامر (CLI) بمستويات ثقة. المصدر الموثوق هو DATA في build_patterns.py؛ ويتم توليد patterns.json وهذا الملف منه.
109 نمط / 64 مزوّد / تم التوليد في 2026-07-02
pip install -e . # console script + importable package
regextokens scan PATH... # walk files/dirs, report findings
regextokens scan PATH -m verified # only offline-proven findings
regextokens scan PATH -f sarif # SARIF for GitHub code scanning
regextokens list # show the catalog
حالة الخروج: 0 لا توجد نتائج، 1 نتائج عند المستوى المطلوب أو أعلى منه، 2 خطأ. وجّهه إلى diff أو شجرة في CI لبوابة عمليات الدمج. تُحجب الأسرار في المخرجات افتراضيًا.
اقبل النتائج التي تمت مراجعتها (بيانات اختبار ثابتة، أمثلة توثيق) بحيث يفشل CI فقط على الأسرار الجديدة:
regextokens scan . --write-baseline .regextokens-baseline.json # snapshot current findings
regextokens scan . --baseline .regextokens-baseline.json # subtract them
يخزّن خط الأساس بصمات (sha256 لمعرّف النمط + جسم السر المُجزَّأ)، ولا يخزّن الأسرار نفسها أبدًا، لذا فإن الالتزام به آمن. المطابقة مستقلة عن الأسطر — فتحرير سطر أعلى نتيجة مقبولة لا يعيد إخفاءها — لكن الرمز نفسه في ملف مختلف يُعدّ تعرّضًا جديدًا ويُبلَّغ عنه. يحتوي قسم allow المُحرَّر يدويًا على السياسة: أنماط مسارات fnmatch ومعرّفات الأنماط. يحافظ --write-baseline عليها ويطبّقها. يلتزم هذا المستودع بخط أساس خاص به يغطي العينات الاصطناعية في build_patterns.py؛ وتُجري CI فحصًا ذاتيًا مقابله.
# .pre-commit-config.yaml
repos:
- repo: https://github.com/odomojuli/regextokens
rev: v0.2.0
hooks:
- id: regextokens
# .github/workflows/secrets.yml
jobs:
secrets:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: odomojuli/regextokens@main
with:
min-confidence: probable
# baseline: .regextokens-baseline.json
# optional: feed the SARIF to code scanning
# - uses: github/codeql-action/upload-sarif@v3
# if: always()
# with: {sarif_file: regextokens.sarif}
كلاهما افتراضيًا إلى -m probable: تتضمن فئة low المعرّفات العامة والعناصر النائبة التي من شأنها أن تجعل بوابة الالتزام غير قابلة للاستخدام.
يُقيَّم كل اكتشاف بواسطة إثبات دون اتصال — حساب محلي فقط، دون شبكة، ودون استدعاءات إلى الجهة المُصدرة. إجابة مطابقة الشكل على سؤال "هل يبدو هذا كرمز مميز؟"؛ بينما تجيب هذه الفحوصات على سؤال "هل يمكننا إثبات، محليًا، أنه كذلك أم لا؟". استخدم -m/--min-confidence للتصفية.
verified-offline — تُثبت مجموع تحقّق أو مُفكِّك ترميز أن البنية أصلية (GitHub/npm CRC32؛ تم التحقق منها تجريبيًا مقابل رموز مميزة ملغاة حقيقية).probable — البنية بالإضافة إلى جسم إنتروبيا شانون متوافق مع سرّ حقيقي.low — مطابقة الشكل فقط؛ قد يكون عنصرًا نائبًا أو معرّفًا عامًا.rejected — يقول الإثبات دون اتصال إن هذا بشكل قابل للإثبات ليس رمزًا مميزًا حقيقيًا (مثل عدم تطابق CRC32)؛ يُستبعد قبل أن يصل إليك.تُعدّ فئة rejected هي العامل المُميِّز: فسلسلة ghp_/npm_ ذات بادئة وطول صالحين لكن بمجموع تحقّق خاطئ تُستبعد بيقين، مما يقضي على أكبر فئة من الإيجابيات الكاذبة لأعلى مزوّدي القيمة. لا يدّعي الإثبات دون اتصال أبدًا أن مفتاحًا نشط — فهذا لا يزال يتطلب واجهة برمجة تطبيقات الجهة المُصدرة.
pip install pytest
pytest # validate every pattern + engine
python build_patterns.py # regenerate patterns.json + README.md
استهلك الكتالوج مباشرةً (بدون محرك):
import json, re
pats = json.load(open("patterns.json"))["patterns"]
rx = {p["id"]: re.compile(p["regex"]) for p in pats}
rx["github-pat-classic"].search(text)
build_patterns.py — المصدر الموثوق (DATA) + المدقق؛ يعيد بناء patterns.json وREADME.md.patterns.json — الكتالوج المُولَّد (قابل للقراءة آليًا). لا تُحرّره يدويًا أبدًا.regextokens/ — حزمة قابلة للتثبيت: catalog (تحميل)، scanner (تنقّل/مطابقة)، verify (إثبات دون اتصال)، baseline (النتائج المقبولة + قائمة السماح)، report (بشري/JSON/SARIF)، cli. تتضمن نسخة متزامنة من patterns.json..pre-commit-hooks.yaml / action.yml / .github/workflows/ — التوزيع: خطاف pre-commit، إجراء GitHub المركّب، CI + إصدار PyPI المُشغَّل بالوسوم (نشر موثوق).tests/ — test_patterns.py (كل نمط: الترجمة، المطابقة، RE2، ReDoS) وtest_engine.py (الماسح، التحقق، التقرير، CLI، مزامنة الكتالوج).sniffer-audit.md — تدقيق لبرامج كشف الأسرار الأخرى (التحقق، التقادم).references.bib / references.md — ببليوغرافيا أدبيات كشف الأسرار.re. بدون lookbehind أو backreferences.re.search (مسح النص المضمّن). غلّفها بـ ^/$ لاستخدامها كمدققات.\b معظم الرموز. احذفها إذا كنت تمسح داخل كتل base64.prefix = موثوق بمفرده؛ structure = شكل ثابت؛ keyword = مشروط بكلمة مفتاحية قريبة؛ identifier = عام، ليس سرًّا؛ encoding = فحص تنسيق، ليس سرًّا.patterns.json هي حشو اصطناعي، وليست بيانات اعتماد حية.sniffer-audit.md — كيف تبني الماسحات الرئيسية الأنماط وتتحقق منها، مع بيانات قياس.references.bib / references.md — ببليوغرافيا أدبيات كشف الأسرار.سلسلة Base64 [encoding]
^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$
مدقق تنسيق، وليس سرًا. أبجدية Base64 القياسية مع الحشو. مثبّت.
src: https://datatracker.ietf.org/doc/html/rfc4648#section-4
JSON Web Token (JWT) [structure]
\bey[A-Za-z0-9_-]{10,}\.ey[A-Za-z0-9/_-]{10,}\.[A-Za-z0-9/_-]{10,}
ثلاثة مقاطع base64url. يبدأ الترويسة بـ ey (أي {"). فكّ الترميز للفحص؛ التوقيع وحده ليس السر.
src: https://datatracker.ietf.org/doc/html/rfc7519
كتلة المفتاح الخاص PEM [prefix]
-----BEGIN (?:RSA |EC |DSA |OPENSSH |PGP |ENCRYPTED )?PRIVATE KEY-----
المؤشر الفردي الأعلى قيمة. يطابق سطر الترويسة لأي مفتاح خاص مُرمَّز بصيغة PEM.
src: https://datatracker.ietf.org/doc/html/rfc7468
مفتاح age X25519 السري [structure]
\bAGE-SECRET-KEY-1[QPZRY9X8GF2TVDW0S3JN54KHCE6MUA7L]{58}\b
Bech32 مع HRP 'AGE-SECRET-KEY-'؛ يُشفَّر مفتاح من 32 بايت إلى 58 حرفًا بعد الفاصل '1' (أحرف كبيرة). المستلمون (age1...) عامّون وليسوا أسرارًا. يستخدم البديل ما بعد الكمّي HRP AGE-SECRET-KEY-PQ-.
src: https://github.com/C2SP/C2SP/blob/main/age.md
رمز المصادقة (واجهة برمجة تطبيقات مهملة) [structure]
\bamzn\.mws\.[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b
amzn.mws.. تقاعدت MWS لصالح SP-API (تسجيل الدخول باستخدام رموز Amazon، البادئات Atza|/Atzr|). كان إدخال القائمة الأصلي مشوّهًا.