HTTPQL وStreamQL

يستخدم Ogma مجموعة فرعية من لغة استعلام متوافقة مع Caido لتصفية سجل HTTP وحركة WebSocket ونتائج الأتمتة والعروض ذات الصلة.

الصيغة

تتكون الاستعلامات من شروط تُربط باستخدام AND وOR.

req.host:example.com AND resp.code:200

تُستخدم الأقواس لتجميع التعبيرات:

(req.path.cont:"/api/" OR req.path.cont:"/graphql") AND resp.code.gte:400

تدعم اللغة التعليقات:

// API errors
req.path.cont:"/api/" AND resp.code.gte:500

/* focus on login */
req.path.cont:"login"

المعاملات

المعامل	المعنى
:	يساوي أو يطابق وفق السلوك الافتراضي، بحسب نوع الحقل
.eq:	يساوي
.ne:	لا يساوي
.cont:	يحتوي، دون مراعاة حالة الأحرف
.ncont:	لا يحتوي، دون مراعاة حالة الأحرف
.cs.cont:	يحتوي، مع مراعاة حالة الأحرف
.cs.ncont:	لا يحتوي، مع مراعاة حالة الأحرف
.like:	مطابقة نمط على غرار SQL
.nlike:	عدم مطابقة نمط على غرار SQL
.regex:	مطابقة تعبير نمطي
.nregex:	عدم مطابقة تعبير نمطي
.lt:	أصغر من
.lte:	أصغر من أو يساوي
.gt:	أكبر من
.gte:	أكبر من أو يساوي
.exists	الترويسة موجودة؛ استخدم req.header["Name"].value.exists أو ما يقابله للاستجابة

أمثلة HTTP

البحث عن حركة API:

req.path.cont:"/api/"

البحث عن أخطاء الخادم:

resp.code.gte:500

البحث عن الاستجابات الكبيرة:

resp.len.gt:100000

البحث عن استجابات JSON:

resp.header["content-type"].value.cont:"application/json"

البحث عن الطلبات التي تحتوي على ملفات تعريف ارتباط:

req.header["cookie"].value.exists

البحث عن حركة المرور التي عُدّلت بالاعتراض أو بالمطابقة والاستبدال:

req.modified.eq:true

البحث عن المسارات التي يُحتمل أنها مخصصة للإدارة:

req.path.cont:"/admin" OR req.path.cont:"/manage"

البحث عن حركة إعادة الإرسال أو الأتمتة:

source:replay OR source:automate

أمثلة التدفقات

يطبّق StreamQL أسلوب الاستعلام نفسه على عروض WebSocket والتدفقات.

البحث عن رسائل WebSocket التي تحتوي على حقل رمز مميز:

ws.raw.cont:"token"

البحث عن الرسائل من الخادم إلى العميل:

ws.direction.eq:"To Client"

البحث عن الرسائل التي تشبه JSON:

ws.raw.cont:"{" AND ws.raw.cont:"}"

مرشحات محفوظة عملية

الاسم	الاستعلام
أخطاء API	req.path.cont:"/api/" AND resp.code.gte:400
نقاط نهاية المصادقة	req.path.cont:"login" OR req.path.cont:"oauth" OR req.path.cont:"session"
حركة JSON	resp.header["content-type"].value.cont:"json"
طرق جديرة بالاهتمام	req.method:POST OR req.method:PUT OR req.method:PATCH OR req.method:DELETE
أسرار محتملة	resp.body.cont:"api_key" OR resp.body.cont:"secret" OR resp.body.cont:"token"

الحدود

لإبقاء سلوك المرشحات قابلًا للتوقع، يحدّ Ogma من تعقيد الاستعلامات:

• الحد الأقصى لعمق التعبيرات المتداخلة: 16.
• الحد الأقصى لعدد الشروط: 64.

إذا أصبح الاستعلام معقدًا أكثر من اللازم، فقسّمه إلى مرشحات محفوظة أو استخدم البحث لإجراء تحقيق أوسع.