61106960/adpeasأداة PowerShell لأتمتة تعداد Active Directory.
# adPEAS v2 — سكربتات رفع الصلاحيات الرائعة في Active Directory
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/4985/094efb3e3ea9d020e014d57d49df2544da13c1a85d28db14f491e55817bcc68f.jpg" alt="شعار adPEAS" width="800">
</p>
<p align="center">
<strong>تقييم أمني شامل لـ Active Directory — بدون أي تبعيات، ملف واحد، جاهز للاستخدام.</strong>
</p>
---
## ما هو adPEAS؟
adPEAS هي أداة تقييم أمني مبنية على PowerShell تحدد حالات سوء التكوين والثغرات ومسارات رفع الصلاحيات في بيئات Active Directory. وهي مصممة لمختبري الاختراق ومدققي الأمن والفرق الحمراء الذين يحتاجون إلى أداة موثوقة ومكتفية ذاتيًا تعمل على أي نظام Windows — بدون RSAT، وبدون وحدة ActiveDirectory، وبدون أي تبعيات خارجية.
**adPEAS v2** هي إعادة كتابة كاملة لـ adPEAS v1. فهي تستبدل النهج القديم القائم على `DirectoryEntry`/`DirectorySearcher` بمعمارية موحّدة تعتمد على `System.DirectoryServices.Protocols.LdapConnection`، وتضيف مصادقة Kerberos أصلية وتقارير متقدمة وعمليات هجومية — كل ذلك بـ PowerShell خالص.
### الجديد في v2
- **حزمة Kerberos أصلية** — AS-REQ/AS-REP وTGS-REQ/TGS-REP وPass-the-Ticket وPKINIT، كل ذلك بـ PowerShell خالص
- **طرق مصادقة متعددة** — كلمة المرور، NT-Hash (OPtH)، مفاتيح AES (PtK)، الشهادات (PKINIT وPass-the-Cert/Schannel)، مصادقة Windows المدمجة
- **أكثر من 40 فحصًا أمنيًا** موزعة على 9 فئات مع تقييم للخطورة
- **تقارير HTML تفاعلية** مع البحث والتصفية ودرجات المخاطر والتلميحات
- **تصدير JSON** لتحويل التقارير دون اتصال والفحص التزايدي ومقارنة الفحوصات
- **جامع BloodHound CE** — جمع بيانات مدمج لتحليل مسارات الهجوم
- **عمليات هجومية** — Kerberoasting وAS-REP Roasting وتذاكر Golden/Silver/Diamond وإساءة استخدام RBCD وShadow Credentials والمزيد
- **سير عمل قائم على الجلسات** — اتصل مرة واحدة وشغّل فحوصات متعددة تفاعليًا
- **إكمال تلقائي بـ Tab** — إكمال تلقائي لأسماء كائنات AD للاستكشاف التفاعلي
> **جديد على adPEAS؟** راجع [دليل البدء السريع](https://github.com/61106960/adpeas/blob/main/docs/02-Quick-Start.md) أو اقرأ [سلسلة المدونات على blog.sekurity.de](https://blog.sekurity.de/blog/adpeas-v2-introduction) للتعمق في المعمارية والمصادقة والتفاصيل الداخلية.
---
## الميزات في لمحة
| الفئة | أبرز النقاط |
|----------|-----------|
| **المصادقة** | بيانات الاعتماد، PKINIT، Pass-the-Cert، NT-Hash، مفاتيح AES، مصادقة Windows، Kerberos أولًا مع تراجع تلقائي |
| **الفحوصات الأمنية** | تكوين النطاق، Kerberoast، ASREPRoast، قوائم التحكم بالوصول (ACLs)، DCSync، التفويض، مسارات تصعيد AD CS، إساءة استخدام GPO، LAPS، مفاتيح استرداد BitLocker، الأنظمة القديمة |
| **التقارير** | وحدة التحكم (مرمّزة بالألوان)، نص عادي، HTML تفاعلي، تصدير JSON |
| **العمليات الهجومية** | Kerberoasting، AS-REP Roasting، تذاكر Golden/Silver/Diamond، RBCD، Shadow Credentials، Pass-the-Ticket |
| **BloodHound** | جامع BloodHound CE مدمج (تصدير ZIP) |
| **وضع OPSEC** | تخطي الاختبار النشط (Kerberoast، ASREPRoast، BloodHound) |
| **النشر** | ملف `.ps1` واحد، بدون RSAT، بدون وحدات خارجية، يعمل دون اتصال وفي الشبكات المعزولة |
---
## المتطلبات
- **نظام التشغيل**: Windows 10/11، Windows Server 2016/2019/2022/2025
- **PowerShell**: 5.1+ (Windows PowerShell)
- **.NET Framework**: 4.5+ (مضمّن في Windows)
- **الشبكة**: LDAP (389)، LDAPS (636)، Kerberos (88)، SMB (445)
لا حاجة إلى وحدة ActiveDirectory أو RSAT أو أي وحدات PowerShell خارجية.
---
## التنزيل
### إصدارات الإصدار الرسمي
| الملف | الحجم | حالة الاستخدام |
|------|------|----------|
| `adPEAS.ps1` | ~4.5 MB | التطوير، تصحيح الأخطاء، مراجعة الكود |
| `adPEAS_min.ps1` | ~3-4 MB | الاستخدام العادي ببصمة أصغر |
| `adPEAS_ultra.ps1` | ~3 MB | حجم أدنى، بدون تعليقات |
| `adPEAS_obf.ps1` | <1 MB | أصغر حجم، مُشوَّش للنقل |
جميع الإصدارات الأربعة متطابقة وظيفيًا. اختر بناءً على سيناريو النشر الخاص بك.
```powershell
# Clone the repository
git clone https://github.com/61106960/adPEAS.git
cd adPEAS
```
### البناء من المصدر
يحمل فرع `main` دائمًا نسخة بناء حديثة من جميع المتغيرات الأربعة، يُعاد بناؤها مع كل إصلاح وميزة، لذا توفّر عناوين URL الخام أعلاه أحدث شيفرة. تحمل تلك النسخ سلسلة إصدار تطويرية (`2.5.1+20260917-1759`). تحتوي كل نسخة [GitHub Release](https://github.com/61106960/adPEAS/releases) موسومة على نسخ البناء الأربع المستقرة مرفقة كأصول قابلة للتنزيل، مع سلسلة إصدار نظيفة (`2.5.1`) — استخدم تلك إذا كنت بحاجة إلى إصدار معروف وقابل للاستشهاد. لتبني من المصدر بنفسك:
```powershell
git clone https://github.com/61106960/adPEAS.git
cd adPEAS
.\Build-Release.ps1
```
ينتج هذا جميع المتغيرات الأربعة (`adPEAS.ps1`، `adPEAS_min.ps1`، `adPEAS_ultra.ps1`، `adPEAS_obf.ps1`) في جذر المستودع. يتطلب Windows PowerShell 5.1 ولا توجد تبعيات إضافية.
---
## البدء السريع
```powershell
# Option 1: Import as module (recommended)
Import-Module .\adPEAS.ps1
# Option 2: Dot-sourcing
. .\adPEAS.ps1
# Option 3: Read and execute in memory
Get-Content -Raw .\adPEAS.ps1 | Invoke-Expression
# Option 4: Load directly from GitHub into memory (no file on disk).
# Both variants work; on an older/hardened host that still defaults to TLS 1.0,
# prepend once: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
# 4a: WebClient - shortest. DownloadString detects and strips the file's UTF-8 BOM
# itself, so nothing extra is needed. WebClient is a legacy API but works everywhere.
Invoke-Expression (New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/61106960/adPEAS/main/adPEAS_obf.ps1')
# 4b: Invoke-WebRequest - the modern cmdlet. Its .Content keeps the BOM as a leading
# U+FEFF that Invoke-Expression cannot parse, so TrimStart removes it first.
Invoke-Expression ((Invoke-WebRequest -Uri "https://raw.githubusercontent.com/61106960/adPEAS/main/adPEAS_obf.ps1" -UseBasicParsing).Content.TrimStart([char]0xFEFF))
```
### أمر واحد (متوافق مع v1)
```powershell
# Domain-joined machine (current user)
Invoke-adPEAS -Domain "contoso.com" -UseWindowsAuth
# With credentials
Invoke-adPEAS -Domain "contoso.com" -Username "john.doe" -Password "P@ssw0rd!"
# OPSEC mode (skip Kerberoast, ASREPRoast, BloodHound)
Invoke-adPEAS -Domain "contoso.com" -UseWindowsAuth -OPSEC
```
### قائم على الجلسات (بنمط v2)
```powershell
# Connect once
Connect-adPEAS -Domain "contoso.com" -UseWindowsAuth
# Run full scan
Invoke-adPEAS
# Or run individual checks
Get-KerberoastableAccounts
Get-ADCSVulnerabilities
Get-DangerousACLs
# Disconnect when done
Disconnect-adPEAS
```
### طرق المصادقة
```powershell
# Credentials
Connect-adPEAS -Domain "contoso.com" -Credential (Get-Credential)
# Overpass-the-Hash (NT-Hash)
Connect-adPEAS -Domain "contoso.com" -Username "admin" -NTHash "32ED87BDB5FDC5E9CBA88547376818D4"
# Pass-the-Key (AES256)
Connect-adPEAS -Domain "contoso.com" -Username "admin" -AES256Key "4a3b2c1d5e6f..."
# PKINIT (Certificate)
Connect-adPEAS -Domain "contoso.com" -Certificate "user.pfx"
# Pass-the-Cert / Schannel (LDAPS, no Kerberos)
Connect-adPEAS -Domain "contoso.com" -Certificate "user.pfx" -PassTheCert
# LDAPS
Connect-adPEAS -Domain "contoso.com" -UseWindowsAuth -UseLDAPS
```
### المخرجات والتقارير
```powershell
# All formats (default) — creates .txt, .html, and .json
Invoke-adPEAS -Domain "contoso.com" -UseWindowsAuth -Outputfile .\report
# HTML only
Invoke-adPEAS -Domain "contoso.com" -UseWindowsAuth -Outputfile .\report -Format HTML
# Offline report conversion from JSON
Convert-adPEASReport -InputJson ".\report.json" -OutputPath ".\new_report"
# Compare two scans (diff report)
Compare-adPEASReport -Baseline ".\scan_q1.json" -Current ".\scan_q2.json" -OutputPath ".\diff"
```
## وحدات فحص الأمان
| الوحدة | الوصف |
|--------|-------------|
| `Domain` | إعدادات النطاق، والثقة، وسياسة كلمات المرور، وتوقيع LDAP، وتوقيع SMB |
| `Creds` | Kerberoast، وASREPRoast، والوصول إلى مفاتيح استرداد LAPS وBitLocker، وانكشاف بيانات الاعتماد في SYSVOL |
| `Rights` | قوائم التحكم في الوصول (ACLs)، وDCSync، وحقوق إعادة تعيين كلمات المرور، وأذونات الوحدات التنظيمية (OU) الخطرة |
| `Delegation` | التفويض غير المقيّد، والمقيّد، والمقيّد القائم على الموارد |
| `ADCS` | قوالب الشهادات ومراكز الشهادات (CAs): ESC1-ESC5، وESC8، وESC9، وESC13، وESC14، وESC15 (ESC10 عبر فحص GPO). مسارات التصعيد التي تتطلب وصولاً إداريًا إلى مضيف CA خارج النطاق - راجع [فحوصات الأمان](https://github.com/61106960/adpeas/blob/main/docs/04-Security-Checks.md) |
| `Accounts` | الحسابات ذات الامتيازات، والمستخدمون المحميون، وحسابات الخدمة، وسجل SID |
| `GPO` | أذونات GPO، وعضوية المجموعات المحلية، والمهام المجدولة، والنصوص البرمجية، وإعدادات التسجيل الخطرة (WDigest، وAlwaysInstallElevated، وOneLogon/Zerologon، …) وسياسات برنامج تشغيل الطابعة Point and Print (PrintNightmare) المنشورة عبر GPO |
| `Computer` | LAPS، والأنظمة القديمة، وخوادم البنية التحتية |
| `Application` | بنية Exchange، وSCCM، وSCOM التحتية |
| `Bloodhound` | جمع بيانات BloodHound CE |
تشغيل وحدات محددة:
```powershell
Invoke-adPEAS -Domain "contoso.com" -UseWindowsAuth -Module Domain,Creds,ADCS
```
أو شغّل كل شيء باستثناء عدد قليل، دون سرد الباقي:
```powershell
Invoke-adPEAS -Domain "contoso.com" -UseWindowsAuth -ExcludeModule Bloodhound,Computer
```
## التوثيق
التوثيق الكامل متاح في دليل [docs/](https://github.com/61106960/adpeas/blob/main/docs):
| المستند | الموضوع |
| ------------------------------------------------------- | ----------------------------------- |
| [Installation](https://github.com/61106960/adpeas/blob/main/docs/01-Installation.md) | التنزيل والإعداد وسياسة التنفيذ |
| [Quick-Start](https://github.com/61106960/adpeas/blob/main/docs/02-Quick-Start.md) | ابدأ في 5 دقائق |
| [Authentication](https://github.com/61106960/adpeas/blob/main/docs/03-Authentication-Methods.md) | جميع خيارات المصادقة |
| [Security Checks](https://github.com/61106960/adpeas/blob/main/docs/04-Security-Checks.md) | مرجع الفحوصات الكامل |
| [BloodHound Collector](https://github.com/61106960/adpeas/blob/main/docs/05-BloodHound-Collector.md) | تصدير BloodHound CE |
| [Core Functions](https://github.com/61106960/adpeas/blob/main/docs/06-Core-Functions.md) | دوال استعلام LDAP |
| [Set- & New-Modules](https://github.com/61106960/adpeas/blob/main/docs/07-Set-Modules.md) | دوال تعديل AD |
| [Helper Functions](https://github.com/61106960/adpeas/blob/main/docs/08-Helper-Functions.md) | دوال مساعدة |
| [Architecture](https://github.com/61106960/adpeas/blob/main/docs/09-Architecture.md) | البنية التقنية |
| [Risk Scoring](https://github.com/61106960/adpeas/blob/main/docs/10-Risk-Scoring-System.md) | درجات الخطورة والمخاطر |
| [Troubleshooting](https://github.com/61106960/adpeas/blob/main/docs/11-Troubleshooting.md) | المشكلات الشائعة والحلول |
| [FAQ](https://github.com/61106960/adpeas/blob/main/docs/12-FAQ.md) | الأسئلة الشائعة |
### سلسلة المدونات
تُنشر سلسلة مفصلة من المدونات تغطي تفاصيل adPEAS v2 الداخلية على [blog.sekurity.de](https://blog.sekurity.de/blog/adpeas-v2-introduction).
---
## الترخيص
adPEAS هو **متاح المصدر (source-available)**. التقييمات الأمنية الداخلية لمؤسستك مجانية. يتطلب الاستخدام التجاري (الاستشارات، MSP، المهام المدفوعة) ترخيصًا تجاريًا.
راجع [LICENSE](https://github.com/61106960/adpeas/blob/main/license/LICENSE.md) للاطلاع على الشروط الكاملة، و[COMMERCIAL_AGREEMENT](https://github.com/61106960/adpeas/blob/main/license/COMMERCIAL_AGREEMENT.md) للاتفاقية التجارية، و[PRICING](https://github.com/61106960/adpeas/blob/main/license/PRICING.md) لخيارات الترخيص.
- **استفسارات الترخيص:** [email protected]
- **الدعم الفني:** [email protected]
---
## إشعار قانوني
adPEAS مخصص **لاختبارات الأمان المصرح بها فقط**. احصل دائمًا على تصريح كتابي قبل الاختبار. لا تستخدمه أبدًا ضد أنظمة لا تملكها أو لا تملك إذنًا باختبارها. المؤلفون غير مسؤولين عن إساءة استخدام هذه الأداة. التزم بجميع القوانين واللوائح المعمول بها.
---
## المؤلف
**Alexander Sturz** — [SEKurity GmbH](https://sekurity.de)
- GitHub: [@61106960](https://github.com/61106960)
- المدونة: [blog.sekurity.de](https://blog.sekurity.de)