[Документация Yandex Cloud](../../index.md) > [Yandex Smart Web Security](../index.md) > [Пошаговые инструкции](index.md) > Профили WAF > Добавить правило-исключение # Добавить правило-исключение WAF {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://console.yandex.cloud) выберите [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в котором находится [профиль WAF](../concepts/waf.md). 1. Перейдите в сервис **Smart Web Security**. 1. На панели слева выберите ![image](../../_assets/smartwebsecurity/waf.svg) **Профили WAF**. 1. Выберите профиль, в который вы хотите добавить [правило-исключение](../concepts/waf.md#exclusion-rules). 1. В меню слева перейдите на вкладку ![image](../../_assets/console-icons/file-xmark.svg) **Правила-исключения** и нажмите кнопку **Создать правило-исключение**. В открывшемся окне: 1. Введите имя правила-исключения. 1. (опционально) Введите описание. 1. (опционально) Включите опцию **Запись логов**, чтобы логировать факты срабатывания правил-исключений. 1. В поле **Пропускать проверки** выберите: * **Все правила** — исключение будет срабатывать для всех правил. * **Выбранные правила** — исключение будет срабатывать для выбранных правил. Нажмите **Добавить правила**, чтобы выбрать правила. 1. В блоке **Область применения** выберите: * **Весь запрос** — исключение будет применяться ко всему HTTP-запросу. * **Часть запроса** — исключение будет применяться только к той части запроса, которая указана в параметрах. Остальной запрос будет проверяться в соответствии с настройками WAF-профиля. В поле **Параметры исключений** выберите один или несколько параметров: `HTTP body`, `Cookie`, `HTTP header` или `Query params`. Для каждого параметра задайте значение. При необходимости включите опцию **Учитывать регистр**. Чтобы добавить еще одно значение для параметра, нажмите ![plus-sign](../../_assets/console-icons/plus.svg) **или**. 1. В блоке **Условия на трафик** определите трафик, для анализа которого будет использоваться правило: * `Весь трафик` — правило будет использоваться для анализа всего трафика. * `При условии` — правило будет использоваться для анализа трафика, заданного в поле **Условия**: * `IP` — IP-адрес, диапазон адресов или регион IP-адресов; * `HTTP header` — строка в заголовке HTTP; * `Request URI` — путь запроса; * `Host` — домен, на который пришел запрос; * `HTTP method` — метод запроса; * `Cookie` — строка в заголовке cookie. * `Bot name` — имена легитимных ботов, принадлежащих различным компаниям и сервисам. * `Bot category` — категории верифицированных ботов по их назначению или характеру действий. * `Verified bot` — фильтрация по признаку верификации бота (`да` или `нет`). * `Bot score` — фильтрация по уровню роботизированности запроса: от `0` (самый низкий уровень, человек) до `100` (самый высокий уровень, бот). * `FingerPrint` — [отпечаток](../concepts/botes.md#fingerprint) SSL/TLS‑соединения. Вы можете задать несколько условий одного типа. Для этого в поле **Условия** выберите все необходимые типы условий. Вы также можете задать одновременно несколько условий одного типа. Для этого в секции с нужным условием нажмите кнопку ![plus-sign](../../_assets/console-icons/plus.svg) **и** или ![plus-sign](../../_assets/console-icons/plus.svg) **или**. Чтобы удалить условие, нажмите ![options](../../_assets/console-icons/trash-bin.svg). 1. Нажмите кнопку **Создать**. - Terraform {#tf} [Terraform](https://www.terraform.io/) позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить. Terraform распространяется под лицензией [Business Source License](https://github.com/hashicorp/terraform/blob/main/LICENSE), а [провайдер Yandex Cloud для Terraform](https://github.com/yandex-cloud/terraform-provider-yandex) — под лицензией [MPL-2.0](https://www.mozilla.org/en-US/MPL/2.0/). Подробная информация о ресурсах провайдера в документации на сайте [Terraform](https://www.terraform.io/docs/providers/yandex/index.html) или в [зеркале](../../terraform/index.md). Если у вас еще нет Terraform, [установите его и настройте провайдер Yandex Cloud](../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform). Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, [аутентифицируйтесь](../../terraform/authentication.md) соответствующим способом. 1. Откройте файл конфигурации Terraform и измените фрагмент с описанием профиля безопасности `yandex_sws_waf_profile`: добавьте блок `exclusion_rule` c правилом-исключением WAF. ```hcl # WAF профиль resource "yandex_sws_waf_profile" "default" { name = "waf-profile-default" core_rule_set { inbound_anomaly_score = 2 paranoia_level = local.waf_paranoia_level rule_set { name = "OWASP Core Ruleset" version = "4.0.0" } } ... # Правило-исключение exclusion_rule { name = "<имя правила-исключения>" condition { source_ip { ip_ranges_match { ip_ranges = [ "<диапазон_IP-адресов_1>", "<диапазон_IP-адресов_2>", ... "<диапазон_IP-адресов_n>" ] } ip_ranges_not_match { ip_ranges = [ "<диапазон_IP-адресов_3>", "<диапазон_IP-адресов_4>", ... "<диапазон_IP-адресов_y>" ] } } } exclude_rules { exclude_all = rule_ids = [ "идентификатор_правила_1", "идентификатор_правила_2", ... "идентификатор_правила_n" ] } } } ``` Где: * `exclusion_rule` — правило-исключение: * `name` — имя правила-исключения. * `condition` — [условия](../concepts/conditions.md), при которых будет срабатывать правило-исключение. В приведенном примере применяется условие по IP-адресу источника трафика. В блоке `condition` вы можете использовать одновременно несколько разных типов условий. * `exclude_rules` — параметры правила-исключения: * `exclude_all` — исключение будет срабатывать для всех правил. Возможные значения `false` или `true`. * `rule_ids` — список идентификаторов правил из базового набора, для которых будет срабатывать исключение. Чтобы указать отдельные правила, для параметра `exclude_all` установите значение `false`. Подробнее о параметрах ресурса `sws_waf_profile` в [документации провайдера](../../terraform/resources/sws_waf_profile.md). 1. Создайте ресурсы: 1. В терминале перейдите в директорию с конфигурационным файлом. 1. Проверьте корректность конфигурации с помощью команды: ```bash terraform validate ``` Если конфигурация является корректной, появится сообщение: ```bash Success! The configuration is valid. ``` 1. Выполните команду: ```bash terraform plan ``` В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет. 1. Примените изменения конфигурации: ```bash terraform apply ``` 1. Подтвердите изменения: введите в терминале слово `yes` и нажмите **Enter**. Проверить изменение ресурсов можно в [консоли управления](https://console.yandex.cloud). - API {#api} Воспользуйтесь методом REST API [update](../waf/api-ref/WafProfile/update.md) для ресурса [WafProfile](../waf/api-ref/WafProfile/index.md) или вызовом gRPC API [WafProfile/Update](../waf/api-ref/grpc/WafProfile/update.md). {% endlist %} #### Полезные ссылки {#see-also} * [Настроить наборы правил WAF](configure-set-rules.md) * [Удалить правило-исключение WAF](exclusion-rule-delete.md) * [Добавить правило в профиль безопасности](rule-add.md)