# Installasjon og konfigurasjon

### Forutsetninger

For å lykkes med integrasjonen ved bruk av Netacea, vennligst sørg for at du har:

1. Tilgang til de relevante API-nøklene og endepunktene for loggleveranse fra Netacea.

### Implementeringstrinn

1. I F5-konsollen, gå til menypunktet System > Resource Provisioning.

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

2\. Sørg for at 'iRules Language Extensions (iRulesLX)' er avkrysset og har tilstrekkelig tildelt kapasitet - 'Nominal' bør velges.

3\. Under 'Local Traffic > iRules' skal de LX-spesifikke menypunktene være tilgjengelige.

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

#### Last opp arbeidsområde <a href="#upload-workspace" id="upload-workspace"></a>

1. Gå til iRules > LX Workspaces
2. Klikk på 'Import'-knappen.

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

3\. Pek importen til arbeidsområdet som er levert av Netacea, og kall arbeidsområdet 'Netacea'.

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

#### Installere f5-nodejs-modulen <a href="#installing-f5-nodejs-module" id="installing-f5-nodejs-module"></a>

{% hint style="info" %}
**Merk:** Når du kobler til via SSH kan du ende opp i `tmos` i stedet for bash. Du kan se dette på kommandolinjen hvis den inneholder ordet `tmos` f.eks.

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

For å få tilgang til filplasseringen nedenfor må du bytte til bash ved å bruke følgende kommando:

`run /util bash`
{% endhint %}

Nodejs-biblioteket for iRules LX er IKKE publisert til NPM ([https://www.npmjs.com](https://www.npmjs.com/)) og finnes kun på F5 BIG-IP-systemet. Du kan finne mer informasjon på F5-nettstedet [her](https://support.f5.com/csp/article/K16221101), samt på NPM (<https://www.npmjs.com/package/f5-nodejs>).

På grunn av dette kreves det noen korte trinn for å sikre at arbeidsområdet fungerer som forventet.

* Koble til F5-noden din via SSH gjennom en terminal
* Bytt til katalogen der arbeidsområdet ditt ligger, f.eks. `/var/ilx/workspaces/Common/your_module_name_here/extensions/netacea`
* Når du er inne i Netacea-modulen, opprett en katalog kalt `node_modules` f.eks. `mkdir node_modules`
* Bytt til den nyopprettede `node_modules`-katalogen og pakk ut f5-nodejs-filene ved å kjøre kommandoen `tar -xvzf /usr/share/packages/nodejs/f5-nodejs-6.tgz`

Dette vil installere f5-nodejs-modulen i ønsket `node_module`-mappe og kan vises i F5-konsollen.

#### Legge til API-nøkler <a href="#adding-api-keys" id="adding-api-keys"></a>

1. Fra LX Workspaces-visningen - klikk på det navngitte arbeidsområdet, f.eks. 'Netacea'
2. Finn config.json-filen og inkluder apiKey og secretKey for arbeidsområdet og klikk 'Save File' nedenfor
3. Klikk på 'Reload from Workspace...'-knappen som deretter vil oppdatere filene i arbeidsområdet.

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

4\. Sørg for at det ikke er noen oransjmarkerte 'workspace files' etterpå. Dette indikerer at de har blitt endret siden siste innlasting av plugin-en.

API-nøkler legges alltid til og lagres før du går videre til 'Activate Plugin' - ellers vil den ikke starte.

#### Legge til din NetaceaConfig.json <a href="#adding-your-netaceaconfig.json" id="adding-your-netaceaconfig.json"></a>

Det er 5 felt som skal være i NetaceaConfig.json-filen. Et eksempel finnes nedenfor:

{% 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 %}

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

1. Fra LX workspaces-visningen - klikk på 'LX Plugins'-fanen, og deretter 'Create'-knappen

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

2\. Kall plugin-en 'Netacea' og velg arbeidsområdet vi nettopp importerte.

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

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

{% hint style="info" %}
Det er verdt å merke seg at F5-arbeideren kan 'INGEST' fra mitigate iRule. Aktivering av netacea\_mitigate betyr at du ikke trenger å ha netacea\_ingest aktivert, ettersom mitigate iRule også håndterer Ingest. Dette betyr at en bruker kun trenger å oppdatere "mitigationType" i NetaceaConfig.json for å bytte mellom ingest og mitigate uten å endre selve iRule.
{% endhint %}

1. Fra den relevante virtuell server-visningen, velg 'Resources'-fanen og deretter 'manage' for iRule-tildeling.

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

2\. Finn de to Netacea iRules i 'Available'-listen, flytt den relevante iRule til 'Enabled'-boksen, og sett ønsket prioritet. Vi anbefaler høyeste prioritet der konflikt ikke vil oppstå.

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

**netacea\_ingest** - dette vil kun sende forespørselsdata til Netacea for analyse og vil ikke utføre noen handling på aktive forespørsler.

**netacea\_mitigate** - dette vil sende forespørselsdata til Netacea og automatisk mitigere identifiserte trusler i henhold til din konfigurasjon.

### Nyttige lenker <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-oversikt - <https://clouddocs.f5.com/api/irules-lx/>

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

iRulesLX Streaming-guide her: <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/no/netacea-plugininformasjon/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.
