0xsteph/pentest-aiمختبِر اختراق بالذكاء الاصطناعي مفتوح المصدر يُثبت كل اكتشاف. أوراكل آلية تعيد تنفيذ كل استغلال؛ والثغرات المؤكَّدة تُصدِر كبسولة إثبات يمكنك إعادة تشغيلها بنفسك.
 [](https://pypi.org/project/ptai/) [](https://pypi.org/project/ptai/) [](https://github.com/0xSteph/pentest-ai/blob/main/LICENSE) [الموقع الإلكتروني](https://pentestai.xyz/) · [البدء السريع](#quick-start) · [مكافآت الثغرات](#bug-bounty-automation) · [التحقق](#how-verification-works) · [التوثيق](https://github.com/0xSteph/pentest-ai/tree/main/docs) · [المشكلات](https://github.com/0xSteph/pentest-ai/issues) **Pentest-AI هي أداة مفتوحة المصدر لاختبار الاختراق ومكافآت الثغرات بالذكاء الاصطناعي تُثبت كل نتيجة.** تربط عميل ذكاء اصطناعي أو نموذجًا بسير عمل اختبار اختراق حقيقي — للتحقيق في تطبيقات الويب، واكتشاف الثغرات وإعادة إنتاجها، واستخدام **أوراكل آلية للتحقق مما إذا كان الاستغلال يعمل فعليًا**. لا دليل، لا نتيجة: النتائج المُتحقق منها تحمل أدلة يمكنك إعادة تشغيلها بنفسك. استخدمها عبر **MCP** (Claude Code، Codex، Cursor، VS Code)، أو من **CLI**، أو في **CI/CD**. يقود النموذج التحقيق؛ ويقرر أوراكل مستقل ما إذا كانت النتيجة تستحق حكمًا مُتحققًا منه — لذا فإن المخرجات إشارة، لا فوضى ذكاء اصطناعي. **مصممة لمكافآت الثغرات المصرّح بها:** استورد نطاق برنامج (HackerOne، Bugcrowd، Intigriti، YesWeHack)، وشغّل مهمة مفروضة النطاق، وحوّل كل نتيجة مُتحقق منها إلى تقديم جاهز للمنصة. [انتقل إلى سير عمل مكافآت الثغرات ←](#bug-bounty-automation) > اختبر فقط الأنظمة التي تملكها أو لديك تصريح صريح لتقييمها. اقرأ [سياسة الاستخدام المقبول](https://pentestai.xyz/aup) و[الشروط](https://pentestai.xyz/terms) قبل تشغيل أي مهمة. ## البدء السريع ### موصى به: Codex أو Claude Code استخدم Python **3.10–3.14** وثبّت [pipx](https://pipx.pypa.io/stable/installation/) أولًا. شغّل `pipx ensurepath` وأعد فتح الطرفية إذا لزم الأمر. يعزل pipx تبعيات Pentest-AI ويجعل أوامرها متاحة عبر المجلدات. ```sh pipx install ptai ptai setup --mcp ``` ثبّت CLI الخاص بعميل الذكاء الاصطناعي أولًا. يسأل الإعداد قبل الاتصال **بجميع العملاء المدعومين المكتشفين**، بما في ذلك Codex وClaude Code عند تثبيتهما. يحافظ على التسجيلات الموجودة. أعد تشغيل عميلك بعد ذلك. يستخدم المعالج **إعدادات على مستوى المستخدم**. لا يثبّت العملاء، ولا يسجّل دخولك، ولا ينزّل النماذج أو يهيّئ Ollama. يوفّر عميل الذكاء الاصطناعي النموذج؛ ولا يطلب خادم MCP مفتاح API منفصل للنموذج. استخدم `ptai setup --mcp --dry-run` لمعاينة التغييرات. راجع [إعداد عميل واحد وإعداد لكل مستودع](https://pentestai.xyz/docs/ai-clients/) لتعليمات Codex `.codex/config.toml` وClaude Code `.mcp.json`. للترقيات، استخدم `pipx upgrade ptai`. في بيئة افتراضية مُفعّلة موجودة، يُدعم أيضًا `python -m pip install --upgrade ptai`؛ أبقِ تلك البيئة متاحة بعد تسجيلها مع عميل الذكاء الاصطناعي. ### بديل: Ollama والنماذج المحلية ثبّت Pentest-AI كما هو موضح أعلاه، لكن تخطَّ إعداد MCP لهذا المسار. [ثبّت Ollama وشغّله](https://docs.ollama.com/quickstart)، ثم اسحب نموذجًا يدعم استدعاء الأدوات. استخدم `ollama list` للعثور على اسمه المثبّت بالضبط. ```bash export PENTEST_AI_LLM_PROVIDER=ollama export PENTEST_AI_MODEL="your-installed-model" ptai start https://your-authorized-target.example --no-sync ``` في PowerShell: ```powershell $env:PENTEST_AI_LLM_PROVIDER = "ollama" $env:PENTEST_AI_MODEL = "your-installed-model" ptai start https://your-authorized-target.example --no-sync ``` استبدل العناصر النائبة قبل التشغيل. لا يحتاج النموذج المحلي إلى مفتاح API سحابي. تؤثر جودة النموذج والذاكرة المتاحة على النتائج. راجع [دليل النماذج](https://pentestai.xyz/docs/ai-clients/) لإعداد نقطة النهاية. ### جرّب العرض التوضيحي المضمّن لا يتطلب مفتاح API أو هدفًا خارجيًا. ```bash pipx install ptai ptai demo ``` يختبر العرض التوضيحي تطبيقًا ضعيفًا مضمّنًا، ويعيد تشغيل نتيجة من كبسولة إثباتها، ويتحقق من المسارات المُحصّنة. افحص سير عمل الأدلة قبل تهيئة مهمة حقيقية. ### مزوّدو النماذج الآخرون للنماذج السحابية المستقلة وتبعيات الماسحات الاختيارية، راجع [دليل التثبيت](https://pentestai.xyz/docs/getting-started/) و[دليل المزوّدين](https://github.com/0xsteph/pentest-ai/blob/main/docs/llm-providers.md). أبقِ مفاتيح API بعيدًا عن التحكم في المصدر. ## أتمتة مكافآت الثغرات صُممت Pentest-AI لعمل مكافآت الثغرات المصرّح به، حيث يكون البقاء ضمن النطاق وتقديم النتائج القابلة لإعادة الإنتاج فقط هما ما يهم. ```sh # 1. Import the program's scope (HackerOne / Bugcrowd / Intigriti / YesWeHack) ptai bounty import --platform hackerone --file scope.json --out program.scope # 2. Run a scope-enforced engagement (a preflight shows exactly what will be # touched and asks you to confirm — nothing out of scope is ever hit) ptai start acme.com --scope-file program.scope --intensity stealth # 3. Turn verified findings into platform-ready submissions ptai bounty report <engagement-id> --platform hackerone --out submissions/ ``` - **النطاق مفروض**، وليس استشاريًا: أحرف البدل، وCIDRs، والاستثناءات خارج النطاق، والفشل المغلق، على كل وكيل وأداة. - **التقديمات قابلة للتقديم**: يتضمن كل منها `curl` قابلًا لإعادة الإنتاج، وCVSS/CWE، والتأثير، والمعالجة، والحكم الآلي مع كبسولة إثبات قابلة لإعادة التشغيل. - أو شغّل دليل المنهجية المضمّن من البداية إلى النهاية: `ptai playbook run bug-bounty-web -i target=acme.com --execute`. [دليل مكافآت الثغرات الكامل ←](https://github.com/0xSteph/pentest-ai/blob/main/docs/bug-bounty.md) ## كيف يعمل التحقق  1. **اعثر على مرشح.** يحدد مسبار أو ماسح سلوكًا يستحق التحقيق. 2. **أعد إنتاجه وتحقق من عنصر تحكم.** يعيد أوراكل مُسمّى تنفيذ الاستغلال ويقارنه بعنصر تحكم لا ينبغي أن يُظهر الضعف. 3. **احتفظ بالأدلة.** تسجّل النتيجة المُتحقق منها الأوراكل ونتائجه في كبسولة إثبات محمولة. استخدم `ptai replay` للتحقق منها مرة أخرى. على سبيل المثال، يجب أن يُرجع تجاوز الترويسة الموثوقة محتوى مميزًا مع ترويسة الهجوم ويرفض الوصول بدونها. الخادم الذي يستجيب لكل طلب بـ HTTP 200 ليس دليلًا كافيًا. **لا يمكن للنموذج منح حكم مُتحقق منه.** يبقى مخرجات الماسح من طرف ثالث غير مُتحقق منها حتى يثبتها أوراكل بشكل مستقل. تبقى النتائج التي لا تحتوي على وصفة تحقق مدعومة مرشحة. ينطبق الحكم المُتحقق منه على الظروف المُختبرة. لا يعني أن التطبيق بأكمله آمن. كبسولات الإثبات غير موقّعة؛ إعادة تشغيل التحقق هي آلية الثقة. [اقرأ تصميم التحقق](https://github.com/0xSteph/pentest-ai/blob/main/docs/why-verification.md) ## ما يمكنك فعله | سير العمل | ما توفره Pentest-AI | | --- | --- | | التحقيق في تطبيقات الويب | مسابر للحقن، والتحكم في الوصول، ومعالجة الطلبات، وغيرها من نقاط ضعف التطبيقات | | تشغيل مهمة مكافآت الثغرات | استيراد نطاق البرنامج، وفرضه، وإنشاء تقديمات جاهزة للمنصة ([دليل](https://github.com/0xSteph/pentest-ai/blob/main/docs/bug-bounty.md)) | | العمل عبر عميل ذكاء اصطناعي | أدوات MCP للمهام والتحقيق والتحقق | | إعادة إنتاج نتيجة | نتائج الأوراكل وكبسولات إثبات قابلة لإعادة التشغيل | | التحقق من إصلاح | إعادة تشغيل التحقق المسجّل مقابل الهدف المُحدّث | | الإبلاغ لفريقك | تقارير ومخرجات SARIF لسير عمل الهندسة الحالية | | إبقاء بيانات المهمة محلية | النتائج مخزّنة على جهازك في SQLite | تتفاوت التغطية حسب المسبار والأوراكل. تحتاج الماسحات الاختيارية إلى ملفاتها التنفيذية الخاصة، وبعض التكاملات توفّر مخرجات خام بدلًا من نتائج منظمة. راجع [التوثيق](https://github.com/0xSteph/pentest-ai/tree/main/docs) و[سجل التغييرات](https://github.com/0xSteph/pentest-ai/blob/main/CHANGELOG.md) لإصدارك؛ قد يحتوي `main` على عمل غير مُصدَر. [اعرض جرد القدرات الذي يتحقق منه CI](https://github.com/0xSteph/pentest-ai/blob/main/docs/capability-inventory.md). ## ضع النتائج المُتحقق منها في CI هيّئ مزوّد النموذج، وهدفًا مصرّحًا به، وموافقة التشغيل الأول في بيئة CI الخاصة بك. أبقِ الأسرار في مخزن أسرار مزوّد CI. ```sh ptai start https://your-authorized-target.example --ci --fail-on verified --no-sync ``` صدّر النتائج المُتحقق منها باستخدام معرّف المهمة من التشغيل: ```sh ptai export YOUR_ENGAGEMENT_ID --sarif pentest.sarif ``` `--sarif` خيار تصدير، وليس خيار `ptai start`. احتفظ بمعرّف المهمة وشغّل التصدير حتى عند فشل بوابة النتائج إذا أردت أدلة للبنيات الفاشلة. ارفع الملف الناتج عبر تكامل SARIF لمزوّد CI. [إعداد CI والقوالب](https://github.com/0xSteph/pentest-ai/blob/main/docs/ci-cd.md) ## الأدلة والمعايير والحدود نتائج المعايير، وإكمال التحديات، والنتائج المُتحقق منها بالأوراكل قياسات مختلفة. تسجّل هذه التقارير الإصدارات والأهداف والمنهجية وراء نتائجها: - [تقارير المعايير والمخرجات](https://github.com/0xSteph/pentest-ai/tree/main/benchmarks) - [منهجية Juice Shop](https://github.com/0xSteph/pentest-ai/blob/main/docs/benchmarks/juice-shop.md) - [بيئة الاختبار الضعيفة](https://github.com/0xSteph/pentest-ai/tree/main/tests/honeypot) - [فحوصات التطبيق النظيف](https://github.com/0xSteph/pentest-ai/tree/main/tests/cleanapp) **توقّع تغطية غير مكتملة.** الفحص الذي لا يحتوي على نتائج مُتحقق منها ليس تقييمًا أمنيًا لكل ما يفعله التطبيق. تؤثر المصادقة، وحالة التطبيق، وفئات الثغرات غير المدعومة، والتغييرات البيئية على ما يمكن العثور عليه وإعادة إنتاجه. راجع النتائج وأبقِ إنسانًا مشاركًا في المهمة. ## سلوك البيانات والشبكة تُخزّن النتائج محليًا. عدّادات الاستخدام المجهولة اختيارية عبر `ptai telemetry enable`. لا يعني التخزين المحلي أن كل عملية تبقى على جهازك: لاستدعاءات مزوّد النموذج والماسحات المثبّتة سلوك شبكي خاص بها. يمكن أن تستخدم فحوصات الثغرات العمياء متعاونًا خارجيًا خارج النطاق؛ تكون بيانات الاستدعاء الوصفية مرئية لتلك الخدمة. استخدم متعاونك الخاص حيث يلزم، أو عطّل الاستدعاءات: ```bash ptai start https://your-authorized-target.example --oast-server https://your-collaborator.example ptai start https://your-authorized-target.example --no-oast ``` ## شارك استخدم [المشكلات](https://github.com/0xSteph/pentest-ai/issues) للأخطاء القابلة لإعادة الإنتاج و[المناقشات](https://github.com/0xSteph/pentest-ai/discussions) للأسئلة والأفكار. راجع [دليل الوكلاء والمساهمين](https://github.com/0xSteph/pentest-ai/blob/main/AGENTS.md) لتعليمات البناء والاختبار. يحتوي مستودع [pentest-ai-agents](https://github.com/0xSteph/pentest-ai-agents) الاختياري على ملفات الوكلاء الفرعيين لـ Claude Code. Pentest-AI مفتوحة المصدر تحت [رخصة MIT](https://github.com/0xSteph/pentest-ai/blob/main/LICENSE).
