New releaseAug 5, 2026
pentest-ai v1.2.0
مختبِر اختراق بالذكاء الاصطناعي مفتوح المصدر يُثبت كل اكتشاف. أوراكل آلية تعيد تنفيذ كل استغلال؛ والثغرات المؤكَّدة تُصدِر كبسولة إثبات يمكنك إعادة تشغيلها بنفسك.
pentest-ai
أداة اختبار الاختراق التي تُثبت نتائجها. لا أوراكل، لا شارة.
الموقع · التثبيت · لماذا التحقق · التوثيق · المعايير · الوكلاء · ديسكورد
⚠️ أدوات هجومية، للاختبار المصرّح به فقط. بقبولك التثبيت فأنت توافق على اتفاقية الاستخدام المقبول والشروط. النص الكامل في الاستخدام المسؤول ↓
ptai هي أداة اختبار اختراق مدفوعة بالذكاء الاصطناعي تعيد تشغيل كل استغلال للتأكد منه. وهي تنفّذ مرحلة الاستطلاع، وتسجّل الدخول، وتربط النتائج في مسارات هجوم متعددة الخطوات، لكنها لا تطلب منك أن تثق بالنتائج. كما تؤكد TruffleHog سرًّا مكشوفًا بتسجيل الدخول به، تؤكد ptai نتيجة الويب بإعادة تشغيل الاستغلال: تبقى النتيجة مرشحة حتى يعيد إنتاجها مُوثِّق آلي (oracle) N من أصل N، وعندها فقط تستحق شارة VERIFIED. مخرجات الماسحات الخارجية (nuclei وnikto وzap) تُحتجز حتى يعيد مُوثِّق التحقق إثباتها. ضجيج الماسحات هو ما يدرّب الفرق على تجاهل أدواتهم، لذا لا يحمل التقرير إلا ما استطاعت ptai إثباته، وكل نتيجة VERIFIED تأتي مع كبسولة إثبات قابلة للنقل يمكنك إعادة تشغيلها بنفسك.
اليوم، هناك 14 فئة ثغرات تم التحقق منها عبر oracle. في بيئة اختبار (honeypot) معرّضة للاختراق عمدًا، تتحقق 23 نتيجة عبر تلك الفئات بدقة 100% دون أي نتائج إيجابية كاذبة. وعلى نسخة OWASP Juice Shop قياسية، تتحقق 12 نتيجة في فحص واحد. تعمل على حاسوبك المحمول. لا سحابة، ولا تليمترية.
شاهدها تعمل
فحص نسخة OWASP Juice Shop قياسية: تم التحقق من 12 نتيجة عبر oracle في فحص واحد. النتائج حقيقية؛ تم ضبط التوقيت لسهولة المشاهدة.
أعد إنتاج الفكرة الأساسية بنفسك في دقيقتين، دون الحاجة إلى هدف خاص بك:```bash pip install ptai && ptai demo
`ptai demo` يفحص تطبيقًا معرّضًا مرفقًا ويُبلغ عن `4 findings, 4 oracle-VERIFIED`، ويعيد تشغيل واحدة مباشرة من كبسولة إثبات (`replay 3/3`)، ثم يشغّل المسارات نفسها بشكل محصّن ويُبلغ عن `0 findings`. الشيء الوحيد الذي تغيّر بين التشغيلتين هو الإصلاح، لذا تظهر النتائج وتختفي مع الثغرة، وليس لأن الأداة صمتت. دقيقتان، بدون مفتاح API، وبدون هدف خاص بك. أعد إثبات أي كبسولة بنفسك باستخدام `ptai replay`.
> **أرقام صادقة.** تشغيل honeypot (23 نتيجة مُتحقَّقًا منها عبر 14 فئة، دقة 100%، صفر نتائج إيجابية كاذبة) وتشغيل Juice Shop (12 نتيجة مُتحقَّقًا منها في فحص واحد) هما معياران فرديان قابلان لإعادة الإنتاج، وليسا معدّلات إيجابيات كاذبة ميدانية. بوابة الأوراكل تشتري الدقة، لا معدل الاكتشاف: فهي تزيل الإيجابيات الكاذبة، ولا ترفع مستوى الكشف. Juice Shop هو التطبيق المعرّض الأكثر دراسة على الإنترنت، لذا اقرأ حجمه الخام على أنه اتساع، وعدد النتائج المُتحقَّق منها على أنه قصة الدقة؛ أما honeypot، بأخطائنا التي كتبناها بأنفسنا، فهو الإشارة الصادقة. بيئة honeypot (`tests/honeypot/`) وبوابة تطبيق نظيف بصفر نتائج إيجابية كاذبة (`tests/cleanapp/`) مضمّنة في المستودع، لذا فالمزاعم قابلة لإعادة الإنتاج وليست مجرد لقطات شاشة.
## ما الجديد في 1.1.0
تغطية التحقق تضاعفت تقريبًا، ولم يعد الفحص يُبلغ عن صفر على هدف أسقطه أثناء التشغيل. كل نتيجة VERIFIED تأتي من أوراكل آلي مسمّى، وليس أبدًا من تأكيد LLM، وهو ما يُفرَض في الكود: أي حكم لا يمكنه تسمية أوراكله يُرفض. هذا الإصدار يضيف:
- **عشر فئات أوراكل جديدة (14 إجمالًا).** تجاوز الترويسة الموثوقة، JWT `alg:none`، تسميم ترويسة المضيف، XXE، الالتباس النوعي، XSS المخزّن، IDOR التسلسلي، الإسناد الجماعي، SSRF غير الأعمى، وتجاوز تسجيل الدخول عبر SQLi، إلى جانب SQLi (boolean/blind) وBOLA/IDOR وXSS المنعكس وإعادة التوجيه المفتوحة واجتياز المسار. لكل أوراكل عنصر تحكم يجب أن يفشل على هدف آمن، بحيث يمتنع تطبيق غير معرّض للخطر عن الإبلاغ بدلًا من الحصول على شارة.
- **مرونة التحقق.** كان بإمكان مسح عدواني أن يُسقط هدفًا هشًا بحاوية واحدة، وبعد ذلك تفشل مرحلة التحقق في كل أوراكل وتُبلغ عن 0 رغم وجود وصفات صالحة وقابلة لإعادة التشغيل. الآن ينتظر حتى يستجيب الهدف مجددًا قبل إعادة الإثبات، وهو ما رفع فحص OWASP Juice Shop من 0 إلى 12 نتيجة مُتحقَّقًا منها عبر الأوراكل.
- **أمان النطاق.** الأدوات النشطة (sqlmap, dalfox) مقيدة بمضيف الهدف في نطاق الاختبار؛ لم يعد الفحص يغذّي أدوات الهجوم بعناوين URLs لأطراف ثالثة مستخرجة من محتوى الصفحة.
- **كبسولات إثبات محمولة** مع `ptai replay`، وواجهة TUI مباشرة تقلب الأحكام إلى VERIFIED على الشاشة، وبوابة CI (`--fail-on verified`) لا تكسر البناء إلا عند وجود نتائج مثبتة.
## على هدف حقيقي: OWASP Juice Shop
عند توجيهه إلى نسخة OWASP Juice Shop قياسية، **يتحقق ptai عبر الأوراكل من 12 نتيجة في فحص واحد**: قبول JWT `alg:none` على نقاط النهاية المحمية، وقراءات BOLA عبر المستخدمين، وIDOR التسلسلي، والالتباس النوعي، وكل منها يُعاد إثباته بواسطة أوراكل آلي وليس مجرد تأكيد. يكتشف أكثر مما يتحقق منه (تجاوز مصادقة SQLi على `/rest/user/login`، UNION SQLi على `/rest/products/search`، XXE يكشف `/etc/passwd`، الإسناد الجماعي، تجاوز إعادة تعيين كلمة المرور)؛ فقط المجموعة الفرعية المُتحقَّق منها تصل إلى التقرير. شغّله عبر Claude Code من خلال MCP بدون مفتاح API، أو بشكل مستقل.
> **ملاحظة صراحة.** Juice Shop هو التطبيق المعرّض الأكثر توثيقًا على الإنترنت، لذا فإن كلاً من LLM ومؤلفي مسابر الفحص يمتلكان أفضلية مسبقة. أما مع هدف جديد، فإن معدل الاكتشاف هو ما تغطيه مكتبة المسابر المنتقاة (أكثر من 60 مسبار ويب اليوم، وتزداد مع كل إصدار)؛ إذ ينسق LLM النتائج ويستنتج عنها، لكنه لا يحل محل المسابر. بيئة honeypot خاصة في `tests/honeypot/` تقيس التغطية مقابل أخطاء كتبناها بأنفسنا، ويتم تأكيدها في CI (`tests/honeypot/test_mcp_honeypot_e2e.py`)؛ أرقامها أقل من Juice Shop، وهذه هي النقطة. ننشر كلاهما. انظر المعيار الكامل [معيار Juice Shop مقابل ZAP / Nuclei / HexStrike](https://github.com/0xsteph/pentest-ai/blob/HEAD/docs/benchmarks/juice-shop.md).
## التثبيت```bash
pip install ptai
المسار 1: قم بتشغيله من Claude Code (بدون مفتاح API)
إذا كنت تدفع بالفعل مقابل Claude Pro / Max / Team، فإن اشتراكك هو LLM. قم بتوصيل ptai كخادم MCP:```bash claude mcp add pentest-ai -- ptai mcp
أعد تشغيل Claude Code، ثم اطلب:
> *"قم بإجراء اختبار اختراق مصادق ضد staging.acme.com. تسجيل الدخول على /login، وكلمة المرور في $APP_PASS."*
> **ما الذي يصل إلى الشبكة**: أدوات ptai وفحوصاته تعمل محليًا ضد هدفك. طلباتك ومخرجات الأدوات التي يقرأها Claude Code تمر عبر Anthropic API، تمامًا مثل أي جلسة Claude Code. إذا كنت بحاجة إلى مسار معزول عن الشبكة، راجع المسار 3 (Ollama / LLM محلي).
يتحكم Claude Code في ptai عبر أدوات MCP التالية (47 منها اليوم):
- `list_tools` / `run_tool`: سرد واستدعاء أيٍّ من أكثر من 200 أداة أمنية مغلفة
- `plan_tools` / `ensure_tools_installed`: الحصول على القائمة الرسمية للأدوات لمهمة، مع تثبيت مجمّع
- `list_probes` / `run_probe`: 60 فحصًا مراعيًا لتطبيقات SPA لفئات الثغرات في OWASP Top 10
- `http_request`: HTTP خام تحت حارس نطاق صارم لسلاسل هجوم جديدة
- `start_engagement` / `get_findings` / `get_attack_chains`: سجل المهمة
- بالإضافة إلى `test_web_app` و`test_active_directory` و`test_cloud` و`test_api_security` وغيرها
### المسار 2: عملاء MCP آخرون (Cursor و VS Code Copilot و Codex و Claude Desktop)```bash
ptai setup --mcp
يكتشف تلقائيًا كل عميل متوافق مع MCP قمت بتثبيته ويكتب ملفات الإعداد الخاصة به. أعد تشغيل العميل وستجد نفس الأدوات الـ 47 هناك.
المسار 3: CLI مستقل عندما لا يكون لديك عميل MCP
إذا كنت تستخدم Claude Code أو Cursor أو Codex أو Claude Desktop، فاستخدم المسار 1 أو 2 أعلاه وتخطَّ هذا القسم. لا حاجة لمفتاح API هناك.
المسار 3 مخصص لخطوط أنابيب CI/CD، ووظائف cron المجدولة، والأجهزة الطرفية المعزولة عن الشبكة، والمستخدمين الذين ليس لديهم عميل MCP. لا يمتلك CLI المستقل LLM خاصًا به، لذا يمكنك توفيره عبر متغير بيئة:```bash export ANTHROPIC_API_KEY=sk-ant-... # Claude (best results)
or
export OPENAI_API_KEY=sk-... # OpenAI
or, fully local, no cloud
export PENTEST_AI_LLM_PROVIDER=ollama # Ollama (default localhost:11434)
or, any of 300+ models via LiteLLM (OpenRouter, Azure, DeepSeek, Groq, Mistral, ...)
pip install litellm
ptai start https://your-target.com
هل تستخدم نقطة نهاية متوافقة مع OpenAI (DeepSeek cloud، Groq، Together AI، vLLM، وغيرها)؟ اضبط `OPENAI_BASE_URL` + `PENTEST_AI_MODEL` واستخدم موفّر openai. الوصفات الكاملة لكل موفّر - بما في ذلك أسماء النماذج المخصصة، واستكشاف الأخطاء وإصلاحها، وقائمة LiteLLM التي تضم أكثر من 300 - موجودة في [`docs/llm-providers.md`](https://github.com/0xsteph/pentest-ai/blob/HEAD/docs/llm-providers.md).
#### حد الإنفاق (المسار 3 فقط)
حلقة الوكيل المستقلة تشغّل نموذجها اللغوي الخاص، لذا فإن الحلقات الجامحة تكلف أموالًا حقيقية. يحدّ ptai الإنفاق لكل عملية بمبلغ **10 دولارات أمريكية افتراضيًا**. مسح عادي لتطبيقات الويب باستخدام Sonnet 4.6 مع التخزين المؤقت للـ prompt ينتهي بأقل من ذلك بكثير؛ بينما قد يتجاوزه تشغيل عميق عبر Opus 4.7.
غيّره عبر متغير بيئة (لا يوجد خيار CLI - متغير البيئة هو المقبض الوحيد):```bash
export PTAI_PRICE_LIMIT=25 # raise to $25
export PTAI_PRICE_LIMIT=0 # unlimited (logs a warning)
unset PTAI_PRICE_LIMIT # back to the $10 default
إذا انطلق الحد الأقصى في منتصف الجلسة، تُعلَّم الجلسة باسم aborted_cost_limit ويتم الحفاظ على نقطة التوقف الخاصة بها. ارفع الحد واستأنف من حيث توقف:```bash
export PTAI_PRICE_LIMIT=25
ptai resume <engagement_id>
المساران 1 و2 (MCP) لا يستخدمان هذا السقف - عميل الذكاء الاصطناعي الخاص بك (Claude Code، Cursor، إلخ.) يدير فوترة LLM الخاصة به.
### تثبيت أدوات الأمان
ptai يغلّف أكثر من 200 أداة خارجية. ثلاث طرق لتثبيتها على الجهاز:```bash
# 1. Zero-config (recommended). At engagement start, the planner predicts
# which tools the LLM will need and asks ONCE to install the missing
# ones. Decline once and the answer persists in
# ~/.pentest-ai/install-preferences.json.
ptai start https://target.example.com
# 2. Batch install upfront. Skips the engagement-time prompt entirely.
ptai setup --tier core # ~6 essentials, ~30s
ptai setup --tier recommended # + fuzzers, crawlers, password tools, ~5m
ptai setup --tier full # everything, ~30m
# 3. Install specific tools by name.
ptai setup --per-tool wpscan,dalfox,paramspider
ptai setup --wizard # interactive picker
في السياقات غير التفاعلية (PTAI_NON_INTERACTIVE=1 أو بدون TTY) يستخدم ptai ما هو موجود في PATH ويسجّل (بدلاً من المطالبة) لأي شيء مفقود.
مسارات أخرى: REST API, MCP composition, HITL teleoperation, cloud workspace, public benchmarks
HTTP REST API (لوحات المعلومات والتكاملات)```bash
pip install ptai[api] ptai serve --port 8888
نقاط النهاية: `/health`, `/version`, `/agents`, `/tools`, `/engagements` (القائمة، التفاصيل، النتائج، السلاسل، قواعد الكشف، تصدير SARIF). تتطلب نقاط نهاية الكتابة (`POST /engagements`, `POST /engagements/{id}/abort`) رأس `Authorization: Bearer $PENTEST_AI_API_TOKEN`. بث مباشر للأحداث على `WS /engagements/{id}/stream`.
### تحميل خوادم MCP أخرى كمصادر أدوات
ادمج مع hexstrike أو أي خادم أمني آخر متوافق مع MCP. عدّل `~/.pentest-ai/mcp_servers.json`:```json
{
"servers": [
{"name": "hexstrike", "command": "python3 hexstrike_mcp.py", "transport": "stdio"}
]
}
الاستيلاء في منتصف التشغيل (التحكم عن بُعد HITL)
أثناء تشغيل جلسة الاختبار، اضغط على Ctrl+C مرتين خلال 600ms لإيقاف المُنسِّق مؤقتًا والدخول إلى REPL: step, inspect findings, inject <instruction>, skip, resume, abort. نماذج اللغة الكبيرة الحالية ليست مستقلة تمامًا. المشغِّل هو صاحب القرار في اللحظات الحاسمة.
المعايير العامة
توجد قياسات معدل الحل القابلة لإعادة الإنتاج في benchmarks/:```bash
./benchmarks/scripts/run_all.sh # writes JSON per run + RESULTS.md
المواصفات، وأداة الاختبار، والنتائج كلها في git. المقارنة الكاملة مع Juice Shop مقابل ZAP / Nuclei / HexStrike موجودة في [`docs/benchmarks/juice-shop.md`](https://github.com/0xsteph/pentest-ai/blob/HEAD/docs/benchmarks/juice-shop.md). لا توجد ادعاءات "معدل اكتشاف 98.7%" لا يمكنك تدقيقها.
### مساحة عمل سحابية (Pro / Team / Enterprise)
واجهة CLI مجانية إلى الأبد وتخزّن كل شيء محليًا. إذا كنت تريد سجل المهام، وتقارير PDF بعلامتك التجارية وجاهزة للعميل، وتعاون الفريق، اربط واجهة CLI بمساحة عمل [app.pentestai.xyz](https://app.pentestai.xyz):```bash
# Sign up, then Dashboard -> API Keys -> Generate -> copy ptai_...
ptai auth login # paste the key (hidden prompt)
ptai auth status # confirm link
# or use an env var for CI:
export PENTESTAI_API_KEY=ptai_...
ptai start يقوم بمزامنة النتائج تلقائيًا إلى مساحة العمل السحابية الخاصة بك عند تسجيل الدخول. لا سحابة = لا اتصالات؛ التكامل يكون معطلاً بصمت إلا إذا قمت بتسجيل الدخول.
بدون LLM إطلاقًا (مشغّل تفاعلي)```bash
ptai menu
التنقل بين الفئات باستخدام الأرقام، البحث (`/term`)، تصفية الوسوم (`t web`)، والتوصية المستندة إلى الكلمات المفتاحية. لا تزال الاختبارات الفعلية تتم عبر `ptai start` مع تأكيد النطاق بالكامل.
</details>
## لماذا يختلف عن غيره
| | |
|---|---|
| 🤖 **منسّق عبر LLM، وليس معتمدًا على LLM** | تغطي سبعة عشر وكيلًا: الاستطلاع، الويب، API، AD، السحابة، الجوال، اللاسلكي، المتصفح، بيانات الاعتماد، رفع الامتيازات، فحص الثغرات، التسلسل الهجومي، PoC، الكشف، إعداد التقارير، الهندسة الاجتماعية، والفريق الأحمر لـLLM. يدير LLM حلقة المراحل ويحلل النتائج؛ اكتشاف العيوب يتم عبر مكتبة الاستقصاءات الحتمية المنتقاة بعناية. وإذا لم تضبط أي مفتاح API، فإن نفس الاستقصاءات تعمل. LLM ينسّق فقط؛ ولا يفحص. |
| 🔓 **لا يتطلب مفتاح API على مسار MCP** | يستخدم مستخدمو Claude Code / Cursor / Codex أداة ptai عبر MCP من خلال اشتراكهم الحالي. أكثر من 200 غلاف أدوات و60 استقصاءً قابلة للاستدعاء عبر LLM دون مفتاح Anthropic. في واجهة CLI المستقلة (`ptai start --agent-mode`) فقط يكون مفتاح API مطلوبًا؛ وهي المسارات الخاصة بـ Codex بدون MCP، وCI، والبيئات المعزولة. |
| 🔐 **يسجّل الدخول** | تفشل معظم الماسحات عند صفحة تسجيل الدخول. هذه الأداة تحافظ على الجلسة، وتُجدّد بيانات الاعتماد عند انتهاء صلاحيتها، وكل أداة لاحقة ترث الكوكيز. تخزّن ملفات تعريف المصادقة *مراجع* (متغيرات البيئة، `op://`، مسارات Vault، ARNs الخاصة بـ AWS Secrets Manager)، ولا تخزّن القيمة نفسها أبدًا. |
| 🧪 **كل نتيجة مُثبتة** | يتم تنفيذ إثبات مفهوم غير تخريبي ضد الهدف. لا مزيد من فرز 40 نتيجة محتملة من ماسح مزعج. |
| ⚡ **مصمم أصلاً لـCI** | إجراء GitHub Action، بوابات الخطورة، مخرجات SARIF، تعليقات PR. أضِفه إلى ملف سير العمل لديك وسيعمل عند طلب السحب التالي. |
| 💾 **يعمل على حاسوبك المحمول** | مرخّص بموجب MIT، دون أي اتصالات سحابية. يعمل دون اتصال مع Ollama. تبقى النتائج على قرصك. |
## كيف يعمل```
┌─────────────────────────────────────────────────────────────┐
│ ptai start <target> │
└─────────────────────────────────────────────────────────────┘
│
┌──────────────────┼──────────────────┐
▼ ▼ ▼
┌────────┐ ┌────────┐ ┌─────────┐
│ recon │ -> │ auth │ -> │ web │
└────────┘ └────────┘ └─────────┘
│
┌────────────────────────────────────┤
▼ ▼
┌────────┐ ┌─────────┐
│ ad │ ┌──────────────────┐ │ cloud │
└────────┘ │ Findings DB │ └─────────┘
│ │ (sqlite + evidence)│ │
└───────▶│ scope-guarded │◀──────┘
│ deduplicated │
└──────────────────┘
│
┌────────────┼────────────┐
▼ ▼ ▼
┌──────┐ ┌─────────┐ ┌──────────┐
│chain │ │validate │ │ detect │
└──────┘ └─────────┘ └──────────┘
│
▼
┌──────────┐
│ report │ md · html · pdf · SARIF · JUnit
└──────────┘
كل وكيل يعمل مع LLM إذا قمت بتعيين مفتاح، أو كحلقة أدوات حتمية إذا لم تقم بذلك. وفي كلتا الحالتين، ترتيب المراحل هو نفسه.
الوكلاء
| الوكلاء | المرحلة | الوظيفة |
|---|---|---|
recon | 1 | فحص المنافذ، تعداد DNS والنطاقات الفرعية، بصمة الخدمات |
web | 2 | اجتياز موثّق لدليل اختبار OWASP Testing Guide الإصدار الرابع |
api_security | 2 | تحليل سطح OpenAPI/GraphQL/REST، OWASP API Top 10 |
browser | 2 | تحليل DOM عبر Playwright، التقاط XHR، تصنيف رؤوس الأمان |
ad | 3 | تعداد Active Directory، Kerberoasting، تحديد مسار BloodHound، إساءة استخدام التفويضات |
cloud | 4 | AWS و Azure و GCP IAM، إعدادات خاطئة، K8s RBAC، serverless |
credential_tester | 4 | رش كلمات المرور، حشو البيانات الاعتمادية، فحوصات تجاوز MFA |
privesc | 5 | نصائح حول تصعيد الامتيازات المحلية والعرضية من السياق المجمّع |
vuln_scanner | 5 | تجميع شامل للثغرات عبر قاعدة بيانات النتائج |
exploit_chain | 6 | ربط النتائج في مسارات هجوم متعددة الخطوات |
poc_validator | 7 | إثبات مفهوم غير مدمر لكل نتيجة |
detection | 8 | قواعد Sigma و SPL و KQL للفريق الأزرق |
report | 9 | Markdown و HTML و PDF و SARIF و JUnit وخرائط الامتثال |
llm_redteam | اختياري | استطلاعات OWASP LLM Top 10 |
social_engineer | اختياري | توليد نصوص التصيد والحجج |
mobile | اختياري | فحوصات Android/iOS الثابتة والديناميكية |
wireless | اختياري | استطلاع الشبكات اللاسلكية والتقاط المصافحة |
أدلة التشغيل
منهجيتك كملف. يتم إيداعها في git. تتم مشاركتها مع فريقك.```yaml name: internal-ad-pentest inputs: domain: { required: true, prompt: "AD domain" } dc_ip: { required: true, prompt: "DC IP" }
phases:
-
id: recon tools: [nmap, masscan]
-
id: ad-enum depends_on: [recon] condition: "any_finding(type='open_port', port=445)" tools: [enum4linux, ldapsearch, bloodhound-python]
-
id: kerberoast requires_finding: { type: ad_user_enumerated } tools: [impacket-getuserspns] llm_decide: true # let the LLM skip if context says useless
لم يتم توفير أي محتوى في الإدخال (INPUT) لترجمته. الرجاء إرسال النص المطلوب ترجمته.```bash
ptai playbook list # show installed playbooks
ptai playbook show web-app-quick # preview before running
ptai playbook run ./my-ad.yaml # execute
خمسة دفاتر تشغيل مدمجة. كتالوج المجتمع قادم.
ضعها في CI الخاص بك```yaml
.github/workflows/security.yml
name: Security scan on: [pull_request]
jobs:
ptai:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: pip install ptai
- run: |
ptai start ${{ vars.STAGING_URL }}
--ci
--fail-on high
--sarif pentest.sarif
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
- uses: github/codeql-action/upload-sarif@v3
if: always()
with:
sarif_file: pentest.sarif
Findings post as a PR comment، SARIF uploads to GitHub Code Scanning، ويفشل البناء عند حد الخطورة المحدد. قوالب **GitLab CI و Jenkins** بالإضافة إلى خيارات متقدمة (ملفات تعريف المصادقة في CI، بوابات التكلفة، ملفات النطاق) -> [docs/ci-cd.md](https://github.com/0xsteph/pentest-ai/blob/HEAD/docs/ci-cd.md).
## المعايير
تصميم ptai مبني خصيصًا لاختبار اختراق تطبيقات SPA مع تغطية فحوصات منسقة. على OWASP Juice Shop، أظهرت [مصفوفة الأدوات الأربع](https://github.com/0xsteph/pentest-ai/blob/HEAD/docs/benchmarks/juice-shop.md) المنشورة:
| الأداة | النتائج | حرجة+عالية | مجموعات OWASP Top 10 | معدل FP |
|---|---:|---:|---:|---:|
| **ptai 0.13.0** | **88** | **46** | **5** | **0%** |
| ZAP 2.17.0 | 593 | 0 | 1 | 47% |
| Nuclei 3.8.0 | 1 | 0 | 1 | 0% |
| HexStrike v6.0 | 11 | 0 | 1 | - |
n=1 بمُقيّم واحد ومحاولة واحدة. المنهجية والملفات الأولية في [`benchmarks/results/2026-05-12/juice-shop/`](https://github.com/0xsteph/pentest-ai/blob/HEAD/benchmarks/results/2026-05-12/juice-shop/). القراءة الصادقة: ptai أفضل في اختبارات اختراق تطبيقات الويب SPA مع تغطية فحوصات منسقة. أما HexStrike فهو أوسع نطاقًا (سحابي، ثنائي، CTF) ومن المحتمل أن يتفوق على ptai في الأسطح القابلة للزحف التقليدية مثل WordPress. ستعمل الإصدارات المستقبلية على توسيع المقارنة.
سياق الأبحاث الحديثة: عوامل اختبار الاختراق بالـ LLM المستقلة تمامًا تُنهي **21-31%** من المهام من البداية إلى النهاية؛ بينما تصل الإعدادات بمساعدة بشرية إلى **64%** (ARTEMIS, DARPA AICC Atlantis, xOffense). صُمم ptai لنمط المساعدة البشرية: يقيّم الـ LLM النتائج، وتكتشف الفحوصات المنسقة، ويتيح الضغط على Ctrl+C مرتين للمشغّل تولي المهمة.
## مقارنة مع الأدوات الأخرى
| | `ptai` | Hexstrike | ZAP | Nuclei | Burp Pro | PentestGPT |
|---|:-:|:-:|:-:|:-:|:-:|:-:|
| مدفوع بالـ LLM عبر MCP (بدون مفتاح API) | ✓ | ✓ | | | | |
| HTTP مُصنَّع بالـ LLM ضمن حماية النطاق | ✓ | جزئي | | | | |
| فحص مصادق عبر MCP | ✓ | جزئي | جزئي | HTTP خام | ✓ | |
| تسلسل الاستغلال | ✓ | جزئي | | | | جزئي |
| تحقق غير مدمر من PoC | ✓ | | | | جزئي | |
| سلاسل حقن مخزنة (تحقق POST -> GET) | ✓ | يدوي | جزئي | | يدوي | |
| فحوصات منسقة (متخصصة وليست قائمة على قوالب) | 60 | مدفوعة بغلاف الأدوات | مدفوعة بالقواعد | 8000+ قالب | يدوي + فحص | - |
| أدوات أمان CLI مغلّفة | 200+ | 150+ | - | - | - | - |
| معالج تثبيت الأدوات | أساسي/موصى به/كامل + لكل أداة | - | n/a | n/a | n/a | - |
| تثبيت ذكي عند بدء المهمة | ✓ | | | | | |
| متوافق مع CI (SARIF + بوابات الخطورة) | ✓ | | جزئي | جزئي | جزئي | |
| فحوصات الفريق الأحمر بالـ LLM | ✓ | | | | | |
| دفاتر تشغيل YAML | ✓ | | | قوالب | | |
| الترخيص | MIT | MIT | Apache-2.0 | MIT | تجاري | MIT |
## ماذا يوجد في الداخل
- **17 وكيلًا** عبر الاستطلاع، الويب، أمان واجهات API، Active Directory، السحابة، الجوال، اللاسلكي، المتصفح، اختبار بيانات الاعتماد، تصعيد الامتيازات، فحص الثغرات، تسلسل الاستغلال، التحقق من PoC، الاكتشاف، إعداد التقارير، الفريق الأحمر للـ LLM، والهندسة الاجتماعية
- **60 فحصًا ويبيًا منسقًا** يغطي OWASP Top 10 + API Top 10
- **أكثر من 200 غلاف أدوات** مع تثبيت تلقائي: nmap, masscan, nuclei, ffuf, sqlmap, gobuster, wapiti, nikto, dalfox, xsstrike, wpscan, hydra, hashcat, enum4linux, bloodhound-python, حزمة impacket, trufflehog, gitleaks, kube-hunter, trivy, prowler, scout-suite، والمزيد
- **أكثر من 4000 قالب Nuclei** مدمجة للكشف الذري عن الثغرات
- **47 أداة MCP** للمهمات المدفوعة بالـ LLM، بما في ذلك `plan_tools` / `ensure_tools_installed` التي تتيح للـ LLM الخارجي تثبيت الأدوات دفعةً واحدة دون مفتاح Anthropic API
- **أكثر من 300 نموذج LLM** عبر مزود LiteLLM (Anthropic, OpenAI, Ollama مباشرة؛ Azure, OpenRouter, DeepSeek, Groq, Mistral, Together AI, Bedrock, Vertex AI, Cohere عبر LiteLLM)
- **واجهة HTTP REST API + WebSocket** (`ptai serve`) لتكاملات غير MCP
- **لوحة تحكم ويب محلية** مع عرض مباشر للمهمة، جدول النتائج، تصور سلسلة الهجمات، وتصدير SARIF
- **وكيل أتمتة المتصفح** مع التقاط لقطات الشاشة، تحليل DOM، التقاط الشبكة، وتقييم ترويسات الأمان (مدعوم بـ Playwright)
- **التحكم عن بُعد مع وجود البشر في الحلقة** (Ctrl+C مرتين لتولي مهمة منتصف التشغيل)
- **قدرة عميل MCP** لتحميل خوادم MCP الخارجية كمصادر أدوات
- **منظومة معايير عامة قابلة لإعادة الإنتاج** في `benchmarks/`. الأرقام والكود والملفات الأولية، كلها في git.
- **6 صيغ إخراج**: Markdown, HTML, PDF, SARIF 2.1.0, JUnit XML, تعيينات الامتثال (OWASP, CWE, CVE, CVSS v3.1)
- **2,400+ اختبار** مع CI على Python 3.10, 3.11, 3.12, 3.13
- **مرخص بـ MIT**، 100% ملكك
## من يستخدمه ولأي غرض
**فرق أمان التطبيقات.** اربطوا `ptai` في CI الخاص بكم. كل PR ضد بيئة التدريج يحصل على فحص مصادق. يفشل البناء عند النتائج عالية الخطورة. حلقة الإصلاح -> إعادة الاختبار -> التأكيد تعمل من تلقاء نفسها.
**الاستشاريون.** أنشئوا مهمة لأسبوع كامل، ووجّهوا `ptai` إلى قائمة الأهداف، واقضوا وقتكم في الأجزاء التي تحتاج إنسانًا: تحليل النتائج، اختيار سلاسل الاستغلال لتوضيحها، والحديث مع العميل. التقرير يكتب نفسه.
**صائدو مكافآت الثغرات.** شغّلوه مع الإفطار. عودوا إلى قائمة من النتائج الموثقة مع PoCs جاهزة للصق في HackerOne.
**أعضاء الفريق الأحمر.** شفّروا منهجية Active Directory الخاصة بكم كدفتر تشغيل YAML. كل مهمة جديدة تشغّله. نفس المنهجية، مشتركة بين الفريق.
**مستخدمو Claude Code / Cursor / Codex.** أضيفوا ptai كخادم MCP. اطلبوا من مساعدكم تشغيل فحص بلغة إنجليزية بسيطة. اشتراككم الحالي يدفع ثمن الـ LLM؛ ptai يوفّر الأدوات.
**المطوّرون الذين يطلقون ميزات ذكاء اصطناعي.** فعّلوا `--enable-llm-redteam` على روبوت المحادثة الخاص بكم. احصلوا على تقرير OWASP LLM Top 10 في دقائق.
## الاستخدام المسؤول
`pentest-ai` أداة أمنية هجومية. تنفّذ عمليات شبكة ومضيف حقيقية ضد الأهداف التي تحددونها. **أنتم وحدكم المسؤولون عن ضمان حصولكم على إذن صريح ومكتوب لاختبار كل هدف.**
بتثبيت أو تشغيل `ptai` فإنكم توافقون على [سياسة الاستخدام المقبول](https://pentestai.xyz/aup) و[شروط الخدمة](https://pentestai.xyz/terms). قد يشكّل اختبار أنظمة لا تملكونها دون إذن كتابي انتهاكًا لقانون الاحتيال وإساءة استخدام الحاسوب (Computer Fraud and Abuse Act)، وقانون إساءة استخدام الحاسوب لعام 1990 (Computer Misuse Act 1990)، والمادة 32 من اللائحة العامة لحماية البيانات (GDPR)، وما يعادلها في منطقتكم. سوء الاستخدام هو مسؤوليتكم وحدكم.
في أول تشغيل، يطالبكم بتأكيد قبول AUP ويحفظ الاختيار في `~/.pentest-ai/aup-consent.txt`. اضبطوا `PENTEST_AI_AUP_ACCEPTED=1` في CI لتجاوز الطلب دون تفاعل.
عند الإقلاع، يحمّل `ptai` ملف نطاق. تُرفض المضيفات خارج النطاق في وقت استدعاء الأداة. تكون PoCs غير مدمرة افتراضيًا. تعمل حدود المعدل تلقائيًا في وضع التخفي. لا تكونوا ذلك الشخص.
### استدعاءات خارج النطاق (OAST) - الخصوصية
يكتشف `ptai` فئات الثغرات العمياء (SSRF أعمى، SQLi أعمى، XXE أعمى، XSS مخزّن أعمى، SSTI، Log4Shell) عبر إرسال حمولات تُطلق عند التنفيذ من جهة الخادم نداءً إلى متعاون خارج النطاق. افتراضيًا، توجَّه عمليات الاستدعاء إلى البنية التحتية العامة `oast.fun` التابعة لـ ProjectDiscovery.
**ما الذي يصل إلى المتعاون ومن يمكنه قراءته.** تولّد كل مهمة زوج مفاتيح RSA-2048 جديدًا في عملية `ptai` المحلية لديكم. تُشفَّر حمولات التفاعل (طلبات HTTP الأولية، استعلامات DNS، مغلفات SMTP التي يستقبلها المتعاون) باستخدام AES-CTR-256 في وضع التخزين على الخادم، مع تغليف مفتاح AES في RSA-OAEP-SHA256 باستخدام المفتاح العام لمهمتكم. **فقط من يملك المفتاح الخاص المطابق - عملية `ptai` المحلية لديكم - يمكنه فك تشفيرها.** لا يمكن لـ ProjectDiscovery (أو أي جهة تشغّل المتعاون) قراءة محتويات التفاعل. ومع ذلك، **البيانات الوصفية مرئية للخادم**: حقيقة حدوث التفاعل، وعنوان IP المصدر للهدف المستدعي، والطابع الزمني، والبروتوكول.
**متى تستضيفه بنفسك.** تحظر PortSwigger صراحةً استخدام Burp Collaborator العام في قواعد المشاركة الخاصة بمكافآت الثغرات لديها، وتتطلب البرامج المؤسسية الكبيرة (Meta, Apple, القطاع المالي) بشكل متزايد أن تنتهي بنية الاستدعاء عند مضيفين يتحكم فيهم المختبر. بالنسبة للمهام المدفوعة، شغّلوا خادم Interactsh الخاص بكم (Apache-2.0، ملف Go ثنائي واحد) ووجّهوا ptai إليه:```bash
ptai start http://target --oast-server https://oast.example.com --oast-token <T>
لتعطيل OAST تمامًا:```bash ptai start http://target --no-oast
لن يتم اكتشاف فئات الثغرات العمياء عند إيقاف تشغيل OAST؛ مسارات الكشف داخل النطاق (فرق الحجم / علامات أخطاء SQL / توقيعات البيانات الوصفية / القائمة على الوقت) لا تزال تعمل.
## النظام البيئي
| المستودع | الوصف |
|---|---|
| [**pentest-ai**](https://github.com/0xSteph/pentest-ai) | هذا المستودع. أداة CLI وخادم MCP. منتج Python. |
| [**pentest-ai-agents**](https://github.com/0xSteph/pentest-ai-agents) | ملفات Markdown مستقلة لوكلاء Claude Code الفرعيين. اختيارية، تعمل بدون هذا CLI. |
هل تحتاج إلى مساحات عمل مشتركة، أو تقارير PDF بعلامتك التجارية، أو SSO، أو مهمة مدارة؟ يوفر [الموقع الإلكتروني](https://pentestai.xyz) لوحات تحكم Pro / Team / Enterprise وخيار Launch Engagement لمرة واحدة. تظل الأداة OSS مجانية إلى الأبد.
## المجتمع
- **Discord:** [انضم إلى الخادم](https://discord.gg/6weeTAubJw). تحدث، واحصل على المساعدة، وشارك النتائج، أو ترقب فقط.
- **الأسئلة والأفكار والملاحظات:** [مناقشات GitHub](https://github.com/0xSteph/pentest-ai/discussions)
- **الإبلاغ عن الأخطاء:** [مشكلات GitHub](https://github.com/0xSteph/pentest-ai/issues)
- **العرض والمشاركة:** انشر أغرب نتيجة حصلت عليها من `ptai` في [العرض والمشاركة](https://github.com/0xSteph/pentest-ai/discussions/categories/show-and-tell)
## الأسئلة الشائعة
**هل أحتاج إلى مفتاح API؟** لا في مسار MCP. إذا كنت تستخدم ptai من Claude Code أو Cursor أو Codex أو Claude Desktop، فإن اشتراكك الحالي هو ما يوفّر LLM. تحتاج فقط إلى مفتاح في CLI المستقل (المسار 3)، وحتى هناك يمكنك التشغيل محليًا بالكامل باستخدام Ollama. انظر [التثبيت](#install).
**هل هو مستقل حقًا أم أنني أراقبه؟** أنت تبقى في الحلقة. ptai منسّق بواسطة LLM وليس مستقلًا - فالمسابير المنتقاة تقوم بالكشف، ويحلل LLM النتائج، والقرار النهائي لك. اضغط Ctrl+C مرتين في منتصف التشغيل لتتولى الأمر. وكلاء LLM المستقلون تمامًا ينجزون 21-31% من مهام الاختراق من البداية إلى النهاية؛ بينما تصل الإعدادات المدعومة بشريًا إلى 64%، وptai مبني لهذا النظام الثاني.
**هل من الآمن توجيهه إلى بيئة الإنتاج؟** فقط بإذن كتابي، وفقط مع تفعيل الضمانات: `intensity=safe` يتخطى المسابير التي تغيّر الحالة، و`respect_rate_limits` يحترم 429 / Retry-After، و`strict_scope` يرفض الطلبات خارج المضيف ويتوقف عن متابعة عمليات إعادة التوجيه. الثلاثة جميعها معطلة افتراضيًا، لذا فعّلها. انظر [الاستخدام المسؤول](#responsible-use).
**لماذا يكون رقم Juice Shop مرتفعًا لكن رقم honeypot أقل؟** Juice Shop هو التطبيق الأكثر توثيقًا بين التطبيقات القابلة للاختراق على الإنترنت، لذلك يتمتع كل من LLM ومؤلفي المسابير ببداية مسبقة. يقيس honeypot الخاص الثغرات التي كتبناها بأنفسنا، لذا يكون رقمه أقل - وهذا الرقم الأقل هو الإشارة الصادقة. ننشر كليهما. انظر [المعايير](#benchmarks).
**هل يتصل بالخادم الرئيسي؟** لا يوجد تتبع عن بُعد، وتبقى النتائج على قرصك. في مسار MCP، تمر استعلاماتك ومخرجات الأدوات التي يقرأها عميل الذكاء الاصطناعي لديك عبر واجهة API لذلك العميل، تمامًا كما في أي جلسة. يرسل اكتشاف الثغرات العمياء (OAST) استرجاعات إلى oast.fun العامة افتراضيًا - المحتويات مشفّرة بزوج مفاتيح محلي، لكن حقيقة حدوث الاسترجاع، بالإضافة إلى عنوان IP المصدر والطابع الزمني، تكون مرئية لمن يشغّل خادم collaborator. استضف Interactsh ذاتيًا أو شغّل باستخدام `--no-oast` لتجنب ذلك. انظر [الاستخدام المسؤول](#responsible-use).
**كم تبلغ تكلفة التشغيل؟** في مسار MCP، لا شيء يتجاوز اشتراك الذكاء الاصطناعي الخاص بك، الذي يتولى فوترته بنفسه. في CLI المستقل، يحدّ ptai الإنفاق عند 10 دولارات لكل مهمة افتراضيًا؛ غيّره باستخدام `PTAI_PRICE_LIMIT`. انظر [التثبيت](#install).
**كيف يختلف هذا عن مجرد استخدام Claude أو PentestGPT؟** مكتبة مسابير منتقاة وحتمية تجد الثغرات؛ ويدير LLM حلقة المراحل ويحلل النتائج، ولا يقوم بالفحص. لهذا تكون النتائج قابلة لإعادة الإنتاج وتأتي مع PoC عملي بدلاً من تخمين من LLM. انظر [لماذا هو مختلف](#why-its-different) و[مقارنة بالمجال](#vs-the-field).
## تاريخ النجوم
<a href="https://star-history.com/#0xSteph/pentest-ai&Date">
<img src="https://assets.kitploit.com/production/public/readmes/placeholders/f0fc86cfe65f76d40e15aaec61704ec8220a56dc89d4be03c46f67cb31b9fa8c.svg" alt="مخطط تاريخ النجوم" width="600">
</a>
## الترخيص
MIT. افعل ما تشاء به.
<div align="center">
**إذا وفّر عليك `ptai` يوم أحد، [امنح المستودع نجمة](https://github.com/0xSteph/pentest-ai). إنه الأجر الوحيد الذي أطلبه.**
</div>