rodhnin/argus-wp-watcherماسح أمان لووردبريس مع تحليل مدعوم بالذكاء الاصطناعي، وإطار امتثال أخلاقي، وتقارير احترافية.
ماسح ثغرات WordPress أخلاقي — ارتباط فوري بـ CVE، ربط OWASP، تحليل مدعوم بالذكاء الاصطناعي، واختبار قائم على الموافقة.
بدء سريع · التوثيق · Docker · ميزات الذكاء الاصطناعي · نجمة على GitHub
نظرة عامة على الفحص · توزيع الخطورة |
النتائج · شارات CVE/OWASP · شريط التصفية |
Argus هو ماسح أمان WordPress جاهز للإنتاج يضع الأخلاق أولاً. صُمم لمختبري الاختراق وباحثي الأمن ومدراء WordPress، ويجمع بين فحص الثغرات التقليدي وتحليل الذكاء الاصطناعي المتطور لتقديم رؤى قابلة للتنفيذ.
--diff last يقارن الفحوصات لتتبع تقدم المعالجةpython -m argus --target https://example.com --html
- **التعرّف متعدد الأساليب**: يكتشف WordPress 4.x-6.x بدون أي نتائج إيجابية كاذبة
- **ربط CVE في الوقت الفعلي**: يفحص كل إصدار تم اكتشافه من الإضافات والقوالب والنواة مقابل WPVulnerability.net (مجاني، بدون مفتاح API)
- **تقييم CVSS**: يجلب الدرجات من NVD لكل CVE (حرج ≥9.0، مرتفع ≥7.0، متوسط ≥4.0)
- **اكتشاف أحدث إصدار**: تعرض واجهة WordPress.org API الإصدار المستقر الحالي بجانب الإصدار المكتشف
- **OWASP Top 10 2021**: كل نتيجة تم تعيينها إلى فئة OWASP الخاصة بها (A01–A10)
- **فحص متزامن**: تجمع الخيوط + تحديد المعدل لفحوصات سريعة ومحترمة
- **اكتشاف ذكي**: إيقاف مبكر للمواقع غير المستندة إلى WordPress (رفض أسرع بنسبة 99%)
- **جمع الأدلة**: يتم الاحتفاظ باستجابات HTTP والترويسات ومحتويات الملفات
### 📈 تقارير فرق الفحص (v0.2.0)```bash
# Compare this scan against the previous one
python -m argus --target https://example.com --html --diff last
# Or reference a specific scan ID
python -m argus --target https://example.com --html --diff 42
يعرض قسم الفروقات:
اختر مزود الذكاء الاصطناعي الخاص بك بناءً على احتياجاتك:
أوضاع التحليل:
--ai-agent): مُثرى ببيانات NVD CVE الحية وعمليات بحث WPVulnerability.net (واجهات برمجة تطبيقات مجانية)--ai-compare): تحليل جنبًا إلى جنب من مزودين متعددين بالتوازي--ai-stream): إخراج الرموز في الوقت الفعلي أثناء توليد الذكاء الاصطناعي--ai-budget): فرض سقف للتكلفة مع حد إيقاف قابل للتكوينتقارير JSON (قابلة للقراءة آليًا)```json { "tool": "argus", "version": "0.2.0", "target": "https://example.com", "summary": {"critical": 3, "high": 5, "medium": 8, "low": 6, "info": 5}, "findings": [ { "id": "ARGUS-WP-012", "title": "Vulnerable plugin: elementor v3.5.0 (31 CVEs)", "severity": "critical", "owasp": {"id": "A06", "name": "Vulnerable and Outdated Components"}, "latest_version": "3.28.1", "cve": ["CVE-2022-1329", "CVE-2022-29455"], "vulnerabilities": [ {"title": "Elementor < 3.4.8 — Authenticated RCE", "cvss": 8.8, "cve_id": "CVE-2022-1329"} ] } ], "diff": {"ref_scan_id": 41, "new": [...], "fixed": [...], "persisting": [...]} }
**تقارير HTML** (مناسبة للبشر، v0.2.0)
- 🎨 تصميم متجاوب مع CSS مضمّن (بدون اعتماديات خارجية)
- 🏷️ شارات شدة ملوّنة + شريط تصفية تفاعلي
- 🔴 شارات CVE مرتبطة بـ NVD، وشارات CWE بنفسجية (بدون تكرار)
- 🟣 شارة OWASP Top 10 2021 لكل نتيجة
- 🟢 شارة أحدث إصدار مستقر للمكوّنات الضعيفة
- 📊 شارة درجة CVSS ملوّنة لكل CVE (أحمر/برتقالي/أصفر/أخضر)
- 📝 لوحات تفاصيل CVE قابلة للتوسيع، وتوصيات قابلة للتوسيع
- 🔧 مقتطفات إعدادات رؤوس الأمان (Apache / Nginx / WordPress)
- 📈 قسم الفروقات (جديد/تم إصلاحه/مستمر) مع تحذير عدم تطابق الوضع
- 🤖 تحليل بالذكاء الاصطناعي مع تبويبات (تنفيذي / تقني / وكيل)
- 📱 متوافق مع الجوال
### 🔐 نظام رمز الموافقة
يفرض Argus الأخلاقيات في الاختراق من خلال التقنية. يتطلب الفحص العدواني وتحليل الذكاء الاصطناعي **إثبات الملكية**:```bash
# 1. Generate token
python -m argus --gen-consent example.com
# 2. Place token on your server
echo "verify-abc123..." > .well-known/verify-abc123.txt
# 3. Verify ownership
python -m argus --verify-consent http --domain example.com --token verify-abc123
# 4. Now you can use aggressive mode
python -m argus --target https://example.com --aggressive --use-ai
قاعدة بيانات SQLite تتعقب كل شيء:
finding_codeai_costs (v0.2.0+)sqlite3 ~/.argos/argos.db "SELECT * FROM v_recent_scans LIMIT 10"
sqlite3 ~/.argos/argos.db "SELECT * FROM v_critical_findings"
---
## 🚀 البدء السريع
### المتطلبات الأساسية
- **Python 3.11+** (يُوصى بـ 3.12)
- **pip** (مدير حزم بايثون)
- **Docker** (اختياري، للمسح الضوئي عبر الحاويات)
### التثبيت
**1. استنساخ المستودع**```bash
git clone https://github.com/rodhnin/argus-wp-watcher.git
cd argus-wp-watcher
2. (اختياري) ثبّت venv إذا لم يكن متوفرًا بالفعل```bash
sudo apt update && sudo apt install -y python3-venv
sudo dnf install python3-virtualenv
brew install [email protected]
**3. إنشاء وتفعيل البيئة الافتراضية**```bash
python3 -m venv .venv
source .venv/bin/activate
# You should see (.venv) in your terminal prompt
4. ترقية pip```bash python -m pip install --upgrade pip
**5. تثبيت التبعيات**```bash
python -m pip install -r requirements.txt
6. قم بتكوين مفاتيح API (إذا كنت تستخدم الذكاء الاصطناعي السحابي)```bash
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
**7. التحقق من التثبيت**```bash
python -m argus --version
# Output: Argus v0.2.0
python -m argus --target https://example.com
python -m argus --target https://example.com --html
python -m argus --target https://example.com --use-ai --html
**🎉 تم بنجاح!** تحقق من `~/.argos/reports/` للاطلاع على تقاريرك.
---
## 📘 دليل الاستخدام
### الفحص الأساسي```bash
# Safe mode (default) - Non-intrusive checks
python -m argus --target https://example.com
# Generate HTML report
python -m argus --target https://example.com --html
# Increase verbosity for debugging
python -m argus --target https://example.com -vv
python -m argus --target https://example.com --rate 10
python -m argus --target https://example.com --threads 8
python -m argus --target https://example.com --timeout 60
python -m argus --target https://example.com --report-dir ./my-reports
### التحليل المدعوم بالذكاء الاصطناعي
**الخطوة 1: عيّن مفتاح API الخاص بك**```bash
export OPENAI_API_KEY="sk-..."
الخطوة 2: اختبر إعدادك```bash
python -m argus.core.ai openai
**الخطوة 3: تشغيل الفحص المدعوم بالذكاء الاصطناعي**```bash
# Both analyses in one scan (~$0.006 with default model)
python -m argus --target https://example.com --use-ai --html
# Technical only (for security teams)
python -m argus --target https://example.com --use-ai --ai-tone technical --html
# Executive only (for management)
python -m argus --target https://example.com --use-ai --ai-tone non_technical --html
# Override model or provider at runtime
python -m argus --target https://example.com --use-ai --ai-model gpt-4o --html
python -m argus --target https://example.com --use-ai --ai-provider anthropic --html
# Stream output in real time
python -m argus --target https://example.com --use-ai --ai-stream
# Agent mode with NVD CVE lookup (free)
python -m argus --target https://example.com --use-ai --ai-agent --html
# Compare two providers side by side
python -m argus --target https://example.com \
--use-ai --ai-compare openai,anthropic --html
# Budget cap ($0.05 max)
python -m argus --target https://example.com --use-ai --ai-budget 0.05
python -m argus --gen-consent example.com
python -m argus --verify-consent http
--domain example.com
--token verify-a3f9b2c1d8e4
python -m argus --target https://example.com --aggressive
---
## 🤖 التحليل القائم على الذكاء الاصطناعي
يستخدم Argus إصدار **LangChain 1.0.0** مع دعم لعدة مزودي ذكاء اصطناعي، مما يمنحك مرونة بناءً على متطلبات الأمان والخصوصية والميزانية لديك.
### المزودون المدعومون
#### OpenAI GPT-4 Turbo
**الأفضل لـ: الاستخدام الإنتاجي**
- ⭐ الجودة: ممتازة (5/5)
- ⚡ السرعة: ~35 ثانية
- 💰 التكلفة: ~$0.25 لكل فحص
- 🔒 الخصوصية: قياسية (البيانات مشفرة أثناء النقل)```bash
export OPENAI_API_KEY="sk-..."
python -m pip install langchain-openai==1.0.0
الأفضل لـ: خصوصية معززة
#### Ollama (النماذج المحلية)
**الأفضل لـ: خصوصية كاملة**
- ⭐ الجودة: جيدة (3/5)
- 🐢 السرعة: ~28 دقيقة (CPU) أو ~75 ثانية (GPU)
- 💰 التكلفة: مجاني
- 🔐 الخصوصية: 100% دون اتصال (البيانات لا تغادر جهازك أبدًا)```bash
# Install Ollama: https://ollama.ai
ollama pull llama3.2
python -m pip install "langchain-ollama>=0.3.0,<0.4.0"
التنظيف التلقائي قبل إرسال البيانات إلى مزودي الذكاء الاصطناعي، يزيل Argus تلقائيًا:
الاشتراك الاختياري فقط
--use-ai صريحًاللحصول على أقصى خصوصية استخدم Ollama محليًا. على الرغم من أنه أبطأ وأقل دقة، فإن بيانات الفحص لا تغادر جهازك أبدًا.
الخيار أ — أعلام سطر الأوامر (تجاوز وقت التشغيل، دون تحرير ملف)```bash
python -m argus --target https://example.com --use-ai --ai-provider anthropic --ai-model claude-3-5-haiku-20241022
python -m argus --target https://example.com --use-ai --ai-provider ollama --ai-model llama3.2
**الخيار B — `config/defaults.yaml` (تغيير الافتراضي الدائم)**```yaml
ai:
langchain:
provider: "ollama" # Changed from "openai"
model: "llama3.2" # Ollama model
ollama_base_url: "http://localhost:11434"
قادم في v0.3.0: قائمة تكوين تفاعلية (على غرار Metasploit)```bash
argus --show-options argus --set ai.provider=anthropic argus --save-profile privacy-mode
---
## 🧪 مختبر الاختبار الآمن
**⚠️ لا تقم أبدًا بفحص المواقع الإنتاجية دون إذن كتابي!**
استخدم مختبر Docker الخاص بنا للتدرب بأمان:
### إعداد بيئة الاختبار```bash
# Navigate to docker directory
cd docker
# Option 1: Use interactive script
./deploy.sh
# Select option 2 (Testing Lab)
# Option 2: Manual deployment
docker compose -f compose.testing.yml up -d
# Wait for services to start (~60-90 seconds)
docker compose -f compose.testing.yml logs -f wordpress
# Setup WordPress
# Open http://localhost:8080 in your browser
# Complete WordPress installation
# Username: admin
# Password: (choose a strong password)
# Create vulnerable conditions for testing
docker compose -f compose.testing.yml exec wordpress bash -c \
"cp /var/www/html/wp-config.php /var/www/html/wp-config.php.bak"
cd ..
python -m argus --target http://localhost:8080 --html
python -m argus --target http://localhost:8080 --use-ai --html
### تنظيف```bash
cd docker
docker compose -f compose.testing.yml down -v # -v removes all data
للاطلاع على سيناريوهات الاختبار التفصيلية، انظر docs/TESTING_GUIDE.md
لا تفحص سوى الأنظمة التي تملكها أو لديك إذن كتابي صريح لاختبارها.
تنفّذ Argus ضوابط تقنية لمنع إساءة الاستخدام:
الوصول غير المصرح به إلى أنظمة الحاسوب غير قانوني في معظم الأنظمة القانونية:
للاطلاع على الإرشادات الأخلاقية الكاملة، انظر docs/ETHICS.md
توفر Argus ثلاثة أوضاع للنشر عبر برنامج نصي تفاعلي:
استخدم البرنامج النصي التفاعلي للنشر:```bash cd docker ./deploy.sh
**خيارات القائمة:**
- `1` → الماسح الإنتاجي فقط
- `2` → مختبر الاختبار (WordPress + MariaDB) فقط
- `3` → كلا البيئتين
- `4` → إيقاف جميع الخدمات
- `5` → إزالة جميع الحاويات والبيانات (إعادة تعيين)
---
### الخيار 1: الماسح الإنتاجي
انشر ماسح Argus فقط لمسح مواقع WordPress الخارجية:```bash
cd docker
./deploy.sh
# Select option 1
أو يدويًا:```bash docker compose up -d
**مسح هدف:**```bash
docker compose exec argus python -m argus --target https://example.com
مع تحليل الذكاء الاصطناعي:```bash docker compose exec argus python -m argus --target https://example.com --use-ai
**توقف:**```bash
docker compose down
⚠️ تحذير: هذه البيئة مُعرَّضة للثغرات عمدًا لأغراض الاختبار. لا تعرّضها للإنترنت العام!
انشر مختبر الاختبار:```bash cd docker ./deploy.sh
**أو يدويًا:**```bash
docker compose -f compose.testing.yml up -d
ما الذي يتم نشره:
الوصول:
افحص بيئة الاختبار:```bash
python -m argus --target http://localhost:8080
**الإيقاف والإزالة:**```bash
docker compose -f compose.testing.yml down -v
انشر ماسح الإنتاج + مختبر الاختبار معًا:```bash cd docker ./deploy.sh
**ما الذي يتم نشره:**
- ✅ ماسح Argus الإنتاجي
- ✅ قاعدة بيانات MariaDB
- ✅ ووردبريس 6.0 (به ثغرات)
- ✅ الاتصال بين الماسح الإنتاجي وشبكة الاختبار
**فحص المواقع الخارجية من الماسح الإنتاجي:**```bash
docker compose exec argus python -m argus --target https://example.com
امسح مختبر الاختبار من الماسح الضوئي للإنتاج:```bash docker compose exec argus python -m argus --target http://wordpress
**إيقاف الكل:**```bash
cd docker
./deploy.sh
# Select option 4
~/.argos/ ├── reports/ │ ├── argus_report_example_20251020_143022.json # Machine-readable │ └── argus_report_example_20251020_143022.html # Human-friendly ├── argos.db # SQLite database └── logs/ └── argus.log # Scan logs
### مخطط تقرير JSON```json
{
"tool": "argus",
"version": "0.2.0",
"target": "https://example-wp-site.com",
"date": "2026-04-15T18:45:30Z",
"mode": "safe",
"summary": {
"critical": 1,
"high": 2,
"medium": 4,
"low": 3,
"info": 5
},
"findings": [
{
"id": "ARGUS-WP-012",
"title": "Vulnerable plugin: contact-form-7 v5.3.1 (6 CVEs)",
"severity": "critical",
"confidence": "high",
"owasp": { "id": "A06", "name": "Vulnerable and Outdated Components" },
"latest_version": "5.9.8",
"cve": ["CVE-2021-39346", "CVE-2020-35489"],
"vulnerabilities": [
{
"title": "Contact Form 7 < 5.3.2 — Unrestricted File Upload",
"cvss": 9.8,
"cve_id": "CVE-2020-35489",
"cwe": ["CWE-434"]
}
],
"description": "Plugin 'contact-form-7' v5.3.1 has 6 known CVEs. Highest CVSS: 9.8 (Critical).",
"evidence": {
"type": "path",
"value": "https://example-wp-site.com/wp-content/plugins/contact-form-7/readme.txt",
"context": "Version detected via readme.txt"
},
"recommendation": "Update contact-form-7 to 5.9.8 (latest stable). Immediate action required.",
"affected_component": "contact-form-7 5.3.1"
},
{
"id": "ARGUS-WP-030",
"title": "wp-config.php backup exposed",
"severity": "critical",
"confidence": "high",
"owasp": { "id": "A05", "name": "Security Misconfiguration" },
"description": "WordPress configuration file backup is publicly accessible.",
"evidence": {
"type": "url",
"value": "https://example-wp-site.com/wp-config.php.bak",
"context": "HTTP 200, Size: 2847 bytes"
},
"recommendation": "Remove immediately and rotate all credentials.",
"affected_component": "wp-config.php.bak"
},
{
"id": "ARGUS-WP-050",
"title": "Missing security header: HSTS",
"severity": "medium",
"confidence": "high",
"owasp": { "id": "A02", "name": "Cryptographic Failures" },
"description": "HSTS header is not set.",
"evidence": {
"type": "header",
"value": "Strict-Transport-Security: [not set]",
"context": "Header missing in HTTP response"
},
"recommendation": "Add: Strict-Transport-Security: max-age=31536000; includeSubDomains; preload"
}
],
"diff": {
"ref_scan_id": 41,
"ref_date": "2026-04-10T10:00:00Z",
"ref_mode": "safe",
"current_mode": "safe",
"mode_mismatch": false,
"new": [{ "id": "ARGUS-WP-012", "title": "Vulnerable plugin: contact-form-7...", "severity": "critical" }],
"fixed": [],
"persisting": [{ "id": "ARGUS-WP-050", "title": "Missing security header: HSTS", "severity": "medium" }]
},
"notes": {
"scan_duration_seconds": 26.4,
"requests_sent": 312,
"rate_limit_applied": true,
"scope_limitations": "Scan limited to publicly accessible pages.",
"false_positive_disclaimer": "Manual verification recommended before remediation."
}
}
للحصول على مرجع المخطط الكامل، انظر docs/REPORT_FORMAT.md و
schema/report.schema.json.
argus-wp-watcher/ │ ├── argus/ # Main application package │ ├── checks/ # Security check modules │ │ ├── config.py # Configuration auditing (XML-RPC, debug, editor) │ │ ├── crawl.py # Web crawl checks (robots, sitemap, comments) [v0.2.0] │ │ ├── files.py # Sensitive file detection (74 safe / 437 aggressive paths) │ │ ├── fingerprint.py # WordPress detection + CVE check for core │ │ ├── headers.py # Security headers analysis │ │ ├── login.py # Login security checks (2FA, CAPTCHA, brute-force) [v0.2.0] │ │ ├── plugins.py # Plugin/theme enumeration + CVE correlation [v0.2.0] │ │ └── users.py # User enumeration │ │ │ ├── core/ # Core infrastructure │ │ ├── ai.py # AI integration (LangChain, streaming, agent, compare) │ │ ├── config.py # Configuration management │ │ ├── consent.py # Consent token system │ │ ├── db.py # SQLite database interface │ │ ├── diff.py # Scan diff computation (new/fixed/persisting) [v0.2.0] │ │ ├── http_client.py # Rate-limited HTTP client │ │ ├── logging.py # Structured logging │ │ ├── owasp.py # OWASP Top 10 2021 mapping for all finding IDs [v0.2.0] │ │ ├── report.py # Report generation (JSON + HTML) │ │ └── vuln_db.py # CVE lookup (WPVulnerability.net + NVD) [v0.2.0] │ │ │ ├── main.py # Entry point │ ├── cli.py # CLI argument parser │ └── scanner.py # Main scan orchestrator │ ├── config/ # Configuration files │ ├── defaults.yaml # Default settings │ └── prompts/ # AI prompt templates │ ├── technical.txt # Technical analysis prompt │ └── non_technical.txt # Executive summary prompt │ ├── db/ │ └── migrate.sql # Database schema │ ├── assets/ │ └── ascii.txt # ASCII art branding │ ├── docker/ # Docker deployment │ ├── compose.yml # Production scanner compose │ ├── compose.testing.yml # Vulnerable WordPress lab │ ├── deploy.sh # Interactive deployment script │ ├── setup-lab.sh # Automated vulnerable lab setup [v0.2.0] │ └── Dockerfile # Production image │ ├── docs/ # Documentation │ ├── AI_INTEGRATION.md # AI setup guide │ ├── CONSENT.md # Consent system details │ ├── DATABASE_GUIDE.md # Database reference │ ├── ETHICS.md # Ethical guidelines │ ├── REPORT_FORMAT.md # Report specification │ ├── ROADMAP.md # Development roadmap │ └── TESTING_GUIDE.md # Safe testing practices │ ├── schema/ │ └── report.schema.json # JSON report schema │ ├── scripts/ │ └── cli-examples.md # CLI usage examples │ ├── templates/ │ └── report.html.j2 # HTML report template │ ├── CHANGELOG.md # Version history ├── LICENSE # MIT License ├── README.md # This file ├── requirements.txt # Python dependencies └── setup.py # Package installer
---
## 🗺️ خارطة الطريق
### v0.1.0 — الإصدار الأولي ✅ (نوفمبر 2025)
**الحالة:** 🎉 **تم الإصدار**
- ✅ ماسح أمان شامل لـ WordPress (أكثر من 130 فحصًا)
- ✅ تحليل مدعوم بالذكاء الاصطناعي (OpenAI, Anthropic, Ollama)
- ✅ نظام رمز الموافقة (التحقق عبر HTTP + DNS)
- ✅ تقارير احترافية (JSON + HTML)
- ✅ استمرارية SQLite وسجل الفحص
- ✅ دعم Docker مع مختبر قابل للاختراق
- ✅ معالجة شاملة للأخطاء والمرونة
### v0.2.0 — تحسين الكشف والذكاء الاصطناعي ✅ (مايو 2026)
**الحالة:** 🎉 **تم الإصدار**
- ✅ **كشف إصدار الإضافات**: سلسلة من 4 طرق (HTML ?ver=, readme.txt, changelog, PHP header)
- ✅ **ربط CVE في الوقت الفعلي**: WPVulnerability.net (مجاني، بدون مفتاح) للإضافات والثيمات ونواة WP
- ✅ **تسجيل CVSS**: NVD API — شارات حرجة/عالية/متوسطة/منخفضة ملوّنة لكل CVE
- ✅ **أحدث إصدار**: توفر واجهة WordPress.org API الإصدار المستقر الحالي إلى جانب الإصدار المكتشف
- ✅ **تعيين OWASP Top 10 2021**: يتم تعيين كل اكتشاف إلى A01–A10 مع شارة في تقرير HTML
- ✅ **تقارير HTML محسّنة**: شارات CVE/CWE/OWASP/CVSS، شريط تصفية، مقتطفات إعدادات، لوحات قابلة للتوسيع
- ✅ **تقارير اختلاف الفحص**: `--diff last` / `--diff ID` مع جديدة/مُصلحة/مستمرة، تحذير عدم تطابق الوضع
- ✅ **الوضع العدواني**: 447 إضافة، 437 مسارًا، أمان تسجيل الدخول (2FA/CAPTCHA/القوة الغاشمة)، زحف الويب
- ✅ **تتبع تكاليف الذكاء الاصطناعي**: فرض الميزانية، `~/.argos/costs.json`، سجلات التكلفة في قاعدة البيانات (جدول `ai_costs`)
- ✅ **بث الذكاء الاصطناعي**: `--ai-stream` لإخراج الرموز في الوقت الفعلي
- ✅ **مقارنة متعددة LLM**: `--ai-compare openai,anthropic` — تحليل متوازٍ جنبًا إلى جنب
- ✅ **وكيل الذكاء الاصطناعي**: `--ai-agent` مع استدعاءات مباشرة لأدوات NVD + WPVulnerability.net
### v0.3.0 — ميزات المؤسسات (الربع الثالث 2026)
**التركيز:** سهولة الاستخدام، قابلية التوسع، الذكاء الاصطناعي التفاعلي
- 🔜 **إدارة إعدادات تفاعلية**: واجهة على غرار Metasploit (`--show-options`, `--set`)
- 🔜 **واجهة سطر أوامر قاعدة البيانات**: لا يتطلب SQL (`argus db scans list`, `argus db findings search`)
- 🔜 **مسح متعدد المواقع**: معالجة دفعات من ملف
- 🔜 **واجهة محادثة بالذكاء الاصطناعي**: تحليل الثغرات بأسلوب المحادثة
- 🔜 **تكامل CI/CD**: قوالب GitHub Actions وJenkins وGitLab
- 🔜 **خادم REST API**: واجهة برمجية مبنية على FastAPI للأتمتة
**التحسينات المخطط لها:**
- إعداد تفاعلي (`--set`, `--show-options`) للتبديل الديناميكي بين المزودين
- تتبع إتمام المراحل ومؤشرات التقدم
- إدارة قاعدة البيانات عبر CLI (بدون الحاجة إلى SQL)
### v0.4.0 — الذكاء والأتمتة (الربع الأول 2027)
**التركيز:** التعلم الآلي، الأتمتة، الذكاء الاصطناعي المتقدم
- 🔜 **المعالجة الآلية**: تكامل WP-CLI للإصلاح التلقائي
- 🔜 **الكشف القائم على التعلم الآلي**: كشف الشذوذ، تقليل النتائج الإيجابية الخاطئة
- 🔜 **المسح الموزع**: عقد عاملة للعمليات واسعة النطاق
- 🔜 **وكلاء ذكاء اصطناعي متقدمون**: تخطيط المسح الذاتي، توليد الاستغلالات
### المسار الاحترافي
**منتج تجاري للمؤسسات**
**قيد التنفيذ**
للحصول على أوصاف مفصلة للميزات، راجع [ROADMAP.md](https://github.com/rodhnin/argus-wp-watcher/blob/HEAD/ROADMAP.md)
---
## 🤝 المساهمة
نرحب بالمساهمات! سواء كانت:
- 🐛 تقارير الأخطاء
- 💡 طلبات الميزات
- 📝 تحسينات التوثيق
- 🔧 المساهمات البرمجية
### كيفية المساهمة
1. **قم بعمل Fork للمستودع**
2. **أنشئ فرع ميزة** (`git checkout -b feature/amazing-feature`)
3. **قم بإجراء تغييراتك**
4. **اكتب/حدّث الاختبارات** (عند الاقتضاء)
5. **قم بتثبيت تغييراتك** (`git commit -m 'Add amazing feature'`)
6. **ادفع إلى الفرع** (`git push origin feature/amazing-feature`)
7. **افتح Pull Request**
### إعداد التطوير```bash
# Clone your fork
git clone https://github.com/YOUR-USERNAME/argus-wp-watcher.git
cd argus-wp-watcher
# Install development dependencies
python -m pip install -r requirements.txt
python -m pip install pytest black flake8 mypy
# Run code formatting
black argus/
# Run linting
flake8 argus/
mypy argus/
# Run tests (when available)
pytest tests/
وجدت خطأ؟ هل لديك طلب ميزة؟
افتح مشكلة: https://github.com/rodhnin/argus-wp-watcher/issues
يرجى تضمين:
python -m argus --version)python --version)التوثيق الشامل متاح في مجلد docs/:
هذا المشروع مرخّص بموجب رخصة MIT - راجع ملف LICENSE للحصول على التفاصيل.``` MIT License
Copyright (c) 2025 Rodney Dhavid Jimenez Chacin
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
---
## ⚠️ إخلاء مسؤولية
**مهم:** هذه الأداة مخصصة **لاختبار الأمان المصرح به فقط**.
### إشعار قانوني
باستخدامك لـ Argus، فإنك تقر وتوافق على ما يلي:
1. ✅ ستقوم **بفحص الأنظمة التي تملكها فقط** أو التي لديك **إذن كتابي صريح** لاختبارها
2. ✅ ستلتزم **بجميع القوانين واللوائح المعمول بها**
3. ✅ أنت تدرك أن **الوصول غير المصرح به غير قانوني** (CFAA، قانون إساءة استخدام الحواسيب، إلخ.)
4. ✅ المؤلف والمساهمون **لا يتحملون أي مسؤولية** عن سوء الاستخدام
5. ✅ يتم توفير هذا البرنامج **"كما هو" دون أي ضمان** من أي نوع
### الإفصاح المسؤول
إذا اكتشفت ثغرات باستخدام Argus:
- 📧 تواصل مع مالك الموقع على انفراد أولاً
- ⏰ امنح وقتًا معقولًا للإصلاح (عادةً 90 يومًا)
- 🤝 نسّق الجدول الزمني للإفصاح
- 📝 وثّق نتائجك بشكل احترافي
### عند الشك
**لا تقم بالفحص.** إذا لم تكن متأكدًا مما إذا كان لديك إذن، فغالبًا لا تملكه.
---
## 🙏 شكر وتقدير
يقف Argus على أكتاف العمالقة:
- **WordPress.org** — فريق الأمان للتوثيق وأفضل الممارسات
- **WPScan** — أبحاث الثغرات وقاعدة البيانات
- **OWASP** — معايير الأمان (أفضل 10، دليل الاختبار)
- **LangChain** — إطار عمل الذكاء الاصطناعي الذي يشغّل التحليل الذكي
- **Anthropic & OpenAI** — نماذج الذكاء الاصطناعي لتحليل الثغرات
- **Ollama** — استدلال الذكاء الاصطناعي المحلي للفحص المراعي للخصوصية
- **Python Community** — مكتبات وأدوات مذهلة
شكر خاص لجميع باحثي الأمان الذين يمارسون ويعززون الاختراق الأخلاقي.
---
## 👤 المؤلف
**Rodney Dhavid Jimenez Chacin (rodhnin)**
- 🌐 الموقع والتواصل: [rodhnin.com](https://rodhnin.com)
- 💼 GitHub: [@rodhnin](https://github.com/rodhnin)
- 🔗 المشروع: [argus-wp-watcher](https://github.com/rodhnin/argus-wp-watcher)
للاستفسارات أو الملاحظات أو طلبات التعاون، يرجى زيارة [rodhnin.com](https://rodhnin.com) للتواصل معي.
---
## 💬 المجتمع
- **المناقشات**: [GitHub Discussions](https://github.com/rodhnin/argus-wp-watcher/discussions)
- **المشكلات**: [GitHub Issues](https://github.com/rodhnin/argus-wp-watcher/issues)
- **الإصدارات**: [GitHub Releases](https://github.com/rodhnin/argus-wp-watcher/releases)
---
<div align="center">
**صُنع بكل ❤️ لصالح المخترقين الأخلاقيين ومسؤولي ووردبريس في جميع أنحاء العالم**
⭐ **قم بوضع نجمة على هذا المستودع** إذا وجدته مفيدًا! ⭐
[الإبلاغ عن خطأ](https://github.com/rodhnin/argus-wp-watcher/issues) • [طلب ميزة](https://github.com/rodhnin/argus-wp-watcher/issues) • [التوثيق](https://github.com/rodhnin/argus-wp-watcher/blob/HEAD/docs/)
---
_Argus v0.2.0 — مايو 2026_
</div>
| فئة الفحص | الوضع الآمن | الوضع الهجومي | التفاصيل |
|---|
| اكتشاف WordPress | ✅ | ✅ | تحديد بصمة الإصدار عبر وسوم meta وملف readme وRSS والأصول |
| الإضافات والثيمات | 100 إضافة | 447 إضافة | اكتشاف الإصدار (4 طرق) + ارتباط فوري بـ CVE/CVSS |
| الملفات الحساسة | 74 مسارًا | 437 مسارًا | نسخ احتياطية لـ wp-config و.env وملفات SQL dump و.git وسجلات التصحيح وأدوات PHP |
| تعداد المستخدمين | 3 طرق | 6 طرق | معرّف المؤلف IDOR وREST API وتحليل HTML + oEmbed ورسالة خطأ تسجيل الدخول وXML-RPC |
| ترويسات الأمان | ✅ | ✅ | HSTS, CSP, X-Frame-Options, Referrer-Policy, Permissions-Policy |
| سوء الإعدادات | ✅ | ✅ | XML-RPC، وضع التصحيح، عرض الدليل، محرر الملفات |
| أمان تسجيل الدخول | ❌ | ✅ | 2FA، CAPTCHA، حماية من القوة الغاشمة، تسجيل مفتوح، سياسة كلمات المرور |
| زحف الويب | ❌ | ✅ | robots.txt وsitemap.xml وتعليقات HTML واكتشاف الروابط (عمق 1) |
| المزود | الأنسب لـ | السرعة | التكلفة/الفحص | الخصوصية |
|---|
| OpenAI gpt-4o-mini (الافتراضي) | أفضل قيمة | ⚡ ~40s | 💰 ~$0.006 | 🔒 قياسية |
| OpenAI gpt-4o | جودة إنتاجية | ⚡ ~40s | 💰 ~$0.05 | 🔒 قياسية |
| Anthropic claude-3-5-haiku | تركيز على الخصوصية | ⚡ ~55s | 💰 ~$0.02 | 🔒 معززة |
| Ollama (محلي) | خصوصية كاملة | 🐢 ~28min | 💰 مجاني | 🔐 100% دون اتصال |
| الوضع | الفحوصات | الموافقة المطلوبة | معدل الطلبات |
|---|
| Safe | غير تطفلي | ❌ لا | 5 req/s |
| Aggressive | فحص عميق | ✅ نعم | 10 req/s |
| AI Analysis | تحليل الثغرات | ✅ نعم | N/A |
| المستند | الوصف |
|---|
| AI_INTEGRATION.md | دليل إعداد الذكاء الاصطناعي الكامل (جميع المزودين الثلاثة) |
| CONSENT.md | التفاصيل الفنية لنظام رمز الموافقة |
| DATABASE_GUIDE.md | مخطط SQLite والاستعلامات والإدارة |
| ETHICS.md | الإطار القانوني والمبادئ التوجيهية الأخلاقية |
| REPORT_FORMAT.md | مخطط JSON ومواصفات HTML |
| TESTING_GUIDE.md | الاختبار الآمن باستخدام مختبر Docker |
| ROADMAP.md | الميزات المستقبلية وخطط التطوير |