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

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

قبل البدء

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

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

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

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

ضبط توجيه خادم وكيل

Cloud Run

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

  1. Open 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 Tag Manager

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

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

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

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

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

اختياري: السماح بحركة البيانات الصادرة من خادم البروكسي

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

تُستخدَم النطاقات التالية لجلب حاوية Google Tag Manager ومعاينتها وتصحيح الأخطاء فيها:

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

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

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

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

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

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

يضبط كل طلب يتم إرساله إلى الخادم الوكيل اسم المستخدم وكلمة المرور في عنوان Proxy-Authorization كقيم Base64.

إذا كنت تستخدم Cloud Run، خزِّن بيانات اعتماد نقطة نهاية الخادم الوكيل في Secret Manager. تتيح خدمة Secret Manager لـ 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
.