> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/consent-management/extensions/tag-firewall.md).

# Tag Firewall

TagFirewall peut autoriser ou bloquer des tags.

{% hint style="info" %}
TagFirewall est une extension payante qui peut être installée avec Commanders Act TMS ou exécutée en mode autonome. Veuillez contacter un consultant ou un gestionnaire de compte Commanders Act pour l’activer.
{% endhint %}

## Présentation générale

TagFirewall bloque en temps réel les tags (domaines) non autorisés. Cela peut, par exemple, aider à bloquer les tags piggybacking et à réduire les risques associés. TagFirewall est très dynamique et peut donc compléter une configuration Content Security Policy (CSP) existante afin de résoudre les problèmes critiques liés aux tags en quelques minutes, ou remplacer entièrement le recours à une Content Security Policy (CSP). TagFirewall propose deux modes :

### Mode liste noire

Ce mode bloque la communication des tags avec une liste configurable de domaines. La communication avec tous les autres domaines reste autorisée.

### Mode liste blanche

Ce mode bloque la communication des tags avec tous les domaines, à l’exception de ceux d’une liste blanche configurée.

## Configuration

### Commanders Act

TagFirewall peut être configuré à l’aide du modèle de tag « Commanders Act - TagFirewall » dans la bibliothèque de tags de Commanders Act TMS.

| Option                         | Description                                                                                                                                                                       |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Mode**                       | Permet de sélectionner le mode liste noire ou liste blanche.                                                                                                                      |
| **Domaines de la liste noire** | Domaines à ajouter à la liste noire. À encadrer par `"` et et à séparer par`,` . (*Uniquement en mode liste noire*)                                                               |
| **Domaines internes**          | Domaines des tags à ajouter à la liste blanche. À encadrer par `"` et et à séparer par`,` . (*Uniquement en mode liste blanche*)                                                  |
| **Domaines des tags**          | Domaines internes (domaines nécessaires au fonctionnement du site) à ajouter à la liste blanche. À encadrer par `"` et et à séparer par`,` . (*Uniquement en mode liste blanche*) |
| **Vérifier SSL**               | Cette option permet de bloquer toutes les requêtes de script `http` (seules les requêtes de script `https` seront autorisées).                                                    |

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-79b46f01816d7481f9ef19b41fb3774ab7ee9022%2Fimage.png?alt=media" alt=""><figcaption><p>Exemple de configuration de TagFirewall.</p></figcaption></figure>

### Mode autonome

TagFirewall peut être configuré à l’aide d’un tag JavaScript personnalisé pour toutes les autres installations. Le tag comporte les options suivantes.

| Option                     | Description                                                                                                                                                             |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **\<whitelist\_tags>**     | Tableau des domaines utilisés par les tags qui ne doivent pas être bloqués. (*Uniquement en mode liste blanche*)                                                        |
| **\<whitelist\_internal>** | Tableau des domaines internes (domaines nécessaires au fonctionnement du site) qui ne doivent pas être bloqués. (*Uniquement en mode liste blanche*)                    |
| **\<blacklist\_tags>**     | Tableau des domaines utilisés par les tags à ajouter à la liste noire. (*Uniquement en mode liste noire*)                                                               |
| **\<active\_flag>**        | Cette option active TagFirewall. Définissez-la sur `true` pour activer TagFirewall.                                                                                     |
| **\<check\_ssl>**          | Cette option permet de bloquer toutes les requêtes de script `http` (seules les requêtes de script `https` seront autorisées). Définissez-la sur `true` pour l’activer. |
| **\<script\_url>**         | URL du fichier JavaScript de la bibliothèque TagFirewall. Cette URL vous sera fournie par un consultant ou un responsable de compte de Commanders Act.                  |

{% tabs %}
{% tab title="Mode liste noire" %}

```markup
<script>
tC = tC || {};
tC.tagFirewall = tC.tagFirewall || {};

tC.tagFirewall.list = {
    "blacklist": {
        "tags": <blacklist_tags>
    }
};

tC.tagFirewall.checkSSL = <check_ssl>;
tC.tagFirewall.blocked  = <active_flag>;  
</script>
<script src="<script_url>"></script>
```

{% endtab %}

{% tab title="Mode liste blanche" %}

```markup
<script>
tC = tC || {};
tC.tagFirewall = tC.tagFirewall || {};

tC.tagFirewall.list = {
    "whitelist": {
        "internal": <whitelist_internal>,
        "tags": <whitelist_tags>
    }
};

tC.tagFirewall.checkSSL = <check_ssl>;
tC.tagFirewall.blocked  = <active_flag>; 
</script>
<script src="<script_url>"></script> 
```

{% endtab %}
{% endtabs %}

#### Exemples

{% tabs %}
{% tab title="Mode liste noire" %}

```markup
<script>
tC = tC || {};
tC.tagFirewall = tC.tagFirewall || {};

tC.tagFirewall.list = {
    "blacklist": {
        "tags": ["bad-domain1.com", "bad-domain2.com"]
    }
};

tC.tagFirewall.checkSSL = true;
tC.tagFirewall.blocked  = true;  
</script>
<script src="<script_url>"></script>
```

{% endtab %}

{% tab title="Mode liste blanche" %}

```markup
<script>
tC = tC || {};
tC.tagFirewall = tC.tagFirewall || {};

tC.tagFirewall.list = {
    "whitelist": {
        "internal": ["cdn.yourdomain.com", "cdn.yourdomain2.com"],
        "tags": ["facebook.com","twitter.com"]
    }
};

tC.tagFirewall.checkSSL = true;
tC.tagFirewall.blocked  = true;
</script>
<script src="<script_url>"></script>
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
La balise doit être incluse dans le `<head>` de votre document. Elle ne peut bloquer que les balises chargées **après** la balise TagFirewall et le fichier de la bibliothèque JavaScript.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/consent-management/extensions/tag-firewall.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
