# Installation und Konfiguration

### Voraussetzungen

Für eine erfolgreiche Integration mit Netacea stellen Sie bitte sicher, dass Sie über Folgendes verfügen:

1. Eine Fastly-Version 1.2.217 oder höher. Dies ist die Version, in der das Netacea Edge-Modul für die Integration hinzugefügt wurde.
2. Zugriff auf die relevanten API-Schlüssel und Log-Shipping-Endpunkte im [Netacea portal](https://docs.netacea.com/de/netacea-plugin-informationen/accessing-your-integration-settings).

Kunden müssen außerdem ein Support-Ticket bei Magento eröffnen, um Fastly zur Aktivierung von POST in ihrer Umgebung aufzufordern. Wir müssen sicherstellen, dass 2 Pragmas in Ihrem Fastly-Konto aktiviert sind, die standardmäßig nicht aktiviert sind.

Erforderliche Pragmas:

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

Um die Pragmas zu aktivieren, eröffnen Sie ein Support-Ticket beim Fastly/Magento-Support. Diese Pragmas können nicht manuell hinzugefügt werden.

### Implementierungsschritte

* Melden Sie sich bei der Fastly/Magento-Weboberfläche an.
* Überprüfen Sie, ob die im Abschnitt [Voraussetzungen ](#implementation-prerequisites)beschriebenen Pragmas aktiviert wurden, indem Sie zu Stores → Konfiguration → Erweitert → System → Vollständiger Seiten-Cache → Fastly-Konfiguration → Tools → Alle Versionen auflisten navigieren.

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

* Zeigen Sie die neueste VCL-Version an und suchen Sie die Pragmas am Anfang der VCL.

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

{% hint style="info" %}
Notieren Sie sich die aktuelle Version, falls Sie in Zukunft ein Rollback durchführen müssen.
{% endhint %}

### Erstellen eines leeren Dictionary

Navigieren Sie zu Stores → Konfiguration → Erweitert → System → Vollständiger Seiten-Cache → Fastly-Konfiguration → Edge Dictionaries und klicken Sie auf „Dictionary hinzufügen".

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

Erstellen Sie ein Dictionary mit dem Namen „netacea\_edge\_config", dieses kann leer gelassen werden.

{% hint style="info" %}
Dieses wird nur bei Verwendung der [Erweiterten Konfiguration](https://docs.netacea.com/de/netacea-plugin-informationen/fastly-magento/installation-and-configuration/advanced-configuration) auf Empfehlung von Netacea befüllt
{% endhint %}

### Installieren des Netacea Edge-Moduls

Navigieren Sie zu Stores → Konfiguration → Erweitert → System → Vollständiger Seiten-Cache → Fastly-Konfiguration → Fastly Edge-Module und klicken Sie im Modul-Manager auf „Verwalten".

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

* Aktivieren Sie das Edge-Modul „Netacea Bot Detection integration" und klicken Sie auf „Speichern".

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

### Anwenden der Kundenschlüssel auf das Modul

* Navigieren Sie zu den aktiven Modulen und klicken Sie auf das Aktionszahnrad „Netacea Bot Detection integration".

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

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

**Geben Sie die erforderlichen Felder ein**

<table><thead><tr><th width="157">Feld</th><th>Wert</th></tr></thead><tbody><tr><td>Integrationsmodus</td><td><p>BYPASS - Deaktiviert die Netacea-Integration vollständig</p><p>INGEST - Passiver Modus, der Netacea die Erfassung und Analyse des Datenverkehrs ermöglicht</p><p>MITIGATE - Aktiver Modus, der basierend auf Netacea's Intent Analytics® Maßnahmen ergreift</p><p>INJECT - Aktiver Modus für Kunden, die Netacea-Analysen an ihrem Backend empfangen und selbst über Maßnahmen entscheiden möchten.</p></td></tr><tr><td>Netacea API-Schlüssel</td><td>Bereitgestellt über das <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>Netacea Secret</td><td>Bereitgestellt über das <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>Verschlüsselungsschlüssel</td><td>Bereitgestellt über das <a href="../accessing-your-integration-settings">Netacea portal</a></td></tr><tr><td>Netacea-Cookie-Name</td><td><p>Ein geeigneter Name für Ihr Mitigation-Cookie.</p><p><strong>Aus Sicherheitsgründen sollten Sie Netacea oder Mitigation nicht in diesem Namen verwenden.</strong></p></td></tr><tr><td>Netacea-Captcha-Cookie-Name</td><td><p>Ein geeigneter Name für Ihr Captcha-Tracking-Cookie.</p><p><strong>Aus Sicherheitsgründen sollten Sie Netacea oder Mitigation nicht in diesem Namen verwenden.</strong></p></td></tr><tr><td>Netacea-Ignorierliste - URL-Pfade</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Optionale Felder - Können leer gelassen werden, sofern nicht mit dem Netacea-Team besprochen**

<table><thead><tr><th width="278">Feld</th><th>Wert</th></tr></thead><tbody><tr><td>Echte IP-Header-Bezeichnung</td><td><p>Ermöglicht Benutzern die Anpassung, welcher Header für die IP der Anfrage verwendet wird.</p><p>Standardmäßig <strong>leer lassen</strong>, um das Fastly-Standardfeld <code>client.IP</code> zu verwenden.</p></td></tr><tr><td>Relative Captcha-Seiten-Assets verwenden</td><td>Wenn auf <code>true</code> gesetzt, wird sichergestellt, dass Captcha ohne Verweise auf das Netacea-CDN bereitgestellt wird. Andernfalls wird die vollständige URL zum Netacea-CDN im Captcha-HTML eingebettet.<br>Standardmäßig <strong>leer lassen</strong>, um HTML seitenweit zu verwenden.</td></tr><tr><td>Captcha-URL-Pfad</td><td>Ermöglicht Benutzern die Erstellung eines Endpunkts, der immer Captcha-HTML bereitstellt. Nützlich bei der Implementierung von Captcha-Challenges für mobile Apps.<br>Standardmäßig <strong>leer lassen</strong>, um den /ATAverify-Pfad zu verwenden.</td></tr><tr><td>Captcha-Seiten-Marker-Header</td><td>Benutzerdefinierter Header, der anzeigt, ob die Antwort eine Captcha-Seite ist. Muss im Format <code>name={{header name}}&#x26;value={{header value}}</code> vorliegen.</td></tr><tr><td>Captcha-Seiten-Marker-Header</td><td><p>Fügt den Benutzeranfragen einen Header hinzu, um anzuzeigen, dass ein Captcha bereitgestellt wurde.</p><p>Standardmäßig <strong>leer lassen</strong>.</p><p>Beispielwert <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Captcha-Content-Negotiation aktivieren</td><td>Handhabt das Format der Captcha-Seite. Wenn auf <code>true</code> gesetzt, kann die Integration die Captcha-Seite im JSON-Format zurückgeben.<br>Standardmäßig <strong>leer lassen</strong>, um HTML seitenweit zu verwenden.</td></tr></tbody></table>

### Abschluss

Überprüfen Sie, ob Sie die folgenden Schritte abgeschlossen haben:

* Installation des [Netacea ](#install-the-netacea-vcl)[Edge-Moduls](#install-the-netacea-edge-module)
* Konfiguration des [Log-Streamings](https://docs.netacea.com/de/netacea-plugin-informationen/monitoring-configuration#log-streaming-implementation-steps) zum bereitgestellten S3-Bucket
* Sicherstellen, dass keine Fehlerwarnungen angezeigt werden

Sie können nun die Bereitstellung durch Klicken auf „Konfiguration speichern" durchführen

{% hint style="info" %}
Manchmal kann eine Cache-Leerung erforderlich sein. Navigieren Sie dazu zu System -> Cache-Verwaltung und klicken Sie auf „Magento-Cache leeren"
{% endhint %}

Das Bot-Management wird nun in der Fastly/Magento-Umgebung bereitgestellt. Sie können die aktive Bereitstellung testen durch:

* Überprüfung der Anwesenheit des Netacea-Cookies auf der Website
* Anzeigen Ihres Reporting-Dashboards für Datenverkehr und Mitigation
* Anforderung einer Überprüfung der internen Metriken durch Netacea