يفحص ملفات تفريغ نطاقات Azure المُصدَّرة بحثاً عن كلمات مرور نصية صريحة، وسلاسل اتصال، ومفاتيح تخزين، وغيرها من الأسرار؛ وينشئ تقارير CSV/HTML منقّحة لسير عمل التدقيق للقراءة فقط.
أداة فحص PowerShell تتنقّل عبر مخرجات Get-AzDomainInfo الخاصة بـ MicroBurst بحثًا عن كلمات المرور النصية الصريحة والمفاتيح وسلاسل الاتصال وغيرها من الأسرار التي لا ينبغي أبدًا أن تبقى غير مشفّرة في بيئة Azure.
مصمّمة لـ سير عمل التدقيق للقراءة فقط: تجمع تفريغًا للنطاق باستخدام MicroBurst (صلاحية Reader كافية لـ Get-AzDomainInfo)، ثم توجّه هذه الأداة إلى مجلد المخرجات. فهي لا تلمس Azure نفسها — بل تقرأ فقط الملفات التي صدّرتها مسبقًا. تُخفى قيم الأسرار في كل تقرير، لذا تكون المخرجات آمنة لإرفاقها بالنتائج.
# Clone / copy this folder, then from a PowerShell prompt:
.\Scan-MicroBurst.ps1 -Path .\MicroBurst-2026 -Verbose
أو استورد الوحدة واستخدم cmdlet مباشرةً:
Import-Module .\MicroBurstSecretsHunter.psd1 -Force
Invoke-MBSecretScan -Path .\MicroBurst-2026
تُكتب التقارير في مجلد يحمل طابعًا زمنيًا (MBSecretScan-<timestamp>) في
الدليل الحالي ما لم تمرر -OutputDirectory.
افتراضيًا تكون كل قيمة محجوبة بحيث تكون التقارير آمنة للمشاركة. تُخصَّص
الأحرف المكشوفة بمقدار ربع طول القيمة (بحد أقصى 4 أحرف بادئة + 2 لاحقة)، وأي
قيمة طولها 8 أحرف أو أقل تُستبدل بقناع ثابت العرض — لذا يظهر كلمة مرور نموذجية
على هيئة ********، بينما يبقى مفتاح تخزين بطول 88 حرفًا قابلًا للتعرف عليه
على هيئة AAAA**********AA. تُحجب سلاسل السياق قبل اقتطاعها، ويُحجب كل سر
يُعثر عليه في سطر من سياق كل نتيجة على ذلك السطر، بحيث لا يبقى أي نص صريح
في التقرير. عند فرز النتائج الإيجابية الكاذبة يكون من الأسرع غالبًا رؤية القيمة
الكاملة — مرر -ShowSecrets لإخراج قيم غير محجوبة في كل مكان (الطرفية، CSV،
HTML، JSON، SARIF). عندئذٍ تحمل الطرفية وHTML لافتة تحذير واضحة، ويجب
التعامل مع التقارير باعتبارها مواد اعتماد حيّة:
Invoke-MBSecretScan -Path .\dump -ShowSecrets # raw values, for local triage
يعمل على PowerShell 7+ (Windows وLinux وmacOS).
كل تشغيل ينتج:
| المخرجات | الوصف |
|---|---|
| ملخص وحدة التحكم | أعداد مرمّزة بالألوان حسب الخطورة/الفئة بالإضافة إلى أهم النتائج الحرجة/العالية. |
findings.csv | صف واحد لكل نتيجة (الخطورة، القاعدة، الملف، السطر، القيمة المحجوبة، السياق) للفرز في Excel. الحقول التي تحمل محتوى مفحوصًا يتم تهريبها ضد حقن صيغ جداول البيانات. |
report.html | تقرير HTML مكتفٍ ذاتيًا (بدون أصول خارجية، محمي بـ Content-Security-Policy) مع بطاقات الخطورة، ومرشح نصي مباشر، ومفاتيح تبديل الخطورة — قابل للمشاركة مع العميل. |
findings.json | بيانات وصفية للفحص بالإضافة إلى كل نتيجة، للبرمجة النصية والأدوات (-NoJson للتخطي). |
findings.sarif | سجل SARIF 2.1.0 اختياري لأدوات فحص الشيفرة (-Sarif). |
يحصل كل مجلد مخرجات أيضًا على ملف علامة صغير .mbsecretscan-output بحيث يتخطاه أي فحص لاحق يحتوي جذره عليه (انظر حدود التغطية).
كما يُصدر الـ cmdlet كائنات النتائج إلى pipeline، بحيث يمكنك المعالجة اللاحقة:
$f = Invoke-MBSecretScan -Path .\dump -Quiet
$f | Where-Object Severity -eq 'Critical' | Format-Table File,Line,RuleName
| القاعدة | الخطورة | مثال على المصدر في تفريغ |
|---|---|---|
| سلسلة اتصال SQL/DB مع كلمة مرور مضمّنة | حرجة | إعدادات App Service، صادرات web.config |
| سلسلة اتصال حساب Azure Storage / مفتاح من 88 حرفًا | حرجة | إعدادات التطبيق، صادرات Storage |
SharedAccessKey الخاص بـ Service Bus / Event Hub | حرجة | إعدادات موارد المراسلة |
| مفتاح حساب Cosmos DB | حرجة | إعدادات التطبيق |
| كتلة مفتاح خاص PEM | حرجة | صادرات Key Vault / الشهادات |
مفتاح Azure Function (?code= في عنوان URL لـ Function / Logic App، x-functions-key) | عالية | تعريفات Logic App، إعدادات التطبيق |
قيمة معامل ARM ("adminPassword": { "value": "..." }، بما في ذلك المنسّقة على عدة أسطر) | عالية | قوالب ARM / ملفات المعاملات |
| كلمة مرور Azure Redis Cache | عالية | سلاسل اتصال Cache |
سر عميل Azure AD (تنسيق …Q~… بعد 2021) | عالية | قوالب ARM، إعدادات التطبيق |
رمز SAS / معامل sig= | عالية | عناوين URL لـ SAS الخاصة بـ Storage |
| رمز JWT / bearer | عالية | الرموز المخزّنة مؤقتًا، الإعدادات |
وجود ملف شهادة / مفتاح (.pfx، .p12، .pem، .key، .jks، .ppk، …) | عالية | في أي مكان في التفريغ |
وجود ملف شهادة (.cer، .crt، .der — عادةً عام) | منخفضة | في أي مكان في التفريغ |
إسناد عام لـ password / pwd، بما في ذلك الأسماء المركّبة (administratorLoginPassword، userPWD) | عالية | متغيرات الأتمتة، إعدادات التطبيق، معاملات ARM، ملفات تعريف النشر |
إسناد عام لـ secret / client_secret، بما في ذلك الأسماء المركّبة (servicePrincipalSecret) | عالية | إعدادات التطبيق، القوالب |
| مفاتيح وصول AWS / رموز GitHub / Slack | عالية/متوسطة | بيانات اعتماد أجنبية مخزّنة في تطبيقات Azure |
api_key / access_key / connectionstring العامة | متوسطة | إعدادات التطبيق |
| سلسلة عالية الإنتروبيا (استدلالية) | منخفضة | شبكة أمان لتنسيقات المفاتيح غير المعروفة — اختيارية عبر -IncludeEntropy |
تطابق قواعد الكلمات المفتاحية العامة الكلمة المفتاحية عند نهاية الاسم المركّب
(sqlAdminPassword، servicePrincipalSecret، storageAccountKey)، لذا تبقى
حقول البيانات الوصفية التي تبدأ فقط بإحداها (passwordLastSet، secretName)
صامتة. تتوقف القيمة العامة قبل مسافة بيضاء تتبعها
key=/key: أخرى، لذا يُنتج password=abc apikey=xyz نتيجتين نظيفتين، بينما
تظل عبارة المرور التي تحتوي على مسافات ملتقطة بالكامل.
نتيجة واحدة لكل سر. عندما تطابق عدة قواعد القيمة نفسها على
السطر نفسه (سلسلة اتصال Storage و المفتاح المجرد المكوّن من 88 حرفًا؛ سلسلة
اتصال SQL و قاعدة كلمة المرور العامة)، تُحتفظ فقط بأعلى
تطابق من حيث الخطورة. وعند التعادل، تفوز قاعدة خاصة بالتنسيق (AZ_AAD_CLIENT_SECRET)
على قاعدة مدفوعة بكلمة مفتاحية (GENERIC_*، ARM_PARAM_*، CSV_*).
توجد مجموعة القواعد الكاملة القابلة للتحرير في Private/Get-MBSignature.ps1. كل قاعدة
هي [PSCustomObject] بالحقول التالية:
| الحقل | مطلوب | الغرض |
|---|---|---|
Id، Name، Category، Severity | نعم | الهوية وكيفية الإبلاغ عن النتيجة وترتيبها. |
Pattern | نعم | التعبير النمطي. يُصرَّف مرة واحدة لكل فحص. |
ValueGroup | نعم | مجموعة الالتقاط التي تحمل السر (0 = المطابقة الكاملة). يوجّه الحجب. |
MultiLine | لا | التقييم مقابل نص الملف كاملًا بدلًا من سطرًا بسطر (كتل PEM، معاملات ARM المنسّقة). تُبلَّغ كل مطابقة، وليس الأولى فقط، على السطر الذي يبدأ فيه ValueGroup. |
CaseSensitive | لا | إلغاء الاشتراك في التصريف الافتراضي IgnoreCase. اضبطه للتنسيقات المعرّفة بحساسية لحالة الأحرف (AKIA، ghp_، eyJ، Q~) — فبدونه، تُطابَق نظائرها بأي حالة أحرف. |
Redact | لا | اضبطه على $false عندما تكون القيمة الملتقطة تسمية وليست سرًا (سطر رأس PEM، اسم ملف شهادة) لتظهر حرفيًا بدلًا من حجبها حتى تصبح غير مقروءة. الافتراضي هو الحجب. |
Get-AzDomainInfo يصدّر متغيرات حساب الأتمتة وإعدادات التطبيق كصفوف
Name,Value[,Encrypted]. يكمن السر في عمود Value بينما تكمن
الكلمة المفتاحية التي تحدد هويته (مثل ServiceAccountPwd، dbConnectionString)
في عمود Name — لذا لا يراها تعبير نمطي عادي أبدًا على نفس
"السطر" وتكون الكلمة المفتاحية مدفونة داخل رمز مركّب بلا حدّ كلمة.
بالنسبة لملفات .csv / .tsv، يقوم الماسح additionally بـ إقران الأعمدة
المهيكل (Private/Get-MBCsvFinding.ps1):
Encrypted=True (القيمة ليست نصًا صريحًا).Password أو StorageKey)، يُبلَّغ عن كل خلية غير عنصر نائب.القيم التي تغطيها قاعدة عالية الثقة بالفعل (سلاسل الاتصال، مفاتيح التخزين، SAS) تُترك لتمريرة السطر الخام لتنقيح أكثر إحكامًا، وتُزال التكرارات من النتائج لكل قيمة وسطر حتى لا يُبلَّغ عن السر نفسه مرتين. إذا تعذّر تحليل ملف كـ CSV، يعود الماسح تلقائيًا إلى فحص السطر الخام العادي.
-ScanValues)يعتمد الإقران أعلاه على اسم الإعداد. لالتقاط الأسرار أيضًا
المخزّنة تحت اسم بلا معنى (مثل Config1 = P@ssw0rd2026!)، مرّر
-ScanValues. يفحص محتوى خلايا القيمة باستدلالين
متحفظين، منخفضي الخطورة: