# Installasjon og konfigurasjon

### Forutsetninger

For å lykkes med integrasjonen ved hjelp av Netacea, vennligst sørg for at du har:

1. En Fastly-versjon på 1.2.217 eller høyere. Dette er versjonen hvor Netacea Edge-modulen for integrasjonen er lagt til.
2. Tilgang til de relevante API-nøklene og loggoverføringsendepunktene i [Netacea-portalen](https://docs.netacea.com/no/netacea-plugininformasjon/accessing-your-integration-settings).

Kunder må også åpne en supporthenvendelse hos Magento for å be Fastly om å aktivere POST i deres miljø. Vi må sikre at det er 2 pragmaer aktivert på din Fastly-konto som ikke er aktivert som standard.

Nødvendige pragmaer:

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

For å aktivere pragmaene, opprett en supporthenvendelse hos Fastly/Magento support. Disse pragmaene kan ikke legges til manuelt.

### Implementeringstrinn

* Logg inn på Fastly/Magento-webgrensesnittet.
* Kontroller at pragmaene beskrevet i [forutsetningsdelen ](#implementation-prerequisites)er aktivert ved å navigere til Butikker → Konfigurasjon → Avansert → System → Helsidebuffer → Fastly-konfigurasjon → Verktøy → List alle versjoner.

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

* Vis den nyeste VCL-versjonen og se etter pragmaene øverst i VCL-en.

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

{% hint style="info" %}
Noter den nåværende versjonen i tilfelle du trenger å rulle tilbake i fremtiden.
{% endhint %}

### Opprett en tom ordbok

Naviger til Butikker → Konfigurasjon → Avansert → System → Helsidebuffer → Fastly-konfigurasjon → Edge-ordbøker og klikk «Legg til ordbok».

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

Opprett en ordbok med navnet «netacea\_edge\_config», denne kan stå tom.

{% hint style="info" %}
Denne vil kun fylles ut ved bruk av [Avansert konfigurasjon](https://docs.netacea.com/no/netacea-plugininformasjon/fastly-magento/installation-and-configuration/advanced-configuration) etter anbefaling fra Netacea
{% endhint %}

### Installer Netacea Edge-modulen

Naviger til Butikker → Konfigurasjon → Avansert → System → Helsidebuffer → Fastly-konfigurasjon → Fastly Edge-moduler og klikk «Administrer» på modulbehandleren.

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

* Huk av for «Netacea Bot Detection integration» Edge-modulen og klikk «Lagre».

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

### Legg til kundenøkler i modulen

* Naviger til Aktive moduler og klikk på «Netacea Bot Detection integration»-tannhjulet.

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

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

**Fyll inn de nødvendige feltene**

<table><thead><tr><th width="157">Felt</th><th>Verdi</th></tr></thead><tbody><tr><td>Integrasjonsmodus</td><td><p>BYPASS - Deaktiverer Netacea-integrasjonen helt</p><p>INGEST - Passiv modus for å la Netacea samle inn og analysere trafikk</p><p>MITIGATE - Aktiv modus som vil mitigere basert på Netacea Intent Analytics®</p><p>INJECT - Aktiv modus for kunder som ønsker å motta Netacea-analyse i sin backend og bestemme hvilke handlinger som skal utføres.</p></td></tr><tr><td>Netacea API-nøkkel</td><td>Tilbys av <a href="../accessing-your-integration-settings">Netacea-portalen</a></td></tr><tr><td>Netacea Secret</td><td>Tilbys av <a href="../accessing-your-integration-settings">Netacea-portalen</a></td></tr><tr><td>Krypteringsnøkkel</td><td>Tilbys av <a href="../accessing-your-integration-settings">Netacea-portalen</a></td></tr><tr><td>Netacea informasjonskapselnavn</td><td><p>Et passende navn for din mitigation-informasjonskapsel.</p><p><strong>For økt sikkerhet, ikke inkluder Netacea eller Mitigation i dette navnet.</strong></p></td></tr><tr><td>Netacea captcha-informasjonskapselnavn</td><td><p>Et passende navn for din Captcha-sporingsinformasjonskapsel.</p><p><strong>For økt sikkerhet, ikke inkluder Netacea eller Mitigation i dette navnet.</strong></p></td></tr><tr><td>Netacea ignoreringsliste - URL-stier</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Valgfrie felter - Kan stå tomme med mindre avtalt med Netacea-teamet**

<table><thead><tr><th width="278">Felt</th><th>Verdi</th></tr></thead><tbody><tr><td>Reell IP-headernavn</td><td><p>Lar brukere tilpasse hvilken header som brukes for forespørselens IP.</p><p>La stå <strong>tom som</strong> standard for å bruke Fastlys standard <code>client.IP</code>-felt.</p></td></tr><tr><td>Bruk relative Captcha-sideressurser</td><td>Hvis satt til <code>true</code>, sikrer det at Captcha serveres uten referanser til Netacea CDN. Ellers vil full URL til Netacea CDN bli innebygd i Captcha HTML.<br>La stå <strong>tom som</strong> standard for å bruke HTML på hele nettstedet.</td></tr><tr><td>Captcha URL-sti</td><td>Lar brukere opprette et endepunkt som alltid serverer Captcha HTML. Nyttig ved implementering av captcha-utfordring for mobilapper.<br>La stå <strong>tom som</strong> standard for å bruke /ATAverify-stien.</td></tr><tr><td>Captcha-sidemarkør-header</td><td>Tilpasset header som indikerer om responsen er en Captcha-side. Må være i formatet <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>Captcha-sidemarkør-header</td><td><p>Legger til en header på brukerens forespørsler for å vise at en captcha har blitt servert.</p><p>La stå <strong>tom som</strong> standard.</p><p>Eksempelverdi <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Aktiver Captcha-innholdsforhandling</td><td>Håndterer formatet på Captcha-siden. Når satt til <code>true</code> er det mulig for integrasjonen å returnere Captcha-siden i form av JSON.<br>La stå <strong>tom som</strong> standard for å bruke HTML på hele nettstedet.</td></tr></tbody></table>

### Fullføring

Kontroller at du har fullført følgende trinn:

* Installert [Netacea ](#install-the-netacea-vcl)[Edge-modulen](#install-the-netacea-edge-module)
* Konfigurert [loggstrømming](https://docs.netacea.com/no/netacea-plugininformasjon/monitoring-configuration#log-streaming-implementation-steps) til den angitte S3-bøtten
* Sørget for at ingen feiladvarsler vises

Du er nå klar til å distribuere ved å klikke «Lagre konfigurasjon»

{% hint style="info" %}
En tømming av hurtigbufferen kan noen ganger være nødvendig. For å gjøre dette, gå til System -> Hurtigbufferadministrasjon og klikk «Tøm Magento-buffer»
{% endhint %}

Bot-administrasjon vil nå være distribuert i Fastly/Magento-miljøet. Du kan teste at distribusjonen er aktiv ved å:

* Sjekke om Netacea-informasjonskapselen er til stede på nettstedet
* Se på rapporteringsdashbordet for trafikk og mitigering
* Be Netacea om å gjennomgå interne metrikker
