# Installazione e configurazione

### Prerequisiti

Per integrare con successo utilizzando Netacea, assicurarsi di disporre di:

1. Fastly versione 1.2.217 o superiore. Questa è la versione in cui viene aggiunto il modulo Netacea Edge per l'integrazione.
2. Accesso alle chiavi API pertinenti e agli endpoint di log shipping nel [portale Netacea](https://docs.netacea.com/it/informazioni-sul-plugin-netacea/accessing-your-integration-settings).

I clienti dovranno inoltre aprire un ticket di supporto con Magento per richiedere a Fastly di abilitare POST nel loro ambiente. È necessario assicurarsi che siano abilitati 2 pragma sul vostro account Fastly che non sono abilitati per impostazione predefinita.

Pragma richiesti:

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

Per abilitare i Pragma, aprire un ticket di supporto con il supporto Fastly/Magento. Questi Pragma non possono essere aggiunti manualmente.

### Passaggi di Implementazione

* Accedere all'interfaccia web Fastly/Magento.
* Verificare che i Pragma descritti nella [sezione dei prerequisiti](#implementation-prerequisites) siano stati abilitati navigando su Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Tools → List all versions.

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

* Visualizzare l'ultima versione VCL e cercare i Pragma nella parte superiore del VCL.

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

{% hint style="info" %}
Prendere nota della versione corrente nel caso sia necessario effettuare un rollback in futuro.
{% endhint %}

### Creare un Dictionary vuoto

Navigare su Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Edge Dictionaries e fare clic su "Add Dictionary".

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

Creare un dictionary con il nome "netacea\_edge\_config", che può essere lasciato vuoto.

{% hint style="info" %}
Verrà popolato solo quando si utilizza la [Configurazione Avanzata](https://docs.netacea.com/it/informazioni-sul-plugin-netacea/fastly-magento/installation-and-configuration/advanced-configuration) su indicazione di Netacea
{% endhint %}

### Installare il Modulo Netacea Edge

Navigare su Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Fastly Edge Modules e fare clic su "Manage" nel Module Manager.

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

* Selezionare il modulo Edge "Netacea Bot Detection integration" e fare clic su "Save".

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

### Applicare le chiavi cliente al Modulo

* Navigare su Active Modules e fare clic sull'icona a ingranaggio Action di "Netacea Bot Detection integration".

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

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

**Inserire i campi obbligatori**

<table><thead><tr><th width="157">Campo</th><th>Valore</th></tr></thead><tbody><tr><td>Modalità di Integrazione</td><td><p>BYPASS - Disabilita completamente l'integrazione Netacea</p><p>INGEST - Modalità passiva per consentire a Netacea di raccogliere e analizzare il traffico</p><p>MITIGATE - Modalità attiva che effettuerà la mitigazione basandosi su Intent Analytics® di Netacea</p><p>INJECT - Modalità attiva per i clienti che desiderano ricevere le analytics di Netacea nel loro backend e decidere le azioni da intraprendere.</p></td></tr><tr><td>Netacea API Key</td><td>Fornita dal <a href="../accessing-your-integration-settings">portale Netacea</a></td></tr><tr><td>Netacea Secret</td><td>Fornito dal <a href="../accessing-your-integration-settings">portale Netacea</a></td></tr><tr><td>Encryption Key</td><td>Fornita dal <a href="../accessing-your-integration-settings">portale Netacea</a></td></tr><tr><td>Nome cookie Netacea</td><td><p>Un nome appropriato per il cookie di mitigazione.</p><p><strong>Per maggiore sicurezza, non includere Netacea o Mitigation in questo nome.</strong></p></td></tr><tr><td>Nome cookie captcha Netacea</td><td><p>Un nome appropriato per il cookie di tracciamento Captcha.</p><p><strong>Per maggiore sicurezza, non includere Netacea o Mitigation in questo nome.</strong></p></td></tr><tr><td>Lista di esclusione Netacea - Percorsi URL</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Campi opzionali - Possono essere lasciati vuoti salvo diversa indicazione del team Netacea**

<table><thead><tr><th width="278">Campo</th><th>Valore</th></tr></thead><tbody><tr><td>Nome Header IP Reale</td><td><p>Consente agli utenti di personalizzare quale header viene utilizzato per l'IP della richiesta.</p><p>Lasciare <strong>vuoto per</strong> impostazione predefinita per utilizzare il campo Fastly standard <code>client.IP</code>.</p></td></tr><tr><td>Utilizza Asset Pagina Captcha Relativi</td><td>Se impostato su <code>true</code>, assicura che il Captcha venga servito senza riferimenti al CDN Netacea. Altrimenti incorporerà l'URL completo al CDN Netacea nell'HTML del Captcha.<br>Lasciare <strong>vuoto per</strong> impostazione predefinita per utilizzare l'HTML su tutto il sito.</td></tr><tr><td>Percorso URL Captcha</td><td>Consente agli utenti di creare un endpoint che serve sempre l'HTML del Captcha. Utile quando si implementa la challenge captcha per applicazioni mobile.<br>Lasciare <strong>vuoto per</strong> impostazione predefinita per utilizzare il percorso /ATAverify.</td></tr><tr><td>Header Marcatore Pagina Captcha</td><td>Header personalizzato che indica se la risposta è una pagina Captcha. Deve essere nel formato <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>Header Marcatore Pagina Captcha</td><td><p>Applica un header alle richieste degli utenti per indicare che è stato servito un captcha.</p><p>Lasciare <strong>vuoto per</strong> impostazione predefinita.</p><p>Valore di esempio <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Abilita Negoziazione Contenuto Captcha</td><td>Gestisce il formato della pagina Captcha. Quando impostato su <code>true</code>, l'integrazione può restituire la pagina Captcha in formato JSON.<br>Lasciare <strong>vuoto per</strong> impostazione predefinita per utilizzare l'HTML su tutto il sito.</td></tr></tbody></table>

### Completamento

Verificare di aver completato i seguenti passaggi:

* Installare il [Netacea ](#install-the-netacea-vcl)[Edge Module](#install-the-netacea-edge-module)
* Configurare il [log streaming](https://docs.netacea.com/it/informazioni-sul-plugin-netacea/monitoring-configuration#log-streaming-implementation-steps) verso il bucket S3 fornito
* Assicurarsi che non compaiano avvisi di errore

Ora è possibile procedere al deployment facendo clic su "Save Config"

{% hint style="info" %}
A volte può essere necessario svuotare la cache. Per farlo, andare su System -> Cache Management e fare clic su "Flush Magento Cache"
{% endhint %}

Il bot management sarà ora distribuito nell'ambiente Fastly/Magento. È possibile verificare che il deployment sia attivo:

* Controllando la presenza del cookie Netacea sul sito web
* Visualizzando la dashboard di reporting per il traffico e la mitigazione
* Richiedendo a Netacea di verificare le metriche interne