# Instalação e Configuração

### Pré-requisitos

Para integrar com sucesso usando a Netacea, certifique-se de que você possui:

1. Uma versão do Fastly 1.2.217+ ou superior. Esta é a versão em que o módulo Netacea Edge para integração foi adicionado.
2. Acesso às chaves de API relevantes e aos endpoints de envio de logs no [portal da Netacea](https://docs.netacea.com/br/informacoes-do-plugin-netacea/accessing-your-integration-settings).

Os clientes também precisarão abrir um chamado de suporte com a Magento para solicitar que o Fastly habilite POST em seu ambiente. Precisamos garantir que existam 2 pragmas habilitados em sua conta Fastly que não são habilitados por padrão.

Pragmas Necessários:

```
Pragma optional_param fix_unsent_body_drain true;
Pragma optional_param no_body_if_bereq_is_get_or_head true;
```

Para habilitar os Pragmas, abra um chamado de suporte com o suporte Fastly/Magento. Esses Pragmas não podem ser adicionados manualmente.

### Etapas de Implementação

* Faça login na interface web do Fastly/Magento.
* Verifique se os Pragmas descritos na [seção de pré-requisitos ](#implementation-prerequisites)foram habilitados navegando até Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Tools → List all versions.

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

* Exiba a versão mais recente do VCL e procure os Pragmas no topo do VCL.

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

{% hint style="info" %}
Anote a versão atual caso precise reverter no futuro.
{% endhint %}

### Criar um Dicionário vazio

Navegue até Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Edge Dictionaries e clique em "Add Dictionary".

<figure><img src="https://3103183613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ0VONni9fqVKgqwRyueW%2Fuploads%2Fgit-blob-65e87c3fa2946353f578fdd1c015f377b8050b94%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Crie um dicionário com o nome "netacea\_edge\_config", este pode ser deixado em branco.

{% hint style="info" %}
Este será preenchido apenas ao usar a [Configuração Avançada](https://docs.netacea.com/br/informacoes-do-plugin-netacea/fastly-magento/installation-and-configuration/advanced-configuration) conforme orientação da Netacea
{% endhint %}

### Instalar o Módulo Netacea Edge

Navegue até Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Fastly Edge Modules e clique em "Manage" no Module Manager.

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

* Marque o Edge Module "Netacea Bot Detection integration" e clique em "Save".

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

### Aplicar chaves do cliente ao Módulo

* Navegue até os Módulos Ativos e clique no ícone de engrenagem de Ação em "Netacea Bot Detection integration".

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

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

**Preencha os campos obrigatórios**

<table><thead><tr><th width="157">Campo</th><th>Valor</th></tr></thead><tbody><tr><td>Modo de Integração</td><td><p>BYPASS - Desabilita completamente a integração com a Netacea</p><p>INGEST - Modo passivo que permite à Netacea coletar e analisar o tráfego</p><p>MITIGATE - Modo ativo que realizará mitigação com base no Intent Analytics® da Netacea</p><p>INJECT - Modo ativo para clientes que desejam receber análises da Netacea em seu backend e decidir as ações a serem tomadas.</p></td></tr><tr><td>Chave de API da Netacea</td><td>Fornecida pelo <a href="../accessing-your-integration-settings">portal da Netacea</a></td></tr><tr><td>Secret da Netacea</td><td>Fornecido pelo <a href="../accessing-your-integration-settings">portal da Netacea</a></td></tr><tr><td>Chave de Criptografia</td><td>Fornecida pelo <a href="../accessing-your-integration-settings">portal da Netacea</a></td></tr><tr><td>Nome do cookie da Netacea</td><td><p>Um nome adequado para seu cookie de mitigação.</p><p><strong>Para maior segurança, não inclua Netacea ou Mitigation neste nome.</strong></p></td></tr><tr><td>Nome do cookie de captcha da Netacea</td><td><p>Um nome adequado para seu cookie de rastreamento de Captcha.</p><p><strong>Para maior segurança, não inclua Netacea ou Mitigation neste nome.</strong></p></td></tr><tr><td>Lista de ignorados da Netacea - Caminhos de URL</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Campos Opcionais - Podem ser deixados em branco, a menos que discutido com a equipe da Netacea**

<table><thead><tr><th width="278">Campo</th><th>Valor</th></tr></thead><tbody><tr><td>Nome do Header de IP Real</td><td><p>Permite que os usuários personalizem qual header é usado para o IP da requisição.</p><p>Deixe <strong>em branco</strong> por padrão para usar o campo padrão do Fastly <code>client.IP</code>.</p></td></tr><tr><td>Usar Assets Relativos na Página de Captcha</td><td>Se definido como <code>true</code>, garante que o Captcha seja servido sem referências ao CDN da Netacea. Caso contrário, incorporará a URL completa do CDN da Netacea no HTML do Captcha.<br>Deixe <strong>em branco</strong> por padrão para usar HTML em todo o site.</td></tr><tr><td>Caminho da URL do Captcha</td><td>Permite que os usuários criem um endpoint que sempre sirva o HTML do Captcha. Útil ao implementar desafio de captcha para aplicativos móveis.<br>Deixe <strong>em branco</strong> por padrão para usar o caminho /ATAverify.</td></tr><tr><td>Header Marcador da Página de Captcha</td><td>Header personalizado que indica se a resposta é uma página de Captcha. Deve estar no formato <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>Header Marcador da Página de Captcha</td><td><p>Aplica um header às requisições dos usuários para mostrar que um captcha foi servido.</p><p>Deixe <strong>em branco</strong> por padrão.</p><p>Exemplo de valor <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Habilitar Negociação de Conteúdo do Captcha</td><td>Controla o formato da página de Captcha. Quando definido como <code>true</code>, é possível que a integração retorne a página de Captcha no formato JSON.<br>Deixe <strong>em branco</strong> por padrão para usar HTML em todo o site.</td></tr></tbody></table>

### Finalização

Verifique se você completou as seguintes etapas:

* Instalar o [Netacea ](#install-the-netacea-vcl)[Edge Module](#install-the-netacea-edge-module)
* Configurar o [streaming de logs](https://docs.netacea.com/br/informacoes-do-plugin-netacea/monitoring-configuration#log-streaming-implementation-steps) para o bucket S3 fornecido
* Garantir que nenhum aviso de erro esteja aparecendo

Agora você está pronto para implantar clicando em "Save Config"

{% hint style="info" %}
Às vezes, pode ser necessária uma limpeza de cache. Para fazer isso, vá para System -> Cache Management e clique em "Flush Magento Cache"
{% endhint %}

O gerenciamento de bots agora estará implantado no ambiente Fastly/Magento. Você pode testar se a implantação está ativa:

* Verificando a presença do cookie da Netacea no site
* Visualizando seu painel de relatórios para tráfego e mitigação
* Solicitando que a Netacea revise as métricas internas