BCheck ta'riflari ma'lumotnomasi

Ushbu sahifada BCheck yozishda foydalanish mumkin bo'lgan kalit so'zlar batafsil keltirilgan. Majburiy xususiyatlar yulduzcha (*) bilan belgilangan.

Metadata

Tekshiruvning o'zi haqidagi ma'lumotni o'z ichiga oladi. metadata obyekti barcha BCheck'lar uchun majburiy va ta'rifning eng boshiga joylashtirilishi shart.

metadata

Boshqaruv oqimi

Ushbu kalit so'zlar ta'rifning bajarilish oqimini boshqaradi.

run for each

Ustidan iteratsiya qilish mumkin bo'lgan massiv o'zgaruvchisini e'lon qiladi. O'zgaruvchi chaqirilganda tekshiruv massivdagi har bir element uchun bir marta ishga tushadi. E'lon qilingan o'zgaruvchi tashqi ko'rinish sohasiga (outer scope) ega.

run for each kalit so'zi ixtiyoriy. Agar undan foydalansangiz, uni ta'rifingizdagi given...then operatoridan oldin joylashtirishingiz shart.

define

Ichki ko'rinish sohasiga (inner scope) ega o'zgaruvchilarni e'lon qiladi. define kalit so'zi ixtiyoriy. Agar undan foydalansangiz, uni ta'rifingizdagi given...then operatoridan oldin joylashtirishingiz shart.

given...then

Audit qilinayotgan kontentga asoslanib, tekshiruv qachon ishga tushishini belgilaydi.

Har bir BCheck quyidagilarni o'z ichiga olgan bitta given / then operatoriga ega bo'lishi shart:

YOKI quyidagilardan biri:

• given response then - tekshiruv audit qilinadigan har bir javob uchun bir marta ishga tushadi.
• given request then - tekshiruv audit qilinadigan har bir so'rov uchun bir marta ishga tushadi.
• given host then - tekshiruv audit qilinadigan har bir host uchun bir marta ishga tushadi.
• given path then - tekshiruv audit qilinadigan har bir noyob yo'l (path) uchun bir marta ishga tushadi.

YOKI quyidagi insertion point kalit so'zlaridan biri:

• given any insertion point then - tekshiruv audit qilinadigan har bir insertion point (har qanday turdagi) uchun bir marta ishga tushadi. Agar siz insertion point turini ko'rsatmasangiz (ya'ni given insertion point dan foydalansangiz), Burp Scanner ham shu sukut bo'yicha variantdan foydalanadi.
• given query insertion point then - tekshiruv audit qilinadigan har bir query uchun bir marta ishga tushadi.
• given header insertion point then - tekshiruv audit qilinadigan har bir sarlavha (header) uchun bir marta ishga tushadi.
• given body insertion point then - tekshiruv audit qilinadigan har bir body kontenti uchun bir marta ishga tushadi.
• given cookie insertion point then - tekshiruv audit qilinadigan har bir cookie uchun bir marta ishga tushadi.

Insertion point'larni birlashtirish uchun or kalit so'zidan foydalanishingiz mumkin. Masalan:

• given query or body insertion point then - tekshiruv audit qilinadigan har bir query yoki body kontenti uchun bir marta ishga tushadi.
• given header or cookie insertion point then - tekshiruv audit qilinadigan har bir sarlavha yoki cookie uchun bir marta ishga tushadi.

Shartli operatorlar

Ushbu kalit so'zlar belgilangan shart natijasida sodir bo'ladigan amallarni boshqaradi. Shartli kalit so'zlardan faqat given...then operatori ichida foydalanishingiz mumkin.

if... then

Belgilangan shart bajarilsa, amalni bajaradi. Quyidagilar talab qilinadi:

• Shart.
• Amal.
• end if kalit so'zi.

else if... then

if operatori ichida ishlatiladi. Agar oldingi shart noto'g'ri va else if sharti to'g'ri bo'lsa, amalni bajaradi. Bitta BCheck ichida bir nechta else if operatoridan foydalanishingiz mumkin.

else then

if operatori ichida ishlatiladi. Agar operatorning sharti va undan oldingi barcha else / if operatorlarining sharti bajarilmasa, amalni bajaradi.

end if

if operatorining oxirini bildiradi.

Shartlar

if operatorlarida quyidagi shartlardan foydalanishingiz mumkin:

• {X} matches "[regex]" - agar X berilgan regex'ga mos kelsa, to'g'ri (true).
• {X} differs from {Y} - agar X javobi Y javobidan farq qilsa, to'g'ri.
• {X} in {Y} - agar Y tarkibida X bo'lsa, to'g'ri (masalan, Y javob bo'lishi, X esa o'sha javob ichida qidiriladigan sarlavha bo'lishi mumkin).
• {X} is {Y} - agar berilgan parametrlar bir xil bo'lsa, to'g'ri.
• any interactions - agar Burp Collaborator biror o'zaro aloqani qabul qilgan bo'lsa, to'g'ri.
• dns interactions - agar Burp Collaborator biror DNS o'zaro aloqasini qabul qilgan bo'lsa, to'g'ri.
• http interactions - agar Burp Collaborator biror HTTP o'zaro aloqasini qabul qilgan bo'lsa, to'g'ri.
• smtp interactions - agar Burp Collaborator biror SMTP o'zaro aloqasini qabul qilgan bo'lsa, to'g'ri.

Shuningdek, shartlarni birlashtirishingiz va o'zgartirishingiz mumkin:

• {condition} and {condition} - agar ikkala shart ham to'g'ri bo'lsa, to'g'ri.
• {condition} or {condition} - agar shartlardan biri yoki ikkalasi to'g'ri bo'lsa, to'g'ri.
• not({condition}) - agar shart to'g'ri bo'lmasa, to'g'ri.

Qavslar

Tekshiruvlaringizdagi mantiq oqimini aniqlashtirish uchun shartlarda qavslardan foydalanishingiz mumkin.

Masalan, A or B and C quyidagi shartlardan biri bajarilganda to'g'ri qiymat beradigan shartni yaratadi:

• A to'g'ri.
• B ham, C ham to'g'ri.

Biroq (A or B) and C quyidagi shartlarning ikkalasi ham bajarilganda to'g'ri qiymat beradigan shartni yaratadi:

• A yoki B to'g'ri.
• C to'g'ri.

Amallar

Ushbu kalit so'zlar Burp Scanner'ni muayyan amalni bajarishga undaydi.

send request

Ko'rsatilgan ma'lumotni o'z ichiga olgan so'rovni yuboradi. given response dan tashqari barcha skanerlash tekshiruvi rejimlari bilan ishlatilishi mumkin.

send request (raw)

Ko'rsatilgan ma'lumotni o'z ichiga olgan so'rovni xom (raw) HTTP so'rovi sifatida yuboradi. given response dan tashqari barcha skanerlash tekshiruvi rejimlari bilan ishlatilishi mumkin.

send payload

Ko'rsatilgan payload qo'shilgan yoki almashtirilgan yangi so'rovni yuboradi. Faqat given insertion point bilan ishlatilishi mumkin.

report issue

Burp Scanner'ni muammo haqida xabar berishga majbur qiladi. Bu BCheck'ni tugatadi, hatto tekshiruvning hali ishga tushmagan qismlari bo'lsa ham.

Masalan, quyidagi BCheck'ni ko'rib chiqing:

Bu tekshiruv o'zining Burp Collaborator payload'i natijasida yuzaga kelgan avval DNS, keyin esa HTTP o'zaro aloqalarini qidiradi. Biroq, agar tekshiruv DNS o'zaro aloqasini topsa, u birinchi report issue amalini bajaradi va HTTP o'zaro aloqalari mavjud bo'lsa ham, ular haqida keyinchalik xabar bermaydi.

report issue and continue

Burp Scanner'ni muammo haqida xabar berishga, so'ngra BCheck'ni ishga tushirishda davom etishga majbur qiladi. Masalan, quyidagi BCheck'ni ko'rib chiqing:

Bu tekshiruv o'zining Burp Collaborator payload'i natijasida yuzaga kelgan avval DNS, keyin esa HTTP o'zaro aloqalarini qidiradi. Agar tekshiruv DNS o'zaro aloqasini topsa, u birinchi report issue amalini bajaradi. So'ngra u tekshiruvni davom ettiradi va keyingi barcha HTTP o'zaro aloqalari haqida xabar beradi.

Muammolar haqida xabar berish

BCheck'larda muammolar haqida report issue yoki report issue and continue kalit so'zlari yordamida xabar berishingiz mumkin. Bu kalit so'z bloklarining ikkalasi ham bir xil xususiyatlarga ega.

Muammolarni nomlash

BCheck'lar xabar qilgan barcha muammolar Declarative Scan Check Generated muammo turiga ega. Muammoning nomi quyidagicha aniqlanadi:

• Agar tegishli report issue yoki report issue and continue blokida name kalit so'zi bo'lsa, Burp'da muammo nomi sifatida shu qiymat ko'rsatiladi.
• Agar tegishli report issue yoki report issue and continue blokida name kalit so'zi bo'lmasa, muammo nomi BCheck'ning name metadata xususiyatidan olinadi.

report issue blokiga name kalit so'zini qo'shish muayyan holatlarda muammo haqida xabar berishda ishlatiladigan nomni bekor qilish imkonini beradi. Bu bitta BCheck'dan turli xil muammo turlari haqida xabar berishda foydali. Masalan, sizda o'xshash xatoliklarning bir necha xil variantlari haqida xabar bera oladigan yagona BCheck bo'lishi mumkin.

Muammolarni birlashtirish

Birlashtirish (consolidation) — bu Burp interfeysdagi ortiqcha shovqinni kamaytirish uchun takrorlanuvchi muammolarni jamlaydigan jarayon.

Agar quyidagi ikkala shart ham to'g'ri bo'lsa, Burp BCheck'lar qaytargan muammolarga o'zining odatdagi birlashtirish qoidalarini qo'llaydi:

• Ikkala muammo ham bitta BCheck tomonidan xabar qilingan.
• Ikkala muammo bir xil nomga ega, bu nom metadata'dan olinganmi yoki report issue blokidagi parametrdan olinganmi — ahamiyati yo'q.

Zaxiralangan o'zgaruvchilar

Ushbu kalit so'zlar muayyan so'rov yoki javob xususiyatlariga ishora qiladi.

request / response

Ushbu kalit so'zlar muayyan so'rov yoki javob xususiyatlariga ishora qiladi. Siz quyidagilarga murojaat qilishingiz mumkin:

• base - crawl davomida ko'rsatilgan skanerlash rejimi uchun Burp Scanner yuborgan so'rov va qabul qilgan javob.
• latest - ushbu skanerlash rejimi uchun eng so'nggi so'rov / javob juftligi.
• {request_name} - called kalit so'zi yordamida nomlangan muayyan so'rov / javob juftligi.

Javob

So'rov

user_agent

Burp'ning user agent'ini qaytaradi.

insertion_point_base_value

Ko'rsatilgan insertion point'ning bazaviy qiymatini qaytaradi.

Funksiyalar

Ushbu kalit so'zlar chaqirilganda muayyan vazifani bajaradi.

E'tibor bering, barcha BCheck funksiyalari jingalak qavslar {} bilan belgilanadi.

random_str

{random_str(int)}

Ko'rsatilgan uzunlikdagi tasodifiy satrni qaytaradi. Uzunlik 0 va 9,999,999 orasida bo'lishi kerak. 0 kiritilsa, bo'sh satr qaytariladi.

regex_replace

regex_replace (String source, String regex, String replacement)

Manba satrni oladi va ko'rsatilgan regex shabloniga mos keluvchi har qanday kontentni almashtiruvchi satr bilan almashtiradi.

to_lower

{to_lower(string)}

Ko'rsatilgan satrni kichik harflarga o'giradi.

to_upper

{to_upper(string)}

Ko'rsatilgan satrni katta harflarga o'giradi.

base64_encode

{base64_encode(string)}

Ko'rsatilgan satrni base64 bilan kodlaydi.

base64_decode

{base64_decode(string)}

Ko'rsatilgan satrni base64'dan dekodlaydi.

generate_collaborator_address

{generate_collaborator_address}

So'rov ichida foydalanish uchun yangi Burp Collaborator manzilini yaratadi. {generate_collaborator_address} ni bir necha marta chaqirib, bitta BCheck ichida bir nechta manzil yaratishingiz mumkin.

SHA1

sha1(String)

Berilgan kiritmani SHA1 hash funksiyasi yordamida hash qiladi.

SHA256

sha256(String)

Berilgan kiritmani SHA256 hash funksiyasi yordamida hash qiladi.

MD5

md5(String)

Berilgan kiritmani MD5 hash funksiyasi yordamida hash qiladi.

Funksiyalarni birlashtirish

Zarur bo'lsa, bu funksiyalarni bir-birining ichiga joylashtirish mumkin. Masalan, quyidagi funksiya o'zgaruvchini kichik harflarga o'giradi va so'ngra uni bitta amalda base64 sifatida kodlaydi:

{base64_encode(to_lower(my_variable))}

Turli ma'lumotlar

Satrlar

Interpolyatsiya qilinadigan va literal satrlarning ikkalasi ham qabul qilinadi:

• Literal satrlarni belgilash uchun qo'shtirnoqlardan ("") foydalaning - "delete carlos"
• Interpolyatsiya qilinadigan satrlarni belgilash uchun teskari apostroflardan (```) foydalaning - https://{random_str(5)}.com`

Ko'p qatorli satrlarni qayta ishlaganda Burp Scanner qator oxirlarini \r\n bilan almashtiradi va har bir qatordagi boshidagi hamda oxiridagi bo'shliqlarni olib tashlaydi (ochuvchi qo'shtirnoqdan keyin va yopuvchi qo'shtirnoqdan oldin turgan bo'shliqlar bundan mustasno).

Masalan:

quyidagiga aylanadi

Interpolyatsiya qilinadigan satrlarda boshidagi/oxiridagi bo'shliqlarni aniq ko'rsatish uchun uning o'rniga \s belgisidan foydalaning.

Belgilarni ekranlash

Satrlar ichida belgilarni ekranlash uchun \ belgisidan foydalaning.

Masalan, \{var} ekranlangan, {var} esa var qiymatini chiqaradi.

Regex

BCheck'lar Java uslubidagi regex'ni qo'llab-quvvatlaydi.

"2[0-9][0-9]"

Izohlar

Izoh qatorlarini belgilash uchun # dan foydalaning.

#Hello

Maxsus belgilar

Bu belgilardan interpolyatsiya qilinadigan satrning bir qismi sifatida foydalanish mumkin. Masalan, '\s' bo'shliq sifatida talqin qilinadi, literal satr "\s" esa ikkita alohida belgi sifatida talqin qilinadi.

• \n - yangi qator
• \r - karetkani qaytarish
• \s - bo'shliq
• \t - tabulyatsiya
• \b - backspace
• \f - sahifani o'tkazish (form feed)

BCheck tuzilishi

Yaroqli BCheck'lar yaratish uchun quyidagi tuzilma qoidalariga amal qilishingiz kerak:

• Har bir ta'rif metadata obyekti bilan boshlanishi shart.
• Har bir ta'rifda aynan bitta given... then operatori bo'lishi shart.
• Shartli operatorlar faqat given... then operatori ichida kelishi mumkin.
• Ishlatilgan har qanday define yoki run for each operatori metadata blokidan keyin, lekin given... then operatoridan oldin joylashtirilishi shart.
• run for each yordamida e'lon qilingan o'zgaruvchilar tashqi ko'rinish sohasiga, define yordamida e'lon qilinganlari esa ichki ko'rinish sohasiga ega. Ya'ni, define orqali e'lon qilingan o'zgaruvchidan keyingi run for each operatorida foydalana olmaysiz.