# Installation og konfiguration

### Forudsætninger

For at gennemføre integrationen med Netacea skal du sikre, at du har:

1. En Fastly version 1.2.217+ eller højere. Det er den version, hvor Netacea Edge-modulet til integrationen tilføjes.
2. Adgang til de relevante API-nøgler og log shipping-endpoints i [Netacea portal](https://docs.netacea.com/dk/netacea-plugin-information/accessing-your-integration-settings).

Kunder skal også åbne en supportsag hos Magento for at anmode Fastly om at aktivere POST i deres miljø. Vi skal sikre, at der er 2 pragmas aktiveret på din Fastly-konto, som ikke er aktiveret som standard.

Påkrævede Pragmas:

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

For at aktivere Pragmas skal du oprette en supportsag hos Fastly/Magento support. Disse Pragmas kan ikke tilføjes manuelt.

### Implementeringstrin

* Log ind på Fastly/Magento webgrænsefladen.
* Kontroller, at de Pragmas, der er beskrevet i [forudsætnings-](#implementation-prerequisites)afsnittet, er blevet aktiveret ved at navigere til Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Tools → List all versions.

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

* Vis den seneste VCL-version og kig efter Pragmas øverst i VCL'en.

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

{% hint style="info" %}
Noter den aktuelle version, hvis du får brug for at rulle tilbage i fremtiden.
{% endhint %}

### Opret en tom Dictionary

Naviger til Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Edge Dictionaries og klik på "Add Dictionary".

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

Opret en dictionary med navnet "netacea\_edge\_config", denne kan efterlades tom.

{% hint style="info" %}
Denne vil kun blive udfyldt ved brug af [Advanced Configuration](https://docs.netacea.com/dk/netacea-plugin-information/fastly-magento/installation-and-configuration/advanced-configuration) efter anbefaling fra Netacea
{% endhint %}

### Installer Netacea Edge-modulet

Naviger til Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Fastly Edge Modules og klik på "Manage" i Module Manager.

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

* Sæt flueben ved "Netacea Bot Detection integration" Edge Module og klik på "Save".

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

### Anvend kundenøgler på modulet

* Naviger til Active Modules og klik på "Netacea Bot Detection integration" Action-tandhjulet.

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

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

**Udfyld de påkrævede felter**

<table><thead><tr><th width="157">Felt</th><th>Værdi</th></tr></thead><tbody><tr><td>Integrationstilstand</td><td><p>BYPASS - Deaktiverer Netacea-integrationen fuldstændigt</p><p>INGEST - Passiv tilstand, der tillader Netacea at indsamle og analysere trafik</p><p>MITIGATE - Aktiv tilstand, der vil mitigere baseret på Netacea's Intent Analytics®</p><p>INJECT - Aktiv tilstand for kunder, der ønsker at modtage Netacea-analytics i deres backend og selv beslutte, hvilke handlinger der skal udføres.</p></td></tr><tr><td>Netacea API-nøgle</td><td>Leveres af <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>Netacea Secret</td><td>Leveres af <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>Krypteringsnøgle</td><td>Leveres af <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>Netacea cookienavn</td><td><p>Et passende navn til din mitigerings-cookie.</p><p><strong>For øget sikkerhed bør du ikke inkludere Netacea eller Mitigation i dette navn.</strong></p></td></tr><tr><td>Netacea captcha-cookienavn</td><td><p>Et passende navn til din Captcha-sporingscookie.</p><p><strong>For øget sikkerhed bør du ikke inkludere Netacea eller Mitigation i dette navn.</strong></p></td></tr><tr><td>Netacea ignoreringsliste - URL-stier</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Valgfrie felter - Kan efterlades tomme, medmindre andet er aftalt med Netacea-teamet**

<table><thead><tr><th width="278">Felt</th><th>Værdi</th></tr></thead><tbody><tr><td>Real IP Header-navn</td><td><p>Giver brugere mulighed for at tilpasse, hvilken header der bruges til anmodningens IP.</p><p>Lad feltet stå <strong>tomt som</strong> standard for at bruge Fastly standard <code>client.IP</code>-feltet.</p></td></tr><tr><td>Brug relative Captcha Page Assets</td><td>Hvis sat til <code>true</code>, sikres det, at Captcha serveres uden referencer til Netacea CDN. Ellers vil der indlejres fuld URL til Netacea CDN i Captcha HTML.<br>Lad feltet stå <strong>tomt som</strong> standard for at bruge HTML på hele sitet.</td></tr><tr><td>Captcha URL-sti</td><td>Giver brugere mulighed for at oprette et endpoint, der altid serverer Captcha HTML. Nyttigt ved implementering af captcha-udfordring til mobilapps.<br>Lad feltet stå <strong>tomt som</strong> standard for at bruge /ATAverify-stien.</td></tr><tr><td>Captcha Page Marker Header</td><td>Brugerdefineret header, der angiver, om svaret er en Captcha-side. Skal være i formatet <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>Captcha Page Marker Header</td><td><p>Tilføjer en header til brugerens anmodninger for at vise, at en captcha er blevet vist.</p><p>Lad feltet stå <strong>tomt som</strong> standard.</p><p>Eksempel på værdi <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Aktiver Captcha Content Negotiation</td><td>Håndterer formatet af Captcha-siden. Når sat til <code>true</code> er det muligt for integrationen at returnere Captcha-siden i form af JSON.<br>Lad feltet stå <strong>tomt som</strong> standard for at bruge HTML på hele sitet.</td></tr></tbody></table>

### Afslutning

Kontroller, at du har gennemført følgende trin:

* Installer [Netacea ](#install-the-netacea-vcl)[Edge Module](#install-the-netacea-edge-module)
* Konfigurer [log streaming](https://docs.netacea.com/dk/netacea-plugin-information/monitoring-configuration#log-streaming-implementation-steps) til den leverede S3-bucket
* Sørg for, at der ikke vises fejladvarsler

Du er nu klar til at deploye ved at klikke på "Save Config"

{% hint style="info" %}
En Cache flush kan nogle gange være påkrævet. For at gøre dette, gå til System -> Cache Management og klik på "Flush Magento Cache"
{% endhint %}

Bot management vil nu være udrullet i Fastly/Magento-miljøet. Du kan teste, at udrulningen er aktiv ved at:

* Kontrollere for tilstedeværelsen af Netacea-cookien på websitet
* Se dit rapporteringsdashboard for trafik og mitigering
* Anmode Netacea om at gennemgå interne metrikker