# Instalação e Configuração
### Pré-requisitos
Para integrar com sucesso usando Netacea, certifique-se de que você possui:
1. Acesso às chaves de API relevantes e endpoints de envio de logs da Netacea.
### Etapas de Implementação
1. No console do F5, acesse o item de menu System > Resource Provisioning.
2\. Certifique-se de que 'iRules Language Extensions (iRulesLX)' está marcado e possui provisionamento adequado atribuído - 'Nominal' deve ser escolhido.
3\. Em 'Local Traffic > iRules', os itens de menu específicos do LX devem estar presentes.
#### Fazer upload do workspace
1. Acesse iRules > LX Workspaces
2. Clique no botão 'Import'.
3\. Aponte a importação para o workspace fornecido pela Netacea e nomeie o workspace como 'Netacea'.
#### Instalando o módulo f5-nodejs
{% hint style="info" %}
**Nota:** Ao conectar via SSH, você pode acabar no `tmos` em vez do bash. Você pode identificar isso na linha de comando se ela contiver a palavra `tmos`, por exemplo:
`username@(ip-172-31-10-207)(cfg-sync Standalone)(Active)(/Common)(tmos)#`
Para acessar o local do arquivo abaixo, você precisará mudar para bash usando o seguinte comando:
`run /util bash`
{% endhint %}
A biblioteca nodejs para iRules LX NÃO está publicada no NPM ([https://www.npmjs.com](https://www.npmjs.com/)) e reside apenas no sistema F5 BIG-IP. Você pode encontrar mais informações no site do F5 [aqui](https://support.f5.com/csp/article/K16221101), bem como no NPM ().
Devido a esse fato, algumas etapas curtas são necessárias para garantir que o workspace funcione conforme esperado.
* Conecte-se via SSH ao seu nó F5 através de um terminal
* Navegue até o diretório onde seu workspace está localizado, por exemplo: `/var/ilx/workspaces/Common/your_module_name_here/extensions/netacea`
* Uma vez dentro do módulo Netacea, crie um diretório chamado `node_modules`, por exemplo: `mkdir node_modules`
* Navegue até o diretório `node_modules` recém-criado e descompacte os arquivos f5-nodejs executando o comando `tar -xvzf /usr/share/packages/nodejs/f5-nodejs-6.tgz`
Isso instalará o módulo f5-nodejs na pasta `node_module` desejada e pode ser visualizado no console do F5.
#### Adicionando Chaves de API
1. Na visualização LX Workspaces - clique no workspace nomeado, por exemplo: 'Netacea'
2. Localize o arquivo config.json e inclua a apiKey e secretKey para o workspace e clique em 'Save File' abaixo
3. Clique no botão 'Reload from Workspace...' que então atualizará os arquivos dentro do workspace.
4\. Certifique-se de que não há 'workspace files' destacados em laranja posteriormente. Isso indica que eles foram alterados desde o último recarregamento do plugin.
As chaves de API são sempre adicionadas e salvas antes de prosseguir para 'Activate Plugin' - caso contrário, falhará ao iniciar.
#### Adicionando seu NetaceaConfig.json
Existem 5 campos que devem estar localizados no arquivo NetaceaConfig.json. Um exemplo pode ser encontrado abaixo:
{% 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 %}
#### Ativar plugin
1. Na visualização LX workspaces - clique na aba 'LX Plugins' e depois no botão 'Create'
2\. Nomeie o plugin como 'Netacea' e escolha o workspace que acabamos de importar.
#### Habilitando iRules
{% hint style="info" %}
Vale ressaltar que o worker do F5 pode realizar 'INGEST' a partir da iRule mitigate. Habilitar netacea\_mitigate significa que você não precisa ter netacea\_ingest habilitado, pois a iRule mitigate também gerenciará o Ingest. Isso significa que o usuário só precisa atualizar o "mitigationType" localizado no NetaceaConfig.json para alternar entre ingest e mitigate sem alterar a iRule em si.
{% endhint %}
1. Na visualização do servidor virtual relevante, escolha a aba 'Resources' e depois 'manage' para alocação de iRule.
2\. Encontre as duas iRules da Netacea na lista 'Available', mova a iRule relevante para a caixa 'Enabled' e defina a prioridade desejada. Recomendamos a prioridade mais alta onde não haja conflito.
**netacea\_ingest** - isso apenas enviará dados de requisição para a Netacea para análise e não tomará nenhuma ação em requisições ao vivo.
**netacea\_mitigate** - isso enviará dados de requisição para a Netacea e mitigará automaticamente as ameaças identificadas de acordo com sua configuração.
### Links úteis
F5 Datasheet -
Visão geral do iRules LX -
Documentação da API iRules LX -
Guia de Streaming do iRulesLX aqui:
%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)