Добавить правило-исключение WAF

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробная информация о ресурсах провайдера в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

1. Откройте файл конфигурации Terraform и измените фрагмент с описанием профиля безопасности yandex_sws_waf_profile: добавьте блок exclusion_rule c правилом-исключением WAF.

   # 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 = <true_или_false>
         rule_ids    = [
           "идентификатор_правила_1",
           "идентификатор_правила_2",
           ...
           "идентификатор_правила_n"
         ]
       }
     }
   }
   

   Где:

   • exclusion_rule — правило-исключение:

     • name — имя правила-исключения.

     • condition — условия, при которых будет срабатывать правило-исключение. В приведенном примере применяется условие по IP-адресу источника трафика.

       В блоке condition вы можете использовать одновременно несколько разных типов условий.

     • exclude_rules — параметры правила-исключения:

       • exclude_all — исключение будет срабатывать для всех правил. Возможные значения false или true.
       • rule_ids — список идентификаторов правил из базового набора, для которых будет срабатывать исключение. Чтобы указать отдельные правила, для параметра exclude_all установите значение false.

   Подробнее о параметрах ресурса sws_waf_profile в документации провайдера.

2. Создайте ресурсы:

   1. В терминале перейдите в директорию с конфигурационным файлом.

   2. Проверьте корректность конфигурации с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

   3. Выполните команду:

      terraform plan
      

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

Проверить изменение ресурсов можно в консоли управления.

Воспользуйтесь методом REST API update для ресурса WafProfile или вызовом gRPC API WafProfile/Update.