apex v2.3.0-canary.52dcca8a
स्वायत्त एजेंटों का उपयोग करके AI-संचालित आक्रामक सुरक्षा परीक्षण, सीधे आपके टर्मिनल में।
Pensar Apex
स्वायत्त एजेंटों का उपयोग करके AI-संचालित पेनेट्रेशन टेस्टिंग — सीधे आपके टर्मिनल में। ब्लैकबॉक्स और व्हाइटबॉक्स पेंटेस्ट चलाएँ जो खोजते हैं, तर्क करते हैं और वास्तविक कमज़ोरियों को उजागर करते हैं।
क्लाउड से चलाना चाहते हैं या इसे अपने CI/CD के साथ एकीकृत करना चाहते हैं? देखें Pensar Console।
उपयोग के मामले
डेवलपर्स
- PR मर्ज करने से पहले
/pentestचलाएँ — टेस्ट चलाने की तरह ही सहजता से कमज़ोरियों को पकड़ें - गंभीरता स्कोर, साक्ष्य और सुझाए गए सुधारों के साथ कार्रवाई योग्य निष्कर्ष प्राप्त करें — किसी सुरक्षा पृष्ठभूमि की आवश्यकता नहीं
- हेडलेस CLI कमांड या Pensar Console के माध्यम से CI/CD में एकीकृत करें
सुरक्षा इंजीनियर
- बड़े हमला सतहों पर एजेंट-संचालित स्वार्म परीक्षण तैनात करें
- मैन्युअल जाँच, एक्सप्लॉइट चेनिंग और सत्यापन के लिए
/operatorमोड का उपयोग करें - लगातार मेमोरी के साथ दोहराए जाने वाले परीक्षण वर्कफ़्लो को स्वचालित करें जो जुड़ावों के दौरान जमा होती रहती है
- Pensar Console के माध्यम से टीमों और परियोजनाओं में स्केल करें
इंस्टॉलेशन
| विधि | कमांड |
|---|---|
| त्वरित इंस्टॉल (macOS/Linux) | curl -fsSL https://pensarai.com/install.sh | bash |
| Homebrew | brew tap pensarai/tap && brew install apex |
| npm | npm install -g @pensar/apex |
| Windows (PowerShell) | irm https://www.pensarai.com/apex.ps1 | iex |
उपयोग
Apex TUI खोलें:
pensar
Herdr
Apex स्वचालित रूप से अपनी स्थिति की रिपोर्ट करता है जब इसे
Herdr के अंदर लॉन्च किया जाता है। साइडबार एक टर्न के दौरान working
दिखाता है, जब अनुमोदन, योजना समीक्षा, या उत्तरों की आवश्यकता होती है तो blocked, और
जब Apex इनपुट के लिए तैयार होता है तो idle दिखाता है। टर्मिनल से जुड़े CLI एजेंट कमांड भी
अपनी गतिविधि की रिपोर्ट करते हैं। किसी प्लगइन या अतिरिक्त Apex कॉन्फ़िगरेशन की आवश्यकता नहीं है।
Herdr 0.9.2 या बाद का संस्करण सर्वर पुनः आरंभ के बाद वर्तमान वार्तालाप को पुनर्स्थापित कर सकता है।
pensar को अपने PATH पर रखें; Apex सत्र ID, सक्रिय मॉडल, और ऑब्फस्केशन सेटिंग के साथ एक रिज़्यूम कमांड प्रदान करता है। सहेजा गया सत्र अपने ऑपरेटर
मोड और अनुमोदन सेटिंग्स को पुनर्स्थापित करता है। पुनर्स्थापित सत्र आपके अगले प्रॉम्प्ट की प्रतीक्षा करते हैं।
आप सीधे एक सत्र भी पुनः खोल सकते हैं:
pensar --resume <session-id>
pensar --resume <session-id> --model <model-id>
रिपोर्टिंग और रिलीज़ पुराने Herdr संस्करणों के साथ भी काम करते हैं। रिपोर्टें एक छोटे टाइमआउट के साथ बैकग्राउंड में चलती हैं, और Herdr की विफलताएँ Apex को बाधित नहीं करतीं।
हेडलेस CLI
स्क्रिप्टिंग, CI, या evalgate एकीकरण के लिए TUI के बिना पेंटेस्ट चलाएँ:
# Basic pentest
pensar pentest --target https://example.com
# With extended thinking and task-driven mode
pensar pentest --target https://example.com --extended-thinking --task-driven
# Whitebox (with source code access)
pensar pentest --target https://example.com --cwd ./my-app
# Targeted pentest with specific objectives
pensar targeted-pentest --target https://example.com --objective "Test authentication bypass"
| फ़्लैग | कमांड | विवरण |
|---|---|---|
--target <url> | pentest, targeted-pentest | लक्ष्य URL (आवश्यक) |
--cwd <path> | pentest | whitebox मोड के लिए स्रोत कोड पथ |
--mode <mode> | pentest | pivoting और flag निष्कर्षण के लिए exfil |
--model <model> | pentest, targeted-pentest | AI मॉडल (डिफ़ॉल्ट: स्वतः-चयनित) |
--extended-thinking | pentest | समर्थित मॉडलों के लिए विस्तारित सोच सक्षम करें |
--task-driven | pentest | कार्य-चालित आर्किटेक्चर सक्षम करें (प्रयोगात्मक) |
--prompt <text|@file> | pentest | एजेंट के लिए कस्टम मार्गदर्शन |
--threat-model <text|@file> | pentest | परीक्षण का मार्गदर्शन करने के लिए खतरा मॉडल |
--objective <text> | targeted-pentest | परीक्षण उद्देश्य (दोहराने योग्य) |
Hoonify अनुमान
/providers में Hoonify कनेक्ट करें या HOONIFY_API_KEY सेट करें, फिर
/models में एक खोजा गया मॉडल चुनें। हेडलेस कमांड
--model-provider hoonify --model <catalog-model-id> स्वीकार करते हैं। मॉडल खोज, टोकन बजट, और लाइव जाँच के लिए
Hoonify सेटअप देखें।
कस्टम अनुमान एंडपॉइंट
customProviders कॉन्फ़िगरेशन या APEX_CUSTOM_PROVIDERS वर्कर एनवायरनमेंट वेरिएबल के माध्यम से
एक OpenAI-संगत एंडपॉइंट और बियरर टोकन लाएँ। इसे
--model-provider <id> --model <model> के साथ चुनें, या ऑपरेटर के /models पिकर में इसके घोषित मॉडल चुनें। GLM सेटिंग्स, हेडलेस जॉब कॉन्फ़िगरेशन, और एक लाइव कनेक्शन परीक्षण के लिए
कस्टम अनुमान सेटअप देखें।
लॉगिंग
Apex डायग्नोस्टिक/ऑपरेशनल लॉगिंग को एक केंद्रीकृत संरचित लॉगर
(src/core/logger) के माध्यम से रूट करता है। जब आउटपुट TTY नहीं होता है तो यह stderr पर एक-पंक्ति JSON लिखता है — इसे
प्रोग्राम के stdout से अलग रखते हुए और लॉग पाइपलाइन (जैसे CloudWatch) में भेजना आसान बनाते हुए —
और इंटरैक्टिव टर्मिनल में सुंदर, रंगीन आउटपुट देता है। उपयोगकर्ता-मुखी CLI/TUI आउटपुट
stdout पर ही रहता है।
स्तर सेट करें (सबसे अधिक → सबसे कम विस्तृत: debug < info < warn < error, डिफ़ॉल्ट info):
pensar pentest --target https://example.com --log-level debug # or --verbose / --quiet
PENSAR_LOG_LEVEL=debug pensar ... # via environment
PENSAR_DEBUG=1 pensar ... # back-compat alias for debug
रिज़ॉल्यूशन क्रम: CLI फ़्लैग → PENSAR_LOG_LEVEL → PENSAR_DEBUG → डिफ़ॉल्ट info।
PENSAR_LOG_FORMAT=json|pretty आउटपुट फ़ॉर्मेट को बाध्य करता है। जब Apex एक प्रबंधित एजेंट के रूप में चलता है,
तो PENSAR_LOG_LEVEL होस्ट एनवायरनमेंट द्वारा प्रदान किया जाता है।
W&B Weave ट्रेसिंग
विश्लेषण और फ़ाइन-ट्यूनिंग के लिए स्टेप-स्तरीय एजेंट ट्रेस को Weights & Biases Weave पर स्ट्रीम करें:
export WANDB_API_KEY=your-key
export WANDB_ENTITY=your-entity
# WANDB_PROJECT defaults to "apex-traces"
pensar pentest --target https://example.com