# Installation et configuration

### Prérequis

Pour réussir l'intégration avec Netacea, veuillez vous assurer que vous disposez de :

1. L'accès aux clés API pertinentes et aux points de terminaison d'envoi de logs fournis par Netacea.

### Étapes d'implémentation

1. Dans la console F5, accédez à l'élément de menu System > Resource Provisioning.

<figure><img src="/files/mRwuSBMZirhaxwi71vec" alt=""><figcaption></figcaption></figure>

2\. Assurez-vous que 'iRules Language Extensions (iRulesLX)' est coché et qu'un provisionnement adéquat est attribué - 'Nominal' doit être sélectionné.

3\. Sous 'Local Traffic > iRules', les éléments de menu spécifiques à LX doivent être présents.

<figure><img src="/files/lw2KcPhwodgZMy6S5cGJ" alt=""><figcaption></figcaption></figure>

#### Télécharger le workspace <a href="#upload-workspace" id="upload-workspace"></a>

1. Accédez à iRules > LX Workspaces
2. Cliquez sur le bouton 'Import'.

<figure><img src="/files/fp2NCo0z0bpY22lkkmBA" alt=""><figcaption></figcaption></figure>

3\. Dirigez l'importation vers le workspace fourni par Netacea, et nommez le workspace 'Netacea'.

<figure><img src="/files/MgRmnVFhlvwUh0q7PKmU" alt=""><figcaption></figcaption></figure>

#### Installation du module f5-nodejs <a href="#installing-f5-nodejs-module" id="installing-f5-nodejs-module"></a>

{% hint style="info" %}
**Remarque :** Lors de la connexion via SSH, vous pourriez vous retrouver dans `tmos` plutôt que dans bash. Vous pouvez le voir sur la ligne de commande si elle contient le mot `tmos` par ex.

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

Pour accéder à l'emplacement de fichier ci-dessous, vous devrez basculer vers bash en utilisant la commande suivante :

`run /util bash`
{% endhint %}

La bibliothèque nodejs pour iRules LX n'est PAS publiée sur NPM ([https://www.npmjs.com](https://www.npmjs.com/)) et réside uniquement sur le système F5 BIG-IP. Vous pouvez trouver plus d'informations sur le site web F5 [ici](https://support.f5.com/csp/article/K16221101), ainsi que sur NPM (<https://www.npmjs.com/package/f5-nodejs>).

En raison de ce fait, quelques étapes courtes sont nécessaires pour s'assurer que le workspace fonctionne comme prévu.

* Connectez-vous en SSH à votre nœud F5 via un terminal
* Accédez au répertoire où réside votre workspace. par ex. `/var/ilx/workspaces/Common/your_module_name_here/extensions/netacea`
* Une fois que vous êtes dans le module Netacea, créez un répertoire nommé `node_modules` par ex. `mkdir node_modules`
* Accédez à votre répertoire `node_modules` nouvellement créé et décompressez les fichiers f5-nodejs en exécutant la commande `tar -xvzf /usr/share/packages/nodejs/f5-nodejs-6.tgz`

Cela installera le module f5-nodejs dans le dossier `node_module` souhaité et peut être visualisé dans la console F5.

#### Ajout des clés API <a href="#adding-api-keys" id="adding-api-keys"></a>

1. Depuis la vue LX Workspaces - cliquez sur le workspace nommé. par ex. 'Netacea'
2. Localisez le fichier config.json et incluez l'apiKey et la secretKey pour le workspace et cliquez sur 'Save File' ci-dessous
3. Cliquez sur le bouton 'Reload from Workspace...' qui mettra alors à jour les fichiers au sein du workspace.

<figure><img src="/files/2Fu4aQB5mHPhSe42To1a" alt=""><figcaption></figcaption></figure>

4\. Assurez-vous qu'il n'y a pas de 'workspace files' surlignés en orange par la suite. Cela signifie qu'ils ont changé depuis le dernier rechargement du plugin.

Les clés API sont toujours ajoutées et enregistrées avant de passer à 'Activate Plugin' - sinon, le démarrage échouera.

#### Ajout de votre NetaceaConfig.json <a href="#adding-your-netaceaconfig.json" id="adding-your-netaceaconfig.json"></a>

Il y a 5 champs qui doivent être présents dans le fichier NetaceaConfig.json. Un exemple peut être trouvé ci-dessous :

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

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

1. Depuis la vue LX workspaces - cliquez sur l'onglet 'LX Plugins', puis sur le bouton 'Create'

<figure><img src="/files/mRSk6Y2iki9J3NWkHhtA" alt=""><figcaption></figcaption></figure>

2\. Nommez le plugin 'Netacea' et choisissez le workspace que nous venons d'importer.

<figure><img src="/files/E00QEx6WRlyrzpf0niE9" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
Il convient de noter que le worker F5 peut effectuer l'« INGEST » depuis l'iRule mitigate. Activer netacea\_mitigate signifie que vous n'avez pas besoin d'avoir netacea\_ingest activé, car l'iRule mitigate gérera également l'Ingest. Cela signifie qu'un utilisateur n'a alors qu'à mettre à jour le "mitigationType" situé dans NetaceaConfig.json pour basculer entre ingest et mitigate sans modifier l'iRule elle-même.
{% endhint %}

1. Depuis la vue du serveur virtuel concerné, choisissez l'onglet 'Resources' puis 'manage' pour l'allocation des iRules.

<figure><img src="/files/RZ3xY92GR8mo1HSr38eV" alt=""><figcaption></figcaption></figure>

2\. Trouvez les deux iRules Netacea dans la liste 'Available', déplacez l'iRule concernée vers la case 'Enabled', et définissez la priorité souhaitée. Nous recommandons la priorité la plus élevée là où aucun conflit ne se produira.

<figure><img src="/files/BpvUpva8FIU17QDzyuMu" alt=""><figcaption></figcaption></figure>

**netacea\_ingest** - cela enverra uniquement les données de requête à Netacea pour analyse et n'effectuera aucune action sur les requêtes en direct.

**netacea\_mitigate** - cela enverra les données de requête à Netacea et atténuera automatiquement les menaces identifiées selon votre configuration.

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

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

Présentation d'iRules LX - <https://clouddocs.f5.com/api/irules-lx/>

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

Guide de streaming iRulesLX ici : <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/fr/informations-sur-les-plugins-netacea/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.