# Installazione e configurazione
### Prerequisiti
Per integrare correttamente utilizzando Netacea, assicurati di disporre di:
1. Accesso alle chiavi API pertinenti e agli endpoint di log shipping forniti da Netacea.
### Passaggi di implementazione
1. Nella console F5, accedi alla voce di menu System > Resource Provisioning.
2\. Assicurati che 'iRules Language Extensions (iRulesLX)' sia selezionato e abbia un provisioning adeguato assegnato - dovrebbe essere scelto 'Nominal'.
3\. In 'Local Traffic > iRules' dovrebbero essere presenti le voci di menu specifiche per LX.
#### Caricamento del workspace
1. Vai a iRules > LX Workspaces
2. Clicca sul pulsante 'Import'.
3\. Indirizza l'importazione verso il workspace fornito da Netacea e assegna al workspace il nome 'Netacea'.
#### Installazione del modulo f5-nodejs
{% hint style="info" %}
**Nota:** Quando ci si connette tramite SSH potresti trovarti in `tmos` anziché in bash. Puoi verificarlo dalla riga di comando se contiene la parola `tmos` ad es.
`username@(ip-172-31-10-207)(cfg-sync Standalone)(Active)(/Common)(tmos)#`
Per accedere alla posizione del file indicata di seguito dovrai passare a bash utilizzando il seguente comando:
`run /util bash`
{% endhint %}
La libreria nodejs per iRules LX NON è pubblicata su NPM ([https://www.npmjs.com](https://www.npmjs.com/)) e risiede esclusivamente sul sistema F5 BIG-IP. Puoi trovare ulteriori informazioni sul sito web di F5 [qui](https://support.f5.com/csp/article/K16221101), così come su NPM ().
Per questo motivo, sono necessari alcuni brevi passaggi per garantire che il workspace funzioni come previsto.
* Collegati tramite SSH al tuo nodo F5 via terminale
* Spostati nella directory in cui risiede il tuo workspace. ad es. `/var/ilx/workspaces/Common/your_module_name_here/extensions/netacea`
* Una volta all'interno del modulo Netacea, crea una directory denominata `node_modules` ad es. `mkdir node_modules`
* Spostati nella directory `node_modules` appena creata e decomprimi i file f5-nodejs eseguendo il comando `tar -xvzf /usr/share/packages/nodejs/f5-nodejs-6.tgz`
Questo installerà il modulo f5-nodejs nella cartella `node_module` desiderata e potrà essere visualizzato nella console F5.
#### Aggiunta delle chiavi API
1. Dalla vista LX Workspaces - clicca sul workspace denominato. ad es. 'Netacea'
2. Individua il file config.json e inserisci apiKey e secretKey per il workspace, quindi clicca su 'Save File' in basso
3. Clicca sul pulsante 'Reload from Workspace...' che aggiornerà i file all'interno del workspace.
4\. Assicurati che non ci siano 'workspace files' evidenziati in arancione successivamente. Questo indica che sono stati modificati dall'ultimo ricaricamento del plugin.
Le chiavi API vengono sempre aggiunte e salvate prima di procedere con 'Activate Plugin' - altrimenti l'avvio fallirà.
#### Aggiunta del NetaceaConfig.json
Ci sono 5 campi che dovrebbero essere presenti nel file NetaceaConfig.json. Di seguito è riportato un esempio:
{% 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 %}
#### Attivazione del plugin
1. Dalla vista LX workspaces - clicca sulla scheda 'LX Plugins', quindi sul pulsante 'Create'
2\. Assegna al plugin il nome 'Netacea' e scegli il workspace appena importato.
#### Abilitazione delle iRules
{% hint style="info" %}
È importante notare che il worker F5 può eseguire 'INGEST' dalla iRule mitigate. Abilitare netacea\_mitigate significa che non è necessario avere netacea\_ingest abilitato, poiché la iRule mitigate gestirà anche Ingest. Ciò significa che un utente deve solo aggiornare il "mitigationType" presente in NetaceaConfig.json per passare da ingest a mitigate senza modificare la iRule stessa.
{% endhint %}
1. Dalla vista del virtual server pertinente, scegli la scheda 'Resources' e quindi 'manage' per l'allocazione delle iRule.
2\. Trova le due iRules Netacea nell'elenco 'Available', sposta la iRule pertinente nella casella 'Enabled' e imposta la priorità desiderata. Raccomandiamo la priorità più alta laddove non si verifichino conflitti.
**netacea\_ingest** - invierà semplicemente i dati delle richieste a Netacea per l'analisi e non intraprenderà alcuna azione sulle richieste in tempo reale.
**netacea\_mitigate** - invierà i dati delle richieste a Netacea e mitigherà automaticamente le minacce identificate in base alla tua configurazione.
### Link utili
F5 Datasheet -
Panoramica iRules LX -
Documentazione API iRules LX -
Guida allo streaming iRulesLX qui:
%20(1)%20(2).png?alt=media)
%20(2)%20(1)%20(1).png?alt=media)
%20(3)%20(1).png?alt=media)
%20(1).png?alt=media)
%20(2).png?alt=media)
%20(3).png?alt=media)
%20(3)%20(1).png?alt=media)
%20(1)%20(3).png?alt=media)
.png?alt=media)