# Installation et configuration

### Prérequis

Pour réussir l'intégration avec Netacea, veuillez vous assurer de disposer des éléments suivants :

1. Une version Fastly 1.2.217 ou supérieure. Il s'agit de la version dans laquelle le module Netacea Edge pour l'intégration a été ajouté.
2. L'accès aux clés API pertinentes et aux points de terminaison d'envoi de logs dans le [portail Netacea](https://docs.netacea.com/fr/informations-sur-les-plugins-netacea/accessing-your-integration-settings).

Les clients devront également ouvrir un ticket de support auprès de Magento pour demander à Fastly d'activer POST dans leur environnement. Nous devons nous assurer que 2 pragmas sont activés sur votre compte Fastly, lesquels ne sont pas activés par défaut.

Pragmas requis :

```
Pragma optional_param fix_unsent_body_drain true;
Pragma optional_param no_body_if_bereq_is_get_or_head true;
```

Pour activer les Pragmas, ouvrez un ticket de support auprès du support Fastly/Magento. Ces Pragmas ne peuvent pas être ajoutés manuellement.

### Étapes d'implémentation

* Connectez-vous à l'interface web Fastly/Magento.
* Vérifiez que les Pragmas décrits dans la section des [prérequis](#implementation-prerequisites) ont été activés en naviguant vers Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Tools → List all versions.

<figure><img src="https://899558619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaRSpZrGcUHd5EHGjrrO5%2Fuploads%2Fgit-blob-0a2f26dd3caca9a7e8b7c9ca9e1ccc7fb24f6c4a%2Fimage%20(10)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

* Affichez la dernière version VCL et recherchez les Pragmas en haut du VCL.

<figure><img src="https://899558619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaRSpZrGcUHd5EHGjrrO5%2Fuploads%2Fgit-blob-b42a13258f2d54e3393b6545175cae5a58d4adde%2Fimage%20(5)%20(2)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Notez la version actuelle au cas où vous auriez besoin d'effectuer un retour en arrière ultérieurement.
{% endhint %}

### Créer un Dictionnaire vide

Naviguez vers Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Edge Dictionaries et cliquez sur « Add Dictionary ».

<figure><img src="https://899558619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaRSpZrGcUHd5EHGjrrO5%2Fuploads%2Fgit-blob-65e87c3fa2946353f578fdd1c015f377b8050b94%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Créez un dictionnaire avec le nom « netacea\_edge\_config », celui-ci peut être laissé vide.

{% hint style="info" %}
Ce dictionnaire ne sera renseigné que lors de l'utilisation de la [Configuration avancée](https://docs.netacea.com/fr/informations-sur-les-plugins-netacea/fastly-magento/installation-and-configuration/advanced-configuration) sur les conseils de Netacea
{% endhint %}

### Installer le Module Netacea Edge

Naviguez vers Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Fastly Edge Modules et cliquez sur « Manage » dans le Module Manager.

<figure><img src="https://899558619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaRSpZrGcUHd5EHGjrrO5%2Fuploads%2Fgit-blob-af0382522aec6168550a56c679cc072072d49a28%2Fimage%20(38)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

* Cochez le Module Edge « Netacea Bot Detection integration » et cliquez sur « Save ».

<figure><img src="https://899558619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaRSpZrGcUHd5EHGjrrO5%2Fuploads%2Fgit-blob-51d0476a200659d68233292c52d21a43348d0085%2Fimage%20(41)%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

### Appliquer les clés client au Module

* Naviguez vers les Modules Actifs et cliquez sur la roue d'action « Netacea Bot Detection integration ».

<figure><img src="https://899558619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaRSpZrGcUHd5EHGjrrO5%2Fuploads%2Fgit-blob-05e0349e35aee0ac419fb9283edbc4b1dde23f74%2Fimage%20(36).png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://899558619-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FaRSpZrGcUHd5EHGjrrO5%2Fuploads%2Fgit-blob-0644bb0ac8cefcd88072c61b6f54687eb96f13c0%2Fimage%20(101).png?alt=media" alt=""><figcaption></figcaption></figure>

**Renseignez les champs requis**

<table><thead><tr><th width="157">Champ</th><th>Valeur</th></tr></thead><tbody><tr><td>Mode d'intégration</td><td><p>BYPASS - Désactive entièrement l'intégration Netacea</p><p>INGEST - Mode passif permettant à Netacea de collecter et analyser le trafic</p><p>MITIGATE - Mode actif qui effectuera des actions de mitigation basées sur Intent Analytics® de Netacea</p><p>INJECT - Mode actif pour les clients qui souhaitent recevoir les analyses Netacea au niveau de leur backend et décider des actions à entreprendre.</p></td></tr><tr><td>Clé API Netacea</td><td>Fournie par le <a href="../accessing-your-integration-settings">portail Netacea</a></td></tr><tr><td>Secret Netacea</td><td>Fourni par le <a href="../accessing-your-integration-settings">portail Netacea</a></td></tr><tr><td>Clé de chiffrement</td><td>Fournie par le <a href="../accessing-your-integration-settings">portail Netacea</a></td></tr><tr><td>Nom du cookie Netacea</td><td><p>Un nom approprié pour votre cookie de mitigation.</p><p><strong>Pour une sécurité accrue, n'incluez pas Netacea ou Mitigation dans ce nom.</strong></p></td></tr><tr><td>Nom du cookie captcha Netacea</td><td><p>Un nom approprié pour votre cookie de suivi Captcha.</p><p><strong>Pour une sécurité accrue, n'incluez pas Netacea ou Mitigation dans ce nom.</strong></p></td></tr><tr><td>Liste d'exclusion Netacea - Chemins URL</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Champs optionnels - Peuvent être laissés vides sauf discussion préalable avec l'équipe Netacea**

<table><thead><tr><th width="278">Champ</th><th>Valeur</th></tr></thead><tbody><tr><td>Nom de l'en-tête IP réelle</td><td><p>Permet aux utilisateurs de personnaliser l'en-tête utilisé pour l'IP de la requête.</p><p>Laissez <strong>vide par</strong> défaut pour utiliser le champ standard Fastly <code>client.IP</code>.</p></td></tr><tr><td>Utiliser des ressources Captcha relatives</td><td>Si défini sur <code>true</code>, cela garantit que le Captcha est servi sans références au CDN Netacea. Sinon, l'URL complète vers le CDN Netacea sera intégrée dans le HTML du Captcha.<br>Laissez <strong>vide par</strong> défaut pour utiliser le HTML sur l'ensemble du site.</td></tr><tr><td>Chemin URL du Captcha</td><td>Permet aux utilisateurs de créer un point de terminaison qui sert toujours le HTML du Captcha. Utile lors de l'implémentation d'un challenge captcha pour les applications mobiles.<br>Laissez <strong>vide par</strong> défaut pour utiliser le chemin /ATAverify.</td></tr><tr><td>En-tête de marqueur de page Captcha</td><td>En-tête personnalisé qui indique si la réponse est une page Captcha. Doit être au format <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>En-tête de marqueur de page Captcha</td><td><p>Ajoute un en-tête aux requêtes des utilisateurs pour indiquer qu'un captcha a été servi.</p><p>Laissez <strong>vide par</strong> défaut.</p><p>Exemple de valeur <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Activer la négociation de contenu Captcha</td><td>Gère le format de la page Captcha. Lorsque défini sur <code>true</code>, il est possible pour l'intégration de retourner la page Captcha sous forme de JSON.<br>Laissez <strong>vide par</strong> défaut pour utiliser le HTML sur l'ensemble du site.</td></tr></tbody></table>

### Finalisation

Vérifiez que vous avez complété les étapes suivantes :

* Installation du [Module Edge](#install-the-netacea-vcl) [Netacea](#install-the-netacea-edge-module)
* Configuration du [streaming de logs](https://docs.netacea.com/fr/informations-sur-les-plugins-netacea/monitoring-configuration#log-streaming-implementation-steps) vers le bucket S3 fourni
* Vérification qu'aucun avertissement d'erreur n'apparaît

Vous êtes maintenant prêt à déployer en cliquant sur « Save Config »

{% hint style="info" %}
Un vidage du cache peut parfois être nécessaire. Pour ce faire, allez dans System -> Cache Management et cliquez sur « Flush Magento Cache »
{% endhint %}

La gestion des bots sera désormais déployée sur l'environnement Fastly/Magento. Vous pouvez vérifier que le déploiement est actif en :

* Vérifiant la présence du cookie Netacea sur le site web
* Consultant votre tableau de bord de reporting pour le trafic et la mitigation
* Demandant à Netacea d'examiner les métriques internes