# Installatie en Configuratie

### Vereisten

Voor een succesvolle integratie met Netacea dient u te beschikken over:

1. Toegang tot de relevante API-sleutels en log shipping-endpoints van Netacea.

### Implementatiestappen

1. Ga in de F5-console naar het menu-item System > Resource Provisioning.

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

2\. Zorg ervoor dat 'iRules Language Extensions (iRulesLX)' is aangevinkt en dat er voldoende provisioning is toegewezen - 'Nominal' dient te worden gekozen.

3\. Onder 'Local Traffic > iRules' dienen de LX-specifieke menu-items aanwezig te zijn.

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

#### Workspace uploaden <a href="#upload-workspace" id="upload-workspace"></a>

1. Ga naar iRules > LX Workspaces
2. Klik op de knop 'Import'.

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

3\. Verwijs de import naar de workspace die door Netacea is aangeleverd en noem de workspace 'Netacea'.

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

#### Installeren van f5-nodejs module <a href="#installing-f5-nodejs-module" id="installing-f5-nodejs-module"></a>

{% hint style="info" %}
**Let op:** Wanneer u verbinding maakt via SSH, kan het zijn dat u in `tmos` terechtkomt in plaats van bash. U kunt dit zien aan de opdrachtregel als deze het woord `tmos` bevat, bijv.

`username@(ip-172-31-10-207)(cfg-sync Standalone)(Active)(/Common)(tmos)#`

Om toegang te krijgen tot de onderstaande bestandslocatie dient u over te schakelen naar bash met de volgende opdracht:

`run /util bash`
{% endhint %}

De nodejs-bibliotheek voor iRules LX is NIET gepubliceerd op NPM ([https://www.npmjs.com](https://www.npmjs.com/)) en bevindt zich uitsluitend op het F5 BIG-IP-systeem. Meer informatie vindt u op de F5-website [hier](https://support.f5.com/csp/article/K16221101), evenals op NPM (<https://www.npmjs.com/package/f5-nodejs>).

Vanwege dit feit zijn enkele korte stappen vereist om ervoor te zorgen dat de workspace naar verwachting functioneert.

* Maak via een terminal een SSH-verbinding met uw F5-node
* Ga naar de directory waar uw workspace zich bevindt, bijv. `/var/ilx/workspaces/Common/your_module_name_here/extensions/netacea`
* Zodra u zich in de Netacea-module bevindt, maakt u een directory aan met de naam `node_modules` bijv. `mkdir node_modules`
* Ga naar uw nieuw aangemaakte `node_modules`-directory en pak de f5-nodejs-bestanden uit door de opdracht `tar -xvzf /usr/share/packages/nodejs/f5-nodejs-6.tgz` uit te voeren

Dit installeert de f5-nodejs-module in de gewenste `node_module`-map en kan worden bekeken in de F5-console.

#### API-sleutels toevoegen <a href="#adding-api-keys" id="adding-api-keys"></a>

1. Klik vanuit de LX Workspaces-weergave op de benoemde workspace, bijv. 'Netacea'
2. Zoek het config.json-bestand en voeg de apiKey en secretKey voor de workspace toe en klik onderaan op 'Save File'
3. Klik op de knop 'Reload from Workspace...' waarmee de bestanden binnen de workspace worden bijgewerkt.

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

4\. Zorg ervoor dat er daarna geen oranje gemarkeerde 'workspace files' zijn. Dit geeft aan dat deze zijn gewijzigd sinds de laatste herlaadactie van de plugin.

API-sleutels worden altijd toegevoegd en opgeslagen voordat u verdergaat met 'Activate Plugin' - anders zal het opstarten mislukken.

#### Uw NetaceaConfig.json toevoegen <a href="#adding-your-netaceaconfig.json" id="adding-your-netaceaconfig.json"></a>

Er zijn 5 velden die aanwezig dienen te zijn in het NetaceaConfig.json-bestand. Hieronder vindt u een voorbeeld:

{% code overflow="wrap" %}

```
{ 
"apiKey": "API_KEY", 
"secretKey": "SECRET_KEY",
"mitigationType": "MITIGATION_TYPE", // Either "INGEST" or "MITIGATE"
"ingestType": "KINESIS",
"mitigationServiceUrl": "MITIGATE SERVICE URL",
  "kinesis": {
  "kinesisStreamName": "KINESIS_STREAM_NAME",
    "kinesisAccessKey": "KINESIS_ACCESS_KEY",
    "kinesisSecretKey": "KINESIS_SECRET_KEY",
    "logBatchSize": 100,
    "maxLogAgeSeconds": 3
  }
}
```

{% endcode %}

#### Plugin activeren <a href="#activate-plugin" id="activate-plugin"></a>

1. Klik vanuit de LX workspaces-weergave op het tabblad 'LX Plugins' en vervolgens op de knop 'Create'

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

2\. Noem de plugin 'Netacea' en kies de workspace die we zojuist hebben geïmporteerd.

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

#### iRules inschakelen <a href="#enabling-irules" id="enabling-irules"></a>

{% hint style="info" %}
Het is vermeldenswaard dat de F5-worker kan 'INGESTEN' vanuit de mitigate iRule. Het inschakelen van netacea\_mitigate betekent dat u netacea\_ingest niet ingeschakeld hoeft te hebben, aangezien de mitigate iRule ook Ingest afhandelt. Dit betekent dat een gebruiker alleen het "mitigationType" in NetaceaConfig.json hoeft bij te werken om te schakelen tussen ingest en mitigate zonder de iRule zelf te wijzigen.
{% endhint %}

1. Kies vanuit de relevante virtual server-weergave het tabblad 'Resources' en vervolgens 'manage' voor iRule-toewijzing.

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

2\. Zoek de twee Netacea iRules in de lijst 'Available', verplaats de relevante iRule naar het vak 'Enabled' en stel de gewenste prioriteit in. Wij adviseren de hoogste prioriteit waar geen conflict zal optreden.

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

**netacea\_ingest** - dit stuurt alleen requestgegevens naar Netacea voor analyse en onderneemt geen actie op live requests.

**netacea\_mitigate** - dit stuurt requestgegevens naar Netacea en mitigeert automatisch geïdentificeerde bedreigingen volgens uw configuratie.

### Nuttige links <a href="#useful-links" id="useful-links"></a>

F5 Datasheet - <https://www.f5.com/pdf/products/big-ip-local-traffic-manager-ds.pdf>

iRules LX overzicht - <https://clouddocs.f5.com/api/irules-lx/>

iRules LX API-documentatie - <https://clouddocs.f5.com/api/irules-lx/APIReference.html>

iRulesLX Streaming-handleiding hier: <https://readthedocs.org/projects/f5-agility-labs-irules/downloads/pdf/latest/>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.netacea.com/nl/netacea-plugin-informatie/f5/installation-and-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
