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

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

قبل البدء

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

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

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

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

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

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 مع الخادم الوكيل

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

لاستخدام مصادقة 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