# Installatie en Configuratie

### Vereisten

Om succesvol te integreren met Netacea, dient u te beschikken over:

1. Een Fastly versie 1.2.131+ of hoger.
2. Toegang tot de relevante API-sleutels en log shipping endpoints in de [Netacea portal](https://docs.netacea.com/nl/netacea-plugin-informatie/accessing-your-integration-settings).
3. [Monitoring ](https://docs.netacea.com/nl/netacea-plugin-informatie/fastly/monitoring-configuration)is geconfigureerd.

Klanten dienen ook een supportticket te openen bij Fastly om POST binnen hun omgeving in te schakelen. We moeten ervoor zorgen dat er 2 pragma's zijn ingeschakeld op uw Fastly-account die standaard niet zijn ingeschakeld.

Vereiste Pragma's:

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

Om de Pragma's in te schakelen, opent u een supportticket bij [Fastly Support](https://support.fastly.com).

### Implementatiestappen

* Log in op de Fastly webinterface.
* Selecteer op de Startpagina de juiste service. U kunt het zoekveld gebruiken om te zoeken op ID, naam of domein.
* Klik op de knop Edit configuration en selecteer vervolgens de optie om de actieve versie te klonen. De pagina Domains verschijnt.

Alle onderstaande configuratiewijzigingen worden aangebracht in de nieuw gekloonde versie.

{% hint style="info" %}
Noteer de huidige actieve versie voor het geval u in de toekomst moet terugdraaien.
{% endhint %}

### Host

Om de Netacea VCL in staat te stellen aanroepen te doen naar de Protector API, moeten 2 nieuwe hosts worden geconfigureerd met de gegevens van Netacea, die worden aangeroepen in de [VCL snippets](#vcl-snippets).

* Klik op de link Origins. De pagina Origins verschijnt.
* Klik op de knop "Create a Host". Het veld Host verschijnt.

Vul een nieuwe host in met de volgende URL en klik op "Add":

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

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

Bewerk de nieuwe host door op het potloodpictogram te klikken en wijzig de naam naar:

```
MitSvc
```

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

Voer in het veld Override host dezelfde URL in als de oorspronkelijke host.

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

Herhaal het proces, vul de nieuwe host in met de volgende URL en klik op "Add":

```
assets.ntcacdn.net
```

Bewerk de nieuwe host door op het potloodpictogram te klikken en wijzig de naam naar:

```
CaptchaAssets
```

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

### VCL Snippets

Om Netacea te activeren en bescherming te bieden, moet de oplossing worden toegevoegd aan de Fastly-omgeving in de vorm van een aangepaste VCL.

De Netacea VCL is verdeeld in 7 belangrijke snippets: INIT, DELIVER, RECV, ERROR, RECV\_CONFIGURE, PASS en MISS. Elk snippet moet worden toegevoegd aan de VCL Snippets-configuratie binnen Fastly.

{% hint style="info" %}
Netacea levert de VCL afzonderlijk.
{% endhint %}

**INIT:**

* Navigeer naar VCL snippets binnen Fastly.
* Klik op de knop "Create snippet".
* Geef het snippet een geschikte naam, zoals Netacea\_INIT
* Stel het type in op "init"

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

* Plak de INIT-code in de VCL
* Op regel 4 - 24 vindt u een set velden die uniek zijn voor elke implementatie om te definiëren. Stel integration\_type in op de geschikte modus.

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

**Verplichte velden**

<table data-full-width="true"><thead><tr><th width="338">Veld</th><th>Waarde</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 - Schakelt de Netacea-integratie volledig uit</p><p>INGEST - Passieve modus om Netacea verkeer te laten verzamelen en analyseren</p><p>MITIGATE - Actieve modus die mitigeert op basis van Netacea's Intent Analytics®</p><p>INJECT - Actieve modus voor klanten die Netacea-analytics willen ontvangen bij hun backend en zelf willen beslissen welke acties te ondernemen.</p></td></tr><tr><td>api_key</td><td>Geleverd via <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>secret_key</td><td>Geleverd via <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>encryption_key</td><td>Geleverd via <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>cookie_name</td><td><p>Een geschikte naam voor uw mitigatie-cookie.</p><p><strong>Voor extra beveiliging, vermijd Netacea of Mitigation in deze naam.</strong></p></td></tr><tr><td>captcha_cookie_name</td><td><p>Een geschikte naam voor uw Captcha-tracking-cookie.</p><p><strong>Voor extra beveiliging, vermijd Netacea of Mitigation in deze naam.</strong></p></td></tr><tr><td>ignore_list</td><td>Kommagescheiden lijst van subdirectory's waar mitigatie niet moet worden toegepast. U kunt hier maximaal 5 subdirectory's instellen. Alle resources onder een dergelijke directory worden genegeerd door de integratie.<br>Voeg standaard <code>/media/,/static/</code> toe om volledige integratiedekking te garanderen zonder te triggeren op media-content.</td></tr></tbody></table>

**Optionele velden - Kunnen leeg worden gelaten tenzij anders besproken met het Netacea-team**

om HTML sitebreed te gebruiken. om het /ATAverify-pad te gebruiken. om HTML sitebreed te gebruiken.

<table data-full-width="true"><thead><tr><th width="330">Veld</th><th>Waarde</th></tr></thead><tbody><tr><td>real_ip_header_name</td><td><p>Stelt gebruikers in staat om aan te passen welke header wordt gebruikt voor het IP-adres van het verzoek.</p><p>Laat</p><p>standaard <strong>leeg</strong> om het standaard Fastly-veld <code>client.IP</code> te gebruiken.</p></td></tr><tr><td>use_relative_path_captcha_assets</td><td>Indien ingesteld op <code>true</code>, zorgt dit ervoor dat Captcha wordt geserveerd zonder verwijzingen naar de Netacea CDN. Anders worden volledige URL's naar de Netacea CDN opgenomen in de Captcha HTML.<br>Laat <strong>standaard</strong> leeg</td></tr><tr><td>captcha_path</td><td>Stelt gebruikers in staat een endpoint te creëren dat altijd Captcha HTML serveert. Nuttig bij het implementeren van captcha-uitdagingen voor mobiele apps.<br>Laat <strong>standaard</strong> leeg</td></tr><tr><td>captcha_header</td><td>Aangepaste header die aangeeft of de response een Captcha-pagina is. Moet in het formaat <code>name={{header name}}&#x26;value={{header value}}</code> zijn.</td></tr><tr><td>enable_captcha_content_negotiation</td><td>Beheert het formaat van de Captcha-pagina. Wanneer ingesteld op <code>true</code>, is het mogelijk voor de integratie om de Captcha-pagina in JSON-formaat te retourneren.<br>Laat <strong>standaard</strong> leeg</td></tr></tbody></table>

<figure><img src="https://2008922765-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKEeLcLvicQ5Zj7Chjz6g%2Fuploads%2Fgit-blob-525038b624bb0310dbd4fb6300b7e9aaa97de335%2Fimage%20(75).png?alt=media" alt=""><figcaption><p>Voorbeeld van geldige configuratie</p></figcaption></figure>

Stel onder geavanceerde opties de prioriteit in op 45.

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

**RECV**:

* Klik op de knop "Create snippet"
* Geef het snippet een geschikte naam, zoals Netacea\_RECV
* Stel het type in op "within subroutine" & "recv (vcl\_recv)"
* Plak de RECV-code in de VCL
* Stel de prioriteit in op 45

**DELIVER**

* Klik op de knop "Create snippet"
* Geef het snippet een geschikte naam, zoals Netacea\_DELIVER
* Stel het type in op "within subroutine" & "deliver (vcl\_deliver)"
* Plak de DELIVER-code in de VCL
* Stel de prioriteit in op 45

**ERROR:**

* Klik op de knop "Create snippet"
* Geef het snippet een geschikte naam, zoals Netacea\_ERROR
* Stel het type in op "within subroutine" & "error (vcl\_error)"
* Plak de ERROR-code in de VCL
* Stel de prioriteit in op 45

**RECV\_CONFIGURE:**

* Klik op de knop "Create snippet"
* Geef het snippet een geschikte naam, zoals Netacea\_RECV\_CONFIGURE
* Stel het type in op "within subroutine" & "recv (vcl\_recv)"
* Plak de RECV\_CONFIGURE-code in de VCL
* Stel de prioriteit in op 46

PASS:

* K