# Installatie en Configuratie

### Vereisten

Om succesvol te integreren met Netacea, dient u te beschikken over:

1. Fastly versie 1.2.217 of hoger. Dit is de versie waarin de Netacea Edge-module voor de integratie is toegevoegd.
2. Toegang tot de relevante API-sleutels en log shipping-eindpunten in het [Netacea portal](https://docs.netacea.com/nl/netacea-plugin-informatie/accessing-your-integration-settings).

Klanten dienen ook een supportticket te openen bij Magento om te verzoeken dat Fastly POST inschakelt binnen hun omgeving. We moeten ervoor zorgen dat er 2 pragma's zijn ingeschakeld op uw Fastly-account die standaard niet zijn ingeschakeld.

Vereiste Pragma's:

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

Om de Pragma's in te schakelen, opent u een supportticket bij Fastly/Magento support. Deze Pragma's kunnen niet handmatig worden toegevoegd.

### Implementatiestappen

* Log in op de Fastly/Magento webinterface.
* Controleer of de Pragma's beschreven in de [vereisten ](#implementation-prerequisites)sectie zijn ingeschakeld door te navigeren naar Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Tools → List all versions.

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

* Toon de laatste VCL-versie en zoek naar de Pragma's bovenaan de VCL.

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

{% hint style="info" %}
Noteer de huidige versie voor het geval u in de toekomst moet terugdraaien.
{% endhint %}

### Een lege Dictionary aanmaken

Navigeer naar Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Edge Dictionaries en klik op "Add Dictionary".

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

Maak een dictionary aan met de naam "netacea\_edge\_config", deze kan leeg worden gelaten.

{% hint style="info" %}
Dit wordt alleen ingevuld bij gebruik van [Advanced Configuration](https://docs.netacea.com/nl/netacea-plugin-informatie/fastly-magento/installation-and-configuration/advanced-configuration) op advies van Netacea
{% endhint %}

### De Netacea Edge-module installeren

Navigeer naar Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Fastly Edge Modules en klik op "Manage" in de Module Manager.

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

* Vink de "Netacea Bot Detection integration" Edge Module aan en klik op "Save".

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

### Klantsleutels toepassen op de Module

* Navigeer naar de Active Modules en klik op het "Netacea Bot Detection integration" Actie-tandwiel.

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

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

**Vul de vereiste velden in**

<table><thead><tr><th width="157">Veld</th><th>Waarde</th></tr></thead><tbody><tr><td>Integratie Modus</td><td><p>BYPASS - Schakelt de Netacea-integratie volledig uit</p><p>INGEST - Passieve modus om Netacea verkeer te laten verzamelen en analyseren</p><p>MITIGATE - Actieve modus die mitigeert op basis van Netacea's Intent Analytics®</p><p>INJECT - Actieve modus voor klanten die Netacea-analytics willen ontvangen bij hun backend en zelf beslissingen willen nemen over te ondernemen acties.</p></td></tr><tr><td>Netacea API Key</td><td>Verstrekt via <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>Netacea Secret</td><td>Verstrekt via <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>Encryptiesleutel</td><td>Verstrekt via <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>Netacea cookienaam</td><td><p>Een geschikte naam voor uw mitigatie-cookie.</p><p><strong>Voor extra beveiliging, vermijd Netacea of Mitigation in deze naam.</strong></p></td></tr><tr><td>Netacea captcha cookienaam</td><td><p>Een geschikte naam voor uw Captcha-trackingcookie.</p><p><strong>Voor extra beveiliging, vermijd Netacea of Mitigation in deze naam.</strong></p></td></tr><tr><td>Netacea negeerlijst - URL-paden</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Optionele velden - Kunnen leeg worden gelaten tenzij besproken met het Netacea-team**

<table><thead><tr><th width="278">Veld</th><th>Waarde</th></tr></thead><tbody><tr><td>Real IP Header Naam</td><td><p>Stelt gebruikers in staat aan te passen welke header wordt gebruikt voor het IP-adres van het verzoek.</p><p>Laat <strong>standaard leeg</strong> om het standaard Fastly <code>client.IP</code> veld te gebruiken.</p></td></tr><tr><td>Gebruik Relatieve Captcha Pagina Assets</td><td>Indien ingesteld op <code>true</code>, wordt Captcha geserveerd zonder verwijzingen naar de Netacea CDN. Anders wordt de volledige URL naar Netacea CDN opgenomen in de Captcha HTML.<br>Laat <strong>standaard leeg</strong> om HTML sitebreed te gebruiken.</td></tr><tr><td>Captcha URL-pad</td><td>Stelt gebruikers in staat een eindpunt te maken dat altijd Captcha HTML serveert. Nuttig bij het implementeren van captcha-verificatie voor mobiele apps.<br>Laat <strong>standaard leeg</strong> om het /ATAverify pad te gebruiken.</td></tr><tr><td>Captcha Pagina Marker Header</td><td>Aangepaste header die aangeeft of de respons een Captcha-pagina is. Moet in het formaat <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>Captcha Pagina Marker Header</td><td><p>Voegt een header toe aan de verzoeken van de gebruiker om aan te tonen dat een captcha is geserveerd.</p><p>Laat <strong>standaard leeg</strong>.</p><p>Voorbeeldwaarde <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Captcha Content Negotiation Inschakelen</td><td>Beheert het formaat van de Captcha-pagina. Wanneer ingesteld op <code>true</code> is het mogelijk om de Captcha-pagina in JSON-formaat te ontvangen.<br>Laat <strong>standaard leeg</strong> om HTML sitebreed te gebruiken.</td></tr></tbody></table>

### Afronden

Controleer of u de volgende stappen hebt voltooid:

* Installeer de [Netacea ](#install-the-netacea-vcl)[Edge Module](#install-the-netacea-edge-module)
* Configureer [log streaming](https://docs.netacea.com/nl/netacea-plugin-informatie/monitoring-configuration#log-streaming-implementation-steps) naar de verstrekte S3-bucket
* Zorg ervoor dat er geen foutmeldingen worden weergegeven

U bent nu klaar om te deployen door op "Save Config" te klikken

{% hint style="info" %}
Een cache flush kan soms nodig zijn. Ga hiervoor naar System -> Cache Management en klik op "Flush Magento Cache"
{% endhint %}

Bot management wordt nu gedeployed op de Fastly/Magento-omgeving. U kunt testen of de deployment actief is door:

* Te controleren op de aanwezigheid van de Netacea-cookie op de website
* Uw rapportagedashboard te bekijken voor verkeer en mitigatie
* Netacea te vragen interne metrics te beoordelen