مشاركة عبر

دعم البروتوكول لرؤوس HTTP في Azure Front Door

  • مقالة

توضح هذه المقالة البروتوكول الذي تدعمه واجهة Front Door مع أجزاء من مسار الاتصال (انظر الصورة). في الأقسام التالية، يمكنك العثور على معلومات حول رؤوس HTTP التي يدعمها Front Door.

رسم تخطيطي يوضح طلب العميل إلى Azure Front Door، والذي تتم إعادة توجيهه إلى الخلفية. يتم إرسال الاستجابة من Azure Front Door إلى العميل.

هام

لا يصدق Azure Front Door على أي رؤوس HTTP غير موثقة هنا.

من العميل إلى Azure Front Door

يقبل Azure Front Door معظم العناوين للطلب الوارد دون تعديلها. تتم إزالة بعض الرؤوس المحجوزة من الطلب الوارد إذا تم إرسالها، بما في ذلك الرؤوس ذات البادئة X-FD-* .

يوفر عنوان طلب تتبع الأخطاء، X-Azure-DebugInfo، معلومات تصحيح أخطاء إضافية حول Front Door. تحتاج إلى إرسال X-Azure-DebugInfo: 1 عنوان الطلب من العميل إلى Azure Front Door لتلقي عناوين الاستجابة الاختيارية عند استجابة Azure Front Door للعميل.

من Front Door إلى الخلفية

يتضمن Azure Front Door عناوين لطلب وارد ما لم تتم إزالتها بسبب القيود. يقوم Azure Front Door أيضا بإلحاق العناوين التالية:

الرأس مثال ووصف
Via Via: 1.1 Azure
يضيف Front Door إصدار HTTP للعميل متبوعا ب Azure كقيمة لعنوان Via. يشير هذا الرأس إلى إصدار HTTP للعميل وأن Front Door كان مستلمًا وسيطًا للطلب بين العميل والخلفية.
X-Azure-ClientIP X-Azure-ClientIP: 127.0.0.1
يمثل عنوان IP للعميل المقترن بالطلب الذي تتم معالجته. على سبيل المثال، قد يقوم طلب قادم من وكيل بإضافة رأس X-Forwarded-For للإشارة إلى عنوان IP للمتصل الأصلي.
X-Azure-SocketIP X-Azure-SocketIP: 127.0.0.1
يمثل عنوان IP للمأخذ المقترن باتصال TCP الذي نشأ منه الطلب الحالي. قد لا يكون عنوان IP للعميل الخاص بالطلب مساويًا لعنوان IP لمأخذ التوصيل لأنه يمكن للمستخدم الكتابة فوق عنوان IP للعميل بشكل عشوائي.
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
سلسلة مرجعية فريدة تحدد طلبا يقدمه Azure Front Door. تستخدم هذه السلسلة للبحث في سجلات الوصول وحاسمة لاستكشاف الأخطاء وإصلاحها.
X-Azure-RequestChain X-Azure-RequestChain: hops=1
عنوان يستخدمه Front Door للكشف عن حلقات الطلب، ويجب ألا يعتمد المستخدمون عليه.
X-Azure-FDID X-Azure-FDID: 55ce4ed1-4b06-4bf1-b40e-4638452104da
سلسلة مرجعية تُحدد ورود الطلب من مورد Front Door محدد. يمكن رؤية القيمة في مدخل Azure أو استردادها باستخدام واجهة برمجة تطبيقات الإدارة. يمكنك استخدام هذا الرأس مع قوائم ACL لعناوين IP لتأمين نقطة النهاية لقبول الطلبات من مورد Front Door محدد فقط. راجع الأسئلة المتداولة للحصول على مزيد من التفاصيل
X-Forwarded-For X-Forwarded-For: 127.0.0.1
غالبا ما يحدد حقل رأس HTTP X-Forwarded-For (XFF) عنوان IP الأصلي لعميل يتصل بخادم ويب من خلال وكيل HTTP أو موازن التحميل. إذا كان هناك رأس XFF موجود، يُلحق Front Door عنوان IP لمأخذ توصيل العميل به أو يضيف رأس XFF إلى عنوان IP لمأخذ توصيل العميل.
X-Forwarded-Host X-Forwarded-Host: contoso.azurefd.net
حقل رأس HTTP X-Forwarded-Host هو أسلوب شائع يستخدم لتعريف المضيف الأصلي الذي طلبه العميل في عنوان طلب HTTP المضيف. وذلك لأن اسم المضيف من Azure Front Door قد يختلف بالنسبة للخادم الخلفي الذي يعالج الطلب. يتم تجاوز أي قيمة سابقة بواسطة Azure Front Door.
X-Forwarded-Proto X-Forwarded-Proto: http
X-Forwarded-Proto غالبا ما يتم استخدام حقل عنوان HTTP لتحديد البروتوكول الأصلي لطلب HTTP. قد يتصل Front Door بالخلفية باستخدام HTTPS استنادًا إلى التكوين. هذا صحيح حتى إذا كان الطلب إلى الوكيل العكسي HTTP. سيتم تجاوز أي قيمة سابقة من قبل Front Door.
X-FD-HealthProbe X-FD-HealthProbe يتم استخدام حقل عنوان HTTP لتحديد فحص السلامة من Front Door. إذا تم تعيين هذا الرأس إلى 1، يكون الطلب من مسبار فحص الصحة. يمكن استخدامه لتقييد الوصول من Front Door بقيمة معينة لحقل X-Forwarded-Host الرأس.

من Front Door إلى العميل

يتم أيضا تمرير أي عناوين يتم إرسالها إلى Azure Front Door من الواجهة الخلفية إلى العميل. يرفق Front Door أيضا العناوين التالية بجميع الاستجابات للعميل:

الرأس مثال ووصف
X-Azure-Ref X-Azure-Ref: 0zxV+XAAAAABKMMOjBv2NT4TY6SQVjC0zV1NURURHRTA2MTkANDM3YzgyY2QtMzYwYS00YTU0LTk0YzMtNWZmNzA3NjQ3Nzgz
هذه سلسلة مرجعية فريدة تحدد طلبا يقدمه Front Door، وهو أمر بالغ الأهمية لاستكشاف الأخطاء وإصلاحها أثناء استخدامه للبحث في سجلات الوصول.
X-Cache X-Cache: يصف هذا العنوان حالة التخزين المؤقت للطلب. لمزيد من المعلومات، راجع التخزين المؤقت باستخدام Azure Front Door.

عناوين استجابة تتبع الأخطاء الاختيارية

تحتاج إلى إرسال X-Azure-DebugInfo: 1 عنوان الطلب لتمكين رؤوس الاستجابة الاختيارية التالية.

الرأس مثال ووصف
X-Azure-OriginStatusCode X-Azure-OriginStatusCode: 503
يحتوي هذا العنوان على رمز حالة HTTP الذي تم إرجاعه بواسطة الخلفية. باستخدام هذا الرأس، يمكنك تحديد رمز حالة HTTP الذي تم إرجاعه من قبل التطبيق قيد التشغيل في الخلفية دون الانتقال خلال سجلات الخلفية. قد يختلف رمز الحالة هذا عن رمز حالة HTTP في الاستجابة المرسلة إلى العميل بواسطة Front Door. يسمح لك هذا الرأس بتحديد ما إذا كانت الخلفية تسيء التصرف أو إذا كانت المشكلة مرتبطة بخدمة Front Door.
X-Azure-InternalError يحتوي هذا العنوان على رمز الخطأ الذي يأتي عبره Azure Front Door عند معالجة الطلب. يشير هذا الخطأ إلى أن المشكلة داخلية لخدمة/بنية Azure Front Door الأساسية. إبلاغ فريق الدعم بالمشكلة.
X-Azure-ExternalError X-Azure-ExternalError: 0x830c1011, The certificate authority is unfamiliar
يظهر هذا الرأس رمز الخطأ الذي يظهر لخوادم Front Door في أثناء إنشاء الاتصال إلى الخادم الخلفي لمعالجة طلب. يساعد هذا العنوان في تحديد المشكلات في الاتصال بين Front Door وتطبيق الواجهة الخلفية. يتضمن هذا العنوان رسالة خطأ مفصلة لمساعدتك في تحديد مشكلات الاتصال بالواجهة الخلفية (على سبيل المثال، دقة DNS والشهادات غير الصالحة وما إلى ذلك).

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