# Installation och konfiguration

### Förutsättningar

För att framgångsrikt integrera med Netacea, säkerställ att du har:

1. En Fastly-version 1.2.217+ eller högre. Det är den version där Netacea Edge-modulen för integrationen läggs till.
2. Tillgång till relevanta API-nycklar och loggöverföringsändpunkter i [Netacea-portalen](https://docs.netacea.com/se/netacea-plugininformation/accessing-your-integration-settings).

Kunder behöver också öppna ett supportärende hos Magento för att begära att Fastly aktiverar POST i deras miljö. Vi måste säkerställa att det finns 2 pragmas aktiverade på ditt Fastly-konto som inte är aktiverade som standard.

Nödvändiga Pragmas:

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

För att aktivera Pragmas, skapa ett supportärende hos Fastly/Magento-supporten. Dessa Pragmas kan inte läggas till manuellt.

### Implementeringssteg

* Logga in på Fastly/Magento-webbgränssnittet.
* Kontrollera att Pragmas som beskrivs i [förutsättnings-](#implementation-prerequisites)avsnittet har aktiverats genom att navigera till Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Tools → List all versions.

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

* Visa den senaste VCL-versionen och leta efter Pragmas högst upp i VCL:en.

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

{% hint style="info" %}
Anteckna den aktuella versionen om du behöver återställa i framtiden.
{% endhint %}

### Skapa en tom Dictionary

Navigera till Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Edge Dictionaries och klicka på "Add Dictionary".

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

Skapa en dictionary med namnet "netacea\_edge\_config", denna kan lämnas tom.

{% hint style="info" %}
Denna kommer endast att fyllas i vid användning av [Avancerad konfiguration](https://docs.netacea.com/se/netacea-plugininformation/fastly-magento/installation-and-configuration/advanced-configuration) efter råd från Netacea
{% endhint %}

### Installera Netacea Edge-modulen

Navigera till Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Fastly Edge Modules och klicka på "Manage" i Module Manager.

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

* Markera "Netacea Bot Detection integration" Edge Module och klicka på "Save".

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

### Tillämpa kundnycklar på modulen

* Navigera till Active Modules och klicka på kugghjulet för "Netacea Bot Detection integration" Action.

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

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

**Fyll i de obligatoriska fälten**

<table><thead><tr><th width="157">Fält</th><th>Värde</th></tr></thead><tbody><tr><td>Integrationsläge</td><td><p>BYPASS - Inaktiverar Netacea-integrationen helt</p><p>INGEST - Passivt läge för att låta Netacea samla in och analysera trafik</p><p>MITIGATE - Aktivt läge som kommer att mitigera baserat på Netaceas Intent Analytics®</p><p>INJECT - Aktivt läge för kunder som vill ta emot Netacea-analys i sin backend och själva bestämma åtgärder.</p></td></tr><tr><td>Netacea API-nyckel</td><td>Tillhandahålls av <a href="../accessing-your-integration-settings">Netacea-portalen</a></td></tr><tr><td>Netacea Secret</td><td>Tillhandahålls av <a href="../accessing-your-integration-settings">Netacea-portalen</a></td></tr><tr><td>Krypteringsnyckel</td><td>Tillhandahålls av <a href="../accessing-your-integration-settings">Netacea-portalen</a></td></tr><tr><td>Netacea cookie-namn</td><td><p>Ett lämpligt namn för din mitigation-cookie.</p><p><strong>För ökad säkerhet, inkludera inte Netacea eller Mitigation i detta namn.</strong></p></td></tr><tr><td>Netacea captcha cookie-namn</td><td><p>Ett lämpligt namn för din Captcha-spårningscookie.</p><p><strong>För ökad säkerhet, inkludera inte Netacea eller Mitigation i detta namn.</strong></p></td></tr><tr><td>Netacea ignoreringslista - URL-sökväg</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Valfria fält - Kan lämnas tomma om inte annat diskuterats med Netacea-teamet**

<table><thead><tr><th width="278">Fält</th><th>Värde</th></tr></thead><tbody><tr><td>Real IP Header-namn</td><td><p>Gör det möjligt för användare att anpassa vilken header som används för förfrågans IP.</p><p>Lämna <strong>tom som</strong> standard för att använda Fastlys standardfält <code>client.IP</code>.</p></td></tr><tr><td>Använd relativa Captcha-sidresurser</td><td>Om satt till <code>true</code>, säkerställer det att Captcha serveras utan referenser till Netacea CDN. Annars kommer full URL till Netacea CDN att bäddas in i Captcha HTML.<br>Lämna <strong>tom som</strong> standard för att använda HTML på hela webbplatsen.</td></tr><tr><td>Captcha URL-sökväg</td><td>Gör det möjligt för användare att skapa en ändpunkt som alltid serverar Captcha HTML. Användbart vid implementering av captcha-utmaning för mobilappar.<br>Lämna <strong>tom som</strong> standard för att använda /ATAverify-sökvägen.</td></tr><tr><td>Captcha Page Marker Header</td><td>Anpassad header som indikerar om svaret är en Captcha-sida. Måste vara i formatet <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>Captcha Page Marker Header</td><td><p>Lägger till en header på användarnas förfrågningar för att visa att en captcha har serverats.</p><p>Lämna <strong>tom som</strong> standard.</p><p>Exempelvärde <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Aktivera Captcha Content Negotiation</td><td>Hanterar formatet för Captcha-sidan. När satt till <code>true</code> är det möjligt för integrationen att returnera Captcha-sidan i form av JSON.<br>Lämna <strong>tom som</strong> standard för att använda HTML på hela webbplatsen.</td></tr></tbody></table>

### Slutförande

Kontrollera att du har slutfört följande steg:

* Installera [Netacea ](#install-the-netacea-vcl)[Edge-modulen](#install-the-netacea-edge-module)
* Konfigurerat [loggströmning](https://docs.netacea.com/se/netacea-plugininformation/monitoring-configuration#log-streaming-implementation-steps) till den tillhandahållna S3-bucketen
* Säkerställ att inga felvarningar visas

Du är nu redo att distribuera genom att klicka på "Save Config"

{% hint style="info" %}
En cachetömning kan ibland krävas. För att göra detta, gå till System -> Cache Management och klicka på "Flush Magento Cache"
{% endhint %}

Bothantering kommer nu att distribueras på Fastly/Magento-miljön. Du kan testa att distributionen är aktiv genom att:

* Kontrollera att Netacea-cookien finns på webbplatsen
* Visa din rapporterings-dashboard för trafik och mitigering
* Begära att Netacea granskar interna mätetal