# Instalação e Configuração ### Pré-requisitos Para integrar com sucesso usando o Netacea, certifique-se de que você tenha: 1. Uma versão do Fastly 1.2.131+ ou superior. 2. Acesso às chaves de API e endpoints de envio de logs relevantes no [portal Netaeca](https://docs.netacea.com/br/informacoes-do-plugin-netacea/accessing-your-integration-settings). 3. [Monitoramento ](https://docs.netacea.com/br/informacoes-do-plugin-netacea/fastly/monitoring-configuration)tenha sido configurado. Os clientes também precisarão abrir um ticket de suporte com a Fastly para habilitar o POST em seu ambiente. Precisamos garantir que existam 2 pragmas habilitados em sua conta Fastly que não estã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 ticket de suporte com o [Suporte Fastly](https://support.fastly.com). ### Etapas de Implementação * Faça login na interface web do Fastly. * Na página inicial, selecione o serviço apropriado. Você pode usar a caixa de pesquisa para buscar por ID, nome ou domínio. * Clique no botão Edit configuration e depois selecione a opção para clonar a versão ativa. A página Domains aparecerá. Todas as alterações de configuração abaixo serão feitas na versão recém-clonada. {% hint style="info" %} Anote a versão atualmente ativa caso precise fazer rollback no futuro. {% endhint %} ### Host Para permitir que o VCL do Netacea faça chamadas à API do Protector, 2 novos hosts devem ser configurados com os detalhes do Netacea, para serem chamados nos [snippets VCL](#vcl-snippets). * Clique no link Origins. A página Origins aparecerá. * Clique no botão "Create a Host". O campo Host aparecerá. Preencha um novo host com a seguinte URL e clique em "Add": ``` mitigations-lbr.netacea.net ```

Edite o novo host clicando no ícone de lápis e altere o nome para: ``` MitSvc ```

No campo Override host, insira a mesma URL do host original.

Repita o processo, preencha o novo host com a seguinte URL e clique em "Add": ``` assets.ntcacdn.net ``` Edite o novo host clicando no ícone de lápis e altere o nome para: ``` CaptchaAssets ```

### Snippets VCL Para que o Netacea seja acionado e ofereça proteção, a solução precisa ser adicionada ao ambiente Fastly na forma de um VCL personalizado. O VCL do Netacea é dividido em 7 snippets principais: INIT, DELIVER, RECV, ERROR, RECV\_CONFIGURE, PASS e MISS. Cada um precisa ser adicionado à configuração de VCL Snippets dentro do Fastly. {% hint style="info" %} O Netacea fornecerá o VCL separadamente. {% endhint %} **INIT:** * Navegue até VCL snippets dentro do Fastly. * Clique no botão "Create snippet". * Dê ao snippet um nome adequado, como Netacea\_INIT * Defina o tipo como "init"

* Cole o código INIT no VCL * Nas linhas 4 - 24, você encontrará campos definidos exclusivos para cada implantação, defina integration\_type para o modo adequado.

**Campos Obrigatórios**

Campo	Valor
integration_type	fastly
integration_version	<Versão da Integração>
integration_mode	BYPASS - Desabilita a integração Netacea completamente INGEST - Modo passivo para permitir que o Netacea colete e analise o tráfego MITIGATE - Modo ativo que realizará mitigação baseada no Intent Analytics® do Netaeca INJECT - Modo ativo para clientes que desejam receber análises do Netacea em seu backend e decidir as ações a tomar.
api_key	Fornecido pelo portal Netaeca
secret_key	Fornecido pelo portal Netaeca
encryption_key	Fornecido pelo portal Netaeca
cookie_name	Um nome adequado para seu cookie de mitigação. Para maior segurança, não inclua Netacea ou Mitigation neste nome.
captcha_cookie_name	Um nome adequado para seu cookie de rastreamento de Captcha. Para maior segurança, não inclua Netacea ou Mitigation neste nome.
ignore_list	Lista separada por vírgulas de subdiretórios onde a mitigação não deve ser aplicada. Você pode configurar até 5 subdiretórios aqui. Todos os recursos sob tal diretório serão ignorados pela integração. Adicione `/media/,/static/` por padrão para garantir cobertura total da integração sem acionar em conteúdo de mídia.

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

Campo	Valor
real_ip_header_name	Permite que os usuários personalizem qual cabeçalho é usado para o IP da requisição. Deixe em branco por padrão para usar o campo padrão do Fastly `client.IP`.
use_relative_path_captcha_assets	Se definido como `true`, garante que o Captcha seja servido sem referências ao CDN do Netacea. Caso contrário, incorporará a URL completa do CDN do Netacea no HTML do Captcha. Deixe em branco por padrão para usar HTML em todo o site.
captcha_path	Permite que os usuários criem um endpoint que sempre serve o HTML do Captcha. Útil ao implementar desafio de captcha para aplicativos móveis. Deixe em branco por padrão para usar o caminho /ATAverify.
captcha_header	Cabeçalho personalizado que indica se a resposta é uma página de Captcha. Deve estar no formato `name={{header name}}&value={{header value}}.`
enable_captcha_content_negotiation	Gerencia o formato da página de Captcha. Quando definido como `true`, é possível que a integração retorne a página de Captcha em formato JSON. Deixe em branco por padrão para usar HTML em todo o site.

Em opções avançadas, defina a prioridade como 45.

**RECV**: * Clique no botão "Create snippet" * Dê ao snippet um nome adequado, como Netacea\_RECV * Defina o tipo como "within subroutine" & "recv (vcl\_recv)" * Cole o código RECV no VCL * Defina a prioridade como 45 **DELIVER** * Clique no botão "Create snippet" * Dê ao snippet um nome adequado, como Netacea\_DELIVER * Defina o tipo como "within subroutine" & "deliver (vcl\_deliver)" * Cole o código DELIVER no VCL * Defina a prioridade como 45 **ERROR:** * Clique no botão "Create snippet" * Dê ao snippet um nome adequado, como Netacea\_ERROR * Defina o tipo como "within subroutine" & "error (vcl\_error)" * Cole o código ERROR no VCL * Defina a prioridade como 45 **RECV\_CONFIGURE:** * Clique no botão "Create snippet" * Dê ao snippet um nome adequado, como Netacea\_RECV\_CONFIGURE * Defina o tipo como "within subroutine" & "recv (vcl\_recv)" * Cole o código RECV\_CONFIGURE no VCL * Defina a prioridade como 46 PASS: * Clique no botão "Create snippet" * Dê ao snippet um nome adequado, como Netacea\_PASS * Defina o tipo como "within subroutine" & "pass (vcl\_pass)" * Cole o código PASS no VCL * Defina a prioridade como 45 MISS: * Clique no botão "Create snippet" *