إجراءات Azure Front Door Rules

تتكون مجموعة قواعد الباب الأمامي من Azure من قواعد مع مجموعة من شروط المطابقة والإجراءات. توفر هذه المقالة وصفا مفصلا للإجراءات التي يمكنك استخدامها في مجموعة قواعد الباب الأمامي ل Azure. يحدد الإجراء السلوك الذي يتم تطبيقه على نوع طلب يحدده شرط (شروط) مطابقة. في مجموعة قواعد الباب الأمامي في Azure، يمكن أن تحتوي القاعدة على ما يصل إلى خمسة إجراءات.

يدعم Azure Front Door متغير الخادم في إجراء مجموعة قواعد.

تتوفر الإجراءات التالية للاستخدام في مجموعة قواعد Azure Front Door:

تجاوز تكوين المسار

استخدم إجراء تجاوز تكوين المسار لتجاوز المجموعة الأصلية أو تكوين التخزين المؤقت لاستخدامه للطلب. يمكنك اختيار تجاوز تكوينات المجموعة الأصلية المحددة في المسار أو احترامها. ومع ذلك، كلما قمت بتجاوز تكوين المسار، يجب تكوين التخزين المؤقت. خلاف ذلك ، سيتم تعطيل التخزين المؤقت للطلب.

يمكنك أيضا تجاوز كيفية تخزين الملفات مؤقتا لطلبات محددة، بما في ذلك:

  • تجاوز سلوك التخزين المؤقت المحدد من قبل الأصل.
  • كيفية استخدام معلمات سلسلة الاستعلام لإنشاء مفتاح ذاكرة التخزين المؤقت للطلب.
  • قيمة وقت العيش (TTL) للتحكم في مدة بقاء المحتويات في ذاكرة التخزين المؤقت.

الخصائص

الخاصية القيم المعتمدة
تجاوز المجموعة الأصلية
  • نعم: تجاوز مجموعة الأصل المستخدمة للطلب.
  • لا: استخدم مجموعة الأصل المحددة في المسار.
تخزين مؤقت
  • تمكين: فرض تمكين التخزين المؤقت للطلب.
  • ذوي الاحتياجات الخاصه: فرض تعطيل التخزين المؤقت للطلب.

عند تعيين تجاوز المجموعة الأصلية إلى نعم، قم بتعيين الخصائص التالية:

الخاصية القيم المعتمدة
مجموعة الأصل مجموعة الأصل التي ينبغي توجيه الطلب إليها. هذا يتجاوز التكوين المحدد في مسار نقطة نهاية Front Door.
بروتوكول إعادة التوجيه بروتوكول الباب الأمامي لاستخدامه عند إعادة توجيه الطلب إلى الأصل. القيم المدعومة هي HTTP فقط ، HTTPS فقط ، مطابقة الطلب الوارد. هذا يتجاوز التكوين المحدد في مسار نقطة نهاية Front Door.

عند تعيين التخزين المؤقت إلى ممكن، قم بتعيين الخصائص التالية:

الخاصية القيم المعتمدة
سلوك التخزين المؤقت لسلسلة الاستعلام
  • تجاهل سلسلة الاستعلام: لا يتم أخذ سلاسل الاستعلام في الاعتبار عند إنشاء مفتاح ذاكرة التخزين المؤقت. في قوالب Azure Resource Manager، اضبط الخاصية queryStringCachingBehavior على IgnoreQueryString.
  • استخدام سلسلة الاستعلام: يحتوي كل عنوان URL فريد على مفتاح ذاكرة التخزين المؤقت الخاص به. في قوالب ARM، استخدم queryStringCachingBehavior من UseQueryString.
  • تجاهل سلسلة الاستعلام المحددة: يتم استبعاد سلاسل الاستعلام المحددة في المعلمات عند إنشاء مفتاح ذاكرة التخزين المؤقت. في قوالب Azure Resource Manager، اضبط الخاصية queryStringCachingBehavior على IgnoreSpecifiedQueryStrings.
  • تضمين سلسلة استعلام محددة: يتم تضمين سلاسل الاستعلام المحددة في المعلمات عند إنشاء مفتاح ذاكرة التخزين المؤقت. في قوالب Azure Resource Manager، اضبط الخاصية queryStringBehavior على IncludeSpecifiedQueryStrings.
معلمات الاستعلام قائمة أسماء معلمة سلسلة الاستعلام مفصولة بفواصل. يتم تعيين هذه الخاصية فقط عند تعيين سلوك التخزين المؤقت لسلسلة الاستعلام إلى تجاهل سلاسل الاستعلام المحددة أو تضمين سلاسل الاستعلام المحددة.
الضغط
  • تمكين: يقوم الباب الأمامي بضغط المحتوى بشكل ديناميكي على الحافة، مما يؤدي إلى استجابة أصغر وأسرع. لمزيد من المعلومات، راجع ضغط الملفات. في قوالب Azure Resource Manager، اضبط الخاصية isCompressionEnabled على Enabled.
  • معطل. الباب الأمامي لا يقوم بالضغط. في قوالب Azure Resource Manager، اضبط الخاصية isCompressionEnabled على Disabled.
سلوك ذاكرة التخزين المؤقت
  • أصل الشرف: سوف يحترم الباب الأمامي دائما توجيه رأس الاستجابة الأصلية. إذا كان التوجيه الأصلي مفقوداً، فستخزن Front Door المحتويات مؤقتاً في أي مكان من يومٍ إلى 3 أيام. في قوالب Azure Resource Manager، اضبط الخاصية cacheBehavior على HonorOrigin.
  • تجاوز دائما: يتم الكتابة فوق قيمة TTL التي تم إرجاعها من الأصل الخاص بك مع القيمة المحددة في الإجراء. سيتم تطبيق هذا السلوك فقط إذا كانت الاستجابة قابلة للتخزين المؤقت. في قوالب Azure Resource Manager، اضبط الخاصية cacheBehavior على OverrideAlways.
  • تجاوز إذا كان الأصل مفقودا: إذا لم يتم إرجاع أي قيمة TTL من الأصل، تقوم القاعدة بتعيين TTL إلى القيمة المحددة في الإجراء. سيتم تطبيق هذا السلوك فقط إذا كانت الاستجابة قابلة للتخزين المؤقت. في قوالب Azure Resource Manager، اضبط الخاصية cacheBehavior على OverrideIfOriginMissing.
مدة ذاكرة التخزين المؤقت عند تعيين سلوك ذاكرة التخزين المؤقت على Override always أو Override if origin missing، يجب أن تحدد هذه الحقول مدة ذاكرة التخزين المؤقت لاستخدامها. المدة القصوى هي 366 يوماً. للحصول على قيمة 0 ثانية، يقوم CDN بتخزين المحتوى مؤقتا، ولكن يجب إعادة التحقق من صحة كل طلب باستخدام الخادم الأصلي. يتم تعيين هذه الخاصية فقط عند تعيين سلوك ذاكرة التخزين المؤقت إلى تجاوز دائما أو تجاوز إذا كان الأصل مفقودا.
  • في مدخل Microsoft Azure: حدد الأيام والساعات والدقائق والثواني.
  • في قوالب ARM: استخدم لتحديد cacheDuration المدة بالتنسيق d.hh:mm:ss.

أمثلة

في هذا المثال، نقوم بتوجيه جميع الطلبات المتطابقة إلى مجموعة أصل تسمى MyOriginGroup، بغض النظر عن التكوين في مسار نقطة نهاية Front Door.

Portal screenshot showing origin group override action.

في هذا المثال، نقوم بتعيين مفتاح ذاكرة التخزين المؤقت لتضمين معلمة سلسلة استعلام باسم customerId. يتم تمكين الضغط، ويتم احترام سياسات التخزين المؤقت الخاصة بالمنشأ.

Portal screenshot showing cache key query string action.

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

Portal screenshot showing cache expiration action.

تعديل عنوان الطلب

استخدم إجراء تعديل عنوان الطلب لتعديل العناوين في الطلب عند إرساله إلى الأصل.

الخصائص

الخاصية القيم المعتمدة
عامل تشغيل
  • Append: تتم إضافة العنوان المحدد إلى الطلب بالقيمة المحددة. إذا كان العنوان موجوداً بالفعل، يتم إلحاق القيمة بقيمة العنوان الحالي باستخدام تسلسل السلسلة. لم يتم إضافة محددات. في قوالب ARM، استخدم headerAction من Append.
  • Overwrite: تتم إضافة العنوان المحدد إلى الطلب بالقيمة المحددة. إذا كان العنوان موجوداً بالفعل، فستستبدل القيمة المحددة القيمة الحالية. في قوالب ARM، استخدم headerAction من Overwrite.
  • Delete: إذا كان العنوان المحدد في القاعدة موجوداً، فسيتم حذف العنوان من الطلب. في قوالب ARM، استخدم headerAction من Delete.
اسم العنوان اسم العنوان المراد تعديله.
قيمة العنوان القيمة المطلوب إلحاقها أو استبدالها.

مثال

في هذا المثال، نلحق القيمة AdditionalValue بعنوان الطلب MyRequestHeader. إذا قام الأصل بتعيين عنوان الرد على قيمة ValueSetByClient، فبعد تطبيق هذا الإجراء، سيكون لعنوان الطلب قيمة ValueSetByClientAdditionalValue.

Portal screenshot showing modify request header action.

تعديل رأس الاستجابة

استخدم الإجراء تعديل عنوان الرد لتعديل العناوين الموجودة في الردود قبل إعادتها إلى العملاء.

الخصائص

الخاصية القيم المعتمدة
عامل تشغيل
  • Append: تتم إضافة العنوان المحدد إلى الرد بالقيمة المحددة. إذا كان العنوان موجوداً بالفعل، يتم إلحاق القيمة بقيمة العنوان الحالي باستخدام تسلسل السلسلة. لم يتم إضافة محددات. في قوالب ARM، استخدم headerAction من Append.
  • Overwrite: تتم إضافة العنوان المحدد إلى الرد بالقيمة المحددة. إذا كان العنوان موجوداً بالفعل، فستستبدل القيمة المحددة القيمة الحالية. في قوالب ARM، استخدم headerAction من Overwrite.
  • Delete: إذا كان العنوان المحدد في القاعدة موجوداً، فسيتم حذف العنوان من الرد. في قوالب ARM، استخدم headerAction من Delete.
اسم العنوان اسم العنوان المراد تعديله.
قيمة العنوان القيمة المطلوب إلحاقها أو استبدالها.

مثال

في هذا المثال، نحذف العنوان الذي يحمل الاسم X-Powered-By من الردود قبل إعادتها إلى العميل.

Portal screenshot showing modify response header action.

إعادة توجيه عنوان URL

استخدم إجراء إعادة توجيه عنوان URL لإعادة توجيه العملاء إلى عنوان URL جديد. يتم إرسال رد إعادة توجيه للعملاء من Front Door.

الخصائص

الخاصية القيم المعتمدة
نوع إعادة التوجيه نوع الرد المطلوب إرجاعه إلى مقدم الطلب.
  • في مدخل Microsoft Azure: موجود (302)، منقول (301)، إعادة توجيه مؤقت (307)، إعادة توجيه دائم (308).
  • في قوالب ARM: Found، Moved، TemporaryRedirect، PermanentRedirect
بروتوكول إعادة التوجيه
  • في مدخل Microsoft Azure: Match Request، HTTP، HTTPS
  • في قوالب ARM: MatchRequest، Http، Https
مضيف الوجهة اسم المضيف الذي تريد إعادة توجيه الطلب إليه. اتركه فارغاً للاحتفاظ بالمضيف الوارد.
مسار الوجهة المسار المراد استخدامه في إعادة التوجيه. قم بتضمين / البادئة. اتركه فارغاً للاحتفاظ بالمسار الوارد.
سلسلة الاستعلام سلسلة الاستعلام المستخدمة في إعادة التوجيه. لا تقم بتضمين ? البادئة. اتركه فارغاً للاحتفاظ بسلسلة الاستعلام الواردة.
جزء الوجهة الجزء المطلوب استخدامه في إعادة التوجيه. اتركه فارغاً للاحتفاظ بالجزء الوارد.

مثال

في هذا المثال، نعيد توجيه الطلب إلى https://contoso.com/exampleredirection?clientIp={client_ip}، مع الاحتفاظ بالجزء. يتم استخدام إعادة توجيه HTTP المؤقتة (307). يتم استخدام عنوان IP الخاص بالعميل بدلا من {client_ip} الرمز المميز داخل عنوان URL باستخدام متغير الخادمclient_ip.

Portal screenshot showing URL redirect action.

إعادة كتابة عنوان URL

استخدم إجراء إعادة كتابة عنوان URL لإعادة كتابة مسار طلب في طريقه إلى الأصل.

الخصائص

الخاصية القيم المعتمدة
نمط المصدر حدد نمط المصدر في مسار URL لاستبداله. حالياً، يستخدم نمط المصدر تطابق قائم على البادئة. لمطابقة جميع مسارات URL، أستخدم شرطة مائلة للأمام (/) كقيمة للنموذج المصدر.
الوجهة حدد مسار الوجهة لاستخدامه في الاستبدال. يستبدل مسار الوجهة النمط المصدر.
قم بالاحتفاظ بمسار غير متطابق في حالة التعيين على Yes، يتم إلحاق المسار المتبقي بعد نمط المصدر بمسار الوجهة الجديد.

مثال

في هذا المثال، نعيد كتابة جميع الطلبات إلى المسار /redirection، ولا نحتفظ ببقية المسار.

Portal screenshot showing URL rewrite action.

في Azure Front Door (كلاسيكي)، يمكن أن يتكون محرك القواعد من ما يصل إلى 25 قاعدة تحتوي على شروط مطابقة وإجراءات مقترنة. توفر هذه المقالة وصفا مفصلا لكل إجراء يمكنك تعريفه في قاعدة.

يحدد الإجراء السلوك الذي يتم تطبيقه على نوع الطلب الذي يطابق الشرط أو مجموعة شروط المطابقة. في تكوين محرك القواعد، يمكن أن تحتوي القاعدة على ما يصل إلى 10 شروط مطابقة و5 إجراءات. يمكنك الحصول على إجراء واحد فقط لتجاوز تكوين التوجيه في قاعدة واحدة.

تتوفر الإجراءات التالية لاستخدامها في تكوين محرك القواعد.

تعديل عنوان الطلب

استخدم هذه الإجراءات لتعديل الرؤوس الموجودة في الطلبات المرسلة إلى الواجهة الخلفية.

حقول مطلوبة

إجراء اسم رأس HTTP القيمة
إلحاق عند تحديد هذا الخيار وتطابق القاعدة، تتم إضافة الرأس المحدد في اسم Header إلى الطلب بالقيمة المحددة. إذا كان الرأس موجوداً بالفعل، يتم إلحاق القيمة بالقيمة الحالية. سلسلة
الكتابة فوق عند تحديد هذا الخيار وتطابق القاعدة، تتم إضافة الرأس المحدد في اسم Header إلى الطلب بالقيمة المحددة. إذا كان الرأس موجوداً بالفعل، فسوف تستبدل القيمة المحددة القيمة الحالية. سلسلة
حذف عندما يُحدَّد هذا الخيار بقواعد مطابقة ويكون العنوان المحدد في القاعدة موجوداً، تُحْذَف الرأس من الطلب. سلسلة

تعديل رأس الاستجابة

استخدم هذه الإجراءات لتعديل الرؤوس الموجودة في الاستجابات التي يتم إرجاعها إلى عملائك.

حقول مطلوبة

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

تجاوزات تكوين المسار

نوع الطريق: إعادة التوجيه

استخدم هذه الإجراءات لإعادة توجيه العملاء إلى عنوان URL جديد.

حقول مطلوبة

الحقل الوصف
نوع إعادة التوجيه إعادة التوجيه هي طريقة لإرسال المستخدمين / العملاء من عنوان URL إلى آخر. يقوم نوع إعادة التوجيه بتعيين رمز الحالة المستخدم من قبل العملاء لفهم الغرض من إعادة التوجيه.

يمكنك تحديد رموز حالة إعادة التوجيه التالية: تم العثور على (302) و تم النقل (301) وإعادة التوجيه المؤقتة (307) وإعادة التوجيه الدائمة (308).
بروتوكول إعادة التوجيه الاحتفاظ بالبروتوكول وفقا للطلب الوارد، أو تحديد بروتوكول جديد لإعادة التوجيه. على سبيل المثال ، حدد "HTTPS" لإعادة توجيه HTTP إلى HTTPS.
مضيف الوجهة قم بتعيين هذا لتغيير اسم المضيف في عنوان URL لإعادة التوجيه أو الاحتفاظ باسم المضيف من الطلب الوارد.
مسار الوجهة إما الاحتفاظ بالمسار وفقا للطلب الوارد، أو تحديث المسار في عنوان URL لإعادة التوجيه.
سلسلة الاستعلام قم بتعيين هذا لاستبدال أي سلسلة استعلام موجودة من عنوان URL للطلب الوارد أو الاحتفاظ بالمجموعة الأصلية من سلاسل الاستعلام.
جزء الوجهة الجزء المقصود هو جزء عنوان URL بعد "#" ، وعادة ما تستخدمه المتصفحات للهبوط على قسم معين في الصفحة. عين هذا لإضافة جزء إلى عنوان URL لإعادة التوجيه.

نوع الطريق: إلى الأمام

استخدم هذه الإجراءات لإعادة توجيه العملاء إلى عنوان URL جديد. تحتوي هذه الإجراءات أيضا على إجراءات فرعية لإعادة كتابة عناوين URL والتخزين المؤقت.

الحقل الوصف
تجمع النهاية الخلفية حدد تجمع الواجهة الخلفية لتجاوز الطلبات وخدمتها، سيعرض هذا أيضاً جميع تجمعات الواجهة الخلفية التي تم تكوينها مسبقاً حالياً في ملف تعريف الباب الأمامي الخاص بك.
بروتوكول إعادة التوجيه بروتوكول لاستخدامه لإعادة توجيه الطلب إلى الخلف أو مطابقة البروتوكول من الطلب الوارد.
إعادة كتابة عنوان URL المسار المطلوب استخدامه عند إنشاء طلب إعادة كتابة عنوان URL لإعادة التوجيه إلى الواجهة الخلفية.
تخزين مؤقت تمكين التخزين المؤقت لقاعدة التوجيه هذه. عند تمكينه، سيقوم Azure Front Door بتخزين المحتوى الثابت مؤقتا.

إعادة كتابة عنوان URL

استخدم هذا الإعداد لتكوين مسار إعادة توجيه مخصص اختياريًّا لاستخدامه عند إنشاء طلب إعادة التوجيه إلى الخلفية.

الحقل الوصف
مسار مخصص لإعادة التوجيه حدد مسارا سيتم إعادة توجيه الطلبات إليه.

تخزين مؤقت

استخدم هذه الإعدادات للتحكم في كيفية تخزين الملفات مؤقتاً للطلبات التي تحتوي على سلاسل استعلام. ما إذا كان سيتم تخزين المحتوى الخاص بك مؤقتاً بناءً على جميع المعلمات أو بناءً على المعلمات المحددة. يمكنك استخدام إعدادات إضافية للكتابة فوق قيمة مدة البقاء (TTL) للتحكم في مدة بقاء المحتويات في ذاكرة التخزين المؤقت. لفرض التخزين المؤقت كإجراء، اضبط حقل التخزين المؤقت على "ممكن". عند فرض التخزين المؤقت، تظهر الخيارات التالية:

سلوك ذاكرة التخزين المؤقت الوصف
تجاهل سلاسل الاستعلام بمجرد تخزين الأصل مؤقتاً، تتجاهل جميع الطلبات اللاحقة سلاسل الاستعلام حتى تنتهي صلاحية الأصل المخزن مؤقتاً.
التخزين المؤقت لكل عنوان URL فريد يتم التعامل مع كل طلب بعنوان URL فريد، بما في ذلك سلسلة الاستعلام، على أنه أصل فريد له ذاكرة التخزين المؤقت الخاصة به.
تجاهل سلاسل الاستعلام المحددة يتم تجاهل سلاسل استعلام عنوان URL المدرجة في إعداد "معلمات الاستعلام" للتخزين المؤقت.
تضمين سلاسل الاستعلام المحددة يتم استخدام سلاسل استعلام عنوان URL المدرجة في إعداد "معلمات الاستعلام" للتخزين المؤقت.
حقول إضافية الوصف
ضغط ديناميكي يمكن للباب الأمامي ضغط المحتوى على الحافة ديناميكيّاً، ما ينتج عنه استجابة أصغر وأسرع.
معلمات الاستعلام قائمة مفصولة بفواصل من المعلمات المسموح بها أو غير المسموح بها لاستخدامها كأساس للتخزين المؤقت.
استخدام مدة ذاكرة التخزين المؤقت الافتراضية قم بالتعيين لاستخدام مدة التخزين المؤقت الافتراضية ل Azure Front Door أو تحديد مدة التخزين المؤقت التي تتجاهل توجيه الاستجابة الأصلية.

الخطوات التالية