# 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.131+ eller högre.
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).
3. [Övervakning ](https://docs.netacea.com/se/netacea-plugininformation/fastly/monitoring-configuration)har konfigurerats.

Kunder behöver även öppna ett supportärende hos Fastly för att aktivera POST i sin miljö. Vi behöver 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 Support](https://support.fastly.com).

### Implementeringssteg

* Logga in på Fastlys webbgränssnitt.
* Från startsidan, välj lämplig tjänst. Du kan använda sökrutan för att söka efter ID, namn eller domän.
* Klicka på knappen Edit configuration och välj sedan alternativet att klona den aktiva versionen. Sidan Domains visas.

Alla konfigurationsändringar nedan kommer att göras på den nyligen klonade versionen.

{% hint style="info" %}
Notera den för närvarande aktiva versionen om du behöver återställa i framtiden.
{% endhint %}

### Host

För att tillåta Netacea VCL att göra anrop till Protector API måste 2 nya hosts konfigureras med Netaceas detaljer, som ska anropas i [VCL-snippets](#vcl-snippets).

* Klicka på länken Origins. Sidan Origins visas.
* Klicka på knappen "Create a Host". Fältet Host visas.

Fyll i en ny host med följande URL och klicka på "Add":

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

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

Redigera den nya hosten genom att klicka på pennikonen och ändra namnet till:

```
MitSvc
```

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

I fältet Override host, ange samma URL som den ursprungliga hosten.

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

Upprepa processen, fyll i den nya hosten med följande URL och klicka på "Add":

```
assets.ntcacdn.net
```

Redigera den nya hosten genom att klicka på pennikonen och ändra namnet till:

```
CaptchaAssets
```

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

### VCL Snippets

För att Netacea ska kunna triggas och erbjuda skydd måste lösningen läggas till i Fastly-miljön i form av en anpassad VCL.

Netacea VCL är uppdelad i 7 nyckelsnippets: INIT, DELIVER, RECV, ERROR, RECV\_CONFIGURE, PASS och MISS. Var och en behöver läggas till i VCL Snippets-konfigurationen inom Fastly.

{% hint style="info" %}
Netacea tillhandahåller VCL separat.
{% endhint %}

**INIT:**

* Navigera till VCL snippets inom Fastly.
* Klicka på knappen "Create snippet".
* Ge snippeten ett lämpligt namn, såsom Netacea\_INIT
* Sätt typen till "init"

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

* Klistra in INIT-koden i VCL
* På rad 4 - 24 hittar du en uppsättning fält unika för varje distribution att definiera, sätt integration\_type till lämpligt läge.

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

**Obligatoriska fält**

<table data-full-width="true"><thead><tr><th width="338">Fält</th><th>Värde</th></tr></thead><tbody><tr><td>integration_type</td><td>fastly</td></tr><tr><td>integration_version</td><td>&#x3C;Integrationsversion></td></tr><tr><td>integration_mode</td><td><p>BYPASS - Inaktiverar Netacea-integrationen helt och hållet</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 på sin backend och bestämma vilka åtgärder som ska vidtas.</p></td></tr><tr><td>api_key</td><td>Tillhandahålls av <a href="../accessing-your-integration-settings">Netacea-portalen</a></td></tr><tr><td>secret_key</td><td>Tillhandahålls av <a href="../accessing-your-integration-settings">Netacea-portalen</a></td></tr><tr><td>encryption_key</td><td>Tillhandahålls av <a href="../accessing-your-integration-settings">Netacea-portalen</a></td></tr><tr><td>cookie_name</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>captcha_cookie_name</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>ignore_list</td><td>Kommaseparerad lista över underkataloger där mitigation inte ska tillämpas. Du kan ange upp till 5 underkataloger här. Alla resurser under sådana kataloger kommer att ignoreras av integrationen.<br>Lägg till <code>/media/,/static/</code> som standard för att säkerställa full integrationstäckning utan att trigga på mediainnehåll.</td></tr></tbody></table>

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

<table data-full-width="true"><thead><tr><th width="330">Fält</th><th>Värde</th></tr></thead><tbody><tr><td>real_ip_header_name</td><td><p>Gör det möjligt för användare att anpassa vilket header som används för begärans IP.</p><p>Lämna <strong>tomt som</strong> standard för att använda Fastly-standardfältet <code>client.IP</code>.</p></td></tr><tr><td>use_relative_path_captcha_assets</td><td>Om satt till <code>true</code> säkerställer det att Captcha serveras utan referenser till Netacea CDN. Annars bäddas fullständig URL till Netacea CDN in i Captcha HTML.<br>Lämna <strong>tomt som</strong> standard för att använda HTML webbplatsövergripande.</td></tr><tr><td>captcha_path</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>tomt som</strong> standard för att använda /ATAverify-sökvägen.</td></tr><tr><td>captcha_header</td><td>Anpassat 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>enable_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 JSON-format.<br>Lämna <strong>tomt som</strong> standard för att använda HTML webbplatsövergripande.</td></tr></tbody></table>

<figure><img src="https://1757243805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGUMNWETAzwSHwJ2JpW3%2Fuploads%2Fgit-blob-525038b624bb0310dbd4fb6300b7e9aaa97de335%2Fimage%20(75).png?alt=media" alt=""><figcaption><p>Exempel på giltig konfiguration</p></figcaption></figure>

Under avancerade alternativ, sätt prioriteten till 45.

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

**RECV**:

* Klicka på knappen "Create snippet"
* Ge snippeten ett lämpligt namn, såsom Netacea\_RECV
* Sätt typen till "within subroutine" & "recv (vcl\_recv)"
* Klistra in RECV-koden i VCL
* Sätt prioriteten till 45

**DELIVER**

* Klicka på knappen "Create snippet"
* Ge snippeten ett lämpligt namn, såsom Netacea\_DELIVER
* Sätt typen till "within subroutine" & "deliver (vcl\_deliver)"
* Klistra in DELIVER-koden i VCL
* Sätt prioriteten till 45

**ERROR:**

* Klicka på knappen "Create snippet"
* Ge snippeten ett lämpligt namn, såsom Netacea\_ERROR
* Sätt typen till "within subroutine" & "error (vcl\_error)"
* Klistra in ERROR-koden i VCL
* Sätt prioriteten till 45

**RECV\_CONFIGURE:**

* Klicka på knappen "Create snippet"
* Ge snippeten ett lämpligt namn, såsom Netacea\_RECV\_CONFIGURE
* Sätt typen till "within subroutine" & "recv (vcl\_recv)"
* Klistra in RECV\_CONFIGURE-koden i VCL
* Sätt prioriteten till 46

PASS:

* Klicka på knappen "Create snippet"
* Ge snippeten ett lämp