# Konfiguracja właściwości

### Wymagania wstępne

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

1. Posiadasz dostęp do odpowiednich kluczy API i Secret od Netacea.
2. Akamai skonfigurowało [Netacea Fail Open](https://docs.netacea.com/pl/informacje-o-wtyczce-netacea/akamai/installation-and-configuration/..#configuring-netacea-fail-open) w Twoim imieniu.
3. Ukończyłeś [Konfigurację właściwości Proxy](https://docs.netacea.com/pl/informacje-o-wtyczce-netacea/akamai/installation-and-configuration/proxy-property-configuration).
4. Ukończyłeś [Instalację Edge Worker](https://docs.netacea.com/pl/informacje-o-wtyczce-netacea/akamai/installation-and-configuration/edgeworker-installation).

## Konfiguracja właściwości

Istnieje szereg konfiguracji, które muszą zostać wykonane na każdej właściwości chronionej przez Netacea. Konfiguracje te obejmują Zmienne i Reguły.

#### Zmienne właściwości

Najpierw skonfigurujemy zmienne w ścieżce właściwości. Można je znaleźć w poniższej tabeli:

<table><thead><tr><th width="291">Nazwa zmiennej</th><th width="135">Wartość początkowa</th><th width="219">Opis</th><th>Ustawienie bezpieczeństwa</th></tr></thead><tbody><tr><td>NETACEA_API_KEY</td><td>Puste</td><td>Klucz API Netacea. Wartość jest ustawiana przez Regułę.</td><td>Ukryte</td></tr><tr><td>NETACEA_SECRET_KEY</td><td>Puste</td><td>Klucz Secret Netacea. Wartość jest ustawiana przez Regułę.</td><td>Ukryte</td></tr><tr><td>CLIENT_IP</td><td>Puste</td><td>Prawdziwy adres IP klienta</td><td>Widoczne</td></tr><tr><td>NETACEA_MITIGATION_TYPE</td><td>INGEST, MITIGATE lub INJECT</td><td><p>INGEST - Integracja tylko pobiera dane.<br><br>MITIGATE - Integracja pobiera dane i stosuje środki zaradcze.<br></p><p>INJECT - Integracja pobiera dane i zwraca wartości nagłówków środków zaradczych zamiast podejmować działanie.</p></td><td>Widoczne</td></tr><tr><td>NETACEA_MITIGATION_URL</td><td><a href="proxy-property-configuration">Nazwa hosta właściwości Proxy</a></td><td>Zmienna do przekierowywania ruchu do Netacea. Musi zawierać prefiks <strong>https://</strong></td><td>Widoczne</td></tr><tr><td>NETACEA_DS2_CUSTOM_FIELD</td><td>Puste</td><td>Zmienna zawierająca niestandardowe informacje o sesji</td><td>Ukryte</td></tr><tr><td>FAILOVER_SECRET</td><td>&#x3C;Sekret Failover dostarczony przez Netacea></td><td>Ciąg znaków dostarczony przez Netacea, używany w przypadku awarii EdgeWorker, aby EdgeWorker przeszedł w tryb fail open</td><td>Poufne</td></tr><tr><td>FAILOVER_HEADER_VALUE</td><td>Puste</td><td>Wartość nagłówka x-ew-failover</td><td>Poufne</td></tr><tr><td>ORIG_HOST</td><td>%(AK_HOST)</td><td>Host używany do failover Netacea</td><td>Widoczne</td></tr><tr><td>NETACEA_INGEST_TYPE</td><td>ORIGIN</td><td>Określa typ pobierania, zapewnia że Akamai nie domyślnie używa HTTP</td><td>Widoczne</td></tr><tr><td>NETACEA_COOKIE_NAME</td><td>&#x3C;Dowolna nazwa cookie></td><td>Określa nazwę pliku cookie środków zaradczych Netacea.<mark style="color:red;">*</mark></td><td>Widoczne</td></tr><tr><td>NETACEA_CAPT_COOKIE_NAME</td><td>&#x3C;Dowolna nazwa cookie></td><td>Określa nazwę pliku cookie captcha Netacea.<mark style="color:red;">*</mark></td><td>Widoczne</td></tr><tr><td>NETACEA_ENCRYPTION_KEY</td><td>&#x3C;Klucz szyfrowania cookie dostarczony przez Netacea></td><td>Włącza szyfrowanie plików cookie, jeśli nie jest puste.<mark style="color:red;">*</mark></td><td>Ukryte</td></tr><tr><td>NETACEA_CAPT_REL_ASSETS</td><td>TRUE</td><td>Pobiera zasoby CAPTCHA z serwera Netacea.</td><td>Widoczne</td></tr></tbody></table>

{% hint style="info" %} <mark style="color:red;">\*</mark>Te zmienne służą do zwiększenia bezpieczeństwa poprzez ukrycie domyślnych nazw i wartości plików cookie Netacea przed publicznym widokiem. Proszę ustawić nazwy plików cookie na wartości niezwiązane z Netacea.
{% endhint %}

Po ich skonfigurowaniu możemy przejść do konfiguracji reguł w ramach właściwości.

### Reguły właściwości

Właściwość wymaga skonfigurowania szeregu reguł przed jej wdrożeniem. Każda z reguł wraz z wymaganymi konfiguracjami znajduje się poniżej.

### **Nowa reguła (pusty szablon reguły): Netacea**

Będzie to zagnieżdżenie reguł służące do grupowania reguł Netacea.

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

### **Nowa reguła (pusty szablon reguły): Ustaw zmienną Failover**

W ramach zagnieżdżonej reguły Netacea dodaj następującą regułę.

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

{% hint style="info" %}
Aby porównać wartość nagłówka failover, musi ona zostać odczytana z nagłówka i zapisana jako zmienna. Następnie nagłówek jest usuwany, aby zapobiec wyciekowi tajnej wartości.
{% endhint %}

### Dodawanie kryteriów i zachowań

| Kryteria          |
| ----------------- |
| Dopasuj wszystkie |
| **Jeśli**         |
| Nagłówek żądania  |
| **x-ew-failover** |
| istnieje          |

| Zachowania |
| ---------- |
|            |

### **Nowa reguła (pusty szablon reguły): Ustaw środki zaradcze dla \<hostname>**

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

### Dodawanie kryteriów i zachowań

| **Reguła środków zaradczych** |
| ----------------------------- |
| *Dodaj komentarz...*          |

| Kryteria                              |
| ------------------------------------- |
| Dopasuj wszystkie                     |
| **Jeśli**                             |
| Nazwa hosta                           |
| Jest jednym z                         |
| **\<hostname>**                       |
| **I**                                 |
| Zmienna                               |
| **PMUSER\_FAILOVER\_HEADER\_VALUE**   |
| nie jest                              |
| **{{user.PMUSER\_FAILOVER\_SECRET}}** |
| **I\***                               |
| Protokół żądania\*                    |
| HTTPS\*                               |

{% hint style="info" %}
\*TYLKO DLA WŁAŚCIWOŚCI, KTÓRE PRZEKIEROWUJĄ HTTP NA HTTPS
{% endhint %}

| Zachowania |
| ---------- |
|            |

{% hint style="info" %}
Proszę odtworzyć powyższą regułę dla każdej domeny (nazwy hosta) w tej właściwości, która jest powiązana z unikalnymi kluczami API i Secret Netacea.
{% endhint %}

### **Nowa reguła (pusty szablon reguły): Netacea Fail Open**

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

{% hint style="info" %}
Ta reguła Fail Open wymaga użycia zaawansowanego zachowania XML.

Aby dodać ten zaawansowany niestandardowy blok XML, skontaktuj się z przedstawicielem konta Akamai, który może poprosić, aby Akamai​ Professional Services utworzyło niestandardowe zachowanie, które można dodać do konfiguracji właściwości na Twoim koncie.
{% endhint %}

| Kryteria                     |
| ---------------------------- |
| Dopasuj wszystkie            |
| **Jeśli**                    |
| Etap metadanych              |
| jest                         |
| **client-response**          |
| **I**                        |
| Status wykonania EdgeWorkers |
| **Niepowodzenie**            |

| Zachowania |
| ---------- |
|            |

{% hint style="info" %} <mark style="color:red;">\*</mark>Zaawansowane zachowanie Failover będzie niedostępne do czasu dodania [XML Netacea Fail Open](https://docs.netacea.com/pl/informacje-o-wtyczce-netacea/akamai/installation-and-configuration/..#configuring-netacea-fail-open-xml).
{% endhint %}

Po dodaniu niestandardowego zachowania zostanie ono wyświetlone poniżej jako **Zaawansowane.**

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

### **Nowa reguła: Warunkowa grupa Origin**

Ta reguła, wraz z regułą \[DataStreamXLOCKX280XLOCK