Configurer le routage vers le serveur proxy

Ce document est destiné aux développeurs qui souhaitent acheminer tout le trafic de taggage côté serveur via un serveur proxy.

Avant de commencer

Avant de pouvoir configurer le routage du serveur proxy, assurez-vous de disposer des éléments suivants :

Configurer le routage du serveur proxy

Cloud Run

Pour transférer le trafic vers un proxy pour les déploiements Cloud Run :

  1. Ouvrez Cloud Run.
  2. Choisissez votre instance Cloud Run de taggage côté serveur.
  3. Cliquez sur MODIFIER ET DÉPLOYER LA NOUVELLE RÉVISION. L'écran de déploiement de la révision s'ouvre.
  4. Sous Conteneur(s), choisissez votre conteneur serveur. Un nouvel écran s'ouvre avec le paramètre du conteneur.

  5. Pour développer la configuration de service, sélectionnez l'onglet Variables et secrets. Cliquez sur le bouton Ajouter une variable et ajoutez la variable d'environnement suivante :

    1. Nom : HTTP_PROXY
    2. Valeur : URI du serveur proxy (par exemple, https://proxy.example.com:3333 ou http://32.12.83.10)

  6. Cliquez sur OK.

  7. Confirmez vos révisions, puis cliquez sur Déployer.

Déploiement manuel

Pour transférer le trafic vers un proxy pour les déploiements manuels :

  1. Définissez une variable d'environnement accessible à l'image Docker :

    1. Nom : HTTP_PROXY
    2. Valeur : URI du serveur proxy (par exemple, https://proxy.example.com ou http://32.12.83.10:1234)

  2. Exécutez votre image Docker avec la nouvelle variable d'environnement.

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

Résultat : Votre déploiement de taggage côté serveur envoie tout le trafic sortant au point de terminaison du proxy que vous avez spécifié dans la variable d'environnement.

Vérifier la configuration du serveur proxy

Pour vérifier la configuration de vos requêtes de proxy, vérifiez à la fois Google Tag Manager et la configuration de votre serveur proxy.

Pour vérifier que votre conteneur serveur proxy les requêtes :

  1. Ouvrez Google Tag Manager.

  2. Ouvrez votre conteneur serveur.

  3. Ouvrez le mode Aperçu. Dans l'onglet Requêtes :

    1. Assurez-vous que votre client revendique la requête entrante.
    2. Assurez-vous que vos balises et variables envoient correctement des requêtes HTTP sortantes.
    3. Pour vérifier si une requête a été envoyée via un serveur proxy, cliquez sur une requête HTTP pour afficher les détails de la requête HTTP.

Pour vérifier votre configuration de proxy :

  1. Consultez les journaux de votre réseau et de votre serveur proxy. Vous devriez au minimum voir des requêtes réussies vers les points de terminaison suivants :
  2. Vérifiez s'il existe des requêtes vers d'autres points de terminaison.
  3. En fonction des fonctionnalités de taggage côté serveur que vous utilisez, vous pouvez également voir des requêtes adressées à d'autres points de terminaison, tels que www.google-analytics.com, bigquery.googleapis.com, ou des points de terminaison tiers. Ajoutez à la liste d'autorisation tous les autres points de terminaison nécessaires à votre configuration de taggage.

Facultatif : Ajouter à la liste d'autorisation le trafic sortant de votre serveur proxy

Si vous bloquez le trafic sortant de votre réseau ou de votre serveur proxy, vous devez ajouter les domaines Google Tag Manager à la liste d'autorisation pour que votre instance de serveur de taggage fonctionne. La méthode d'ajout à la liste d'autorisation du trafic sortant dépend de votre environnement réseau et de votre logiciel proxy. Avant de commencer à ajouter des points de terminaison à la liste d'autorisation, assurez-vous de bien comprendre la topologie de votre réseau.

Les domaines suivants sont utilisés pour récupérer, prévisualiser et déboguer votre conteneur Google Tag Manager :

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

Si vous hébergez votre serveur de prévisualisation sur un réseau différent de celui de votre serveur proxy ou si vous disposez de règles réseau restrictives, ajoutez à la liste d'autorisation le trafic sortant du proxy vers le serveur de prévisualisation. L'URL du serveur de prévisualisation est définie lorsque vous déployez votre conteneur serveur.

Facultatif : Utiliser l'authentification BASIC avec votre serveur proxy

Si votre organisation nécessite une authentification, vous pouvez utiliser l'authentification BASIC avec tous les types de serveurs.

Pour utiliser l'authentification BASIC, incluez les identifiants (nom d'utilisateur/mot de passe) dans l'URL du serveur proxy au format suivant :

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

Chaque requête adressée au proxy définit le nom d'utilisateur et le mot de passe dans l' en-tête Proxy-Authorization en tant que valeurs Base64.

Si vous utilisez Cloud Run, stockez les identifiants du point de terminaison du proxy dans Secret Manager. Secret Manager donne à Cloud Run l'accès au secret au démarrage et résout la valeur. Découvrez comment configurer des secrets dans Cloud Run.

Facultatif : Désactiver le proxy pour des hôtes spécifiques

La variable d'environnement NO_PROXY vous permet de définir une liste de noms d'hôte délimités par une virgule qui ne peuvent pas être envoyés via le serveur proxy.

Par exemple, si vous indiquez : NO_PROXY=example.com,169.254.169.254,diagnostics.example2.com:3131

Le conteneur sGTM ne proxy aucune des requêtes suivantes :

  • 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