Обновление формата условий в API, CLI и Terraform

Статья создана

Обновлена 4 июня 2026 г.

Обновление существующих конфигураций
Формат описания условий
Обновление CLI
Примеры использования новых полей

Важно

9 июня 2026 года сервис перейдет на новый формат условий и имена полей в правилах профиля безопасности, WAF и ARL. Если вы используете API, CLI или Terraform, обновите команды и конфигурации.

Раньше несколько значений в одном условии задавались списком. Теперь такие значения нужно объединять в одно текстовое поле и разделять символом |.

Также меняются имена полей http_methods, authorities, ja3_ranges, ja4_ranges.

Обновление существующих конфигураций

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

Формат описания условий

Поле в старом формате

Поле в новом формате

http_methods:

GET
POST

http_method_matcher:

GET|POST

authorities:

example.com
example.net

authority_matcher:

example\.com|example\.net

ja3_ranges:

d4e5f6a7b8c9
a1b2c3d4e5f6

ja3_matcher:

d4e5f6a7b8c9|a1b2c3d4e5f6

ja4_ranges:

t13d1516h2_8daaf6152771
t13d1812h2_c73b8a5f9d24

ja4_matcher:

t13d1516h2_8daaf6152771|t13d1812h2_c73b8a5f9d24

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

Пример разных типов условий в старом формате:

exact_match = example.com
exact_not_match = example.net
prefix_match = aaa/
prefix_match = bbb
prefix_not_match = ccc
pire_regex_match = d.*
pire_regex_not_match = f.*

Пример объединения условий в новый формат:

"pireRegexMatch": "example\.com|~(example\.net)|aaa(|/.*)|bbb.*|~(ccc)|d.*|~(f.*)"

Если в регулярном выражении специальные символы (, ), {, }, [, ], ., *, +, ?, ^, $, |, \, & или ~ используются как обычные, экранируйте их с помощью \.

Символ ~ можно использовать как логическое отрицание.

Помимо регулярных выражений для объединения условий можно использовать списки со строками или списки с регулярными выражениями.

Обновление CLI

Обновите CLI до последней версии:
```
yc components update
```

Посмотрите формат новых полей в командах create и update:

yc smartwebsecurity security-profile create -h
yc smartwebsecurity security-profile update -h

Примеры использования новых полей

CLI

Terraform

API

Если вы передаете параметры напрямую в команде, замените старые поля на новые:

yc smartwebsecurity security-profile create \
  --name security-profile \
  --default-action ALLOW \
  --security-rules '[
    {
      name = "security-rule",
      priority = 1,
      dry-run = false,
      rule-specifier = {
        rule-condition = {
          action = DENY,
          condition = {
            authority = {
              authority-matcher = {
                match = {
                  pire-regex-match = "example1|example2"
                }
              }
            },
            http-method = {
              http-method-matcher = {
                match = {
                  pire-regex-match = "GET|POST"
                }
              }
            },
            finger-print = {
              ja3-matcher = {
                match = {
                  pire-regex-match = "d4e5f6a7b8c9|a1b2c3d4e5f6"
                }
              },
              ja4-matcher = {
                match = {
                  pire-regex-match = "t13d1516h2_8daaf6152771|t13d1812h2_c73b8a5f9d24"
                }
              }
            }
          }
        }
      }
    }
  ]'

Пример команды с новыми полями для списков:

yc smartwebsecurity security-profile create \
  --name security-profile \
  --default-action ALLOW \
  --security-rules '[
    {
      name = "security-rule",
      priority = 1,
      dry-run = false,
      rule-specifier = {
        rule-condition = {
          action = DENY,
          condition = {
            source-ip = {
              asn-lists-match = {
                list-ids = ["<идентификатор_списка_1>", "<идентификатор_списка_2>"]
              },
              asn-lists-not-match = {
                list-ids = ["<идентификатор_списка_1>", "<идентификатор_списка_2>"]
              }
            },
            authority = {
              authority-matcher = {
                match = {
                  lists-matchers = {
                    str-lists-match = {
                      list-ids = ["<идентификатор_списка>"]
                    },
                    str-lists-not-match = {
                      list-ids = ["<идентификатор_списка>"]
                    },
                    reg-exp-lists-match = {
                      list-ids = ["<идентификатор_списка>"]
                    },
                    reg-exp-lists-not-match = {
                      list-ids = ["<идентификатор_списка>"]
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  ]'

Если вы используете файл с правилами, обновите в нем названия полей и значения условий.

Подробнее о командах в справочнике CLI: security-profile create и security-profile update.

В конфигурации Terraform замените старые поля в блоках условий:

resource "yandex_sws_security_profile" "yandex-sws-security-profile" {
  name = "test-terraform-yandex-sws-security-profile"
  default_action = "ALLOW"

  security_rule {
    name = "rule-condition-migration"
    priority = 4

    rule_condition {
      action = "ALLOW"

      condition {
        authority {
          authority_matcher {
            pire_regex_match = "example1|example2"
          }
        }
        http_method {
          http_method_matcher {
            pire_regex_match = "GET|POST"
          }
        }
        finger_print {
          ja3_matcher {
            pire_regex_match = "d4e5f6a7b8c9|a1b2c3d4e5f6"
          }
          ja4_matcher {
            pire_regex_match = "t13d1516h2_8daaf6152771|t13d1812h2_c73b8a5f9d24"
          }
        }
      }
    }
  }
}

Пример конфигурации с новыми полями для списков:

resource "yandex_sws_security_profile" "yandex-sws-security-profile" {
  name = "test-terraform-yandex-sws-security-profile"
  default_action = "ALLOW"

  security_rule {
    name = "rule-condition-new-lists"
    priority = 5

    rule_condition {
      action = "ALLOW"

      condition {
        source_ip {
          asn_lists_match {
            list_ids = ["<идентификатор_списка_1>", "<идентификатор_списка_2>"]
          }
          asn_lists_not_match {
            list_ids = ["<идентификатор_списка_1>", "<идентификатор_списка_2>"]
          }
        }

        authority {
          authority_matcher {
            lists_matchers {
              str_lists_match {
                list_ids = ["<идентификатор_списка>"]
              }
              str_lists_not_match {
                list_ids = ["<идентификатор_списка>"]
              }
              reg_exp_lists_match {
                list_ids = ["<идентификатор_списка>"]
              }
              reg_exp_lists_not_match {
                list_ids = ["<идентификатор_списка>"]
              }
            }
          }
        }
      }
    }
  }
}

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

Пример запроса с новыми полями:

curl -X POST \
  'https://smartwebsecurity.api.cloud.yandex.net/smartwebsecurity/v1/securityProfiles' \
  -H "Authorization: Bearer $(yc iam create-token)" \
  -H 'Content-Type: application/json' \
  -d '{
    "folderId": "<идентификатор_каталога>",
    "name": "security-profile",
    "defaultAction": "ALLOW",
    "securityRules": [
      {
        "name": "rule-condition-migration",
        "priority": 4,
        "ruleCondition": {
          "action": "ALLOW",
          "condition": {
            "authority": {
              "authorityMatcher": {
                "pireRegexMatch": "example1|example2"
              }
            },
            "httpMethod": {
              "httpMethodMatcher": {
                "pireRegexMatch": "GET|POST"
              }
            },
            "fingerPrint": {
              "ja3Matcher": {
                "pireRegexMatch": "d4e5f6a7b8c9|a1b2c3d4e5f6"
              },
              "ja4Matcher": {
                "pireRegexMatch": "t13d1516h2_8daaf6152771|t13d1812h2_c73b8a5f9d24"
              }
            }
          }
        }
      }
    ]
  }'

Пример запроса с новыми полями для списков:

curl -X POST \
  'https://smartwebsecurity.api.cloud.yandex.net/smartwebsecurity/v1/securityProfiles' \
  -H "Authorization: Bearer $(yc iam create-token)" \
  -H 'Content-Type: application/json' \
  -d '{
    "folderId": "<идентификатор_каталога>",
    "name": "security-profile",
    "defaultAction": "ALLOW",
    "securityRules": [
      {
        "name": "rule-condition-new-lists",
        "priority": 5,
        "ruleCondition": {
          "action": "ALLOW",
          "condition": {
            "sourceIp": {
              "asnListsMatch": {
                "listIds": [
                  "<идентификатор_списка_1>",
                  "<идентификатор_списка_2>"
                ]
              },
              "asnListsNotMatch": {
                "listIds": [
                  "<идентификатор_списка_1>",
                  "<идентификатор_списка_2>"
                ]
              }
            },
            "authority": {
              "authorityMatcher": {
                "listsMatchers": {
                  "strListsMatch": {
                    "listIds": [
                      "<идентификатор_списка>"
                    ]
                  },
                  "strListsNotMatch": {
                    "listIds": [
                      "<идентификатор_списка>"
                    ]
                  },
                  "regExpListsMatch": {
                    "listIds": [
                      "<идентификатор_списка>"
                    ]
                  },
                  "regExpListsNotMatch": {
                    "listIds": [
                      "<идентификатор_списка>"
                    ]
                  }
                }
              }
            }
          }
        }
      }
    ]
  }'

Подробнее о методах в справочнике REST API: SecurityProfile.Create и SecurityProfile.Update для ресурса SecurityProfile.

Обновление формата условий в API, CLI и Terraform

Обновление существующих конфигураций

Формат описания условий

Обновление CLI

Примеры использования новых полей

См. также

Была ли статья полезна?

Обновление формата условий в API, CLI и Terraform

Обновление существующих конфигурацийОбновление существующих конфигураций

Формат описания условий {matching-format}Формат описания условий

Обновление CLIОбновление CLI

Примеры использования новых полейПримеры использования новых полей

См. такжеСм. также

Была ли статья полезна?

Обновление существующих конфигураций

Формат описания условий

Обновление CLI

Примеры использования новых полей

См. также