المطابقة والاستبدال

تعدّل المطابقة والاستبدال حركة المرور تلقائياً أثناء مرورها عبر الوكيل، دون إيقافها أو طلب إجراء يدوي لكل طلب.

كيفية عمل القواعد

تحدد كل قاعدة ما تبحث عنه وما تفعله به. عندما يطابق طلب أو استجابة الشروط، تطبق القاعدة تحويلها فوراً.

تُطبق القواعد بحسب ترتيب ظهورها في القائمة. إذا استهدفت قاعدتان الترويسة نفسها، تُطبق أول قاعدة مطابقة أولاً، وترى القواعد اللاحقة نتيجة ذلك التغيير.

حقول القاعدة

الحقل	الوصف
الاسم	تسمية للقاعدة. استخدم اسماً وصفياً لتحديد غرضها.
الاتجاه	ما إذا كانت القاعدة تنطبق على الطلبات أو الاستجابات أو كليهما
العملية	التحويل المراد تنفيذه، وفق جدول العمليات أدناه
وضع المطابقة	حرفي أو تعبير نمطي أو محتوى كامل، تبعاً للعملية
قيمة المطابقة	السلسلة أو النمط المطلوب العثور عليه
قيمة الاستبدال	القيمة البديلة
مفعل	مفتاح لتفعيل القاعدة أو تعطيلها دون حذفها
المرشحات	شروط اختيارية للطريقة والمضيف والمسار وHTTPQL تحد مواضع تطبيق القاعدة

العمليات

العملية	ما تفعله
إضافة ترويسة	تضيف ترويسة جديدة باسم وقيمة ثابتين
إزالة الترويسة	تحذف ترويسة بحسب الاسم
استبدال الترويسة	تستبدل قيمة ترويسة موجودة
استبدال المتن	تستبدل جزءاً من المتن باستخدام قيمة المطابقة
المسار / الاستعلام / معلمة الاستعلام	تغيّر مسار الطلب أو قيم الاستعلام
سطر الطلب / الاستجابة	تغيّر المكوّن المحدد من سطر بداية HTTP
رمز الحالة	تغيّر حالة استجابة
الرسالة الخام	تحوّل سطر بداية HTTP والترويسات والمتن معاً
حمولة WebSocket	تستبدل محتوى رسائل العميل أو الخادم المطابق
مسار العمل	تشغّل سير عمل تحويل مفعلاً على المحتوى المحدد

أوضاع المطابقة

يطابق الوضع حرفي السلسلة الدقيقة. استخدمه للرموز الثابتة أو أسماء الترويسات أو القيم المحددة.

يطابق تعبير نمطي باستخدام تعبير نمطي. استخدمه عندما يتغير الهدف، مثلاً لمطابقة رمز يتغير مع كل جلسة، أو لالتقاط مجموعة وإعادة استخدامها في الاستبدال.

في استبدالات التعبير النمطي، استخدم مجموعات الالتقاط مع $1 و$2 وما إلى ذلك للإشارة إلى الأجزاء المطابقة في قيمة الاستبدال.

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

تحويل متن استجابة كامل

أنشئ سير عمل تحويل وفعّله، ثم تحقّق منه بمدخلات اختبارية.
أنشئ قاعدة مطابقة واستبدال باتجاه الاستجابة وعملية مسار عمل (المتن).
اختر وضع المطابقة المحتوى بالكامل وحدد سير العمل.
ضيّق القاعدة بمرشح HTTPQL، مثلاً:

text

req.host.eq:"cdn.example.com" AND (req.path.cont:".js" OR resp.headers["Content-Type"].value.cont:"javascript")

يتلقى سير العمل المتن كاملاً؛ وتحل مخرجاته محله. يحوّل مسار عمل (الترويسة) ترويسة مسماة، بينما يحوّل مسار عمل (الترويسات الخام) كتلة الترويسات. هذه مدخلات مختلفة عن متن الاستجابة.

تُفحص مرشحات HTTPQL في سياق الطلب والاستجابة المتاح. لا يمكن لقاعدة باتجاه الطلب الاعتماد على استجابة لم تصل بعد. عطّل تسجيل سير العمل عندما تنتج القاعدة عمليات تشغيل كثيفة؛ وفعّله مؤقتاً لتشخيص تحويل.

إعادة ترتيب القواعد

اسحب صف قاعدة لتغيير موضعه في القائمة. يهم الترتيب عندما تعدّل القواعد أجزاء متداخلة من الطلب أو الاستجابة نفسها.

مساعدة الذكاء الاصطناعي

انقر تعبئة بالذكاء الاصطناعي في محرر القاعدة وصف ما تريد تغييره بلغة طبيعية. ينشئ Ogma حقول القاعدة بناءً على وصفك. راجع القيم المُنشأة وعدّلها قبل تفعيل القاعدة.

أمثلة على تعليمات مناسبة:

"أزل ترويسة X-Frame-Options من جميع الاستجابات"
"استبدل قيمة ترويسة Authorization برمز الاختبار الخاص بي"
"أضف ترويسة باسم X-Debug وقيمة true إلى جميع الطلبات"

اختبار قاعدة

قبل تفعيل قاعدة لحركة المرور الحية، اختبرها بطلب نموذجي:

افتح محرر القاعدة.
الصق طلب HTTP خاماً في لوحة اختبار.
انقر تطبيق القواعد. تعرض اللوحة النتيجة والقواعد التي طُبقت.
تحقق من أن المخرجات تطابق توقعاتك.
فعّل القاعدة.

تحتوي لوحة الاختبار أيضاً على هدف الاستجابة مع مدخلات للحالة والترويسات والمتن. تحقق من قائمة القواعد المطبقة: يختبر ذلك القواعد المنطبقة، لا حقل محرر معزولاً فقط.