Genel Bakış

[api-discovery-enable-link]:        ../api-discovery/setup.md#enable
[link-wallarm-mode-override]:       ../admin-en/configure-parameters-en.md#wallarm_mode_allow_override
[rule-creation-options]:            ../user-guides/events/check-attack.md#attack-analysis_1
[acl-access-phase]:                 ../admin-en/configure-parameters-en.md#wallarm_acl_access_phase 
[img-mode-rule]:                    ../images/user-guides/rules/wallarm-mode-rule.png

# Filtreleme Modu

Filtreleme modu, gelen istekleri işlerken filtreleme düğümünün davranışını tanımlar. Bu yönergeler, mevcut filtreleme modlarını ve yapılandırma yöntemlerini açıklar.

## Mevcut filtreleme modları

Wallarm filtreleme düğümü, gelen istekleri aşağıdaki modlarda işleyebilir (en hafif olandan en katı olanına doğru):

* **Disabled** (`off`)
* **Monitoring** (`monitoring`)
* **Safe blocking** (`safe_blocking`)
* **Blocking** (`block`)

| Wallarm node behavior | `off` | `monitoring` | `safe_blocking` |`block` |
| -------- | - | - | - | -|
| Analyzes incoming requests for [input validation](../attacks-vulns-list.md#attack-types), [virtual patch](../user-guides/rules/vpatch-rule.md), and [regex-based](../user-guides/rules/regex-rule.md) malicious payloads | - | + | + | + |
| Uploads malicious requests to the Wallarm Cloud so that they are displayed in the event list | - | + | + | + |
| Blocks malicious requests | - | - | Only those originated from [graylisted IPs](../user-guides/ip-lists/overview.md) | + |
| Blocks requests originated from [denylisted IPs](../user-guides/ip-lists/overview.md)<sup>see exception</sup> <br> (IPs added manually and automatically by [multi-attack protection](../admin-en/configuration-guides/protecting-with-thresholds.md) and behavioral protection: [API abuse prevention](../api-abuse-prevention/setup.md), [manual BOLA](../admin-en/configuration-guides/protecting-against-bola-trigger.md), [brute force](../admin-en/configuration-guides/protecting-against-bruteforce.md) and [forced browsing](../admin-en/configuration-guides/protecting-against-forcedbrowsing.md)) | - | + | + | + |
| Blocks requests originated from [graylisted IPs](../user-guides/ip-lists/overview.md) <br> (IPs added manually and automatically by the same protection measures as for denylist) | - | - | Only those containing malicious payloads | - |
| Allows requests originated from [allowlisted IPs](../user-guides/ip-lists/overview.md) | - | + | + | + |

!!! warning "Exception for denylist"
    If [`wallarm_acl_access_phase off`][acl-access-phase], the Wallarm node does not block requests from denylisted IPs in the `monitoring` mode.

## Yapılandırma yöntemleri

Filtreleme modu, aşağıdaki yollarla yapılandırılabilir:

* [Düğüm tarafında `wallarm_mode` direktifini ayarlayın](#setting-wallarm_mode-directive)
* [Wallarm Console'da genel filtreleme kuralını tanımlayın](#general-filtration-rule-in-wallarm-console)
* [Wallarm Console'da uç noktaya yönelik filtreleme kurallarını tanımlayın](#endpoint-targeted-filtration-rules-in-wallarm-console)

Filtreleme modu yapılandırma yöntemlerinin öncelikleri, [`wallarm_mode_allow_override` direktifinde](#prioritization-of-methods) belirlenir. Varsayılan olarak, Wallarm Console'da belirtilen ayarlar, değer şiddetine bakılmaksızın `wallarm_mode` direktifi tarafından belirtilen ayarlardan daha yüksek önceliğe sahiptir.

### `wallarm_mode` direktifinin ayarlanması

Düğüm tarafında `wallarm_mode` direktifini kullanarak düğüm filtreleme modunu ayarlayabilirsiniz. Farklı dağıtımlarda `wallarm_mode` direktifinin nasıl ayarlandığına dair ayrıntılar aşağıda açıklanmıştır.

Belirtilen yapılandırmanın yalnızca [in-line](../installation/inline/overview.md) dağıtımlar için geçerli olduğunu unutmayın - [out-of-band (OOB)](../installation/oob/overview.md) çözümlerinde yalnızca `monitoring` modu etkin olabilir.

=== "All-in-one installer"

    Linux üzerinde [all-in-one installer](../installation/nginx/all-in-one.md) kullanılarak kurulan NGINX tabanlı düğümler için, filtreleme düğümü yapılandırma dosyasında `wallarm_mode` direktifini ayarlayabilirsiniz. Farklı bağlamlar için filtreleme modlarını tanımlayabilirsiniz. Bu bağlamlar, en globalden en yerel olana doğru aşağıdaki sırayla düzenlenmiştir:

    * `http`: direktifler HTTP sunucusuna gönderilen isteklere uygulanır.
    * `server`: direktifler sanal sunucuya gönderilen isteklere uygulanır.
    * `location`: sadece belirtilen yol içeren isteklere direktifler uygulanır.

    `http`, `server` ve `location` blokları için farklı `wallarm_mode` direktif değerleri tanımlanırsa, en yerel yapılandırma en yüksek önceliğe sahiptir.

    Aşağıdaki [yapılandırma örneğine](#configuration-example) bakınız.

=== "Docker NGINX‑based image"

    Docker konteynerleri üzerinden NGINX tabanlı Wallarm düğümleri dağıtırken, [environment variable olarak geçin](../admin-en/installation-docker-en.md#run-the-container-passing-the-environment-variables) `WALLARM_MODE`:

    ```
    docker run -d -e WALLARM_API_TOKEN='XXXXXXX' -e WALLARM_LABELS='group=<GROUP>' -e NGINX_BACKEND='example.com' -e WALLARM_API_HOST='us1.api.wallarm.com' -e WALLARM_MODE='monitoring' -p 80:80 wallarm/node:5.3.0
    ```

    Alternatif olarak, [yapılandırma dosyasına ekleyin](../admin-en/installation-docker-en.md#run-the-container-mounting-the-configuration-file) ve bu dosyayı monte ederek konteyneri çalıştırın.

=== "Docker Envoy‑based image"

    Docker konteynerleri üzerinden Envoy tabanlı Wallarm düğümleri dağıtırken, [environment variable olarak geçin](../admin-en/installation-guides/envoy/envoy-docker.md#run-the-container-passing-the-environment-variables) `WALLARM_MODE`:

    ```
    docker run -d -e WALLARM_API_TOKEN='XXXXXXX' -e WALLARM_LABELS='group=<GROUP>' -e ENVOY_BACKEND='example.com' -e WALLARM_API_HOST='us1.api.wallarm.com' -e WALLARM_MODE='monitoring' -p 80:80 wallarm/envoy:4.8.0-1
    ```

    Alternatif olarak, [yapılandırma dosyasına ekleyin](../admin-en/configuration-guides/envoy/fine-tuning.md#basic-settings) ve bu dosyayı monte ederek konteyneri çalıştırın.

=== "NGINX Ingress controller"

    NGINX Ingress controller için `wallarm-mode` anotasyonunu kullanın:

    ```
    kubectl annotate ingress <YOUR_INGRESS_NAME> -n <YOUR_INGRESS_NAMESPACE> nginx.ingress.kubernetes.io/wallarm-mode=monitoring
    ```

    Filtreleme modunu `monitoring` olarak ayarlayarak NGINX tabanlı Ingress controller'ınız için trafik analizinin nasıl [etkinleştirildiğine](../admin-en/installation-kubernetes-en.md#step-2-enabling-traffic-analysis-for-your-ingress) dair örneğe bakınız.

=== "Sidecar"

    Wallarm Sidecar çözümü için, varsayılan `values.yaml` dosyasının Wallarm ile ilgili bölümünde `mode` parametresini ayarlayın:

    ```
    config:
    wallarm:
        ...
        mode: monitoring
        modeAllowOverride: "on"
    ```

    Sidecar için filtreleme modunun nasıl belirtileceğine dair detayları [burada](../installation/kubernetes/sidecar-proxy/helm-chart-for-wallarm.md) görebilirsiniz.

=== "Edge Connectors"

    [Security Edge connectors](../installation/se-connector.md) için, bağlantı dağıtımı sırasında **Filtration mode** seçicide `wallarm_mode` değerini belirtirsiniz.
=== "Native Node"
    * Native Node all-in-one installer ve Docker image için [`route_config.wallarm_mode`](../installation/native-node/all-in-one-conf.md#route_configwallarm_mode) parametresini kullanın.
    * Native Node Helm chart için [`config.connector.mode`](../installation/native-node/helm-chart-conf.md#configconnectormode) parametresini kullanın.

### Wallarm Console'da Genel Filtreleme Kuralı

Gelen tüm istekler için genel filtreleme modunu **Settings** → **General** bölümünde [US](https://us1.my.wallarm.com/settings/general) veya [EU](https://my.wallarm.com/settings/general) Cloud üzerinden tanımlayabilirsiniz.

![The general settings tab](../images/configuration-guides/configure-wallarm-mode/en/general-settings-page-with-safe-blocking.png)

Genel filtreleme modu ayarı, **Rules** bölümünde **Set filtration mode** [default](../user-guides/rules/rules.md#default-rules) kuralı olarak temsil edilir. Bu bölümdeki uç noktaya yönelik filtreleme kurallarının daha yüksek önceliğe sahip olduğunu unutmayın.

### Wallarm Console'da Uç Noktaya Yönelik Filtreleme Kuralları

Belirli dallar, uç noktalar ve diğer koşullara bağlı olarak filtreleme modunu ayarlayabilirsiniz. Wallarm, bunu yapmak için **Set filtration mode** [kuralını](../user-guides/rules/rules.md) sağlar. Bu tür kurallar, [Wallarm Console'da ayarlanan genel filtreleme kuralından](#general-filtration-rule-in-wallarm-console) daha yüksek önceliğe sahiptir.

Yeni bir filtreleme modu kuralı oluşturmak için:

1. Proceed to Wallarm Console:

    * **Rules** → **Add rule** or your branch → **Add rule**.
    * **Attacks** / **Incidents** → attack/incident → hit → **Rule**.
    * **API Discovery** (if [enabled][api-discovery-enable-link]) → your endpoint → **Create rule**.

1. **Fine-tuning attack detection** → **Override filtration mode** seçeneğini seçin. 
1. **If request is** kısmında, kuralın uygulanacağı kapsamı [tanımlayın](../user-guides/rules/rules.md#configuring). Kuralı belirli bir dal, istek veya uç nokta için başlattıysanız, kapsam onlar tarafından tanımlanır - gerekirse daha fazla koşul ekleyebilirsiniz.
1. İstenen modu seçin.
1. Değişiklikleri kaydedin ve [kural derlemesinin tamamlanmasını](../user-guides/rules/rules.md#ruleset-lifecycle) bekleyin.

Filtreleme modu kuralı oluşturmak için ayrıca [Wallarm API'sini doğrudan çağırabileceğinizi](../api/request-examples.md#create-the-rule-setting-filtration-mode-to-monitoring-for-the-specific-application) unutmayın.

### Yöntemlerin Önceliklendirilmesi

!!! warning "Edge düğümünde `wallarm_mode_allow_override` direktifinin desteği"
    Lütfen, `wallarm_mode_allow_override` direktifinin Wallarm Edge [inline](../installation/security-edge/deployment.md) ve [connector](../installation/se-connector.md) düğümlerinde özelleştirilemeyeceğini unutmayın.

`wallarm_mode_allow_override` direktifi, filtreleme düğümü yapılandırma dosyasındaki `wallarm_mode` direktifi değerlerini kullanmak yerine Wallarm Console'da tanımlanan kuralların uygulanabilmesini yönetir.

`wallarm_mode_allow_override` direktifi için geçerli olan değerler şunlardır:

* `off`: Wallarm Console'da belirtilen kurallar göz ardı edilir. Konfigürasyon dosyasında `wallarm_mode` direktifiyle belirtilen kurallar uygulanır.
* `strict`: Sadece, konfigürasyon dosyasında `wallarm_mode` direktifiyle belirtilenlerden daha katı filtreleme modlarını tanımlayan Wallarm Cloud'daki kurallar uygulanır.

    Mevcut filtreleme modları, en hafif olandan en katı olana doğru yukarıda [listelenmiştir](#available-filtration-modes).

* `on` (varsayılan): Wallarm Console'da belirtilen kurallar uygulanır. Konfigürasyon dosyasında `wallarm_mode` direktifiyle belirtilen kurallar göz ardı edilir.

`wallarm_mode_allow_override` direktifi değerinin tanımlanabileceği bağlamlar, en globalden en yerel olana doğru aşağıdaki listede sunulmuştur:

* `http`: `http` bloğu içindeki direktifler, HTTP sunucusuna gönderilen isteklere uygulanır.
* `server`: `server` bloğu içindeki direktifler, sanal sunucuya gönderilen isteklere uygulanır.
* `location`: `location` bloğu içindeki direktifler, yalnızca ilgili yolu içeren isteklere uygulanır.

`http`, `server` ve `location` blokları için farklı `wallarm_mode_allow_override` direktif değerleri tanımlanırsa, en yerel yapılandırma en yüksek önceliğe sahiptir.

**`wallarm_mode_allow_override` direktifinin kullanım örneği:**

```bash
http {

    wallarm_mode monitoring;

    server {
        server_name SERVER_A;
        wallarm_mode_allow_override off;
    }

    server {
        server_name SERVER_B;
        wallarm_mode_allow_override on;

        location /main/login {
            wallarm_mode_allow_override strict;
        }
    }
}