# Asennus ja määritys

### Edellytykset

Netacea-integraation onnistuneen käyttöönoton varmistamiseksi varmista, että sinulla on:

1. Fastly-versio 1.2.217 tai uudempi. Tämä on versio, jossa Netacea Edge -moduuli integraatiota varten on lisätty.
2. Pääsy asiaankuuluviin API-avaimiin ja lokien toimituksen päätepisteisiin [Netacea-portaalissakin.](https://docs.netacea.com/fi/netacea-laajennustiedot/accessing-your-integration-settings)

Asiakkaiden tulee myös avata tukipyyntö Magentoon pyytääkseen Fastlyä ottamaan käyttöön POST-toiminnon heidän ympäristössään. Meidän on varmistettava, että Fastly-tililläsi on käytössä 2 pragma-asetusta, jotka eivät ole oletuksena käytössä.

Vaaditut pragmat:

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

Pragmojen käyttöönottamiseksi avaa tukipyyntö Fastly/Magento-tukeen. Näitä pragmoja ei voi lisätä manuaalisesti.

### Käyttöönottovaiheet

* Kirjaudu sisään Fastly/Magento-verkkokäyttöliittymään.
* Tarkista, että [edellytykset ](#implementation-prerequisites)-osiossa mainitut pragmat on otettu käyttöön siirtymällä kohtaan Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Tools → List all versions.

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

* Näytä uusin VCL-versio ja etsi pragmat VCL:n alusta.

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

{% hint style="info" %}
Kirjaa muistiin nykyinen versio siltä varalta, että sinun täytyy palata aiempaan versioon tulevaisuudessa.
{% endhint %}

### Tyhjän sanakirjan luominen

Siirry kohtaan Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Edge Dictionaries ja klikkaa "Add Dictionary".

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

Luo sanakirja nimellä "netacea\_edge\_config", tämä voidaan jättää tyhjäksi.

{% hint style="info" %}
Tämä täytetään vain käytettäessä [Lisämääritystä ](https://docs.netacea.com/fi/netacea-laajennustiedot/fastly-magento/installation-and-configuration/advanced-configuration)Netacea-tiimin ohjeistuksella
{% endhint %}

### Netacea Edge -moduulin asennus

Siirry kohtaan Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Fastly Edge Modules ja klikkaa "Manage" moduulinhallinnassa.

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

* Valitse "Netacea Bot Detection integration" Edge Module ja klikkaa "Save".

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

### Asiakasavainten liittäminen moduuliin

* Siirry aktiivisiin moduuleihin ja klikkaa "Netacea Bot Detection integration" -toiminnon rataskuvaketta.

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

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

**Syötä pakolliset kentät**

<table><thead><tr><th width="157">Kenttä</th><th>Arvo</th></tr></thead><tbody><tr><td>Integration Mode</td><td><p>BYPASS - Poistaa Netacea-integraation kokonaan käytöstä</p><p>INGEST - Passiivinen tila, joka sallii Netacea-tiimin kerätä ja analysoida liikennettä</p><p>MITIGATE - Aktiivinen tila, joka torjuu uhkia Netacea-tiimin Intent Analytics® -palvelun perusteella</p><p>INJECT - Aktiivinen tila asiakkaille, jotka haluavat vastaanottaa Netacea-analytiikkaa taustajärjestelmäänsä ja päättää toteutettavat toimenpiteet.</p></td></tr><tr><td>Netacea API Key</td><td>Saatavilla <a href="../accessing-your-integration-settings">Netacea-portaalista</a></td></tr><tr><td>Netacea Secret</td><td>Saatavilla <a href="../accessing-your-integration-settings">Netacea-portaalista</a></td></tr><tr><td>Encryption Key</td><td>Saatavilla <a href="../accessing-your-integration-settings">Netacea-portaalista</a></td></tr><tr><td>Netacea cookie name</td><td><p>Sopiva nimi torjuntaevästeellesi.</p><p><strong>Turvallisuuden lisäämiseksi älä sisällytä Netacea- tai Mitigation-sanoja tähän nimeen.</strong></p></td></tr><tr><td>Netacea captcha cookie name</td><td><p>Sopiva nimi Captcha-seurantaevästeellesi.</p><p><strong>Turvallisuuden lisäämiseksi älä sisällytä Netacea- tai Mitigation-sanoja tähän nimeen.</strong></p></td></tr><tr><td>Netacea ignore list - URL Paths</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Valinnaiset kentät - Voidaan jättää tyhjiksi, ellei Netacea-tiimin kanssa ole toisin sovittu**

<table><thead><tr><th width="278">Kenttä</th><th>Arvo</th></tr></thead><tbody><tr><td>Real IP Header Name</td><td><p>Mahdollistaa käyttäjien mukauttaa, mitä otsikkoa käytetään pyynnön IP-osoitteelle.</p><p>Jätä <strong>oletuksena tyhjäksi</strong> käyttääksesi Fastlyn vakiomuotoista <code>client.IP</code> -kenttää.</p></td></tr><tr><td>Use Relative Captcha Page Assets</td><td>Jos asetettu arvoon <code>true</code>, se varmistaa, että Captcha tarjoillaan ilman viittauksia Netacea CDN:ään. Muussa tapauksessa Captcha-HTML:ään upotetaan täydellinen URL Netacea CDN:ään.<br>Jätä <strong>oletuksena tyhjäksi</strong> käyttääksesi HTML:ää koko sivustolla.</td></tr><tr><td>Captcha URL Path</td><td>Mahdollistaa käyttäjien luoda päätepisteen, joka tarjoilee aina Captcha-HTML:n. Hyödyllinen toteutettaessa captcha-haastetta mobiilisovelluksille.<br>Jätä <strong>oletuksena tyhjäksi</strong> käyttääksesi /ATAverify-polkua.</td></tr><tr><td>Captcha Page Marker Header</td><td>Mukautettu otsikko, joka ilmaisee, onko vastaus Captcha-sivu. Muoto on oltava <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>Captcha Page Marker Header</td><td><p>Lisää otsikon käyttäjän pyyntöihin osoittamaan, että captcha on tarjoiltu.</p><p>Jätä <strong>oletuksena tyhjäksi</strong>.</p><p>Esimerkkiarvo <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Enable Captcha Content Negotiation</td><td>Käsittelee Captcha-sivun muotoa. Kun asetettu arvoon <code>true</code>, integraation on mahdollista palauttaa Captcha-sivu JSON-muodossa.<br>Jätä <strong>oletuksena tyhjäksi</strong> käyttääksesi HTML:ää koko sivustolla.</td></tr></tbody></table>

### Viimeistely

Tarkista, että olet suorittanut seuraavat vaiheet:

* Asenna [Netacea ](#install-the-netacea-vcl)[Edge Module](#install-the-netacea-edge-module)
* Määritä [lokien striimaus](https://docs.netacea.com/fi/netacea-laajennustiedot/monitoring-configuration#log-streaming-implementation-steps) toimitettuun S3-säilöön
* Varmista, ettei virheilmoituksia näy

Olet nyt valmis ottamaan käyttöön klikkaamalla "Save Config"

{% hint style="info" %}
Välimuistin tyhjennys voi joskus olla tarpeen. Tee tämä siirtymällä kohtaan System -> Cache Management ja klikkaamalla "Flush Magento Cache"
{% endhint %}

Bottien hallinta on nyt otettu käyttöön Fastly/Magento-ympäristössä. Voit testata käyttöönoton aktiivisuutta seuraavasti:

* Tarkistamalla Netacea-evästeen läsnäolo verkkosivustolla
* Tarkastelemalla raportoinnin hallintapaneelia liikenteen ja torjunnan osalta
* Pyytämällä Netacea-tiimiltä sisäisten mittareiden tarkistusta