sapper-v2 bilan avtonom pentest legionini yaratish va ishga tushirish

sapper-v2 nima?

sapper-v2 ruxsat berilgan penetratsion testlar uchun ishlab chiqilgan avtonom, ko‘p agentli tizimdir. Tobora murakkablashib borayotgan bitta agentga tayanish o‘rniga, u bir nechta sun’iy intellekt agentlarini legionga birlashtiradi: ishni taqsimlaydi, topilmalar bilan almashadi va agentlar almashtirilganda bilimlarni saqlab qoladi.

Loyiha Tencent Cloud Intelligent Attack-Defense Challenge musobaqasining uchinchi onlayn saralash bosqichida g‘olib bo‘ldi va GeekCon 2026 AI Challenge tanlovida Birinchi mukofotni oldi. Tencent tadbirida u sakkiz soatlik nazoratsiz ish jarayonini 80.18 ball bilan yakunlab, taxminan bir milliard token ishlatgan holda 85 ta flag topdi.

sapper-v2’dan faqat o‘zingizga tegishli yoki test qilish uchun aniq ruxsat olgan tizimlarda foydalaning. O‘rnatish yoki ishga tushirishdan oldin DISCLAIMER.md faylini ko‘rib chiqing.

Tizim qanday ishlaydi

Loyiha uchta asosiy imkoniyatga tayanadi:

• Yaratish: Tizim tmux’da yangi sun’iy intellekt sessiyalarini ochadi va vazifalar talab qilganida ixtisoslashgan ishchi agentlarni yaratish imkonini beradi.
• Til: Agentlar bir-birining kirish sessiyalariga xabar kiritish orqali muloqot qiladi.
• Tarix: Topilmalar bitta agent kontekstida qoldirilmaydi, balki qatlamli fakt-maqsad grafigida saqlanadi.

Tarix tizimi uch qatlamdan iborat: sarlavha, qisqa mazmun va dalillar hujjati. Agentlar avval ixcham sarlavhani o‘qishi, qo‘shimcha kontekst kerak bo‘lsa qisqa mazmunni ko‘rishi va batafsil tekshirish uchun dalillarni ochishi mumkin. Bu yondashuv kontekst sarfini kamaytiradi va noto‘g‘ri fakt sabab yuzaga keladigan zararni cheklaydi.

Ishlash vaqtidagi rollar

Ishlash vaqtida sapper-v2 muvofiqlashtirish, bajarish va mavjudlikni ajratadi:

• Qo‘mondon: Doskani o‘qiydi, nishonlarni baholaydi va ishlarni taqsimlaydi. Hujumlarni o‘zi bajarmaydi.
• Generallar: Murakkab hujumlarni boshqaradi va o‘z guruhlarini jalb qilishi mumkin.
• Razvedkachilar: Qisqa razvedka ishlarini bajaradi hamda nishon keng ko‘lamli bajarish yoki chuqurroq tekshiruvni talab qilishini aniqlashga yordam beradi.
• Askarlar: Biriktirilgan vazifalar ustida parallel ishlaydi.
• Aloqachi: Bir joydan bildirilmagan flaglarni to‘playdi va yuboradi. Bu rol oldindan kodlanmagan, balki ish jarayonida paydo bo‘lgan.
• Nazoratchi: Strategiyaga ega bo‘lmagan skript bo‘lib, ishdan chiqqan qo‘mondonni --continue bilan qayta ishga tushiradi, kalitlarni almashtiradi va ish yakunidagi jarayonlarni boshqaradi.

README uchta ko‘rinadigan ish oynasini tasvirlaydi: qo‘mondon, tmux panellarida ishlayotgan AI legioni va nazoratchi.

Asosiy imkoniyatlar

• Mehnatni parallel taqsimlash: Razvedkachilar, askarlar, generallar va qo‘mondon alohida vazifalar bilan ishlaydi.
• Doimiy tashkiliy xotira: Alohida agent almashtirilganda ham bilim saqlanib qoladi.
• Kontekstni almashtirish: Konteksti to‘lib qolgan agentlar keyingi agentlar uchun yozma saboqlar qoldirishi mumkin.
• Model darajalari: Musobaqa konfiguratsiyasida qo‘mondon va generallar uchun GLM-5.3, razvedkachilar va askarlar uchun esa DeepSeek V4.1 Flash ishlatilgan.
• Ishlash barqarorligi: Nazoratchi qo‘mondonni qayta ishga tushirishi, kalitlarni almashtirishi va strategik qarorlar qabul qilmasdan uzluksizlikni saqlashi mumkin.
• Musobaqalar o‘rtasida uzatish: Qo‘mondon tuzilishi o‘xshash topshiriq oilalarini aniqlab, muvaffaqiyatli ish usullarini yangi tayinlangan agentlarga uzatishi mumkin.
• Fakt-maqsad CLI: Loyiha o‘z grafigini boshqarish va bir nechta topshiriq bo‘yicha ish jarayonlarini bajarish uchun buyruqlar hamda ko‘rsatmalarni taqdim etadi.

sapper CLI’ni o‘rnatish

Tezkor o‘rnatish skripti sapper CLI’ni kerakli joyga havola qiladi. README’ga ko‘ra, CLI faqat standart kutubxonadan foydalanadi va qo‘shimcha bog‘liqliklarga ega emas.

Repository ildiz katalogidan quyidagini ishga tushiring:

bash install.sh

README qo‘shimcha mahalliy talablar yoki platformaga xos o‘rnatish bosqichlarini ko‘rsatmaydi. Agar buyruq sapper’ni shell’da mavjud qilmasa, install.sh faylini tekshiring va uning simvolik havola manzili bajariladigan fayllar yo‘lingizga kiritilganini tasdiqlang.

Ruxsat berilgan tekshiruvni boshlash

sapper setup yordamida yangi tekshiruv yarating. Quyidagi misol loyiha tezkor boshlash qo‘llanmasidan olingan:

sapper setup --goal "assess http://target" --agents

http://target o‘rniga faqat yozma ruxsatingiz qamrab olgan endpointni kiriting. Agentlar noaniqliksiz vazifaga ega bo‘lishi uchun maqsad tasdiqlangan doirani aniq bayon qilishi kerak.

--agents parametri loyiha ko‘rsatgan agentlarga yo‘naltirilgan ish jarayonini boshlaydi. Sozlashdan keyin doska va joriy frontni tekshiring:

sapper status

Status ko‘rinishi ish qanday ketayotganini tekshirish uchun asosiy tezkor buyruqdir. Qo‘mondon tekshiruv vazifalarini bevosita bajarish o‘rniga nishonlarni baholash va mutaxassislarni taqsimlash uchun doskadan foydalanadi.

Minimal CLI ish jarayoni

1. Ruxsatni tasdiqlang: Nishon, vaqt oralig‘i, ruxsat etilgan usullar va to‘xtatish shartlarini vositadan tashqarida hujjatlashtiring.
2. CLI’ni o‘rnating: Klonlangan repository’dan bash install.sh buyrug‘ini ishga tushiring.
3. Maqsadni belgilang: Tasdiqlangan nishon bilan sapper setup --goal "assess http://target" --agents buyrug‘ini ishga tushiring.
4. Doskani kuzating: Doska va frontni ko‘rib chiqish uchun sapper status buyrug‘ini ishga tushiring.
5. Saqlangan bilimlarni ko‘rib chiqing: Bitta grafik operatsiyalari yoki bir nechta topshiriq bo‘yicha tekshiruvlar kerak bo‘lganda SKILL.md faylida hujjatlashtirilgan fakt-maqsad ish jarayonidan foydalaning.

To‘liq legionni Docker bilan ishga tushirish

Repozitariyda to‘liq commander asosidagi legion uchun Dockerfile mavjud. Imgeni repozitariy ildizidan yarating:

docker build -f docker/Dockerfile.commander -t sapper:latest .

Konteynerni ishga tushirishdan oldin docker/ENV.md faylida tasvirlangan model gateway’lari, kalitlar to‘plami va byudjet muhit o‘zgaruvchilarini sozlang. Bu sozlamalar muhim, chunki arxitektura turli model darajalariga turli vazifalarni yuklaydi hamda kalitlarni almashtirish va byudjetni hisobga olgan holda ishlashni qo‘llab-quvvatlaydi.

README konteynerni ishga tushirishni sxematik shaklda ko‘rsatadi:

docker run -d --name sapper ... sapper:latest

Ko‘p nuqta tayyor ishga tushiriladigan literal argument emas. Uni repozitariyning muhit hujjatlarida ko‘rsatilgan zarur muhit o‘zgaruvchilari va boshqa Docker opsiyalari bilan almashtiring. Ishlab chiqarish hisob ma’lumotlarini taxmin qilmang yoki xavfsizroq sirlarni boshqarish usuli mavjud bo‘lsa, sirlarni bevosita shell tarixiga joylamang.

Commander doktrinasini tushuning

Commanderning operatsion doktrinasi docker/commander/SKILL.md faylida saqlanadi. README bir nechta tamoyilni ta’kidlaydi:

• Avval osonlarini parallel rejalashtirish: Amalga oshirish oson bo‘lgan maqsadlarni bir vaqtning o‘zida hal qilish uchun ishlarni taqsimlang; butun legionni bitta qiyin yo‘lga majburlamang.
• Tor joy vaqtida qayta foydalanish: Operatsiya oxiriga yaqin mavjud dalillar tezda natija berishi mumkin bo‘lgan qisman hal qilingan maqsadlarni qayta ko‘rib chiqing.
• Zararni cheklash intizomi: Taraqqiyot bermayotgan ishga cheksiz vaqt yoki token sarflashdan saqlaning.
• Rollarni ajratish: Commander e’tiborini bevosita bajarishdan ko‘ra doskani o‘qish, baholash va vazifalarni taqsimlashga yo‘naltiring.

Rasmiy arxitektura shartnomasi uchun docker/commander/SPEC.md faylini o‘qing. Tizim musobaqa davomida qanday ishlaganini tushuntiruvchi retrospektiv uchun BATTLE-REPORT.md fayliga murojaat qiling.

Ilg‘or ishlash bo‘yicha maslahatlar

Ruxsat berilgan doiraga mos maqsadlar yozing

Sozlash maqsadi agentlar intiladigan missiyaga aylanadi. Tasdiqlangan maqsadni aniq bayon qiling va aloqasi bo‘lmagan xostlar yoki xizmatlarni o‘rganishga ruxsat sifatida talqin qilinishi mumkin bo‘lgan keng iboralardan saqlaning. Tashqi ruxsat hujjatlari asosiy manba bo‘lib qoladi.

Haddan tashqari katta xulosalar o‘rniga qatlamli dalillardan foydalaning

Yuqori darajadagi faktlarni ixcham saqlang, batafsil dalillarni esa ularning ostida qoldiring. Sarlavha mohiyatni yetkazishi, xulosa dolzarblikni tushuntirishi, dalillar hujjati esa tekshirishni qo‘llab-quvvatlashi kerak. Bu sapper-v2 dizayniga mos keladi va har bir tafsilotni agent kontekstiga qayta-qayta yuklashning oldini oladi.

Agentlarni almashtirishda o‘rganilgan saboqlarni saqlang

Loyiha kampaniya davomida askar kontekstining to‘yinganligini taxminan 260,000 token darajasida o‘lchadi. Uning javobi ishchini qayta ishga tushirish va uning o‘rnini egallovchi uchun qo‘llanma qoldirishdan iborat bo‘ldi. Operatsiya natijalarini ko‘rib chiqishda tasdiqlangan topilmalar, sinab ko‘rilgan yondashuvlar, hal qilinmagan savollar va qayta foydalanish mumkin bo‘lgan tartiblarni o‘z ichiga olgan aniq topshirish qaydlariga ustunlik bering.

Strategiyani mavjudlikdan ajrating

Watchdog ataylab strategik rolga ega emas. Qayta tiklash xatti-harakatlari, kalitlarni almashtirish va jarayonlarni qayta ishga tushirishni maqsadlar va taktika haqidagi qarorlardan alohida saqlang. Bu amal commander tomonidanmi yoki ishlashni davom ettirish avtomatizatsiyasidanmi kelganini aniqlashni osonlashtiradi.

Token va model xarajatlarini nazorat qiling

sapper-v2 musobaqa arxitekturasi yuqori darajadagi qaror qabul qilish uchun kuchliroq modellarni, katta hajmdagi razvedka va bajarish uchun esa yengilroq modellarni belgilagan. Hujjatlashtirilgan konfiguratsiyani takrorlasangiz, gateway’lar, kalitlar to‘plami va byudjetlarni Docker muhiti bo‘yicha ko‘rsatmalar orqali sozlang hamda ruxsat etilgan ish davomida sarfni kuzatib boring.

O‘tkazilgan bilimlarga ishonishdan oldin dalillarni tekshiring

Maqsadlar bir xil tuzilishga ega bo‘lsa, chaqiriqlar o‘rtasida bilim almashish ishni tezlashtirishi mumkin, ammo o‘xshashliklar tekshiruv o‘rnini bosa olmaydi. Meros qilib olingan qo‘llanmani boshqa chaqiriqqa qo‘llashdan oldin xulosalar va ularni qo‘llab-quvvatlovchi dalillarni qatlamli grafik orqali tekshiring.

Xavfsizlik va mas’uliyatli foydalanish

sapper-v2 hujumkor xavfsizlik vositasi bo‘lib, undan ruxsatsiz kirish uchun foydalanish mumkin emas. Uning README faylida AI hujumkor vositalar yetkazadigan zararni kuchaytirishi mumkinligi aniq ogohlantiriladi. Amaldagi qonunlarga rioya qiling, aniq ruxsat oling, maqsad doirasini cheklang, byudjet va to‘xtatish shartlarini belgilang hamda muhitga mos inson nazoratini saqlang.

Loyiha kelajakdagi taggant mexanizmini ham taklif qiladi: hujumkor harness’ga biriktiriladigan belgilar noqonuniy tajovuzlar vaqtida jabrlanuvchilarga identifikatsiya ma’lumotlarini sizdirishi va atributsiyani qo‘llab-quvvatlashi mumkin. README buni foydalanuvchilar bugun tayanishi mumkin bo‘lgan mavjud himoya sifatida emas, balki kriptografik va hamjamiyat dizaynini talab qiladigan taklif sifatida taqdim etadi.

Xulosa

sapper-v2 avtonom xavfsizlik baholashiga kooperativ yondashuvni namoyish etadi: commander ishni taqsimlaydi, mutaxassislar parallel ishlaydi, watchdog uzluksizlikni ta’minlaydi, qatlamli faktlar grafigi esa tashkiliy bilimlarni saqlaydi. Yengil CLI’dan boshlang, doskani sapper status orqali kuzating va to‘liq legion kerak bo‘lganda Docker sozlamasidan foydalaning. Har bir ishni doimo aniq ruxsat va loyiha disclaimersi doirasida olib boring.