Verfy nima qiladi va qayerda to'xtaydi
Quyidagi har bir imkoniyat yonida uning cheklovlari yozilgan. Verfy faqat ko'rsata oladigan narsasini da'vo qiladi.
Verfy Lock
verfy.lock har bir tool'ning kanonik nomi, tavsifi va kiritma sxemasining SHA-256 qiymatini, server yuborsa sarlavhasi, annotatsiyalari va chiqish sxemasini ham qulflaydi. MCP prompt'lari ham xuddi shunday qulflanadi.
- O'zgarish
- Tavsifi o'zgargan tool agentdan yashiriladi va unga chaqiruvlar rad etiladi (VFY-TOOL-004), toki kimdir o'zgarishni tasdiqlamaguncha.
- Yangi tool'lar
- Allaqachon qulflangan serverga qo'shilgan tool standart holatda tasdiq talab qiladi (VFY-TOOL-006).
- Ko'rib chiqish
- verfy lock diff ko'rinmas belgilarni ochiq yozgan holda tushunarli diff ko'rsatadi; verfy lock approve uni kim qabul qilganini yozib qo'yadi.
- Server kodi
- Server birorta tool'ni o'zgartirmasdan kodini o'zgartirishi mumkin. npx, uvx yoki pipx aniq versiya bilan ishga tushiradigan server uchun verfy.lock paketni va registry'dagi shu reliz hash'ini ham yozib qo'yadi; ulardan biri o'zgarsa, tekshiruv yiqiladi. verfy lock pin pkg@latest ni aniq versiyaga aylantiradi (0.19.0 dan).
- Orqaga qaytarish
- Yangilanish tool'ni o'zgartirgan bo'lsa, verfy lock rollback lock'ga mos relizga qaytadi. Masofaviy serverning oldingi relizi yo'q, shuning uchun uning o'zgargan tool'i odam tasdiqlamaguncha bloklangan qoladi.
- CI
- verfy lock check .mcp.json'dagi serverlarni ishga tushiradi va ularni commit qilingan verfy.lock bilan solishtiradi. Uni CI'da ishga tushiring, tool o'zgargan har bir pull request tekshiruvdan yiqiladi.
- Jamoa
- Qurilmalar o'zgarish taklif qiladi; owner yoki admin panelda bir marta tasdiqlaydi va har bir qurilma uni verfy team pull bilan oladi.
- Ogohlantirishlar
- Chaqiruv tasdiq kutayotganda, tool tavsifi o'zgarganda, chaqiruvlar rad etilganda yoki qurilma bir kun kvitansiya yubormay qo'yganda Slack yoki Telegram'ga xabar. Slack'da o'zgargan tool bilan Approve va Reject tugmalari kelishi mumkin (beta).
- Tasdiq navbati
- "on_ask": "team" bilan tasdiq kerak bo'lgan gateway chaqiruvi panelda owner yoki adminni kutadi, keyin bajariladi yoki rad etiladi. Faqat argumentlar hash'i yuboriladi.
Verfy Receipts
Har bir qaror Ed25519 bilan imzolangan va SHA-256 bilan zanjirga bog'langan verfy.receipt/1 yozuviga aylanadi.
- Tarkibi
- Tartib raqami, oldingi hash, vaqt, agent, sessiya, server, tool, amal turi, argumentlarning tuzli SHA-256 qiymati, verdict, qoida ID'lari, siyosat hash'i, tool digest'i va natija.
- Maxfiylik
- Argumentlar va natijalar standart holatda hash sifatida saqlanadi. Sirlari yashirilgan argumentlarni saqlash mahalliy sozlamada aniq yoqiladi.
- Tekshirish
- verfy verify har bir imzo va bog'lanishni internetsiz tekshiradi. Verfy Cloud ularni yuklashda va so'rov bo'yicha yana tekshiradi.
- Standart format
- verfy scitt export har bir kvitansiyani IETF SCITT imzolangan bayonoti (CWT da'volari bilan COSE_Sign1) sifatida yozadi, shuning uchun uni SCITT shaffoflik xizmati yoki istalgan COSE kutubxonasi tekshira oladi. Verfy o'zining shaffoflik xizmatini yuritmaydi.
Verfy Guard
Claude Code PreToolUse hook'iga, Codex yoki Gemini CLI hook'iga, Cursor, Copilot yoki Devin Desktop hook'iga (beta) yoki MCP gateway'ga yetib kelgan har bir tool chaqiruvini qat'iy qoidalar bilan oldindan tekshirish.
- Shell
- Uy papkasi, ildiz yoki loyihani rekursiv o'chirish, diskni formatdan o'tkazish, fork bomb'lar, force-push, nashr va deploy buyruqlari, sudo, curl'dan shell'ga, tarmoqdan ham foydalanadigan buyruqda sirlarni o'qish.
- Fayllar
- Himoyalangan yo'llarga yozish (~/.ssh, /etc, git hook'lari, shell profillari, Verfy papkasi), .env va maxfiy kalitlar kabi nozik fayllar, loyihadan tashqariga yozish.
- Tarmoq
- Bulut metadata manzillari, tunnellar va request bin'lar, URL ichidagi login-parollar, qolgan hamma narsa uchun ruxsat ro'yxati.
- Ma'lumot va pul
- WHERE'siz buzuvchi SQL, to'lov limitlari, kunlik byudjetlar, noma'lum qabul qiluvchilar, argumentlardagi sirlar.
- Tashqi matndan keyin
- session.after_outside_text bilan sessiya veb-sahifa yoki tool javobini o'qigach, quyidagilar ushlab turiladi: network.allow'da yo'q saytlarga so'rovlar, git push, kalit faylini o'qish, loyihadan tashqariga yozish, xabarlar, to'lovlar va o'chirishlar (VFY-SESSION-001). Standart holatda o'chiq. ask qiymatida ular odamni kutadi; strict shablondagidek deny qiymatida rad etiladi. Matnni hech qanday model o'qimaydi.
- Cursor (beta)
- verfy hook install --cursor --write Cursor'ning terminal buyruqlari, fayllarni o'qish, yozish va o'chirish hamda MCP chaqiruvlarini ishga tushishidan oldin tekshiradi va MCP natijalaridan kalitlarni olib tashlaydi. U Cursor hujjatlariga asoslangan va hali Cursor'ning o'zida ishlatib ko'rilmagan; veb-qidiruv qamrab olinmagan.
- Agent o'chira olmaydigan hook'lar
- Administrator sifatida ishga tushirilgan verfy setup --system --write Claude Code va Cursor hook'larini butun kompyuter uchun fayllarga yozadi. Agent siz nomingizdan ishlaydi, shuning uchun ularni o'zgartira olmaydi, hatto o'zi yozib ishga tushirgan skript bilan ham.
- So'rovlardagi maxfiy kalitlar
- API kaliti, token yoki yopiq kalit bor so'rov modelga yetib borishidan oldin to'xtatiladi, Claude Code, Codex va Cursor'da, imzolangan kvitansiya bilan. Kalitning o'zi saqlanmaydi.
- Agentlarning xavfli sozlamalari
- verfy posture har bir agentning o'z sozlamalarini o'qiydi va ularni zaiflashtiradigan narsani aytadi: bypassPermissions, approval_policy = never, o'chirilgan sandbox, o'chirilgan hook'lar.
- VS Code, Cursor, Devin Desktop (beta)
- Editor extension'i Verfy'ni editorning ichidan sozlaydi va editor terminalini sandbox ichida ochib bera oladi: agent buyruqlari faqat loyihaga yoza oladi va faqat policy'dagi hostlarga ulanadi.
- Barcha agentlar bitta buyruqda
- verfy setup --write kompyuterdagi Claude Code, Cursor, Codex, Gemini CLI, Copilot, Devin Desktop (Windsurf) va Claude Desktop'ni topadi, har biriga hook qo'shadi va MCP serverlarini gateway ortiga qo'yadi; har bir faylning nusxasi saqlanadi.
- Codex va Gemini CLI
- verfy hook install --codex yoki --gemini shu tekshiruvni bu agentlarga ham qo'shadi: terminal buyruqlari, fayllarga murojaat va MCP chaqiruvlari, Codex patch'idagi har bir fayl ham. Verfy odamdan so'raydigan joyda Gemini sizdan so'raydi; Codex'da hook uchun «ask» yo'q, shuning uchun Verfy amalni to'xtatadi va agentga sizdan so'rashni aytadi. Gemini hook'i Gemini CLI'ning o'z hook kodi orqali ishlatib tekshirilgan, Codex hook'i Codex'ning manba kodi bilan solishtirilgan.
- Copilot, Devin Desktop (beta)
- verfy hook install --copilot yoki --devin xuddi shuni GitHub Copilot (CLI va VS Code) va Devin Desktop uchun qiladi; Windsurf endi shunday ataladi. Copilot sizdan so'raydi, Devin to'xtatadi. Ular agentlarning hujjatlariga asoslangan, chunki kodi yopiq, va hali ularning o'zida ishlatib ko'rilmagan.
- Masofaviy serverlar
- verfy proxy --name NAME --url URL masofaviy MCP serverni Streamable HTTP yoki eskiroq SSE orqali gateway ortiga qo'yadi. Kalit faqat o'sha manzilga boradi. OAuth orqali kirish hali qo'llab-quvvatlanmaydi.
- O'z qoidalaringiz
- Tool'lar uchun deny/ask ro'yxatlari, tool yoki argument bo'yicha o'z regex qoidalaringiz, o'chirilgan qoidalar, hammasi bitta JSON siyosatda. Shablondan boshlang: strict, read-only yoki ci.
- Chiqishdagi sirlar
- MCP gateway tool natijalaridagi API kalitlari, tokenlar va maxfiy kalitlarni agent o'qishidan oldin [REDACTED:rule] bilan almashtiradi. Claude Code'ning o'rnatilgan tool'lari chiqishi o'zgartirilmaydi.
- O'zini himoya qilish
- Agent Verfy'ni o'z tool'lari bilan o'chira olmaydi: hook sozlamalari, verfy.lock, siyosat yoki Verfy o'rnatmasini o'zgartirish rad etiladi, verfy lock approve'ni ishga tushirish yoki Verfy'ni o'chirish ham. MCP konfiglaridagi o'zgarishlar tasdiq talab qiladi.
Verfy Scan
Claude Code (.mcp.json, ~/.claude.json), Cursor va Claude Desktop konfiglaridagi MCP serverlarni topadi va tool tavsiflarini tekshiradi.
- Konfig tekshiruvi
- Qulflanmagan npx/uvx paketlari, curl | sh orqali ishga tushirish, oddiy http'dagi masofaviy serverlar, avtorizatsiyasiz masofaviy serverlar, konfiglarga yozilgan sirlar, imtiyozli konteynerlar.
- Tool tekshiruvi
- Yashirin ko'rsatmalar va tool zaharlash, boshqa tool'lar xatti-harakatini o'zgartiradigan ko'rsatmalar (shadowing), ko'rinmas Unicode, uzun kodlangan bloklar, sirlar, chalg'ituvchi read-only belgilari.
- Natijalar
- Har bir topilmada qoida ID'si, jiddiylik darajasi, qayerda topilgani va nima qilish kerakligi bor. CI uchun --json chiqishi va exit code'lar.
Verfy Sandbox
Verfy o'zi sandbox emas, lekin uni ishga tushira oladi. verfy run --sandbox buyruqni, MCP serverni yoki agentni siyosatingizdagi sozlamalar bilan Anthropic'ning ochiq kodli sandbox'i (srt) ichida ishga tushiradi. Bu bepul, CLI ichida va har bir buyruq uchun alohida yoqiladi.
- Tarmoq
- Siyosatingizdagi network.allow yoki --allow-host nomlamagan hech bir host'ga ulanib bo'lmaydi, network.deny esa ustun.
- Fayllar
- --allow-write boshqasini qo'shmasa, yozish shu papkada qoladi, u yerda ham verfy.lock, siyosat, .mcp.json, .claude va .cursor papkalari va git hook'lari yopiq, hali mavjud bo'lmasa ham, chunki keyin nima ishga tushishini ular hal qiladi. ~/.ssh, ~/.aws, boshqa login ma'lumotlari yo'llari va siyosatingizdagi nozik fayllarni o'qib bo'lmaydi.
- Muhit
- Buyruqqa faqat PATH, HOME va boshqa asosiy o'zgaruvchilar yetadi, shuning uchun muhitingizdagi API kalitlari tashqarida qoladi. --allow-env NAME bittasini ichkariga o'tkazadi, --agent bilan esa agentning o'z ANTHROPIC_ va CLAUDE_ o'zgaruvchilari kiradi.
- MCP serverlar
- Uni verfy proxy ortiga qo'ying: Verfy serverning tool chaqiruvlarini tekshiradi, serverning o'zi nima qilishini esa operatsion tizim ushlab turadi.
- Agent
- --agent bilan agent ham ichkarida ishlaydi va uning Verfy hook'i kvitansiyalarni imzolashda davom etadi.
- Claude Code sandbox'i
- verfy sandbox status uning sozlamalari nimani ochiq qoldirishini ko'rsatadi; verfy sandbox sync --write yetishmaganini qo'shadi va zaxira nusxa saqlaydi.
- Windows
- Oddiy Windows'da sandbox yo'q, shuning uchun u yerda buyruq WSL2 ichidagi verfy run'ga boradi, u yerda verfy va srt o'rnatilgan bo'lishi kerak. Windows foydalanuvchisining login ma'lumotlari papkalari ham yopiq.
- Jimgina boshqa yo'lga o'tmaydi
- srt bo'lmasa, buyruq yoza oladigan papkada tursa yoki Windows'da verfy va srt bilan WSL2 bo'lmasa, buyruq ishga tushmaydi.
- Ochiq sinovdan o'tgan
- CI job'i uni haqiqiy macOS va Linux mashinalarida va WSL2 orqali Windows'da ishga tushiradi va operatsion tizim nimani rad etishini tekshiradi.
Biz joylashtiradigan xizmat
Verfy joylashtiradi, har bir jadvalda qator darajasidagi himoya va ilova orqali qilingan har bir o'zgarish uchun audit yozuvi bilan. Uning kodi yopiq; kompyuterlaringizda ishlaydigan CLI ochiq. Xavfsizlik modeli bu qanday ta'minlangan va sinalganini va qayerda tugashini ko'rsatadi.
Tarixli siyosatlar
Jamoa siyosatini JSON sifatida tahrirlang, tekshiring va har bir e'lon qilingan versiyani kim e'lon qilgani bilan ko'ring.
Siyosat simulyatori
E'lon qilishdan oldin Verfy agentning namunaviy amallari to'plamini qayta o'ynaydi va kundalik ishning ko'pini bloklaydigan siyosatni qabul qilmaydi.
Lock tasdiqlari
Tasdiqlangan versiyaga nisbatan diff bilan kutayotgan tool o'zgarishlari; tasdiqlash yoki rad etish, audit jurnaliga yoziladi.
Qurilmalar
Noutbuk va CI runner'larni bir martalik kodlar bilan ulang, oxirgi marta qachon sinxronlanganini ko'ring, bir zumda bekor qiling.
Kvitansiyalar
Verdict, tool, qurilma va sana bo'yicha qidirish va saralash; istalgan kvitansiyani ochib, imzo tekshiruvi va zanjirdagi o'rnini ko'ring.
Dalillar eksporti
SHA-256 hash'lari va ochiq kalitlari bilan JSONL va manifest, 60 soniyalik havolalar orqali yuklab olinadi.
Rollar
Owner, admin, member va auditor, shunchaki yashirin tugmalar bilan emas, Postgres qator darajasidagi himoyasi bilan ta'minlangan.
Audit jurnali
Har bir siyosat, a'zo, qurilma, lock va eksport o'zgarishining hash bilan bog'langan, faqat qo'shiladigan yozuvi.