# Proxy management

Vous pouvez également mettre en place le proxy mode sur site comme fonctionnalité pour orchestrer la communication entre votre site web et la plateforme Commanders Act. Un proxy est une sorte d'intermédiaire qui achemine les informations entre deux points, en l'occurrence votre site web et Commanders Act.

### Principe général

Lorsqu’un site utilise un domaine de tracking personnalisé (ex : `waf.monsite.com`) configuré en **reverse proxy** vers Commanders Act, les requêtes envoyées vers ce domaine passent par le navigateur **comme si elles étaient internes au site**. Cela permet :

* De **déposer un cookie 1st party** (lié au domaine du site).
* De **récupérer ce cookie** dans les requêtes envoyées à Commanders Act via le proxy.

<figure><img src="https://3381090214-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEe3W7NzUcXEd8EpLaNY9%2Fuploads%2FALDX9sLossbrNH1HkrlY%2Fimage.png?alt=media&#x26;token=4025d27c-3724-4817-97d9-ac4d942b4692" alt=""><figcaption></figcaption></figure>

#### Étapes de transmission du cookie

**1. Création du cookie côté navigateur**

Le tag Commanders Act (via le container) dépose un cookie sur le domaine `waf.monsite.com`.\
Ce cookie contient généralement un identifiant utilisateur ou de session.

**2. Requête envoyée via le proxy**

Le navigateur envoie une requête vers `waf.monsite.com`, qui est en réalité un proxy vers `ca-trk-proxy.commander1.com`.\
Le cookie est automatiquement **inclus dans l’en-tête HTTP** de la requête (`Cookie:`).

**3. Proxy Cloudflare ou autre proxy..**

Le proxy **ne doit pas modifier l’en-tête `Host`** ni supprimer les cookies.\
Il transmet la requête telle quelle à l’infrastructure Commanders Act.

**4. Réception côté Commanders Act**

Le serveur Commanders Act lit le cookie dans l’en-tête HTTP.\
Il peut alors **associer les données collectées à l’utilisateur** identifié par ce cookie.

### Conditions nécessaires

Pour que la transmission fonctionne correctement :

* Le domaine de tracking doit être **1st party** (même domaine ou sous-domaine que le site).
* Le proxy doit **préserver les en-têtes HTTP**, notamment `Cookie` et `Host`.
* Le container doit être configuré pour utiliser ce domaine dans **Domain Management**.

#### Découvrir la solution On-Premise Proxy

{% embed url="<https://doc.commandersact.com/configure/administration/domain-management/on-premise-proxy>" %}

#### Découvrir la solution WAF Proxy

{% embed url="<https://doc.commandersact.com/configure/administration/domain-management/waf-proxy-cloudflare>" %}

{% hint style="info" %}
Le proxy sur site est conçu pour être installé par votre équipe informatique sur vos propres serveurs. Cela permet un contrôle et une flexibilité dans la gestion du flux de données entre votre système et Commanders Act.
{% endhint %}
