pentest-ai v1.4.0

الموقع الإلكتروني · البدء السريع · مكافآت الثغرات · التحقق · التوثيق · المشكلات

Pentest-AI هي أداة مفتوحة المصدر لاختبار الاختراق بالذكاء الاصطناعي وللبحث عن مكافآت الثغرات، تفصل بين النتائج المُثبتة والتخمينات. تربط عميل ذكاء اصطناعي أو نموذجًا بسير عمل حقيقي لاختبار الاختراق: التحقيق في تطبيقات الويب، واكتشاف الثغرات وإعادة إنتاجها، واستخدام أوراكل آلية للتحقق مما إذا كان الاستغلال يعمل فعليًا. النتيجة التي لا تستطيع أي أوراكل إثباتها تبقى مصنّفة كمرشّحة، أما النتيجة المتحقَّق منها فتحمل الطلبات والاستجابات التي أثبتتها.

استخدمها عبر MCP (Claude Code، Codex، Cursor، VS Code)، أو من CLI، أو في CI/CD. يقود النموذج التحقيق؛ بينما تقرر أوراكل مستقلة ما إذا كانت النتيجة تستحق حكمًا متحقَّقًا منه، بحيث لا تصل تخمينات النموذج متزيّنة بزي النتائج.

مصمَّمة لمكافآت الثغرات المصرَّح بها: ملف تعريف واحد لكل برنامج يحمل نطاقه ومعدله المعلن ومعرّفك كباحث، وتُظهر التجربة الجافة الخطة قبل إرسال أي شيء، وتُستمد مسودات التقارير من النتائج المتحقَّق منها فقط. انتقل إلى سير عمل مكافآت الثغرات ←

اختبر فقط الأنظمة التي تملكها أو لديك تصريح صريح بتقييمها. اقرأ سياسة الاستخدام المقبول والشروط قبل تنفيذ أي مهمة.

البدء السريع

موصى به: Codex أو Claude Code

استخدم Python 3.10 إلى 3.14 وثبّت pipx أولًا. شغّل pipx ensurepath وأعد فتح الطرفية إذا لزم الأمر. يعزل pipx تبعيات Pentest-AI ويجعل أوامرها متاحة عبر المجلدات.

pipx install ptai
ptai setup --mcp

ثبّت واجهة سطر الأوامر (CLI) الخاصة بعميل الذكاء الاصطناعي لديك أولاً. يسأل الإعداد قبل الاتصال بجميع العملاء المدعومين المكتشفين، بما في ذلك Codex وClaude Code عند تثبيتهما. يحافظ على التسجيلات الموجودة. أعد تشغيل عميلك بعد ذلك.

يستخدم المعالج إعدادات على مستوى المستخدم. وهو لا يثبّت العملاء، ولا يسجّل دخولك، ولا ينزّل النماذج، ولا يهيّئ Ollama. يوفّر عميل الذكاء الاصطناعي لديك النموذج؛ ولا يتطلب خادم MCP مفتاح API منفصل للنموذج. استخدم ptai setup --mcp --dry-run لمعاينة التغييرات. راجع إعداد عميل واحد وإعداد لكل مستودع للحصول على تعليمات Codex .codex/config.toml وClaude Code .mcp.json.

للترقيات، استخدم pipx upgrade ptai. في بيئة افتراضية مفعّلة موجودة، يُدعم أيضاً python -m pip install --upgrade ptai؛ أبقِ تلك البيئة متاحة بعد تسجيلها مع عميل الذكاء الاصطناعي لديك.

بديل: Ollama والنماذج المحلية

ثبّت Pentest-AI كما هو موضح أعلاه، لكن تخطَّ إعداد MCP لهذا المسار. ثبّت Ollama وشغّله، ثم اسحب نموذجاً يدعم استدعاء الأدوات. استخدم ollama list للعثور على اسمه الدقيق المثبّت.

export PENTEST_AI_LLM_PROVIDER=ollama
export PENTEST_AI_MODEL="your-installed-model"
ptai start https://your-authorized-target.example --no-sync

في PowerShell:

$env:PENTEST_AI_LLM_PROVIDER = "ollama"
$env:PENTEST_AI_MODEL = "your-installed-model"
ptai start https://your-authorized-target.example --no-sync

استبدل العناصر النائبة قبل التشغيل. لا يحتاج النموذج المحلي إلى مفتاح API سحابي. تؤثر جودة النموذج والذاكرة المتاحة على النتائج. راجع دليل النموذج لتهيئة نقطة النهاية.

جرّب العرض التوضيحي المرفق

لا حاجة إلى مفتاح API أو هدف خارجي.

pipx install ptai
ptai demo

يختبر العرض التوضيحي تطبيقًا ضعيفًا مرفقًا، ويعيد تشغيل اكتشاف من كبسولة إثباته، ويتحقق من المسارات المحصّنة. افحص سير عمل الأدلة قبل إعداد مهمة حقيقية.

مزوّدو النماذج الآخرون

للنماذج السحابية المستقلة وتبعيات الماسح الاختيارية، راجع دليل التثبيت ودليل المزوّد. أبقِ مفاتيح API خارج نظام التحكم بالمصدر.

أتمتة مكافآت الثغرات

وضع مكافآت الثغرات مخصص للبرامج التي تسمح بالاختبار الآلي. تكتب ملف تعريف واحدًا لكل برنامج يتضمن نطاقه ومعدله المعلن ومعرّف الباحث الخاص بك. ثم يطبّق --program كل ذلك على كل طلب، ويطبع --dry-run الخطة دون إرسال أي شيء.

# ~/.pentest-ai/programs/acme.toml
platform = "hackerone"
handle = "acme"
researcher = "your-h1-username"   # sent on every request in X-Bug-Bounty
rps = 5.0                         # the rate the program states
scope = ["*.acme.com", "api.acme.com"]
excluded = ["status.acme.com"]
scanners_allowed = true
allow_race = false

ptai start https://api.acme.com --program acme --dry-run    # sends nothing
ptai start https://api.acme.com --program acme --auto-auth
ptai bounty-report <engagement-id> --program acme --output-dir drafts/

ضمن --program:

• كل طلب مقيّد بمعدل البرنامج، بما في ذلك الأدوات الخارجية. الأداة التي لا يمكن تقييدها بحصتها من المعدل تُتخطى ويذكر الفحص ذلك.
• يأتي النطاق من الملف الشخصي ولا من أي مكان آخر. الطلبات الخارجة عنه تُرفض، والاستثناءات تتغلب على أحرف البدل.
• يحمل كل طلب معرّف الباحث الخاص بك في X-Bug-Bounty، أو في الترويسة التي يحددها البرنامج (PTAI_BOUNTY_HEADER_NAME).
• أدوات قوائم الكلمات مثل gobuster وffuf مرفوضة. لا يزال مجسّا الاستكشاف المدمجان يجرّبان قائمة من المسارات المحتملة، نحو 500 طلب.
• لا تُرسل الحمولات المصممة لاستنزاف الهدف أو إسقاطه. المجسات التي تغيّر حسابات مستخدمين آخرين أو الحالة المشتركة لا تُشغَّل. لا تُشغَّل دفعات ظروف التسابق إلا عندما يضبط الملف الشخصي allow_race = true.
• يُحترم 429 وRetry-After. الهدف الذي يتباطأ يحصل على معدل أقل، والهدف الذي يبقى متدهورًا يوقف الفحص مع تسجيل السبب.
• البرنامج الذي يحظر الماسحات يحتاج إلى كتابة yes صراحةً، لأن فحصه قد يُبطل الملاذ الآمن.

يصوغ ptai bounty-report تقارير من النتائج المتحقق منها بواسطة oracle فقط، مع خطوات إعادة الإنتاج مأخوذة من طلبات oracle نفسها. أعد إنتاج كل واحدة يدويًا وقدّمها بنفسك. يحوّل ptai bounty import ملف النطاق المصدَّر من البرنامج إلى مدخلات سماح واستثناء للملف الشخصي.

الوقت الفعلي هو الطلبات مقسومة على المعدل. على تطبيق الاختبار لدينا، تمريرة كاملة عند 3 طلبات في الثانية تعني نحو 8,700 طلب وتستغرق 51 دقيقة، وتجد كل الثغرات الحرجة والعالية التي تجدها تمريرة عند 10 طلبات في الثانية. عند 10 طلبات في الثانية كانت نحو 6,600 طلب و11 دقيقة، مقيسة قبل أن تحصل المجسات البطيئة على مجال لإكمال عملها عند المعدلات المنخفضة.

عند القياس عند الوصول، لم تتجاوز أي ثانية المعدل المعلن عند 3 أو 10 طلبات في الثانية، بما في ذلك الطلبات المرسلة من الأدوات الخارجية.

الدليل الكامل لصيد الثغرات →

كيف يعمل التحقق

1. العثور على مرشح. يحدد مجس أو ماسح سلوكًا يستحق التحقيق.
2. إعادة إنتاجه والتحقق من عنصر تحكم. يعيد oracle مسمّى تنفيذ الاستغلال ويقارنه بعنصر تحكم لا ينبغي أن يُظهر الضعف.
3. الاحتفاظ بالأدلة. تسجّل النتيجة المتحقق منها oracle والطلبات التي أرسلها والاستجابات التي حكم عليها. يعيد ptai retest فحص الهدف وptai diff يُظهر ما تغيّر. يعرض ptai demo كبسولة إثبات محمولة يعيد ptai replay التحقق منها.

على سبيل المثال، يجب أن يعيد تجاوز الترويسة الموثوقة محتوى مميزًا مع ترويسة الهجوم ويرفض الوصول بدونها. الخادم الذي يجيب على كل طلب بـ HTTP 200 ليس دليلًا كافيًا.