# Instalacja i konfiguracja

### Wymagania wstępne

Aby pomyślnie przeprowadzić integrację z wykorzystaniem Netacea, upewnij się, że posiadasz:

1. Fastly w wersji 1.2.217 lub wyższej. Jest to wersja, w której dodano moduł Netacea Edge do integracji.
2. Dostęp do odpowiednich kluczy API i punktów końcowych do przesyłania logów w [portalu Netacea](https://docs.netacea.com/pl/informacje-o-wtyczce-netacea/accessing-your-integration-settings).

Klienci będą również musieli otworzyć zgłoszenie do wsparcia Magento z prośbą o włączenie przez Fastly obsługi POST w ich środowisku. Należy upewnić się, że na koncie Fastly włączone są 2 dyrektywy pragma, które domyślnie nie są aktywne.

Wymagane dyrektywy pragma:

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

Aby włączyć dyrektywy pragma, należy utworzyć zgłoszenie do wsparcia Fastly/Magento. Tych dyrektyw pragma nie można dodać ręcznie.

### Kroki implementacji

* Zaloguj się do interfejsu webowego Fastly/Magento.
* Sprawdź, czy dyrektywy pragma opisane w sekcji [wymagań wstępnych](#implementation-prerequisites) zostały włączone, przechodząc do Sklepy → Konfiguracja → Zaawansowane → System → Full Page Cache → Konfiguracja Fastly → Narzędzia → Wyświetl wszystkie wersje.

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

* Wyświetl najnowszą wersję VCL i poszukaj dyrektyw pragma na początku VCL.

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

{% hint style="info" %}
Zanotuj aktualną wersję na wypadek konieczności przywrócenia poprzedniego stanu w przyszłości.
{% endhint %}

### Utwórz pusty słownik

Przejdź do Sklepy → Konfiguracja → Zaawansowane → System → Full Page Cache → Konfiguracja Fastly → Słowniki Edge i kliknij „Dodaj słownik".

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

Utwórz słownik o nazwie „netacea\_edge\_config", który może pozostać pusty.

{% hint style="info" %}
Zostanie on wypełniony tylko podczas korzystania z [Konfiguracji zaawansowanej](https://docs.netacea.com/pl/informacje-o-wtyczce-netacea/fastly-magento/installation-and-configuration/advanced-configuration) zgodnie z zaleceniami Netacea
{% endhint %}

### Zainstaluj moduł Netacea Edge

Przejdź do Sklepy → Konfiguracja → Zaawansowane → System → Full Page Cache → Konfiguracja Fastly → Moduły Fastly Edge i kliknij „Zarządzaj" w Menedżerze modułów.

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

* Zaznacz moduł Edge „Netacea Bot Detection integration" i kliknij „Zapisz".

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

### Zastosuj klucze klienta do modułu

* Przejdź do Aktywnych modułów i kliknij ikonę koła zębatego przy pozycji „Netacea Bot Detection integration".

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

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

**Wprowadź wymagane pola**

<table><thead><tr><th width="157">Pole</th><th>Wartość</th></tr></thead><tbody><tr><td>Tryb integracji (Integration Mode)</td><td><p>BYPASS - Całkowicie wyłącza integrację Netacea</p><p>INGEST - Tryb pasywny umożliwiający Netacea zbieranie i analizowanie ruchu</p><p>MITIGATE - Tryb aktywny, który będzie mitygować zagrożenia na podstawie Intent Analytics® Netacea</p><p>INJECT - Tryb aktywny dla klientów, którzy chcą otrzymywać analizy Netacea na swoim backendzie i samodzielnie decydować o podejmowanych działaniach.</p></td></tr><tr><td>Klucz API Netacea (Netacea API Key)</td><td>Dostarczony przez <a href="../accessing-your-integration-settings">portal Netacea</a></td></tr><tr><td>Sekret Netacea (Netacea Secret)</td><td>Dostarczony przez <a href="../accessing-your-integration-settings">portal Netacea</a></td></tr><tr><td>Klucz szyfrowania (Encryption Key)</td><td>Dostarczony przez <a href="../accessing-your-integration-settings">portal Netacea</a></td></tr><tr><td>Nazwa ciasteczka Netacea (Netacea cookie name)</td><td><p>Odpowiednia nazwa dla ciasteczka mitygacji.</p><p><strong>Dla zwiększenia bezpieczeństwa nie umieszczaj w tej nazwie słów Netacea ani Mitigation.</strong></p></td></tr><tr><td>Nazwa ciasteczka captcha Netacea (Netacea captcha cookie name)</td><td><p>Odpowiednia nazwa dla ciasteczka śledzenia Captcha.</p><p><strong>Dla zwiększenia bezpieczeństwa nie umieszczaj w tej nazwie słów Netacea ani Mitigation.</strong></p></td></tr><tr><td>Lista wykluczeń Netacea - ścieżki URL (Netacea ignore list - URL Paths)</td><td><code>/static/,/media/</code></td></tr></tbody></table>

**Pola opcjonalne - Można pozostawić puste, chyba że uzgodniono inaczej z zespołem Netacea**

<table><thead><tr><th width="278">Pole</th><th>Wartość</th></tr></thead><tbody><tr><td>Nazwa nagłówka rzeczywistego IP (Real IP Header Name)</td><td><p>Umożliwia użytkownikom dostosowanie, który nagłówek jest używany do określenia adresu IP żądania.</p><p>Pozostaw <strong>domyślnie puste</strong>, aby używać standardowego pola Fastly <code>client.IP</code>.</p></td></tr><tr><td>Użyj względnych zasobów strony Captcha (Use Relative Captcha Page Assets)</td><td>Jeśli ustawiono na <code>true</code>, zapewnia wyświetlanie Captcha bez odniesień do CDN Netacea. W przeciwnym razie pełny URL do CDN Netacea zostanie osadzony w kodzie HTML Captcha.<br>Pozostaw <strong>domyślnie puste</strong>, aby używać HTML na całej stronie.</td></tr><tr><td>Ścieżka URL Captcha (Captcha URL Path)</td><td>Umożliwia użytkownikom utworzenie punktu końcowego, który zawsze serwuje HTML Captcha. Przydatne przy implementacji wyzwania captcha dla aplikacji mobilnych.<br>Pozostaw <strong>domyślnie puste</strong>, aby używać ścieżki /ATAverify.</td></tr><tr><td>Nagłówek znacznika strony Captcha (Captcha Page Marker Header)</td><td>Niestandardowy nagłówek wskazujący, czy odpowiedź jest stroną Captcha. Musi mieć format <code>name={{header name}}&#x26;value={{header value}}.</code></td></tr><tr><td>Nagłówek znacznika strony Captcha (Captcha Page Marker Header)</td><td><p>Dodaje nagłówek do żądań użytkowników wskazujący, że captcha została wyświetlona.</p><p>Pozostaw <strong>domyślnie puste</strong>.</p><p>Przykładowa wartość: <code>name=X-Captcha-Served&#x26;value=true</code></p></td></tr><tr><td>Włącz negocjację treści Captcha (Enable Captcha Content Negotiation)</td><td>Obsługuje format strony Captcha. Gdy ustawiono na <code>true</code>, integracja może zwracać stronę Captcha w formacie JSON.<br>Pozostaw <strong>domyślnie puste</strong>, aby używać HTML na całej stronie.</td></tr></tbody></table>

### Zakończenie

Sprawdź, czy wykonałeś następujące kroki:

* Zainstalowałeś [moduł Netacea](#install-the-netacea-vcl) [Edge Module](#install-the-netacea-edge-module)
* Skonfigurowałeś [strumieniowanie logów](https://docs.netacea.com/pl/informacje-o-wtyczce-netacea/monitoring-configuration#log-streaming-implementation-steps) do dostarczonego zasobnika S3
* Upewniłeś się, że nie pojawiają się żadne ostrzeżenia o błędach

Jesteś teraz gotowy do wdrożenia poprzez kliknięcie „Zapisz konfigurację"

{% hint style="info" %}
Czasami może być wymagane wyczyszczenie pamięci podręcznej. Aby to zrobić, przejdź do System -> Zarządzanie pamięcią podręczną i kliknij „Wyczyść pamięć podręczną Magento"
{% endhint %}

Zarządzanie botami zostanie teraz wdrożone w środowisku Fastly/Magento. Możesz sprawdzić, czy wdrożenie jest aktywne poprzez:

* Sprawdzenie obecności ciasteczka Netacea na stronie
* Wyświetlenie pulpitu raportowania w celu przeglądu ruchu i mitygacji
* Poproszenie Netacea o przegląd wewnętrznych metryk