# Asennus ja määritys

### Edellytykset

Onnistuneeseen integrointiin Netaecan kanssa varmista, että sinulla on:

1. Fastly-versio 1.2.131 tai uudempi.
2. Pääsy asianmukaisiin API-avaimiin ja lokien toimituksen päätepisteisiin [Netacea portal](https://docs.netacea.com/fi/netacea-laajennustiedot/accessing-your-integration-settings).
3. [Monitoring ](https://docs.netacea.com/fi/netacea-laajennustiedot/fastly/monitoring-configuration)on konfiguroitu.

Asiakkaiden on myös avattava tukipyyntö Fastlyn kanssa POST-toiminnon käyttöön ottamiseksi ympäristössään. Meidän on varmistettava, että Fastly-tililläsi on käytössä 2 pragma-asetusta, jotka eivät ole oletusarvoisesti käytössä.

Vaaditut Pragma-asetukset:

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

Ota Pragma-asetukset käyttöön avaamalla tukipyyntö [Fastly Support](https://support.fastly.com).

### Toteutusvaiheet

* Kirjaudu sisään Fastlyn verkkoliittymään.
* Valitse etusivulta sopiva palvelu. Voit käyttää hakukenttää ID:n, nimen tai domainin mukaan hakemiseen.
* Napsauta Edit configuration -painiketta ja valitse sitten vaihtoehto aktiivisen version kloonaamiseksi. Domains-sivu avautuu.

Kaikki alla olevat konfiguraatiomuutokset tehdään juuri kloonattuun versioon.

{% hint style="info" %}
Merkitse muistiin tällä hetkellä aktiivinen versio siltä varalta, että sinun on palattava siihen tulevaisuudessa.
{% endhint %}

### Isäntä

Jotta Netacea VCL voi tehdä kutsuja Protector API:iin, 2 uutta isäntää on konfiguroitava Netaecan tiedoilla kutsuttaviksi [VCL snippets](#vcl-snippets).

* Napsauta Origins-linkkiä. Origins-sivu avautuu.
* Napsauta "Create a Host" -painiketta. Host-kenttä tulee näkyviin.

Täytä uusi isäntä seuraavalla URL-osoitteella ja napsauta "Add":

```
mitigations-lbr.netacea.net
```

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

Muokkaa uutta isäntää napsauttamalla kynäkuvaketta ja vaihda nimeksi:

```
MitSvc
```

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

Kirjoita Override host -kenttään sama URL kuin alkuperäisessä isännässä.

<figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-7275cea7605b5ffa73dd1f752c9b97abd22a6928%2FScreenshot%202025-04-02%20161507.png?alt=media" alt=""><figcaption></figcaption></figure>

Toista prosessi, täytä uusi isäntä seuraavalla URL-osoitteella ja napsauta "Add":

```
assets.ntcacdn.net
```

Muokkaa uutta isäntää napsauttamalla kynäkuvaketta ja vaihda nimeksi:

```
CaptchaAssets
```

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

### VCL-pätkät

Jotta Netacea käynnistyy ja tarjoaa suojauksen, ratkaisu on lisättävä Fastly-ympäristöön mukautetun VCL:n muodossa.

Netacea VCL on jaettu 7 keskeiseen pätkään: INIT, DELIVER, RECV, ERROR, RECV\_CONFIGURE, PASS ja MISS. Jokainen on lisättävä VCL Snippets -konfiguraatioon Fastlyssa.

{% hint style="info" %}
Netacea toimittaa VCL:n erikseen.
{% endhint %}

**INIT:**

* Siirry VCL snippets -osioon Fastlyssa.
* Napsauta "Create snippet" -painiketta.
* Anna pätkälle sopiva nimi, kuten Netacea\_INIT
* Aseta tyypiksi "init"

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

* Liitä INIT-koodi VCL:ään
* Riveillä 4–24 löydät joukon kullekin käyttöönotolle yksilöllisiä kenttiä määritettäväksi, aseta integration\_type sopivaan tilaan.

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

**Pakolliset kentät**

<table data-full-width="true"><thead><tr><th width="338">Kenttä</th><th>Arvo</th></tr></thead><tbody><tr><td>integration_type</td><td>fastly</td></tr><tr><td>integration_version</td><td>&#x3C;Integration Version></td></tr><tr><td>integration_mode</td><td><p>BYPASS - Poistaa Netaeca-integraation kokonaan käytöstä</p><p>INGEST - Passiivinen tila, joka mahdollistaa Netaecan kerätä ja analysoida liikennettä</p><p>MITIGATE - Aktiivinen tila, joka torjuu Netaecan Intent Analytics® -analyysin perusteella</p><p>INJECT - Aktiivinen tila asiakkaille, jotka haluavat vastaanottaa Netaeca-analytiikan taustajärjestelmässään ja päättää toteutettavat toimenpiteet.</p></td></tr><tr><td>api_key</td><td>Toimitetaan <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>secret_key</td><td>Toimitetaan <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>encryption_key</td><td>Toimitetaan <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>cookie_name</td><td><p>Sopiva nimi torjuntaevästeellesi.</p><p><strong>Lisäturvallisuuden vuoksi älä sisällytä tähän nimeen sanoja Netacea tai Mitigation.</strong></p></td></tr><tr><td>captcha_cookie_name</td><td><p>Sopiva nimi Captcha-seurantaevästeellesi.</p><p><strong>Lisäturvallisuuden vuoksi älä sisällytä tähän nimeen sanoja Netacea tai Mitigation.</strong></p></td></tr><tr><td>ignore_list</td><td>Pilkuilla eroteltu luettelo alihakemistoista, joissa torjuntaa ei sovelleta. Voit määrittää enintään 5 alihakemistoa tähän. Integraatio jättää huomiotta kaikki tällaisen hakemiston resurssit.<br>Lisää <code>/media/,/static/</code> oletusarvoisesti varmistaaksesi täyden integraatiokattavuuden ilman aktivoitumista mediasisällöstä.</td></tr></tbody></table>

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

<table data-full-width="true"><thead><tr><th width="330">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>oletusarvoisesti tyhjäksi</strong> käyttääksesi Fastlyn vakiomuotoista <code>client.IP</code> -kenttää.</p></td></tr><tr><td>use_relative_path_captcha_assets</td><td>Jos asetettu arvoon <code>true</code>, varmistaa että Captcha tarjotaan ilman viittauksia Netaeca CDN:ään. Muutoin Captcha HTML:ään upotetaan täydellinen URL Netaeca CDN:ään.<br>Jätä <strong>oletusarvoisesti tyhjäksi</strong> käyttääksesi HTML:ää koko sivustolla.</td></tr><tr><td>captcha_path</td><td>Mahdollistaa käyttäjien luoda päätepisteen, joka tarjoaa aina Captcha HTML:n. Hyödyllinen Captcha-haasteen toteuttamisessa mobiilisovelluksille.<br>Jätä <strong>oletusarvoisesti tyhjäksi</strong> käyttääksesi /ATAverify-polkua.</td></tr><tr><td>captcha_header</td><td>Mukautettu otsikko, joka ilmaisee, onko vastaus Captcha-sivu. On oltava muodossa <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>enable_captcha_content_negotiation</td><td>Käsittelee Captcha-sivun muotoa. Kun asetettu arvoon <code>true</code>, integraatio voi palauttaa Captcha-sivun JSON-muodossa.<br>Jätä <strong>oletusarvoisesti tyhjäksi</strong> käyttääksesi HTML:ää koko sivustolla.</td></tr></tbody></table>

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

Aseta lisäasetuksissa prioriteetiksi 45.

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

**RECV**:

* Napsauta "Create snippet" -painiketta
* Anna pätkälle