إعداد توجيه الخادم الوكيل

هذا المستند مخصّص للمطوّرين الذين يريدون توجيه جميع زيارات وضع العلامات من جهة الخادم عبر خادم وكيل.

قبل البدء

قبل أن تتمكّن من إعداد توجيه الخادم الوكيل، تأكَّد من توفُّر ما يلي:

  • حاوية خادم تم نشرها على Cloud Run أو من خلال الإعداد اليدوي.

  • خادم وكيل تم نشره ويتوافق مع طلبات HTTP CONNECT

  • إمكانية إضافة زيارات صادرة معيّنة من الخادم الوكيل إلى القائمة المسموح بها، على سبيل المثال، باستخدام VPC أو جدار الحماية أو قوائم التحكُّم بالوصول إلى الخادم الوكيل (قوائم ACL).

إعداد توجيه الخادم الوكيل

Cloud Run

لإعادة توجيه حركة البيانات إلى خادم وكيل لعمليات نشر Cloud Run:

  1. فتح Cloud Run
  2. اختَر مثيل Cloud Run لوضع العلامات من جهة الخادم.
  3. انقر على تعديل المراجعة الجديدة ونشرها. سيتم فتح شاشة نشر النسخة السابقة.
  4. ضمن الحاويات، اختَر حاوية الخادم. يتم فتح شاشة جديدة بإعداد الحاوية.

  5. لتوسيع ضبط الخدمة، اختَر علامة التبويب المتغيّرات والأسرار. انقر على الزر إضافة متغيّر وأضِف متغير البيئة التالي:

    1. الاسم: HTTP_PROXY
    2. القيمة: عنوان URI للخادم الوكيل (مثل https://proxy.example.com:3333 أو http://32.12.83.10)
    .

  6. انقر على تم.

  7. أكِّد النُسخ السابقة وانقر على نشر.

النشر اليدوي

لإعادة توجيه عدد الزيارات إلى خادم وكيل لعمليات النشر اليدوية:

  1. تحديد متغير بيئة يمكن الوصول إليه لصورة Docker:

    1. الاسم: HTTP_PROXY
    2. القيمة: عنوان URI للخادم الوكيل (مثل https://proxy.example.com أو http://32.12.83.10:1234)
    .

  2. شغِّل صورة Docker باستخدام متغير البيئة الجديد.

    docker run -p 8080:8080 \
-e CONTAINER_CONFIG=CONTAINER_CONFIG \
-e HTTP_PROXY=PROXY_URL \
gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable

النتيجة: عند نشر وضع العلامات من جهة الخادم، يتم إرسال جميع الزيارات الصادرة إلى نقطة نهاية الخادم الوكيل التي حدّدتها في متغير البيئة.

التحقُّق من إعداد الخادم الوكيل

للتحقّق من إعداد طلبات الخادم الوكيل، تحقّق من أداة "إدارة العلامات من Google" وإعدادات الخادم الوكيل.

للتحقّق من طلبات الخوادم الوكيلة لحاوية الخادم:

  1. فتح أداة "إدارة العلامات من Google"

  2. افتح حاوية الخادم.

  3. افتح وضع المعاينة. في علامة التبويب الطلبات:

    1. تأكَّد من أن العميل يطالب بالطلب الوارد.
    2. تأكَّد من أنّ العلامات والمتغيّرات ترسل طلبات HTTP صادرة بنجاح.
    3. للتحقق مما إذا كان قد تم إرسال الطلب عبر خادم وكيل، انقر على طلب HTTP لعرض تفاصيل طلب HTTP.

للتحقُّق من إعداد الخادم الوكيل، يُرجى اتّباع الخطوات التالية:

  1. تحقَّق من سجلّات الشبكة والخادم الوكيل. من المفترض أن تظهر لك على الأقل طلبات ناجحة إلى نقاط النهاية التالية:
  2. تحقَّق مما إذا كانت هناك طلبات لنقاط نهاية أخرى.
  3. استنادًا إلى ميزات وضع العلامات من جهة الخادم التي تستخدمها، قد تظهر لك أيضًا طلبات تم إجراؤها إلى نقاط نهاية أخرى، مثل www.google-analytics.com أو bigquery.googleapis.com أو نقاط نهاية تابعة لجهات خارجية. يمكنك إضافة أي نقاط نهاية أخرى مطلوبة لإعداد وضع العلامات إلى القائمة المسموح بها.

اختياري: إضافة عدد الزيارات الصادرة من الخادم الوكيل إلى القائمة المسموح بها

إذا حظرت الزيارات الصادرة من شبكتك أو من الخادم الوكيل، يجب إضافة نطاقات أداة "إدارة العلامات من Google" إلى القائمة المسموح بها حتى تعمل نسخة خادم وضع العلامات. تعتمد طريقة إدراج حركة البيانات الصادرة في القائمة المسموح بها على بيئة الشبكة وبرنامج الخادم الوكيل. قبل أن تبدأ في إضافة نقاط النهاية إلى القائمة المسموح بها، تأكد من فهم مخطط الشبكة.

تُستخدم النطاقات التالية لجلب حاويتك على أداة "إدارة العلامات من Google" ومعاينتها وتصحيح أخطاءها:

  • https://www.googletagmanager.com
  • https://tagmanager.google.com
  • ${Preview server URL}

إذا كنت تستضيف خادم المعاينة على شبكة مختلفة عن الخادم الوكيل أو كانت لديك قواعد شبكة محدودة، يمكنك إضافة عدد الزيارات الصادرة من الخادم الوكيل إلى خادم المعاينة في القائمة المسموح بها. يتم تحديد عنوان URL لخادم المعاينة عند نشر حاوية الخادم.

اختياري: استخدام المصادقة الأساسية مع الخادم الوكيل

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

لاستخدام مصادقة BASIC، يمكنك تضمين بيانات الاعتماد (اسم المستخدم/كلمة المرور) كجزء من عنوان URL للخادم الوكيل بالتنسيق التالي:

HTTP_PROXY=http(s)://USER_NAME:PASSWORD@PROXY_URL

يضبط كل طلب للخادم الوكيل اسم المستخدم وكلمة المرور في رأس تفويض الخادم الوكيل كقيم Base64.

إذا كنت تستخدم Cloud Run، يُرجى تخزين بيانات اعتماد نقطة النهاية للخادم الوكيل في المدير السري. يمنح "المدير السري" Cloud Run إمكانية الوصول إلى المفتاح السرّي عند بدء التشغيل ويحلّ القيمة. تعرَّف على كيفية ضبط الأسرار في Cloud Run.

اختياري: إيقاف الخادم الوكيل لمضيفين محدَّدين

يتيح لك متغيِّر بيئة NO_PROXY تحديد قائمة بأسماء المضيفين والمُفصولة بفواصل التي لا يمكن إرسالها من خلال الخادم الوكيل.

على سبيل المثال: NO_PROXY=example.com,169.254.169.254,diagnostics.example2.com:3131

لا تعمل حاوية sGTM على خادم وكيل لأي من الطلبات التالية:

  • http://example.com وhttps://sub.example.com وhttps://other.example.com:123
  • http://169.254.169.254 وhttps://169.254.169.254 وhttp://169.254.169.254:123
  • http://diagonstics.example2.com:3131، https://diagonstics.example2.com:3131