Spec-Zone.ru › AWS CLI v2

[ aws . wafv2 ]

get-web-acl

Описание

Извлекает указанный WebACL.

См. также: Документация по API AWS

Сводка

  get-web-acl
[--name <value>]
[--scope <value>]
[--id <value>]
[--arn <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--name (string)

Имя web ACL. Нельзя изменить имя web ACL после его создания.

--scope (string)

Указывает, относится ли это к глобальному типу ресурса, например, к дистрибутиву Amazon CloudFront. Для приложения Amplify используйте CLOUDFRONT.

Для работы с CloudFront необходимо также указать регион US East (N. Virginia) следующим образом:

  • CLI - Укажите регион при использовании области CloudFront: --scope=CLOUDFRONT --region=us-east-1.
  • API и SDK - Для всех вызовов используйте конечную точку региона us-east-1.

Возможные значения:

  • CLOUDFRONT
  • REGIONAL

--id (string)

Уникальный идентификатор для web ACL. Этот идентификатор возвращается в ответах на команды create и list. Вы предоставляете его для таких операций, как update и delete.

--arn (string)

Имя ресурса Amazon (ARN) web ACL, который вы хотите получить.

--cli-input-json | --cli-input-yaml (string) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передать произвольные двоичные значения с использованием значения, предоставленного JSON, поскольку строка будет восприниматься буквально. Это может быть не указано вместе с --cli-input-yaml.

--generate-cli-skeleton (string) Выводит скелет JSON в стандартный вывод без отправки запроса API. При предоставлении без значения или значения input выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, при предоставлении yaml-input он выведет пример входного YAML, который можно использовать с --cli-input-yaml. При предоставлении значения output он проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный скелет JSON не является стабильным между версиями AWS CLI, и в сгенерированном скелете JSON нет гарантий обратной совместимости.

Глобальные параметры

--debug (boolean)

Включить отладочное ведение журнала.

--endpoint-url (string)

Переопределить URL по умолчанию команды данным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии со службами AWS. Для каждого SSL-подключения AWS CLI будет проверять SSL-сертификаты. Эта опция переопределяет поведение по умолчанию при проверке SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическое разбиение на страницы. Если автоматическое разбиение на страницы отключено, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования выходных данных команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для использования при фильтрации данных ответа.

--profile (string)

Использовать конкретный профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки config/env.

--version (string)

Отображение версии этого инструмента.

--color (string)

Включить/выключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Пакет сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки config/env.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокироваться и не будет завершаться по таймауту. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокироваться и не будет завершаться по таймауту. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, который будет использоваться для двоичных больших объектов. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные большие объекты будут предоставлены в виде строки, закодированной в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое отображается на двоичный большой объект fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую, независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическую подсказку для параметров ввода CLI.

Примеры

Примечание

Чтобы использовать следующие примеры, у вас должна быть установлена и настроена AWS CLI. Дополнительные сведения см. в руководстве по началу работы в Руководстве пользователя AWS CLI .

Если не указано иное, все примеры имеют правила цитирования, похожие на unix. Эти примеры необходимо адаптировать к правилам цитирования вашего терминала. См. Использование кавычек со строками в Руководстве пользователя AWS CLI .

Для извлечения web ACL

Следующий get-web-acl извлекает web ACL с указанным именем, областью и идентификатором. Вы можете получить идентификатор для web ACL из команд create-web-acl и list-web-acls.

aws wafv2 get-web-acl \
    --name test01 \
    --scope REGIONAL \
    --id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Вывод:

{
    "WebACL":{
        "Capacity":3,
        "Description":"",
        "Rules":[
            {
                "Priority":1,
                "Action":{
                    "Block":{

                    }
                },
                "VisibilityConfig":{
                   "SampledRequestsEnabled":true,
                    "CloudWatchMetricsEnabled":true,
                    "MetricName":"testrule01"
                },
                "Name":"testrule01",
                "Statement":{
                    "AndStatement":{
                        "Statements":[
                            {
                                "ByteMatchStatement":{
                                    "PositionalConstraint":"EXACTLY",
                                    "TextTransformations":[
                                        {
                                            "Priority":0,
                                            "Type":"NONE"
                                        }
                                    ],
                                    "SearchString":"dGVzdHN0cmluZw==",
                                    "FieldToMatch":{
                                        "UriPath":{

                                        }
                                    }
                                }
                            },
                            {
                                "SizeConstraintStatement":{
                                    "ComparisonOperator":"EQ",
                                    "TextTransformations":[
                                        {
                                            "Priority":0,
                                            "Type":"NONE"
                                        }
                                    ],
                                    "FieldToMatch":{
                                        "QueryString":{

                                        }
                                    },
                                    "Size":0
                                }
                            }
                        ]
                    }
                }
            }
        ],
        "VisibilityConfig":{
            "SampledRequestsEnabled":true,
            "CloudWatchMetricsEnabled":true,
            "MetricName":"test01"
        },
        "DefaultAction":{
            "Allow":{

            }
        },
        "Id":"a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "ARN":"arn:aws:wafv2:us-west-2:123456789012:regional/webacl/test01/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "Name":"test01"
    },
    "LockToken":"e3db7e2c-d58b-4ee6-8346-6aec5511c6fb"
}

Для получения дополнительной информации см. Управление и использование списка управления доступом к сети (Web ACL) в Руководстве разработчика AWS WAF, AWS Firewall Manager и AWS Shield Advanced.

Output

WebACL -> (structure)

Спецификация WebACL. Вы можете изменить настройки в этом WebACL и использовать его для обновления этого WebACL или создания нового.

Name -> (string)

Имя WebACL. Вы не можете изменить имя WebACL после его создания.

Id -> (string)

Уникальный идентификатор для WebACL. Этот ID возвращается в ответах на команды create и list. Вы используете этот ID для таких действий, как получение, обновление и удаление WebACL.

ARN -> (string)

Имя ресурса Amazon (ARN) WebACL, который вы хотите связать с ресурсом.

DefaultAction -> (structure)

Действие, которое необходимо выполнить, если ни один из Rules, содержащихся в WebACL, не соответствует.

Block -> (structure)

Указывает, что WAF должен блокировать запросы по умолчанию.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

HTTP-код состояния для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылается на текст ответа, который вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия по умолчанию WebACL, которое установлено на блокировку. Для этого сначала определите ключ и значение текста ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию WebACL, настройке BlockAction, вы ссылаетесь на текст ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP, которые необходимо использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Указывает, что WAF должен разрешать запросы по умолчанию.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Description -> (string)

Описание WebACL, которое помогает с идентификацией.

Rules -> (list)

Операторы правил, используемые для идентификации веб-запросов, которыми вы хотите управлять. Каждое правило включает в себя один оператор верхнего уровня, который WAF использует для идентификации соответствующих веб-запросов, и параметры, которые определяют, как WAF обрабатывает их.

(structure)

Одно правило, которое можно использовать в WebACL или RuleGroup для идентификации веб-запросов, которыми вы хотите управлять тем или иным образом. Каждое правило включает в себя один оператор верхнего уровня, который WAF использует для идентификации соответствующих веб-запросов, и параметры, которые определяют, как WAF обрабатывает их.

Name -> (string)

Имя правила.

Если вы измените имя Rule после его создания и хотите, чтобы имя метрики правила отражало это изменение, обновите имя метрики в настройках VisibilityConfig правила. WAF не обновляет имя метрики автоматически при обновлении имени правила.

Priority -> (integer)

Если вы определите более одного Rule в WebACL, WAF оценивает каждый запрос в соответствии с Rules в порядке, основанном на значении Priority. WAF обрабатывает правила с более низким приоритетом в первую очередь. Приоритеты не обязательно должны быть последовательными, но все они должны быть разными.

Statement -> (structure)

Оператор обработки WAF для правила, например ByteMatchStatement или SizeConstraintStatement.

ByteMatchStatement -> (structure)

Оператор правила, который определяет поиск соответствия строк для WAF, который необходимо применить к веб-запросам. Оператор соответствия байтов предоставляет байты для поиска, местоположение в запросах, которые вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска обычно представляют собой строку, которая соответствует символам ASCII. В консоли WAF и руководстве для разработчиков это называется оператором соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF выполняет поиск только в той части веб-запросов, которую вы указываете для проверки в FieldToMatch. Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch:

  • Method: Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath: Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg.
  • JA3Fingerprint: Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. Эту опцию можно использовать только с ByteMatchStatement соответствия строк с установленным PositionalConstraint в EXACTLY. Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов WebACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журналов см. в разделе Поля журналов в Руководстве разработчика WAF.
  • HeaderOrder: Список имен заголовков для сопоставления. WAF создает строку, которая содержит упорядоченный список имен заголовков из заголовков в веб-запросе, а затем выполняет сопоставление с этой строкой.

Если SearchString включает буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете API WAF

Укажите версию значения, закодированную в base64. Максимальная длина значения перед кодированием base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER, а значение Data равно User-Agent. Если вы хотите выполнить поиск в заголовке User-Agent значения BadBot, вы кодируете BadBot с использованием MIME-кодирования base64 и включаете результирующее значение, QmFkQm90, в значение SearchString.

Если вы используете CLI или один из SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если размер тела превышает то, что WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — считайте веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считайте веб-запрос несоответствующим утверждению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения с использованием синтаксиса указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или и в том, и в другом. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим утверждению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для неверного JSON. Когда разбор завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если размер тела превышает то, что WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — считайте веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считайте веб-запрос несоответствующим утверждению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области видимости и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для определения подмножества заголовков для проверки в веб-запросе.

Необходимо указать только один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие — в значениях. Он требует, чтобы соответствие было найдено либо в ключах, либо в значениях, либо в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки чрезмерного размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверить файлы cookie запроса. Необходимо настроить фильтры области видимости и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie чрезмерного размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать только один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие — в значениях. Он требует, чтобы соответствие было найдено либо в ключах, либо в значениях, либо в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки чрезмерного размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления полей в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки чрезмерного размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот параметр можно использовать только с соответствием строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие варианты резервного поведения:

  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот параметр можно использовать только с соответствием строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие варианты резервного поведения:

  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверить фрагменты URI запроса. Необходимо настроить фильтры области видимости и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI чрезмерного размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

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

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString . Допустимые значения включают следующее:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString , но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString , а SearchString должен содержать только буквенно-цифровые символы или подчеркивания (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает истинность обоих следующих утверждений:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot .
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot; .
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString .

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмера следующие:

  • CONTINUE - Обычным образом проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки переразмера с настройками вашего правила и действий веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмера следующие:

  • CONTINUE - Обычным образом проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки переразмера с настройками вашего правила и действий веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого негабаритного содержимого заголовка в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (строка)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого негабаритного содержимого файлов cookie в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (строка)

Что должен делать WAF, если файлов cookie в запросе больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (структура)

Проверка фрагментов URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого негабаритного содержимого фрагмента URI в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценку содержимого только до первой ошибки синтаксического анализа, которую он встретит.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недопустимого JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполняет все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на атаки путем внедрения SQL-кода.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию о выявлении и смягчении ложных срабатываний см. в разделе Testing and tuning в Руководстве разработчика WAF .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак путем внедрения SQL-кода или имеют низкую толерантность к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (structure)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). При атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских скриптов в другие легитимные веб-браузеры.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (строка)

Что должен делать WAF, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (структура)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (список)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, значениях или и том, и другом. Чтобы требовать соответствия в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (строка)

Что должен делать WAF, если ему не удается полностью разобрать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недопустимого JSON. Когда синтаксический анализ успешен, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

OversizeHandling -> (строка)

Что должен делать WAF, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры для области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или и в том, и в другом. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры для области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или и в том, и в другом. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при отступлении:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при отступлении:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверка фрагментов URI запроса. Необходимо настроить фильтры для области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если он не может полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, которую он обнаружит.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может быть успешным даже для недопустимого JSON. Когда синтаксический анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой приоритетной настройки, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

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

SizeConstraintStatement -> (структура)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше чем (>) или меньше чем (<). Например, вы можете использовать оператор ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле запроса в пределах лимита для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать предел проверки, вы можете использовать оператор ограничения размера, чтобы блокировать запросы с большим размером тела запроса. Для получения дополнительной информации о лимитах проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI считается одним символом. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE - Проверять доступное содержимое тела запроса в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки переразмеров с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить origin.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Возможные варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, которую он обнаружит.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. Тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE - Проверять доступное содержимое тела запроса в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки переразмеров с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области действия и шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверять все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое — для проверки значений.

OversizeHandling -> (string)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области действия и шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверять все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое — для проверки значений.

OversizeHandling -> (string)

Что должен делать WAF, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонентов в своей проверке. WAF разделяет имена заголовков в строке с использованием двоеточий и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области действия и шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если он не может полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел Тело JSON в Руководстве разработчика WAF.

ComparisonOperator -> (string)

Оператор для использования при сравнении части запроса с параметром размера.

Размер -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе «Преобразования текста» в Руководстве разработчика WAF .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и который сопоставляет веб-запросы на основе кода страны. Правило сопоставления по географическому признаку помечает каждый проверяемый запрос независимо от того, находит ли оно совпадение.

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор отдельно и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes.
  • В противном случае настройте правило сопоставления по географическому признаку с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил сопоставления меток для запуска после правила сопоставления по географическому признаку и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя коды страны и региона альфа-2 из международного стандарта Международной организации по стандартизации (ISO) 3166. WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы укажете его, адрес в сопоставлении по географическому признаку ForwardedIPConfig.

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code>.

Если вы используете переадресованный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code>.

Для получения дополнительной информации см. оператор правила сопоставления по географическому признаку в Руководстве разработчика WAF.

CountryCodes -> (list)

Массив двухсимвольных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ], из кодов ISO альфа-2 стран международного стандарта ISO 3166.

Когда вы используете оператор сопоставления по географическому признаку только для меток региона и страны, которые он добавляет к запросам, вам все равно необходимо предоставить код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета совпадающих запросов, но оно все равно будет генерировать ведение журнала и метрики подсчета для любых совпадений. Вы можете уменьшить ведение журнала и метрики, которые создает правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, который следует использовать для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для этого значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус сопоставления, присваиваемый веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие режимы резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем предоставьте ARN группы правил в этом операторе.

Вы не можете вложить RuleGroupReferenceStatement, например, для использования внутри NotStatement или OrStatement. Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в web ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count.

Примечание

Вместо этого параметра используйте RuleActionOverrides. Он принимает любое допустимое значение действия, включая Count.

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count.

Примечание

Вместо этого параметра используйте RuleActionOverrides. Он принимает любое допустимое значение действия, включая Count.

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count.

RuleActionOverrides -> (list)

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

Примечание

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

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

(structure)

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

Примечание

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

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

Name -> (string)

Имя правила для переопределения.

Примечание

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

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб ACL настройка BlockAction , вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса с использованием оставшихся правил в web ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правила, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который определяет адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать набор IP, см. CreateIPSet.

Каждый оператор правила IP-набора ссылается на IP-набор. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Имя ресурса Amazon (ARN) набора IP, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, вместо использования IP-адреса, указанного источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP для использования для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси-серверы, через которые прошел запрос.

Параметры для этой настройки следующие:

  • FIRST - Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий с регулярными выражениями в компонентах веб-запроса. Чтобы использовать его, создайте RegexPatternSet, который определяет выражения, которые вы хотите обнаружить, а затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от своих правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверьте строку запроса. Это часть URL, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела превышает размер, который WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерного размера с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логический оператор AND для объединения двух правил сопоставления: одно для проверки ключей и другое для проверки значений.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела превышает размер, который WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерного размера с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверит и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Параметры для обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правила. Если указать ALL , WAF проверит и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого cookie в WAF.

Параметры для обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступных файлов cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Параметры для обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 представляет собой 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 представляет собой 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment , чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недействительного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе «Тело JSON» в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

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

RateBasedStatement -> (структура)

Правило на основе скорости подсчитывает входящие запросы и ограничивает запросы, когда они поступают слишком быстро. Правило классифицирует запросы в соответствии с вашими критериями агрегирования, собирает их в экземпляры агрегирования, а также подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в используемом в данный момент правиле, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия правила по ограничению скорости на срок до одной минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегирования, например IP-адрес и метод HTTP или метод HTTP, аргумент запроса и cookie.

Каждое уникальное сочетание значений для указанных вами ключей агрегирования представляет собой отдельный экземпляр агрегирования, причем значение каждого ключа вносит вклад в определение экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило создаст разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегирования является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • HTTP-метод POST: количество 2
    • HTTP-метод GET: количество 2
  • Если критерием агрегирования является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в комбинированный экземпляр агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любого n-кортежа ключей агрегирования каждое уникальное сочетание значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает по скорости индивидуально.

При необходимости вы можете вложить другое утверждение в утверждение на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только запросов, соответствующих вложенному утверждению. Вы можете использовать это вложенное утверждение для сужения области действия в сочетании со спецификациями ключа агрегирования, или вы можете просто подсчитывать и ограничивать скорость всех запросов, соответствующих утверждению для сужения области действия, без дополнительного агрегирования. Когда вы решите просто управлять всеми запросами, соответствующими утверждению для сужения области действия, экземпляр агрегирования является сингулярным для правила.

Вы не можете вложить RateBasedStatement внутри другого утверждения, например внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Для получения дополнительной информации об опциях см. раздел Ограничение скорости веб-запросов с использованием правил на основе скорости в Руководстве разработчика WAF .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, для которых WAF в настоящее время ограничивает скорость для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставите одни и те же параметры правила на основе скорости в двух веб-ACL, каждое из двух утверждений правила представляет собой отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление со стороны WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление со стороны WAF.

Limit -> (long)

Предел запросов в течение указанного окна оценки для одного экземпляра агрегирования для правила на основе скорости. Если утверждение на основе скорости включает в себя ScopeDownStatement , этот лимит применяется только к запросам, соответствующим утверждению.

Примеры:

  • Если вы агрегируете только по IP-адресу, это ограничение запросов с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это ограничение запросов для любой отдельной пары метод, город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в свои подсчеты запросов, оглядываясь назад от текущего времени. Например, для настройки 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые значения: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а определяет, как далеко назад он смотрит каждый раз, когда проверяет. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 минут)

AggregateKeyType -> (string)

Настройка, которая указывает, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте скорость запросов, соответствующих утверждению для сужения области действия правила на основе скорости. С этим параметром подсчитанные запросы не агрегируются далее. Используется только утверждение для сужения области действия. Когда количество всех запросов, удовлетворяющих утверждению для сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим утверждению для сужения области действия. С этим параметром необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. С этим параметром необходимо указать ключи агрегирования в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегирования IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы агрегировать по комбинации перенаправленного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать по комбинации IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .

ScopeDownStatement -> (structure)

Необязательное вложенное утверждение, которое сужает область веб-запросов, оцениваемых и управляемых утверждением на основе скорости. Когда вы используете утверждение для сужения области действия, правило на основе скорости отслеживает и ограничивает скорость только запросов, соответствующих утверждению для сужения области действия. Вы можете использовать любое вложенное Statement в утверждении для сужения области действия, и вы можете вкладывать утверждения на любом уровне, так же, как и для утверждения правила.

ByteMatchStatement -> (structure)

Утверждение правила, которое определяет поиск соответствия строк, который WAF применяет к веб-запросам. Утверждение соответствия байтам предоставляет байты для поиска, местоположение в запросах, которые вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска обычно представляют собой строку, которая соответствует символам ASCII. В консоли WAF и в руководстве для разработчиков это называется утверждением соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF ищет только в той части веб-запросов, которую вы указываете для проверки в FieldToMatch. Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с соответствием строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY . Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел Поля журнала в Руководстве разработчика WAF .
  • HeaderOrder : список имен заголовков для сопоставления. WAF создает строку, содержащую упорядоченный список имен заголовков, из заголовков в веб-запросе, а затем сопоставляет эту строку.

Если SearchString содержит буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете WAF API

Укажите версию значения в кодировке base64. Максимальная длина значения до его кодирования base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER , а значение Data равно User-Agent . Если вы хотите выполнить поиск в заголовке User-Agent значения BadBot , вы кодируете BadBot с использованием кодирования MIME base64 и включаете полученное значение, QmFkQm90 , в значение SearchString .

Если вы используете CLI или один из Amazon Web Services SDK

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить HTTP-метод. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL , WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое AND оператор для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки обычным способом в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое AND оператор для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie обычным способом в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки обычным способом в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагментов URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если этот параметр не указан, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого типа преобразования см. в разделе «Преобразования текста» в Руководстве разработчика WAF .

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString . Допустимые значения включают следующее:

СОДЕРЖИТ

Указанная часть веб-запроса должна включать значение SearchString , но местоположение не имеет значения.

СОДЕРЖИТ_СЛОВО

Указанная часть веб-запроса должна включать значение SearchString , а SearchString должен содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что верны оба следующих утверждения:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot .
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot; .
ТОЧНО

Значение указанной части веб-запроса должно точно соответствовать значению SearchString .

НАЧИНАЕТСЯ_С

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ЗАВЕРШАЕТСЯ_С

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы делать такие вещи, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как простой текст. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов с превышением размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверить доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов с превышением размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверить доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков большего размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Для этого требуется, чтобы совпадение было найдено в ключах, значениях или обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie большего размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Для этого требуется, чтобы совпадение было найдено в ключах, значениях или обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагментов URI большего размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, которую он обнаружит.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе Тело JSON в Руководстве разработчика WAF.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

SensitivityLevel -> (строка)

Чувствительность, которую вы хотите, чтобы WAF использовал для проверки на атаки типа SQL-инъекций.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию о выявлении и смягчении ложных срабатываний см. в разделе Testing and tuning в WAF Developer Guide .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другую защиту от атак типа SQL-инъекций или имеют низкую толерантность к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (структура)

Инструкция по правилам, которая проверяет наличие атак межсайтового скриптинга (XSS). В XSS-атаках злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских скриптов в другие легитимные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg.

QueryString -> (structure)

Проверьте строку запроса. Это часть URL, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмерности следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычным образом, в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки переразмерности с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения с помощью синтаксиса JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр, чтобы включить все пути. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение отката. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмерности следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычным образом, в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки переразмерности с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указано ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указано ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонентов при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором имеется достаточная информация TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement, для которого PositionalConstraint установлено в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» руководства разработчика WAF .

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (строка)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором имеется достаточная информация TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement, для которого PositionalConstraint установлено в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» руководства разработчика WAF .

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (строка)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверка фрагментов URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если этот параметр не указан, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в руководстве разработчика WAF .

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента FieldToMatch запроса перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с параметра с наименьшим приоритетом, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробное описание каждого типа преобразования см. в разделе Text transformations в Руководстве разработчика WAF.

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, вы можете использовать оператор ограничения размера, чтобы искать строки запроса, которые длиннее 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле до лимита для веб-ACL и типа защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера для блокировки запросов, размер тела которых больше. Для получения дополнительной информации об ограничениях проверки см. параметры Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI учитывается как один символ. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большего размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большего размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Совпадение со всеми элементами. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствие только указанным путям включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого негабаритного содержимого заголовка в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE — обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого негабаритного содержимого файлов cookie в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE — обычная проверка доступных файлов cookie в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим заявлению правила.

HeaderOrder -> (structure)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления полей при проверке. WAF разделяет имена заголовков в строке двоеточиями без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE — обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы она соответствовала любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы она соответствовала любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим заявлению правила.

UriFragment -> (structure)

Проверить фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого негабаритного содержимого фрагмента URI в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет поведение при отказе. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

ComparisonOperator -> (string)

The operator to use to compare the request part to the size setting.

Size -> (long)

The size, in byte, to compare to the request part, after any transformations.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

GeoMatchStatement -> (structure)

A rule statement that labels web requests by country and region and that matches against web requests based on country code. A geo match rule labels every request that it inspects regardless of whether it finds a match.

  • To manage requests only by country, you can use this statement by itself and specify the countries that you want to match against in the CountryCodes array.
  • Otherwise, configure your geo match rule with Count action so that it only labels requests. Then, add one or more label match rules to run after the geo match rule and configure them to match against the geographic labels and handle the requests as needed.

WAF labels requests using the alpha-2 country and region codes from the International Organization for Standardization (ISO) 3166 standard. WAF determines the codes using either the IP address in the web request origin or, if you specify it, the address in the geo match ForwardedIPConfig .

If you use the web request origin, the label formats are awswaf:clientip:geo:region:<ISO country code>-<ISO region code> and awswaf:clientip:geo:country:<ISO country code> .

If you use a forwarded IP address, the label formats are awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> and awswaf:forwardedip:geo:country:<ISO country code> .

For additional details, see Geographic match rule statement in the WAF Developer Guide .

CountryCodes -> (list)

An array of two-character country codes that you want to match against, for example, [ "US", "CN" ] , from the alpha-2 country ISO codes of the ISO 3166 international standard.

When you use a geo match statement just for the region and country labels that it adds to requests, you still have to supply a country code for the rule to evaluate. In this case, you configure the rule to only count matching requests, but it will still generate logging and count metrics for any matches. You can reduce the logging and metrics that the rule produces by specifying a country that’s unlikely to be a source of traffic to your site.

(string)

ForwardedIPConfig -> (structure)

The configuration for inspecting IP addresses in an HTTP header that you specify, instead of using the IP address that’s reported by the web request origin. Commonly, this is the X-Forwarded-For (XFF) header, but you can specify any header name.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

HeaderName -> (string)

The name of the HTTP header to use for the IP address. For example, to use the X-Forwarded-For (XFF) header, set this to X-Forwarded-For .

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

FallbackBehavior -> (string)

The match status to assign to the web request if the request doesn’t have a valid IP address in the specified position.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

You can specify the following fallback behaviors:

  • MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.
  • NO_MATCH - Treat the web request as not matching the rule statement.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Вы не можете вкладывать RuleGroupReferenceStatement, например, для использования внутри NotStatement или OrStatement. Нельзя использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в web ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, для которых действия установлены в Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любые действительные настройки действий, включая Count.

(structure)

Указывает отдельное правило в группе правил, действие которого вы хотите переопределить на Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любые действительные настройки действий, включая Count.

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count.

RuleActionOverrides -> (list)

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

Примечание

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

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(structure)

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

Примечание

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

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

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

ActionToUse -> (structure)

Действие переопределения, которое следует использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP, который следует вернуть клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Указывает на текст ответа, который вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение текста ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL BlockAction настройке, вы ссылаетесь на текст ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP, которые следует использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Инструкция правила, используемая для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этой инструкции. Чтобы создать набор IP, см. CreateIPSet.

Каждая инструкция правила набора IP ссылается на набор IP. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Имя ресурса Amazon (ARN) IPSet, на который ссылается эта инструкция.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующее поведение при отказе:

  • MATCH - Считать веб-запрос соответствующим инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим инструкции правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значением заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные — прокси-серверы, через которые прошел запрос.

Варианты этой настройки следующие:

  • FIRST - Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий в компонентах веб-запроса с использованием регулярных выражений. Чтобы использовать это, создайте RegexPatternSet, который определяет выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить в WAF.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF для проверки только содержимое, находящееся в пределах лимита.

  • Для Application Load Balancer и AppSync ограничение фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig для дополнительных сборов за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF для проверки только содержимое, находящееся в пределах лимита.

  • Для Application Load Balancer и AppSync ограничение фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig для дополнительных сборов за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки переразмеров с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF для проверки только содержимое, находящееся в пределах лимита.

  • Для Application Load Balancer и AppSync ограничение фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig для дополнительных сборов за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF для проверки только содержимое, находящееся в пределах лимита.

  • Для Application Load Balancer и AppSync ограничение фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig для дополнительных сборов за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки переразмеров с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например, host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для недопустимого JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого типа преобразований см. в разделе Text transformations in the WAF Developer Guide .

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает их скорость, когда они поступают слишком быстро. Правило классифицирует запросы в соответствии с вашими критериями агрегирования, собирает их в экземпляры агрегирования и подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в правиле, которое в настоящее время используется, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия правила по ограничению скорости на срок до одной минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегирования, такие как IP-адрес и метод HTTP или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для указанных вами ключей агрегирования является отдельным экземпляром агрегирования, при этом значение каждого ключа вносит вклад в определение экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило будет создавать разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегирования является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: количество 2
    • Метод HTTP GET: количество 2
  • Если критерием агрегирования является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в объединенный экземпляр агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любого n-кортежа ключей агрегирования каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает по скорости индивидуально.

При желании вы можете вложить другой оператор внутри оператора на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только запросов, соответствующих вложенному оператору. Вы можете использовать этот вложенный оператор уменьшения области действия вместе со спецификациями ключа агрегирования или просто подсчитывать и ограничивать скорость всех запросов, соответствующих оператору уменьшения области действия, без дополнительного агрегирования. Когда вы решите просто управлять всеми запросами, которые соответствуют оператору уменьшения области действия, экземпляр агрегирования является единственным для правила.

Нельзя вкладывать RateBasedStatement внутри другого оператора, например, внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Дополнительную информацию об опциях см. в разделе Rate limiting web requests using rate-based rules в WAF Developer Guide .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, для которых WAF в настоящее время ограничивает скорость для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Этот параметр недоступен для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставите одни и те же настройки правила на основе скорости в двух веб-ACL, каждый из двух операторов правила представляет отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление со стороны WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление со стороны WAF.

Limit -> (long)

Предел запросов в течение указанного окна оценки для одного экземпляра агрегирования для правила на основе скорости. Если оператор на основе скорости включает в себя ScopeDownStatement , этот предел применяется только к запросам, соответствующим оператору.

Примеры:

  • Если вы агрегируете только по IP-адресу, это предел запросов с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это предел запросов для любой одной пары метод-город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в подсчет запросов, заглядывая назад от текущего времени. Например, при настройке 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые значения: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а то, как далеко назад он смотрит при каждой проверке. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 минут)

AggregateKeyType -> (string)

Настройка, указывающая, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывать и ограничивать запросы, соответствующие оператору уменьшения области действия правила на основе скорости. При использовании этого параметра подсчитываемые запросы не подвергаются дальнейшему агрегированию. Оператор уменьшения области действия является единственной используемой спецификацией. Когда количество всех запросов, удовлетворяющих оператору уменьшения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим оператору уменьшения области действия. С этим параметром необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегировать количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. С этим параметром необходимо указать ключи агрегирования в свойстве CustomKeys . Чтобы выполнить агрегирование только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегирования в IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегировать количество запросов по первому IP-адресу в заголовке HTTP. С этим параметром необходимо указать заголовок, который нужно использовать, в свойстве ForwardedIPConfig . Чтобы выполнить агрегирование по комбинации перенаправленного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .
  • IP - Агрегировать количество запросов по IP-адресу из источника веб-запроса. Чтобы выполнить агрегирование по комбинации IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в заголовке HTTP, который вы указываете, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (string)

Имя заголовка HTTP, который нужно использовать для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

CustomKeys -> (list)

Задает агрегированные ключи для использования в правиле на основе скорости.

(структура)

Задает один пользовательский агрегированный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правил на основе скорости.

Заголовок -> (структура)

Используйте значение заголовка в запросе в качестве агрегированного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегирования. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Имя -> (string)

Имя заголовка для использования.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве агрегированного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегирования. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Имя -> (string)

Имя cookie для использования.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве агрегированного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегирования. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Имя -> (string)

Имя аргумента запроса для использования.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

QueryString -> (structure)

Используйте строку запроса запроса в качестве агрегированного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегирования. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

HTTPMethod -> (structure)

Используйте метод HTTP запроса в качестве агрегированного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегирования. Если вы используете только метод HTTP в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегирования.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве агрегированного ключа. Каждый отдельный перенаправленный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете выполнять агрегирование только по перенаправленному IP-адресу, указав FORWARDED_IP в AggregateKeyType вашего правила на основе скорости.

С помощью этой опции вы должны указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве агрегированного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете выполнять агрегирование только по IP-адресу, указав IP в AggregateKeyType вашего правила на основе скорости.

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве агрегированного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегирования. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегирования.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

For information about label namespaces and names, see Label syntax and naming requirements in the WAF Developer Guide .

Namespace -> (string)

Пространство имен для использования для агрегирования.

UriPath -> (structure)

Используйте путь URI запроса в качестве агрегированного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегирования. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

JA3Fingerprint -> (structure)

Используйте отпечаток пальца JA3 запроса в качестве агрегированного ключа. Если вы используете один отпечаток пальца JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия, назначаемый веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка пальца JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.
  • NO_MATCH - Treat the web request as not matching the rule statement.

JA4Fingerprint -> (structure)

Use the request’s JA4 fingerprint as an aggregate key. If you use a single JA4 fingerprint as your custom key, then each value fully defines an aggregation instance.

FallbackBehavior -> (string)

The match status to assign to the web request if there is insufficient TSL Client Hello information to compute the JA4 fingerprint.

You can specify the following fallback behaviors:

  • MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.
  • NO_MATCH - Treat the web request as not matching the rule statement.

AndStatement -> (structure)

A logical rule statement used to combine other rule statements with AND logic. You provide more than one Statement within the AndStatement .

Statements -> (list)

The statements to combine with AND logic. You can use any statements that can be nested.

( … recursive … )

OrStatement -> (structure)

A logical rule statement used to combine other rule statements with OR logic. You provide more than one Statement within the OrStatement .

Statements -> (list)

The statements to combine with OR logic. You can use any statements that can be nested.

( … recursive … )

NotStatement -> (structure)

A logical rule statement used to negate the results of another rule statement. You provide one Statement within the NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

A rule statement used to run the rules that are defined in a managed rule group. To use this, provide the vendor name and the name of the rule group in this statement. You can retrieve the required names by calling ListAvailableManagedRuleGroups .

You cannot nest a ManagedRuleGroupStatement , for example for use inside a NotStatement or OrStatement . You cannot use a managed rule group inside another rule group. You can only reference a managed rule group as a top-level statement within a rule that you define in a web ACL.

Note

You are charged additional fees when you use the WAF Bot Control managed rule group AWSManagedRulesBotControlRuleSet , the WAF Fraud Control account takeover prevention (ATP) managed rule group AWSManagedRulesATPRuleSet , or the WAF Fraud Control account creation fraud prevention (ACFP) managed rule group AWSManagedRulesACFPRuleSet . For more information, see WAF Pricing .

VendorName -> (string)

The name of the managed rule group vendor. You use this, along with the rule group name, to identify a rule group.

Name -> (string)

The name of the managed rule group. You use this, along with the vendor name, to identify the rule group.

Version -> (string)

The version of the managed rule group to use. If you specify this, the version setting is fixed until you change it. If you don’t specify this, WAF uses the vendor’s default version, and then keeps the version at the vendor’s default when the vendor updates the managed rule group settings.

ExcludedRules -> (list)

Rules in the referenced rule group whose actions are set to Count .

Note

Instead of this option, use RuleActionOverrides . It accepts any valid action setting, including Count .

(structure)

Specifies a single rule in a rule group whose action you want to override to Count .

Note

Instead of this option, use RuleActionOverrides . It accepts any valid action setting, including Count .

Name -> (string)

The name of the rule whose action you want to override to Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Additional information that’s used by a managed rule group. Many managed rule groups don’t require this.

The rule groups used for intelligent threat mitigation require additional configuration:

  • Use the AWSManagedRulesACFPRuleSet configuration object to configure the account creation fraud prevention managed rule group. The configuration includes the registration and sign-up pages of your application and the locations in the account creation request payload of data, such as the user email and phone number fields.
  • Use the AWSManagedRulesATPRuleSet configuration object to configure the account takeover prevention managed rule group. The configuration includes the sign-in page of your application and the locations in the login request payload of data such as the username and password.
  • Use the AWSManagedRulesBotControlRuleSet configuration object to configure the protection level that you want the Bot Control rule group to use.

(structure)

Additional information that’s used by a managed rule group. Many managed rule groups don’t require this.

The rule groups used for intelligent threat mitigation require additional configuration:

  • Use the AWSManagedRulesACFPRuleSet configuration object to configure the account creation fraud prevention managed rule group. The configuration includes the registration and sign-up pages of your application and the locations in the account creation request payload of data, such as the user email and phone number fields.
  • Use the AWSManagedRulesATPRuleSet configuration object to configure the account takeover prevention managed rule group. The configuration includes the sign-in page of your application and the locations in the login request payload of data such as the username and password.
  • Use the AWSManagedRulesBotControlRuleSet configuration object to configure the protection level that you want the Bot Control rule group to use.

For example specifications, see the examples section of CreateWebACL .

LoginPath -> (string)

Note

Instead of this setting, provide your configuration under AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Note

Instead of this setting, provide your configuration under the request inspection configuration for AWSManagedRulesATPRuleSet or AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Note

Instead of this setting, provide your configuration under the request inspection configuration for AWSManagedRulesATPRuleSet or AWSManagedRulesACFPRuleSet .

Identifier -> (string)

The name of the username field.

How you specify this depends on the request inspection payload type.

  • For JSON payloads, specify the field name in JSON pointer syntax. For information about the JSON Pointer syntax, see the Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "username": "THE_USERNAME" } } , the username field specification is /form/username .
  • For form encoded payload types, use the HTML form names. For example, for an HTML form with the input element named username1 , the username field specification is username1

PasswordField -> (structure)

Note

Instead of this setting, provide your configuration under the request inspection configuration for AWSManagedRulesATPRuleSet or AWSManagedRulesACFPRuleSet .

Identifier -> (string)

The name of the password field.

How you specify this depends on the request inspection payload type.

  • For JSON payloads, specify the field name in JSON pointer syntax. For information about the JSON Pointer syntax, see the Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "password": "THE_PASSWORD" } } , the password field specification is /form/password .
  • For form encoded payload types, use the HTML form names. For example, for an HTML form with the input element named password1 , the password field specification is password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Additional configuration for using the Bot Control managed rule group. Use this to specify the inspection level that you want to use. For information about using the Bot Control managed rule group, see WAF Bot Control rule group and WAF Bot Control in the WAF Developer Guide .

InspectionLevel -> (string)

The inspection level to use for the Bot Control rule group. The common level is the least expensive. The targeted level includes all common level rules and adds rules with more advanced inspection criteria. For details, see WAF Bot Control rule group in the WAF Developer Guide .

EnableMachineLearning -> (boolean)

Applies only to the targeted inspection level.

Determines whether to use machine learning (ML) to analyze your web traffic for bot-related activity. Machine learning is required for the Bot Control rules TGT_ML_CoordinatedActivityLow and TGT_ML_CoordinatedActivityMedium , which inspect for anomalous behavior that might indicate distributed, coordinated bot activity.

For more information about this choice, see the listing for these rules in the table at Bot Control rules listing in the WAF Developer Guide .

Default: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это для предоставления информации о запросе на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы входа.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в Руководстве разработчика WAF .

LoginPath -> (string)

Путь к конечной точке входа в ваше приложение. Например, для URL https://example.com/web/login вы предоставите путь /web/login . Пути входа, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов входа, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа, либо JSON, либо с кодировкой формы.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля — password1 .

Identifier -> (string)

Имя поля пароля.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля — password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа в систему клиентом, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от клиентских сессий и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка, с которым нужно выполнить сопоставление. Имя должно точно соответствовать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, строка может быть в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно выполнить сопоставление в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетных записей (ACFP), AWSManagedRulesACFPRuleSet . Используйте это, чтобы предоставить информацию о запросе на создание учетной записи в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив отвечает на запросы на создание учетных записей.

Информацию об использовании управляемой группы правил ACFP см. в разделе WAF Fraud Control предотвращение мошенничества при создании учетных записей (ACFP) группы правил и WAF Fraud Control предотвращение мошенничества при создании учетных записей (ACFP) в Руководстве разработчика WAF .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница вашего веб-сайта, которая принимает заполненную регистрационную форму для нового пользователя. Эта страница должна принимать запросы POST.

Например, для URL-адреса https://example.com/web/newaccount вы предоставите путь /web/newaccount. Пути к страницам создания учетных записей, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетных записей /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница вашего веб-сайта, на которой форма регистрации представлена новым пользователям.

Примечание

Эта страница должна принимать запросы GET text/html.

Например, для URL-адреса https://example.com/web/registration вы предоставите путь /web/registration. Пути к страницам регистрации, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или закодированная форма.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1 .

Identifier -> (string)

Имя поля пароля.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1 .

EmailField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего адрес электронной почты вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 спецификация поля электронной почты — email1 .

Identifier -> (string)

Имя поля электронной почты.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 спецификация поля электронной почты — email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного номера телефона.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного адреса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответов доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентом, подсчитывая успешные и неудачные попытки с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от клиентских сеансов и IP-адресов, которые имели слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно точно соответствовать, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] and "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] and "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] and "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно сопоставить в JSON. Идентификатор должен точно соответствовать, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] and "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие показатели подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(structure)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие показатели подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

For a list of status codes that you can use in your custom responses, see Supported status codes for custom response in the WAF Developer Guide .

CustomResponseBodyKey -> (string)

References the response body that you want WAF to return to the web request client. You can define a custom response for a rule action or a default web ACL action that is set to block. To do this, you first define the response body key and value in the CustomResponseBodies setting for the WebACL or RuleGroup where you want to use it. Then, in the rule action or web ACL default action BlockAction setting, you reference the response body using this key.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Повторяющиеся имена заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Повторяющиеся имена заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса с использованием оставшихся правил в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Повторяющиеся имена заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA по веб-запросу.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Повторяющиеся имена заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge по веб-запросу.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка Challenge определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Повторяющиеся имена заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, добавленными к веб-запросу правилами, которые уже были запущены в веб-ACL.

Оператор соответствия меткам предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю строку полного имени метки, которая была добавлена к веб-запросу. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, которое добавило метку. Если вы не предоставите полное имя в строке соответствия метке, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор соответствия меткам.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора соответствия:

  • Если Scope указывает LABEL , то эта спецификация должна включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс, вплоть до предоставления полного имени метки.
  • Если Scope указывает NAMESPACE , то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, а компоненты метки должны разделяться двоеточием, например NS1:NS2:name .

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую WAF должен проверить.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, идентифицирующая ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурсов в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурсов в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурсов в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Необходимо указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Необходимо указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если он не может полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет поведение резервного копирования. Для получения дополнительной информации см. body JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурсов в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Вы должны указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, соответствующие критериям проверки правила. Если вы укажете ALL, WAF проверит и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах и соответствие было найдено в значениях. Требуется совпадение в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie, соответствующие критериям проверки правила. Если вы укажете ALL, WAF проверит и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах и соответствие было найдено в значениях. Требуется совпадение в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние сопоставления, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние сопоставления, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагментов URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным контентом, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

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

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы укажете перенаправленный IP-адрес в параметрах ключа агрегирования правила.

HeaderName -> (string)

Имя заголовка HTTP, который следует использовать для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние сопоставления, которое следует присвоить веб-запросу, если запрос не содержит допустимый IP-адрес в указанном положении.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

CustomKeys -> (list)

Указывает агрегированные ключи для использования в правиле на основе скорости.

(структура)

Указывает один пользовательский агрегированный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, опускаются из оценки и обработки правила на основе скорости.

Заголовок -> (структура)

Используйте значение заголовка в запросе в качестве агрегированного ключа. Каждое отдельное значение в заголовке способствует экземпляру агрегирования. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Имя -> (строка)

Имя используемого заголовка.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

Cookie -> (структура)

Используйте значение cookie в запросе в качестве агрегированного ключа. Каждое отдельное значение в cookie способствует экземпляру агрегирования. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Имя -> (строка)

Имя используемого cookie.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

QueryArgument -> (структура)

Используйте указанный аргумент запроса в качестве агрегированного ключа. Каждое отдельное значение для именованного аргумента запроса способствует экземпляру агрегирования. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Имя -> (строка)

Имя используемого аргумента запроса.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

QueryString -> (структура)

Используйте строку запроса запроса в качестве агрегированного ключа. Каждая отдельная строка способствует экземпляру агрегирования. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегирования.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

HTTPMethod -> (структура)

Используйте метод HTTP запроса в качестве агрегированного ключа. Каждый отдельный метод HTTP способствует экземпляру агрегирования. Если вы используете только метод HTTP в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегирования.

ForwardedIP -> (структура)

Используйте первый IP-адрес в заголовке HTTP в качестве агрегированного ключа. Каждый отдельный переадресованный IP-адрес способствует экземпляру агрегирования.

Когда вы указываете IP-адрес или переадресованный IP-адрес в настройках пользовательского ключа, вы также должны указать по крайней мере еще один ключ для использования. Вы можете агрегировать только по переадресованному IP-адресу, указав FORWARDED_IP в AggregateKeyType вашего правила на основе скорости.

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

IP -> (структура)

Используйте исходный IP-адрес запроса в качестве агрегированного ключа. Каждый отдельный IP-адрес способствует экземпляру агрегирования.

Когда вы указываете IP-адрес или переадресованный IP-адрес в настройках пользовательского ключа, вы также должны указать по крайней мере еще один ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в AggregateKeyType вашего правила на основе скорости.

LabelNamespace -> (структура)

Используйте указанное пространство имен метки в качестве агрегированного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, способствует экземпляру агрегирования. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегирования.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

Информацию о пространствах имен и именах меток см. в разделе Label syntax and naming requirements в WAF Developer Guide .

Namespace -> (строка)

Пространство имен для использования при агрегировании.

UriPath -> (структура)

Используйте путь URI запроса в качестве агрегированного ключа. Каждый отдельный путь URI способствует экземпляру агрегирования. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегирования.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

JA3Fingerprint -> (структура)

Используйте отпечаток JA3 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (строка)

Состояние соответствия, которое необходимо назначить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие резервные варианты:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Используйте отпечаток пальца JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток пальца JA4 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия для назначения веб-запросу, если недостаточно информации TLS Client Hello для вычисления отпечатка пальца JA4.

Вы можете указать следующие fallback-поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логическое утверждение правила, используемое для объединения других утверждений правила с логикой AND. Вы предоставляете более одного Statement внутри AndStatement .

Statements -> (list)

Утверждения для объединения с логикой AND. Вы можете использовать любые утверждения, которые могут быть вложенными.

(structure)

Руководство по обработке для Rule, используемое WAF для определения соответствия веб-запроса правилу.

Например, спецификации см. в разделе примеров CreateWebACL.

ByteMatchStatement -> (structure)

Оператор правила, который определяет поиск соответствия строки для WAF для применения к веб-запросам. Оператор соответствия байтов предоставляет байты для поиска, местоположение в запросах, которые вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска, как правило, представляют собой строку, которая соответствует символам ASCII. В консоли WAF и руководстве для разработчиков это называется оператором соответствия строки.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF ищет только в той части веб-запросов, которую вы указываете для проверки в FieldToMatch. Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : HTTP-метод, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY . Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. Log fields в WAF Developer Guide .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, которая содержит упорядоченный список имен заголовков из заголовков в веб-запросе, а затем сопоставляет ее с этой строкой.

Если SearchString содержит буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете API WAF

Укажите версию значения, закодированную в base64. Максимальная длина значения перед кодированием base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER , а значение Data равно User-Agent . Если вы хотите выполнить поиск в заголовке User-Agent для значения BadBot , вы кодируете BadBot в base64, используя кодирование MIME base64, и включаете полученное значение, QmFkQm90 , в значение SearchString .

Если вы используете CLI или один из пакетов SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение в base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

В качестве альтернативы, вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов превышающие размер, см. в конфигурации объекта Body.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (структура)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов превышающие размер, см. в конфигурации объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (список)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (строка)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки большого размера следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie.

Варианты обработки большого размера следующие:

  • CONTINUE - Обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для соответствия в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки большого размера следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancer. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при отмене:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancer. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при отмене:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

UriFragment -> (структура)

Проверить фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недопустимого JSON. Когда анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе «Тело JSON» в Руководстве разработчика WAF.

Преобразования текста -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

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

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF выполнял поиск SearchString. Допустимые значения включают следующие:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString, но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString, а SearchString должен содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что верны оба следующих условия:

  • SearchString находится в начале указанной части веб-запроса или предшествует символу, отличному от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot.
  • SearchString находится в конце указанной части веб-запроса или после него следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot;.
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString.

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного кода SQL. Злоумышленники вставляют вредоносный код SQL в веб-запросы, чтобы делать такие вещи, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

В качестве альтернативы вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверка всех аргументов запроса.

UriPath -> (структура)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса следует сразу после заголовков запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов нестандартного размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Доступны следующие варианты обработки нестандартных размеров:

  • CONTINUE - Проверьте доступное содержимое тела обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки нестандартных размеров с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка HTTP-метода. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу после заголовков запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов нестандартного размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. body JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Доступны следующие варианты обработки нестандартных размеров:

  • CONTINUE - Проверьте доступное содержимое тела обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки нестандартных размеров с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правил.

Cookies -> (structure)

Проверить файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правил.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правил.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях журнала см. в разделе Log fields в WAF Developer Guide.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка пальца JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правил.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях журнала см. в разделе Log fields в WAF Developer Guide.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка пальца JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правил.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правил.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе JSON body в WAF Developer Guide.

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на предмет атак типа SQL injection.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию об идентификации и смягчении ложных срабатываний см. в разделе Testing and tuning в WAF Developer Guide .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак типа SQL injection или которые имеют низкую толерантность к ложным срабатываниям.

Default: LOW

XssMatchStatement -> (structure)

Инструкция по правилу, которое проверяет наличие атак межсайтового скриптинга (XSS). В XSS-атаках злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства внедрения вредоносных клиентских сценариев в другие законные веб-браузеры.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела превышает возможности WAF по проверке.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает для выполнения источником.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью параметра MatchPattern. Если указать параметр ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью разобрать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполняет синтаксический анализ и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела превышает возможности WAF по проверке.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части заголовков, которые необходимо сопоставить с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы потребовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей и другое для проверки значений.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритных данных следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части файлов cookie, которые необходимо проверить с помощью критериев проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы потребовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей и другое для проверки значений.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки негабаритных данных следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве поля для соответствия компоненту в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритных данных следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с установленным значением PositionalConstraint равным EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет отпечатка пальца JA3.

Можно указать следующие резервные режимы:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с установленным значением PositionalConstraint равным EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет отпечатка пальца JA4.

Можно указать следующие резервные режимы:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста —> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, вы можете использовать оператор ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF будет проверять только количество байтов в теле до предела для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать предел проверки, вы можете использовать оператор ограничения размера, чтобы блокировать запросы с большим размером тела запроса. Для получения дополнительной информации об ограничениях проверки см. Body и JsonBody параметры для FieldToMatch типа данных.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI будет учитываться как один символ. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью Headers FieldToMatch параметра.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковая имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверить доступное содержимое тела обычным способом, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить origin.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Соответствует всем элементам. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Соответствует только указанным путям включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF будет соответствовать ключам и значениям.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое AND выражение для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он сталкивается.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недействительного JSON. Когда анализ завершается успешно, WAF не применяет поведение fallback. Для получения дополнительной информации см. тело JSON в WAF Developer Guide .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверить доступное содержимое тела обычным способом, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers , чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого заголовков, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All , IncludedHeaders или ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, соответствующие критериям проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется соответствие в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies или ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie, которые необходимо проверить в соответствии с критериями проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется соответствие в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie в запросе больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверка фрагментов URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment , чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого фрагмента URI, превышающего размер, в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью обработать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если этот параметр не указан, WAF обрабатывает и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

ComparisonOperator -> (string)

Оператор для сравнения части запроса с параметром размера.

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой приоритетной настройки, а затем использует содержимое преобразованного компонента.

(structure)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

GeoMatchStatement -> (structure)

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

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор сам по себе и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes .
  • В противном случае настройте правило гео-соответствия с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам для запуска после правила гео-соответствия и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухбуквенные коды страны и региона из международного стандарта International Organization for Standardization (ISO) 3166. WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в гео-соответствии ForwardedIPConfig .

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете переадресованный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Для получения дополнительных сведений см. Geographic match rule statement в WAF Developer Guide .

CountryCodes -> (list)

Массив двухсимвольных кодов стран, с которыми вы хотите сопоставить, например [ "US", "CN" ] , из двухбуквенных кодов стран ISO международного стандарта ISO 3166.

Когда вы используете оператор гео-соответствия только для меток региона и страны, которые он добавляет к запросам, вам все равно придется указать код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно все равно будет генерировать журналы и метрики подсчета для любых совпадений. Вы можете уменьшить объем ведения журнала и метрик, которые создает правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, а не использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Note

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Note

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое следует присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Note

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, затем укажите ARN группы правил в этом операторе.

Нельзя вкладывать RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Нельзя использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня внутри правила, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в указанной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(structure)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блок. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL в настройке BlockAction , вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правил, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать IP-набор, см. CreateIPSet.

Каждый оператор правила IP-набора ссылается на IP-набор. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Amazon Resource Name (ARN) IPSet, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка, который следует использовать для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое нужно присвоить веб-запросу, если в запросе нет допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные — прокси-серверы, через которые прошел запрос.

Варианты этой настройки следующие:

  • FIRST — Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST — Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY — Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий в компонентах веб-запроса с использованием регулярных выражений. Чтобы использовать это, создайте RegexPatternSet, который определяет выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки большого размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка метода HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы потребовать совпадение в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF будет анализировать и оценивать контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе JSON body в WAF Developer Guide .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки большого размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Вы должны настроить фильтры соответствия области и шаблону в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Он требует нахождения совпадения в ключах или значениях, или и в том и в другом. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND, чтобы объединить два правила соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверить файлы cookie запроса. Вы должны настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правил. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Он требует нахождения совпадения в ключах или значениях, или и в том и в другом. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND, чтобы объединить два правила соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено значение EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует назначить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено значение EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует назначить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для недействительного JSON. Когда синтаксический анализ прошел успешно, WAF не применяет поведение при отказе. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

RateBasedStatement -> (structure)

A rate-based rule counts incoming requests and rate limits requests when they are coming at too fast a rate. The rule categorizes requests according to your aggregation criteria, collects them into aggregation instances, and counts and rate limits the requests for each instance.

Note

If you change any of these settings in a rule that’s currently in use, the change resets the rule’s rate limiting counts. This can pause the rule’s rate limiting activities for up to a minute.

You can specify individual aggregation keys, like IP address or HTTP method. You can also specify aggregation key combinations, like IP address and HTTP method, or HTTP method, query argument, and cookie.

Each unique set of values for the aggregation keys that you specify is a separate aggregation instance, with the value from each key contributing to the aggregation instance definition.

For example, assume the rule evaluates web requests with the following IP address and HTTP method values:

  • IP address 10.1.1.1, HTTP method POST
  • IP address 10.1.1.1, HTTP method GET
  • IP address 127.0.0.0, HTTP method POST
  • IP address 10.1.1.1, HTTP method GET

The rule would create different aggregation instances according to your aggregation criteria, for example:

  • If the aggregation criteria is just the IP address, then each individual address is an aggregation instance, and WAF counts requests separately for each. The aggregation instances and request counts for our example would be the following:
    • IP address 10.1.1.1: count 3
    • IP address 127.0.0.0: count 1
  • If the aggregation criteria is HTTP method, then each individual HTTP method is an aggregation instance. The aggregation instances and request counts for our example would be the following:
    • HTTP method POST: count 2
    • HTTP method GET: count 2
  • If the aggregation criteria is IP address and HTTP method, then each IP address and each HTTP method would contribute to the combined aggregation instance. The aggregation instances and request counts for our example would be the following:
    • IP address 10.1.1.1, HTTP method POST: count 1
    • IP address 10.1.1.1, HTTP method GET: count 2
    • IP address 127.0.0.0, HTTP method POST: count 1

For any n-tuple of aggregation keys, each unique combination of values for the keys defines a separate aggregation instance, which WAF counts and rate-limits individually.

You can optionally nest another statement inside the rate-based statement, to narrow the scope of the rule so that it only counts and rate limits requests that match the nested statement. You can use this nested scope-down statement in conjunction with your aggregation key specifications or you can just count and rate limit all requests that match the scope-down statement, without additional aggregation. When you choose to just manage all requests that match a scope-down statement, the aggregation instance is singular for the rule.

You cannot nest a RateBasedStatement inside another statement, for example inside a NotStatement or OrStatement . You can define a RateBasedStatement inside a web ACL and inside a rule group.

For additional information about the options, see Rate limiting web requests using rate-based rules in the WAF Developer Guide .

If you only aggregate on the individual IP address or forwarded IP address, you can retrieve the list of IP addresses that WAF is currently rate limiting for a rule through the API call GetRateBasedStatementManagedKeys . This option is not available for other aggregation configurations.

WAF tracks and manages web requests separately for each instance of a rate-based rule that you use. For example, if you provide the same rate-based rule settings in two web ACLs, each of the two rule statements represents a separate instance of the rate-based rule and gets its own tracking and management by WAF. If you define a rate-based rule inside a rule group, and then use that rule group in multiple places, each use creates a separate instance of the rate-based rule that gets its own tracking and management by WAF.

Limit -> (long)

The limit on requests during the specified evaluation window for a single aggregation instance for the rate-based rule. If the rate-based statement includes a ScopeDownStatement , this limit is applied only to the requests that match the statement.

Examples:

  • If you aggregate on just the IP address, this is the limit on requests from any single IP address.
  • If you aggregate on the HTTP method and the query argument name “city”, then this is the limit on requests for any single method, city pair.

EvaluationWindowSec -> (long)

The amount of time, in seconds, that WAF should include in its request counts, looking back from the current time. For example, for a setting of 120, when WAF checks the rate, it counts the requests for the 2 minutes immediately preceding the current time. Valid settings are 60, 120, 300, and 600.

This setting doesn’t determine how often WAF checks the rate, but how far back it looks each time it checks. WAF checks the rate about every 10 seconds.

Default: 300 (5 minutes)

AggregateKeyType -> (string)

Setting that indicates how to aggregate the request counts.

Note

Web requests that are missing any of the components specified in the aggregation keys are omitted from the rate-based rule evaluation and handling.
  • CONSTANT - Count and limit the requests that match the rate-based rule’s scope-down statement. With this option, the counted requests aren’t further aggregated. The scope-down statement is the only specification used. When the count of all requests that satisfy the scope-down statement goes over the limit, WAF applies the rule action to all requests that satisfy the scope-down statement. With this option, you must configure the ScopeDownStatement property.
  • CUSTOM_KEYS - Aggregate the request counts using one or more web request components as the aggregate keys. With this option, you must specify the aggregate keys in the CustomKeys property. To aggregate on only the IP address or only the forwarded IP address, don’t use custom keys. Instead, set the aggregate key type to IP or FORWARDED_IP .
  • FORWARDED_IP - Aggregate the request counts on the first IP address in an HTTP header. With this option, you must specify the header to use in the ForwardedIPConfig property. To aggregate on a combination of the forwarded IP address with other aggregate keys, use CUSTOM_KEYS .
  • IP - Aggregate the request counts on the IP address from the web request origin. To aggregate on a combination of the IP address with other aggregate keys, use CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

The configuration for inspecting IP addresses in an HTTP header that you specify, instead of using the IP address that’s reported by the web request origin. Commonly, this is the X-Forwarded-For (XFF) header, but you can specify any header name.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

This is required if you specify a forwarded IP in the rule’s aggregate key settings.

HeaderName -> (string)

The name of the HTTP header to use for the IP address. For example, to use the X-Forwarded-For (XFF) header, set this to X-Forwarded-For .

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

FallbackBehavior -> (string)

The match status to assign to the web request if the request doesn’t have a valid IP address in the specified position.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

You can specify the following fallback behaviors:

  • MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.
  • NO_MATCH - Treat the web request as not matching the rule statement.

CustomKeys -> (list)

Указывает совокупные ключи для использования в правиле на основе скорости.

(structure)

Указывает один пользовательский совокупный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правила на основе скорости.

Header -> (structure)

Используйте значение заголовка в запросе в качестве совокупного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегации. Если вы используете один заголовок в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя используемого заголовка.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве совокупного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегации. Если вы используете один cookie в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя используемого cookie.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве совокупного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегации. Если вы используете один аргумент запроса в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя используемого аргумента запроса.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryString -> (structure)

Используйте строку запроса запроса в качестве совокупного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегации. Если вы используете только строку запроса в качестве своего пользовательского ключа, то каждая строка полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

HTTPMethod -> (structure)

Используйте HTTP-метод запроса в качестве совокупного ключа. Каждый отдельный HTTP-метод вносит вклад в экземпляр агрегации. Если вы используете только HTTP-метод в качестве своего пользовательского ключа, то каждый метод полностью определяет экземпляр агрегации.

ForwardedIP -> (structure)

Используйте первый IP-адрес в HTTP-заголовке в качестве совокупного ключа. Каждый отдельный переадресованный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или переадресованного IP-адреса в настройках пользовательского ключа необходимо также указать как минимум один другой ключ для использования. Вы можете агрегировать только по переадресованному IP-адресу, указав FORWARDED_IP в AggregateKeyType вашего правила на основе скорости.

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

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве совокупного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или переадресованного IP-адреса в настройках пользовательского ключа необходимо также указать как минимум один другой ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в AggregateKeyType вашего правила на основе скорости.

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве совокупного ключа. Каждое отдельное полное имя метки, имеющей указанное пространство имен метки, вносит вклад в экземпляр агрегации. Если вы используете только одно пространство имен метки в качестве своего пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегации.

Это использует только метки, которые были добавлены в запрос правилами, оцениваемыми до этого правила на основе скорости в веб-ACL.

Информацию о пространствах имен и именах меток см. в разделе Синтаксис меток и требования к именованию в Руководстве разработчика WAF .

Namespace -> (string)

Пространство имен для использования для агрегирования.

UriPath -> (structure)

Используйте путь URI запроса в качестве совокупного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегации. Если вы используете только путь URI в качестве своего пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

JA3Fingerprint -> (structure)

Используйте отпечаток JA3 запроса в качестве совокупного ключа. Если вы используете один отпечаток JA3 в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие варианты поведения при сбое:

  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве своего пользовательского ключа, тогда каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Можно указать следующее поведение при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой AND. Необходимо указать несколько Statement в рамках AndStatement .

Statements -> (list)

Операторы для объединения с логикой AND. Можно использовать любые операторы, которые можно вложить.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой OR. Необходимо указать несколько Statement в рамках OrStatement .

Statements -> (list)

Операторы для объединения с логикой OR. Можно использовать любые операторы, которые можно вложить.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Необходимо указать один Statement в рамках NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Необходимые имена можно получить, вызвав ListAvailableManagedRuleGroups .

Нельзя вкладывать ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Нельзя использовать управляемую группу правил внутри другой группы правил. Можно только ссылаться на управляемую группу правил как на оператор верхнего уровня в правиле, которое вы определяете в ACL веб-сайта.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control account takeover prevention (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control account creation fraud prevention (ACFP) AWSManagedRulesACFPRuleSet . Дополнительные сведения см. в разделе WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Используется это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Используется это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. При указании этого параметр версии фиксируется, пока вы его не измените. Если это не указано, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика, когда поставщик обновляет настройки управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылающейся группе правил, действия которых установлены на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого нужно переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

Name -> (string)

Имя правила, действие которого нужно переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для смягчения интеллектуальных угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетных записей. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также места в полезных данных запроса на создание учетной записи данных, таких как поля адреса электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в приложение и места в полезных данных запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать в группе правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для смягчения интеллектуальных угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетных записей. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также места в полезных данных запроса на создание учетной записи данных, таких как поля адреса электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в приложение и места в полезных данных запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать в группе правил Bot Control.

Примеры спецификаций см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этого параметра укажите конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этого параметра укажите конфигурацию в разделе конфигурации проверки запросов для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этого параметра укажите конфигурацию в разделе конфигурации проверки запросов для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

То, как это указать, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезных данных с кодированием формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этого параметра укажите конфигурацию в разделе конфигурации проверки запросов для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

То, как это указать, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезных данных с кодированием формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная настройка для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Сведения об использовании управляемой группы правил Bot Control см. в разделе Группа правил WAF Bot Control и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки для использования в группе правил Bot Control. Общий уровень — наименее затратный. Целевой уровень включает все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе Группа правил WAF Bot Control в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют аномальное поведение, которое может указывать на распределенную, скоординированную активность ботов.

Дополнительные сведения об этом выборе см. в списке этих правил в таблице в разделе Список правил Bot Control в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил (ATP) для предотвращения захвата учетных записей, AWSManagedRulesATPRuleSet . Используйте это для предоставления информации о запросе входа в группу правил. Для веб-ACL, которые защищают дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы входа.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в Руководстве разработчика WAF .

LoginPath -> (string)

Путь к конечной точке входа в ваше приложение. Например, для URL https://example.com/web/login , вы предоставите путь /web/login . Пути входа, начинающиеся с предоставленного вами пути, считаются совпадением. Например /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов входа, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа, либо JSON, либо с кодировкой формы.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

Identifier -> (string)

Название поля имени пользователя.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

Identifier -> (string)

Название поля пароля.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиентов, ведя подсчет успешных и неудачных попыток для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным соответствием, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна быть точным соответствием, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, строка может быть в любом месте тела и должна быть точным соответствием, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для сопоставления со значением в JSON. Идентификатор должен быть точным соответствием, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути к странице входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet. Используйте это, чтобы предоставить информацию о запросе на создание учетной записи группе правил. Для веб-ACL, которые защищают дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на создание учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. группу правил предотвращения мошенничества при создании учетной записи WAF Fraud Control (ACFP) и предотвращение мошенничества при создании учетной записи WAF Fraud Control (ACFP) в Руководстве разработчика WAF.

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать запросы POST.

Например, для URL https://example.com/web/newaccount, вы предоставите путь /web/newaccount. Пути к страницам создания учетной записи, которые начинаются с предоставленного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая представляет форму регистрации новым пользователям.

Примечание

Эта страница должна принимать запросы GET text/html.

Например, для URL https://example.com/web/registration, вы предоставите путь /web/registration. Пути к страницам регистрации, которые начинаются с предоставленного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или закодированная форма.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя имеет вид /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя имеет вид username1

Identifier -> (string)

Название поля имени пользователя.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя имеет вид /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя имеет вид username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля имеет вид /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля имеет вид password1 .

Identifier -> (string)

Название поля пароля.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля имеет вид /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля имеет вид password1 .

EmailField -> (structure)

Название поля в полезной нагрузке запроса, содержащего адрес электронной почты вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты имеет вид /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 спецификация поля электронной почты имеет вид email1 .

Identifier -> (string)

Название поля электронной почты.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты имеет вид /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 спецификация поля электронной почты имеет вид email1 .

PhoneNumberFields -> (list)

Названия полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Укажите порядок полей номера телефона в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы поля номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы поля номера телефона: primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Название поля в полезной нагрузке запроса, которое содержит часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Название отдельного поля основного номера телефона.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы поля номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы поля номера телефона: primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Названия полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Укажите порядок полей адреса в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы поля адреса: /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Название поля в полезной нагрузке запроса, которое содержит часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Название отдельного поля основного адреса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы поля адреса: /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответа доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентами, подсчитывая успешные и неудачные попытки с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы из клиентских сессий и IP-адресов, которые имели слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (структура)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (структура)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно точно совпадать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачной, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения для сопоставления в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

Настройки действия, которые следует использовать вместо действий правила, настроенных внутри группы правил. Вы указываете одну переопределяющую настройку для каждого правила, действие которого вы хотите изменить.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит переопределяющую настройку.

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

(структура)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит переопределяющую настройку.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит переопределяющую настройку.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF блокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

ResponseCode -> (integer)

HTTP-код состояния, который необходимо вернуть клиенту.

For a list of status codes that you can use in your custom responses, see Supported status codes for custom response in the WAF Developer Guide .

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить настраиваемый ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в режим блокировки. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или действии по умолчанию веб-ACL настройка BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

HTTP-заголовки, которые следует использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Инструкция правила для сопоставления с метками, добавленными к веб-запросу правилами, которые уже запущены в веб-ACL.

Инструкция соответствия метке предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю строку полностью определенного имени метки, которая была добавлена к веб-запросу. Полностью определенные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, добавившего метку. Если вы не предоставите полное имя в строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и инструкция сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope инструкции сопоставления:

  • Если Scope указывает LABEL, то эта спецификация должна включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс, предоставляя полностью определенное имя метки.
  • Если Scope указывает NAMESPACE, то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, а компоненты метки должны разделяться двоеточием, например NS1:NS2:name.

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковая имеется.

Body -> (structure)

Проверьте тело запроса как простой текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов нестандартного размера, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки большого размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки большого размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте HTTP-метод. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов нестандартного размера, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Соответствует всем элементам. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Соответствует только указанным путям включения. См. также MatchScope в JsonBody .

Укажите пути включения с использованием синтаксиса JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр, чтобы включить все пути. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и в значениях. Он требует, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки большого размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки большого размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого контента заголовка большего размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для определения подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует обнаружения соответствия в ключах и соответствия в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих случаях. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie большего размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для определения подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует обнаружения соответствия в ключах и соответствия в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих случаях. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычным образом проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации вашего оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка JA3.

Можно указать следующие варианты резервного поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации вашего оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка JA4.

Можно указать следующие варианты резервного поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим оператору правила.

UriFragment -> (structure)

Проверить фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим оператору правила.

Если не предоставить этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может быть успешным даже для недопустимого JSON. При успешном синтаксическом анализе WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON-тело в Руководстве разработчика WAF.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

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

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

OrStatement -> (structure)

A logical rule statement used to combine other rule statements with OR logic. You provide more than one Statement within the OrStatement .

Statements -> (list)

The statements to combine with OR logic. You can use any statements that can be nested.

(structure)

The processing guidance for a Rule , used by WAF to determine whether a web request matches the rule.

For example specifications, see the examples section of CreateWebACL .

ByteMatchStatement -> (structure)

A rule statement that defines a string match search for WAF to apply to web requests. The byte match statement provides the bytes to search for, the location in requests that you want WAF to search, and other settings. The bytes to search for are typically a string that corresponds with ASCII characters. In the WAF console and the developer guide, this is called a string match statement.

SearchString -> (blob)

A string value that you want WAF to search for. WAF searches only in the part of web requests that you designate for inspection in FieldToMatch . The maximum length of the value is 200 bytes.

Valid values depend on the component that you specify for inspection in FieldToMatch :

  • Method : The HTTP method that you want WAF to search for. This indicates the type of operation specified in the request.
  • UriPath : The value that you want WAF to search for in the URI path, for example, /images/daily-ad.jpg .
  • JA3Fingerprint : Available for use with Amazon CloudFront distributions and Application Load Balancers. Match against the request’s JA3 fingerprint. The JA3 fingerprint is a 32-character hash derived from the TLS Client Hello of an incoming request. This fingerprint serves as a unique identifier for the client’s TLS configuration. You can use this choice only with a string match ByteMatchStatement with the PositionalConstraint set to EXACTLY . You can obtain the JA3 fingerprint for client requests from the web ACL logs. If WAF is able to calculate the fingerprint, it includes it in the logs. For information about the logging fields, see Log fields in the WAF Developer Guide .
  • HeaderOrder : The list of header names to match for. WAF creates a string that contains the ordered list of header names, from the headers in the web request, and then matches against that string.

If SearchString includes alphabetic characters A-Z and a-z, note that the value is case sensitive.

If you’re using the WAF API

Specify a base64-encoded version of the value. The maximum length of the value before you base64-encode it is 200 bytes.

For example, suppose the value of Type is HEADER and the value of Data is User-Agent . If you want to search the User-Agent header for the value BadBot , you base64-encode BadBot using MIME base64-encoding and include the resulting value, QmFkQm90 , in the value of SearchString .

If you’re using the CLI or one of the Amazon Web Services SDKs

The value that you want WAF to search for. The SDK automatically base64 encodes the value.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки переразмера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки переразмера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (структура)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (структура)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (список)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Для этого требуется соответствие в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он столкнется.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для неверного JSON. Когда анализ завершен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки переразмера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки переразмера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков передаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, размер которого превышает допустимый, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые нужно сопоставить с критериями проверки правил. Если вы укажете ALL, WAF проверит и ключи, и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, или в значениях, или в обоих случаях. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовка.

Варианты обработки oversize следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie передаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie, размер которого превышает допустимый, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если вы укажете ALL, WAF проверит и ключи, и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, или в значениях, или в обоих случаях. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie.

Варианты обработки oversize следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления поля при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовка.

Варианты обработки oversize следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журнала см. в разделе Log fields в WAF Developer Guide.

Предоставьте строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия для назначения веб-запросу, если в запросе нет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журнала см. в разделе Log fields в WAF Developer Guide.

Предоставьте строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия для назначения веб-запросу, если в запросе нет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, размер которого превышает допустимый, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе JSON body в WAF Developer Guide.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Text transformations in the WAF Developer Guide .

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString . Допустимые значения включают следующее:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString , но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString , а SearchString должен содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что верны оба следующих условия:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot .
  • SearchString находится в конце указанной части веб-запроса или следует за символом, отличным от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot; .
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString .

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

В качестве альтернативы вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считайте, что веб-запрос не соответствует оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считайте, что веб-запрос не соответствует оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе Тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считайте, что веб-запрос не соответствует оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если вы укажете ALL, WAF проверит и ключи, и значения.

All не требует совпадения в ключах и совпадения в значениях. Он требует совпадения в ключах, или в значениях, или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правил. Если вы укажете ALL, WAF проверит и ключи, и значения.

All не требует совпадения в ключах и совпадения в значениях. Он требует совпадения в ключах, или в значениях, или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что должен делать WAF, если файлов cookie запроса больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (structure)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с установленным параметром PositionalConstraint на EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Вы можете указать следующие варианты поведения при резервировании:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с установленным параметром PositionalConstraint на EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Вы можете указать следующие варианты поведения при резервировании:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations в WAF Developer Guide .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки атак типа SQL injection.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию о выявлении и смягчении ложных срабатываний см. в разделе Testing and tuning в WAF Developer Guide .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак SQL injection или имеют низкую устойчивость к ложным срабатываниям.

Default: LOW

XssMatchStatement -> (structure)

Оператор правила, который проверяет атаки межсайтового скриптинга (XSS). При атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте как средство для внедрения вредоносных клиентских скриптов в другие законные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверка строки запроса. Это часть URL, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF для проверки только содержимое, которое находится в пределах лимита.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF для проверки только содержимое, которое находится в пределах лимита.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка метода HTTP. Метод указывает тип операции, которую запрос просит выполнить origin.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF для проверки только содержимое, которое находится в пределах лимита.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверка тела как обычного текста. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для недействительного JSON. Когда анализ завершен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF для проверки только содержимое, которое находится в пределах лимита.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить область и фильтры сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовков сверх размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверьте все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует совпадения ни в ключах, ни в значениях. Для этого требуется совпадение в ключах, или в значениях, или и в том, и в другом. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND, чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует сделать, если заголовков запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить область и фильтры сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie сверх размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверьте все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует совпадения ни в ключах, ни в значениях. Для этого требуется совпадение в ключах, или в значениях, или и в том, и в другом. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND, чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует сделать, если файлов cookie в запросе больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует сделать, если заголовков запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел Log fields в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел Log fields в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить область и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагментов URI сверх размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует сделать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF parsing doesn’t fully validate the input JSON string, so parsing can succeed even for invalid JSON. When parsing succeeds, WAF doesn’t apply the fallback behavior. For more information, see JSON body in the WAF Developer Guide .

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например больше (>) или меньше (<). Например, вы можете использовать оператор ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверит только количество байтов в теле запроса в пределах лимита для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера для блокировки запросов с большим размером тела запроса. Дополнительную информацию об ограничениях проверки см. в настройках Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI учитывается как один символ. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большего размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить исходный сервер.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большего размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе о теле JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части заголовков, которые нужно сопоставить с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Требуется нахождение соответствия в ключах, значениях или обоих. Чтобы потребовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Доступны следующие параметры обработки негабаритных данных:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверьте все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Требуется нахождение соответствия в ключах, значениях или обоих. Чтобы потребовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Доступны следующие параметры обработки негабаритных данных:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для соответствия компоненту в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Доступны следующие параметры обработки негабаритных данных:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот выбор можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот выбор можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверка фрагментов URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

ComparisonOperator -> (string)

The operator to use to compare the request part to the size setting.

Size -> (long)

The size, in byte, to compare to the request part, after any transformations.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

GeoMatchStatement -> (structure)

A rule statement that labels web requests by country and region and that matches against web requests based on country code. A geo match rule labels every request that it inspects regardless of whether it finds a match.

  • To manage requests only by country, you can use this statement by itself and specify the countries that you want to match against in the CountryCodes array.
  • Otherwise, configure your geo match rule with Count action so that it only labels requests. Then, add one or more label match rules to run after the geo match rule and configure them to match against the geographic labels and handle the requests as needed.

WAF labels requests using the alpha-2 country and region codes from the International Organization for Standardization (ISO) 3166 standard. WAF determines the codes using either the IP address in the web request origin or, if you specify it, the address in the geo match ForwardedIPConfig .

If you use the web request origin, the label formats are awswaf:clientip:geo:region:<ISO country code>-<ISO region code> and awswaf:clientip:geo:country:<ISO country code> .

If you use a forwarded IP address, the label formats are awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> and awswaf:forwardedip:geo:country:<ISO country code> .

For additional details, see Geographic match rule statement in the WAF Developer Guide .

CountryCodes -> (list)

An array of two-character country codes that you want to match against, for example, [ "US", "CN" ] , from the alpha-2 country ISO codes of the ISO 3166 international standard.

When you use a geo match statement just for the region and country labels that it adds to requests, you still have to supply a country code for the rule to evaluate. In this case, you configure the rule to only count matching requests, but it will still generate logging and count metrics for any matches. You can reduce the logging and metrics that the rule produces by specifying a country that’s unlikely to be a source of traffic to your site.

(string)

ForwardedIPConfig -> (structure)

The configuration for inspecting IP addresses in an HTTP header that you specify, instead of using the IP address that’s reported by the web request origin. Commonly, this is the X-Forwarded-For (XFF) header, but you can specify any header name.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

HeaderName -> (string)

The name of the HTTP header to use for the IP address. For example, to use the X-Forwarded-For (XFF) header, set this to X-Forwarded-For .

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

FallbackBehavior -> (string)

The match status to assign to the web request if the request doesn’t have a valid IP address in the specified position.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

You can specify the following fallback behaviors:

  • MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.
  • NO_MATCH - Treat the web request as not matching the rule statement.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, которые определены в группе правил. Чтобы использовать это, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Вы не можете вложить RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня внутри правила, которое вы определяете в ACL веб-сайта.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Позаботьтесь о проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(structure)

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

Примечание

Позаботьтесь о проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

Позаботьтесь о проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ на веб-запрос.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF возвращал клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или настройке по умолчанию веб-ACL BlockAction вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в ACL веб-сайта.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правил, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который определяет адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать IP-набор, см. CreateIPSet.

Каждый оператор правила набора IP ссылается на IP-набор. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) IPSet, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для этого значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

Position -> (string)

Положение в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные — прокси-серверы, через которые прошел запрос.

Параметры для этого параметра следующие:

  • FIRST — Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST — Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY — Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Инструкция правила, используемая для поиска в компонентах веб-запроса совпадений с регулярными выражениями. Чтобы использовать это, создайте RegexPatternSet, который определяет выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этой инструкции. Веб-запрос соответствует инструкции правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждая инструкция правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) RegexPatternSet, на который ссылается эта инструкция.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, идентифицирующая ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий инструкции правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Рабочей группы разработки Интернет-протоколов (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий инструкции правила.

Если вы не предоставите этот параметр, WAF выполняет синтаксический анализ и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение отката. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий инструкции правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Вы должны настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим оператору правила.

Cookies -> (структура)

Проверить файлы cookie запроса. Вы должны настроить область и фильтры сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим оператору правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие резервные поведения:

  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие резервные поведения:

  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Вы должны настроить область и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста удаляют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного контента, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста удаляют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает скорость запросов, когда они поступают со слишком высокой скоростью. Правило категоризирует запросы в соответствии с вашими критериями агрегирования, собирает их в экземпляры агрегирования, подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в правиле, которое в настоящее время используется, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия по ограничению скорости правила на срок до минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегирования, такие как IP-адрес и метод HTTP, или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для ключей агрегирования, которые вы указываете, является отдельным экземпляром агрегирования, причем значение каждого ключа вносит вклад в определение экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило создаст разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: счетчик 3
    • IP-адрес 127.0.0.0: счетчик 1
  • Если критерием агрегирования является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: счетчик 2
    • Метод HTTP GET: счетчик 2
  • Если критерием агрегирования является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в объединенный экземпляр агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: счетчик 1
    • IP-адрес 10.1.1.1, метод HTTP GET: счетчик 2
    • IP-адрес 127.0.0.0, метод HTTP POST: счетчик 1

Для любой n-кортежа ключей агрегирования каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает по скорости индивидуально.

При желании вы можете вложить другой оператор в оператор на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только тех запросов, которые соответствуют вложенному оператору. Вы можете использовать этот вложенный оператор сужения области действия в сочетании со спецификациями вашего ключа агрегирования или просто подсчитывать и ограничивать скорость всех запросов, соответствующих оператору сужения области действия, без дополнительного агрегирования. Когда вы решите просто управлять всеми запросами, которые соответствуют оператору сужения области действия, экземпляр агрегирования является единственным для правила.

Вы не можете вложить RateBasedStatement в другой оператор, например, внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Дополнительные сведения об опциях см. в разделе Rate limiting web requests using rate-based rules в WAF Developer Guide .

Если вы агрегируете только по отдельному IP-адресу или переадресованному IP-адресу, вы можете получить список IP-адресов, которые WAF в настоящее время ограничивает по скорости для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставите одни и те же настройки правила на основе скорости в двух веб-ACL, каждый из двух операторов правил представляет отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление со стороны WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление со стороны WAF.

Limit -> (long)

Ограничение на запросы в течение указанного окна оценки для одного экземпляра агрегирования для правила на основе скорости. Если оператор на основе скорости включает в себя ScopeDownStatement , это ограничение применяется только к запросам, соответствующим оператору.

Примеры:

  • Если вы агрегируете только по IP-адресу, это ограничение на запросы с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это ограничение на запросы для любой одной пары метод-город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в свои подсчеты запросов, оглядываясь назад с текущего момента. Например, для настройки 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые значения: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а как далеко назад он смотрит каждый раз, когда проверяет. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 минут)

AggregateKeyType -> (string)

Настройка, указывающая, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте запросы, соответствующие оператору сужения области действия правила на основе скорости. С этим параметром подсчитанные запросы больше не агрегируются. Оператор сужения области действия — единственная используемая спецификация. Когда количество всех запросов, удовлетворяющих оператору сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим оператору сужения области действия. С этим параметром необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. С этим параметром необходимо указать ключи агрегирования в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по переадресованному IP-адресу, не используйте пользовательские ключи. Вместо этого установите для типа ключа агрегирования значение IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы агрегировать по комбинации переадресованного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать по комбинации IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в заголовке HTTP, который вы указываете, вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы укажете переадресованный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (string)

Имя заголовка HTTP, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое следует присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при резервном копировании:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

CustomKeys -> (list)

Определяет агрегатные ключи, используемые в правиле на основе скорости.

(структура)

Определяет один настраиваемый агрегатный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, опускаются из оценки и обработки правил на основе скорости.

Заголовок -> (структура)

Используйте значение заголовка в запросе в качестве агрегатного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегации. Если вы используете один заголовок в качестве настраиваемого ключа, каждое значение полностью определяет экземпляр агрегации.

Имя -> (string)

Имя используемого заголовка.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве агрегатного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегации. Если вы используете один cookie в качестве настраиваемого ключа, каждое значение полностью определяет экземпляр агрегации.

Имя -> (string)

Имя используемого cookie.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве агрегатного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегации. Если вы используете один аргумент запроса в качестве настраиваемого ключа, каждое значение полностью определяет экземпляр агрегации.

Имя -> (string)

Имя аргумента запроса для использования.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryString -> (structure)

Используйте строку запроса запроса в качестве агрегатного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегации. Если вы используете только строку запроса в качестве настраиваемого ключа, каждая строка полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

HTTPMethod -> (structure)

Используйте метод HTTP запроса в качестве агрегатного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегации. Если вы используете только метод HTTP в качестве настраиваемого ключа, каждый метод полностью определяет экземпляр агрегации.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве агрегатного ключа. Каждый отдельный переадресованный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или переадресованного IP-адреса в настройках настраиваемого ключа необходимо также указать по крайней мере еще один ключ для использования. Вы можете выполнить агрегацию только по переадресованному IP-адресу, указав FORWARDED_IP в заявлении на основе скорости AggregateKeyType .

С этим параметром необходимо указать заголовок для использования в свойстве правила на основе скорости ForwardedIPConfig .

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве агрегатного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или переадресованного IP-адреса в настройках настраиваемого ключа необходимо также указать по крайней мере еще один ключ для использования. Вы можете выполнить агрегацию только по IP-адресу, указав IP в заявлении на основе скорости AggregateKeyType .

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве агрегатного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегации. Если вы используете только одно пространство имен меток в качестве настраиваемого ключа, каждое имя метки полностью определяет экземпляр агрегации.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются до этого правила на основе скорости в веб-ACL.

Сведения о пространствах имен и именах меток см. в разделе Синтаксис меток и требования к именованию в Руководстве разработчика WAF .

Namespace -> (string)

Пространство имен для использования для агрегации.

UriPath -> (structure)

Используйте путь URI запроса в качестве агрегатного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегации. Если вы используете только путь URI в качестве настраиваемого ключа, каждый путь URI полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

JA3Fingerprint -> (structure)

Используйте отпечаток JA3 запроса в качестве агрегатного ключа. Если вы используете один отпечаток JA3 в качестве настраиваемого ключа, каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия, присваиваемый веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток JA4 запроса в качестве составного ключа. Если вы используете один отпечаток JA4 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Состояние соответствия, назначаемое веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правила с логикой AND. Вы предоставляете более одного Statement в рамках AndStatement .

Statements -> (list)

Операторы для объединения с логикой AND. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правила с логикой OR. Вы предоставляете более одного Statement в рамках OrStatement .

Statements -> (list)

Операторы для объединения с логикой OR. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один Statement в рамках NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вкладывать ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Нельзя использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control для предотвращения захвата учетной записи (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control для предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF будет использовать версию по умолчанию от поставщика, а затем сохранит версию по умолчанию от поставщика при обновлении поставщиком настроек управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылочной группе правил, для которых действия установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое действие, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое действие, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения и местоположения данных в полезной нагрузке запроса на создание учетной записи, например, поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и местоположения данных в полезной нагрузке запроса на вход, такие как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения и местоположения данных в полезной нагрузке запроса на создание учетной записи, например, поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и местоположения данных в полезной нагрузке запроса на вход, такие как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

Примеры спецификаций см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этой настройки предоставьте свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этой настройки предоставьте свою конфигурацию в разделе конфигурации проверки запросов для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этой настройки предоставьте свою конфигурацию в разделе конфигурации проверки запросов для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этой настройки предоставьте свою конфигурацию в разделе конфигурации проверки запросов для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. WAF Bot Control rule group и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки для использования для группы правил Bot Control. Общий уровень является наименее затратным. Целевой уровень включает в себя все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в WAF Bot Control rule group в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применимо только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение необходимо для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Список правил Bot Control в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил защиты от захвата учетной записи (ATP) AWSManagedRulesATPRuleSet . Используйте это для предоставления информации о запросе на вход в группу правил. Для списков управления доступом к веб-сайтам, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив отвечает на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Информацию об использовании управляемой группы правил ATP см. в разделе «Группа правил защиты от захвата учетной записи WAF Fraud Control (ATP)» и «Защита от захвата учетной записи WAF Fraud Control (ATP)» в Руководстве разработчика WAF .

LoginPath -> (string)

Путь к конечной точке входа в ваше приложение. Например, для URL-адреса https://example.com/web/login вы должны предоставить путь /web/login . Пути входа, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа, либо JSON, либо закодированный в форму.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля — password1 .

Identifier -> (string)

Имя поля пароля.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля — password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в списках управления доступом к веб-сайтам, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиентов, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Имя заголовка для сопоставления. Имя должно точно совпадать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно совпадать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил по предотвращению мошенничества при создании учетных записей (ACFP) AWSManagedRulesACFPRuleSet. Используйте это, чтобы предоставить информацию о запросе на создание учетной записи в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на создание учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) и WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) в Руководстве разработчика WAF.

CreationPath -> (string)

Путь конечной точки создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать запросы POST.

Например, для URL-адреса https://example.com/web/newaccount, вы предоставите путь /web/newaccount. Пути страниц создания учетной записи, начинающиеся с предоставленного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь конечной точки регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая представляет форму регистрации для новых пользователей.

Примечание

Эта страница должна принимать запросы GET text/html.

Например, для URL-адреса https://example.com/web/registration, вы предоставите путь /web/registration. Пути страниц регистрации, начинающиеся с предоставленного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи, либо JSON, либо закодированная форма.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля — password1 .

Identifier -> (string)

Имя поля пароля.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля — password1 .

EmailField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего электронную почту вашего клиента.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем email1 спецификация поля электронной почты — email1 .

Identifier -> (string)

Имя поля электронной почты.

Способ указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем email1 спецификация поля электронной почты — email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве в точном порядке их следования в полезной нагрузке запроса.

Способ указания полей номера телефона зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами input с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного номера телефона.

Способ указания полей номера телефона зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами input с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве в точном порядке их следования в полезной нагрузке запроса.

Способ указания полей адреса зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами input с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного адреса.

Способ указания полей адреса зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами input с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентом, подсчитывая количество успешных и неудачных попыток с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (структура)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (список)

Коды состояния в ответе, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(целое число)

FailureCodes -> (список)

Коды состояния в ответе, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "FailureCodes": [ 400, 404 ]

(целое число)

Header -> (структура)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (строка)

Имя заголовка для сопоставления. Имя должно точно соответствовать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (список)

Значения в заголовке ответа с указанным именем, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(строка)

FailureValues -> (список)

Значения в заголовке ответа с указанным именем, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(строка)

BodyContains -> (структура)

Настраивает проверку тела ответа на индикаторы успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (список)

Строки в теле ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешной, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(строка)

FailureStrings -> (список)

Строки в теле ответа, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачной, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Пример JSON: "FailureStrings": [ "Request failed" ]

(строка)

Json -> (структура)

Настраивает проверку JSON ответа на индикаторы успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (строка)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (список)

Значения для указанного идентификатора в JSON ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(строка)

FailureValues -> (список)

Значения для указанного идентификатора в JSON ответа, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(строка)

EnableRegexInPath -> (логическое)

Разрешить использование регулярных выражений в пути к странице регистрации и пути к созданию учетной записи.

RuleActionOverrides -> (список)

Настройки действий для использования вместо действий правил, настроенных внутри группы правил. Вы указываете одну переоценку для каждого правила, действие которого вы хотите изменить.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(структура)

Настройка действия для использования вместо действия правила, настроенного внутри группы правил. Вы указываете одну переоценку для каждого правила, действие которого вы хотите изменить.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения, которое следует использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Указывает WAF блокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP, который необходимо вернуть клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP, которые следует использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type. Повторные имена заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Указывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Повторные имена заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Указывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Повторные имена заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Указывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Повторные имена заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Указывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Повторные имена заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, которые были добавлены к веб-запросу правилами, которые уже были запущены в веб-ACL.

Оператор сопоставления меток предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю часть полного имени метки, которая была добавлена к веб-запросу. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, которое добавило метку. Если вы не предоставите полное имя в строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы сопоставлять, используя имя метки, или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора соответствия:

  • Если Scope указывает LABEL, то это указание должно включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс до предоставления полного имени метки.
  • Если Scope указывает NAMESPACE, то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда происходит метка.

Метки чувствительны к регистру, а компоненты метки должны быть разделены двоеточием, например NS1:NS2:name.

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с настройками вашего правила и действиями веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка HTTP-метода. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих соответствий шаблонов по критериям проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON, с которыми нужно сопоставить с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND, чтобы объединить два правила сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможные варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может быть успешным даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с настройками вашего правила и действиями веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Для проверки службой-хостом, лежащей в основе, в WAF пересылаются только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков. Необходимо настроить обработку содержимого заголовков, превышающего допустимый размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указано ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков всего. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий утверждению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Для проверки службой-хостом, лежащей в основе, в WAF пересылаются только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie. Необходимо настроить обработку содержимого файлов cookie, превышающего допустимый размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для сопоставления с критериями проверки правила. Если указано ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie всего. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков всего. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, назначаемый веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие варианты поведения при отступлении:

  • MATCH — рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, назначаемый веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие варианты поведения при отступлении:

  • MATCH — рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий утверждению правила.

UriFragment -> (structure)

Проверка фрагментов URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Для проверки службой-хостом, лежащей в основе, в WAF пересылаются только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI. Необходимо настроить обработку содержимого фрагмента URI, превышающего допустимый размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий утверждению правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать контент только до первой ошибки анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если указать одно или несколько преобразований для применения, WAF выполняет все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

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

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один Statement в пределах NotStatement .

Statement -> (structure)

Оператор для отрицания. Можно использовать любой оператор, который можно вложить.

ByteMatchStatement -> (structure)

Оператор правила, который определяет поиск соответствия строк для WAF, применяемый к веб-запросам. Оператор соответствия байтов предоставляет байты для поиска, расположение в запросах, которые вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска обычно представляют собой строку, которая соответствует символам ASCII. В консоли WAF и руководстве для разработчиков это называется оператором соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF выполняет поиск только в той части веб-запросов, которую вы назначаете для проверки в FieldToMatch . Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : HTTP-метод, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. Эту опцию можно использовать только с соответствием строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY . Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, содержащую упорядоченный список имен заголовков из заголовков в веб-запросе, а затем выполняет сопоставление с этой строкой.

Если SearchString содержит буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете API WAF

Укажите версию значения с кодировкой base64. Максимальная длина значения до кодирования base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER , а значение Data равно User-Agent . Если вы хотите выполнить поиск в заголовке User-Agent значения BadBot , вы кодируете BadBot с кодировкой MIME base64 и включаете результирующее значение QmFkQm90 в значение SearchString .

Если вы используете CLI или один из SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Имя -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Имя -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверьте строку запроса. Это часть URL, которая отображается после символа ? , если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычным образом проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (структура)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (структура)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (список)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (строка)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычным образом проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большего размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie большего размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверьте все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части файлов cookie, которые необходимо проверить с помощью критериев проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например, host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено в значение EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журналов см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено в значение EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журналов см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI большего размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью разобрать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования указанного контента, начиная с наименьшей приоритетности, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

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

PositionalConstraint -> (строка)

Область в той части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString . Допустимые значения включают следующие:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString , но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString , и SearchString должен содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что верно следующее:

  • SearchString находится в начале указанной части веб-запроса или перед ним стоит символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot .
  • SearchString находится в конце указанной части веб-запроса или после него стоит символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot; .
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString .

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (структура)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы делать такие вещи, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

В качестве альтернативы вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию установлен лимит 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body .

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию установлен лимит 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки больших размеров следующие:

  • CONTINUE - Проверить доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию установлен лимит 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадение в ключах и в значениях, используйте логическое выражение AND , чтобы объединить два правила сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию установлен лимит 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки больших размеров следующие:

  • CONTINUE - Проверить доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Вы должны настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части заголовков, которые нужно сопоставить с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствие в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Вы должны настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствие в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с установленным значением PositionalConstraint, равным EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях журнала см. раздел Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с установленным значением PositionalConstraint, равным EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях журнала см. раздел Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку содержимого фрагментов URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Для получения дополнительной информации см. раздел Тело JSON в Руководстве разработчика WAF.

TextTransformations -> (список)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного контента, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations in the WAF Developer Guide .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на атаки типа SQL-инъекции.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию об идентификации и смягчении ложных срабатываний см. в разделе Testing and tuning in the WAF Developer Guide .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другую защиту от атак типа SQL-инъекции или имеют низкую толерантность к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (structure)

Оператор правила, который выполняет проверку на атаки типа межсайтового скриптинга (XSS). При атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте как средство для внедрения вредоносных клиентских сценариев в другие законные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить отдельный заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить отдельный аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, идентифицирующая ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов, размер которых превышает допустимый, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — Проверить доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH — Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действий вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов, размер которых превышает допустимый, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах, а соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING — Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет поведение отката. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — Проверить доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH — Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действий вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого негабаритного содержимого заголовка в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого негабаритного содержимого файла cookie в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия, и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Отпечаток пальца JA3 для клиентских запросов можно получить из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если в запросе нет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Отпечаток пальца JA4 для клиентских запросов можно получить из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если в запросе нет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверка фрагментов URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI негабаритного размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам, для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости, для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполняет все преобразования для указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

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

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, можно использовать оператор ограничения размера для поиска строк запросов, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF будет проверять только количество байтов в теле запроса до лимита для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера, чтобы заблокировать запросы с большим размером тела запроса. Для получения дополнительной информации об ограничениях проверки см. параметры Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI для значения параметра Часть запроса для фильтрации, косая черта (/) в URI считается одним символом. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка нечувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может иметь длину до 30 символов и нечувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверить доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверить метод HTTP. Метод указывает тип операции, которую запрос требует от источника.

JsonBody -> (структура)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. С информацией об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Требуется найти совпадение в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может быть успешным даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверить доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или в значениях, или и в том, и в другом. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для определения подмножества файлов cookie, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки в соответствии с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или в значениях, или и в том, и в другом. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для соответствия в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Если не указать этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF parsing doesn’t fully validate the input JSON string, so parsing can succeed even for invalid JSON. When parsing succeeds, WAF doesn’t apply the fallback behavior. For more information, see JSON body in the WAF Developer Guide.

ComparisonOperator -> (string)

Оператор для использования для сравнения части запроса с настройкой размера.

Размер -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations in the WAF Developer Guide .

GeoMatchStatement -> (structure)

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

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор сам по себе и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes .
  • В противном случае настройте свое правило гео-соответствия с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам для запуска после правила гео-соответствия и настройте их для соответствия географическим меткам и обработки запросов по мере необходимости.

WAF помечает запросы, используя коды стран и регионов alpha-2 из международного стандарта ISO 3166 Международной организации по стандартизации (ISO). WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в гео-соответствии ForwardedIPConfig .

Если вы используете источник веб-запроса, форматы меток — awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете переадресованный IP-адрес, форматы меток — awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Дополнительные сведения см. в разделе Geographic match rule statement in the WAF Developer Guide .

CountryCodes -> (list)

Массив двухсимвольных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ] , из кодов стран alpha-2 ISO международного стандарта ISO 3166.

Когда вы используете оператор гео-соответствия только для меток региона и страны, которые он добавляет к запросам, вам все равно необходимо указать код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета совпадающих запросов, но оно по-прежнему будет генерировать журналы и показатели подсчета для любых соответствий. Вы можете уменьшить объем ведения журнала и показатели, которые производит правило, указав страну, которая вряд ли будет источником трафика для вашего сайта.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в HTTP-заголовке, который вы указываете, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не содержит допустимый IP-адрес в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Вы не можете вкладывать RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как оператор верхнего уровня внутри правила, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, для которых действия установлены в Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любой допустимый параметр действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любой допустимый параметр действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(structure)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения, которое следует использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP, который нужно вернуть клиенту.

Список кодов состояния, которые можно использовать в ваших пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Указывает на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL настройке BlockAction , вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP, которые следует использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правил, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать набор IP, см. CreateIPSet.

Каждый оператор правил набора IP ссылается на набор IP. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) набора IP, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке, вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое нужно присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующее поведение при сбое:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правил.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значением заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси-серверы, через которые прошел запрос.

Варианты этого параметра следующие:

  • FIRST - Проверьте первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверьте последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверьте все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий в компонентах веб-запроса с использованием регулярных выражений. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, а затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может быть длиной до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверьте тело запроса как простой текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступного содержимого тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими параметрами правил и действий веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения с использованием синтаксиса указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL , WAF сопоставляет с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логический оператор AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если он не может полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не укажете этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступного содержимого тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими параметрами правил и действий веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблона в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого заголовка негабаритного размера в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия ключам и значениям, используйте логическое оператор AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблона в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого файлов cookie негабаритного размера в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверьте все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия ключам и значениям, используйте логическое оператор AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Обычным образом проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту возможность можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который следует присвоить веб-запросу, если в запросе нет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту возможность можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который следует присвоить веб-запросу, если в запросе нет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment , чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого фрагмента URI негабаритного размера в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF-синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным контентом, начиная с самой низкой приоритетной настройки, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

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

RateBasedStatement -> (структура)

Правило на основе частоты подсчитывает входящие запросы и ограничивает запросы по частоте, когда они поступают со слишком высокой скоростью. Правило категоризирует запросы в соответствии с вашими критериями агрегирования, собирает их в экземпляры агрегирования, а также подсчитывает и ограничивает запросы по частоте для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в правиле, которое в настоящее время используется, изменение сбрасывает счетчики ограничения частоты правила. Это может приостановить действия ограничения частоты правила на срок до одной минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегирования, такие как IP-адрес и метод HTTP, или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для ключей агрегирования, которые вы указываете, представляет собой отдельный экземпляр агрегирования, при этом значение каждого ключа способствует определению экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило создаст разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: счетчик 3
    • IP-адрес 127.0.0.0: счетчик 1
  • Если критерием агрегирования является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: счетчик 2
    • Метод HTTP GET: счетчик 2
  • Если критерием агрегирования является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут способствовать созданию комбинированного экземпляра агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: счетчик 1
    • IP-адрес 10.1.1.1, метод HTTP GET: счетчик 2
    • IP-адрес 127.0.0.0, метод HTTP POST: счетчик 1

Для любого n-кортежа ключей агрегирования каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает по частоте отдельно.

При необходимости можно вложить другой оператор внутрь оператора на основе частоты, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало по частоте только те запросы, которые соответствуют вложенному оператору. Вы можете использовать этот вложенный оператор сужения области вместе со спецификациями ключа агрегирования или просто подсчитывать и ограничивать по частоте все запросы, которые соответствуют оператору сужения области, без дополнительного агрегирования. Когда вы решите просто управлять всеми запросами, которые соответствуют оператору сужения области, экземпляр агрегирования является единственным для правила.

Нельзя вложить RateBasedStatement внутри другого оператора, например, внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Дополнительную информацию о параметрах см. в разделе Ограничение частоты веб-запросов с использованием правил на основе частоты в Руководстве разработчика WAF .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, которые WAF в настоящее время ограничивает по частоте для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе частоты, которое вы используете. Например, если вы предоставляете одни и те же настройки правила на основе частоты в двух веб-ACL, каждый из двух операторов правил представляет собой отдельный экземпляр правила на основе частоты и получает собственное отслеживание и управление со стороны WAF. Если вы определяете правило на основе частоты внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе частоты, который получает собственное отслеживание и управление со стороны WAF.

Limit -> (long)

Лимит запросов в течение указанного окна оценки для одного экземпляра агрегирования для правила на основе частоты. Если оператор на основе частоты включает ScopeDownStatement , этот лимит применяется только к запросам, которые соответствуют оператору.

Примеры:

  • Если вы агрегируете только по IP-адресу, это ограничение на запросы с любого отдельного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это ограничение на запросы для любой отдельной пары метод, город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в свои подсчеты запросов, заглядывая назад с текущего момента времени. Например, для настройки 120, когда WAF проверяет частоту, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые значения: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет частоту, а как далеко назад он смотрит каждый раз, когда проверяет. WAF проверяет частоту примерно каждые 10 секунд.

По умолчанию: 300 (5 minutes)

AggregateKeyType -> (string)

Настройка, указывающая, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, опускаются из оценки и обработки правила на основе частоты.
  • CONSTANT - Подсчитывать и ограничивать запросы, которые соответствуют оператору сужения области действия правила на основе частоты. С этим параметром подсчитанные запросы не агрегируются дополнительно. Оператор сужения области действия является единственной используемой спецификацией. Когда количество всех запросов, удовлетворяющих оператору сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим оператору сужения области действия. С этим параметром необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегировать количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. С этим параметром необходимо указать ключи агрегирования в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегирования в IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегировать количество запросов по первому IP-адресу в заголовке HTTP. С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы агрегировать комбинацию перенаправленного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .
  • IP - Агрегировать количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать комбинацию IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (string)

Имя заголовка HTTP, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для этого значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

CustomKeys -> (list)

Указывает совокупные ключи для использования в правиле на основе скорости.

(structure)

Указывает один пользовательский совокупный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, опускаются из оценки и обработки правила на основе скорости.

Header -> (structure)

Используйте значение заголовка в запросе в качестве совокупного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегации. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя используемого заголовка.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробных описаний каждого из типов преобразований см. Text transformations in the WAF Developer Guide .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве совокупного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегации. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя используемого cookie.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробных описаний каждого из типов преобразований см. Text transformations in the WAF Developer Guide .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве совокупного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегации. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя используемого аргумента запроса.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробных описаний каждого из типов преобразований см. Text transformations in the WAF Developer Guide .

QueryString -> (structure)

Используйте строку запроса запроса в качестве совокупного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегации. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробных описаний каждого из типов преобразований см. Text transformations in the WAF Developer Guide .

HTTPMethod -> (structure)

Используйте метод HTTP запроса в качестве совокупного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегации. Если вы используете только метод HTTP в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегации.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве совокупного ключа. Каждый отдельный переадресованный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или переадресованного IP-адреса в настройках пользовательского ключа необходимо также указать как минимум один другой ключ для использования. Вы можете агрегировать только по переадресованному IP-адресу, указав FORWARDED_IP в вашем операторе на основе скорости AggregateKeyType .

С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве совокупного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или переадресованного IP-адреса в настройках пользовательского ключа необходимо также указать как минимум один другой ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в вашем операторе на основе скорости AggregateKeyType .

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве совокупного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегации. Если вы используете только одно пространство имен меток в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегации.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

For information about label namespaces and names, see Label syntax and naming requirements in the WAF Developer Guide .

Namespace -> (string)

Пространство имен для использования при агрегации.

UriPath -> (structure)

Используйте путь URI запроса в качестве совокупного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегации. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правила на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробных описаний каждого из типов преобразований см. Text transformations in the WAF Developer Guide .

JA3Fingerprint -> (structure)

Используйте отпечаток пальца JA3 запроса в качестве совокупного ключа. Если вы используете один отпечаток пальца JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка пальца JA3.

Вы можете указать следующие режимы работы при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве пользовательского ключа, каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия для присвоения веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой AND. Вы предоставляете более одного оператора в рамках AndStatement .

Statements -> (list)

Операторы для объединения с логикой AND. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой OR. Вы предоставляете более одного оператора в рамках OrStatement .

Statements -> (list)

Операторы для объединения с логикой OR. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один оператор в рамках NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, которые определены в управляемой группе правил. Чтобы использовать это, предоставьте имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вкладывать ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в ACL веб-приложения.

Примечание

Взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control для предотвращения захвата учетной записи (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control для предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия используемой управляемой группы правил. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика при обновлении настроек управляемой группы правил поставщиком.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной конфигурации:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения и местоположения в полезной нагрузке запроса на создание учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в ваше приложение и местоположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной конфигурации:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения и местоположения в полезной нагрузке запроса на создание учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в ваше приложение и местоположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

Например, спецификации см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в рамках конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в рамках конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя - /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя - username1

PasswordField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в рамках конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля - /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля - password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. WAF Bot Control rule group и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки, используемый для группы правил Bot Control. Общий уровень является наименее затратным. Целевой уровень включает все общие правила уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе Группа правил WAF Bot Control в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Список правил Bot Control в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это, чтобы предоставить информацию о запросе на вход в систему группе правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это также, чтобы предоставить информацию о том, как ваш дистрибутив реагирует на запросы на вход в систему.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в WAF Developer Guide .

LoginPath -> (string)

Путь конечной точки входа в систему для вашего приложения. Например, для URL-адреса https://example.com/web/login , вы должны предоставить путь /web/login . Пути входа, начинающиеся с предоставленного вами пути, считаются соответствующими. Например, /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа в систему.

RequestInspection -> (structure)

Критерии проверки запросов на вход в систему, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа в систему: JSON или закодированный в форме.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя - /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя - username1

Identifier -> (string)

Имя поля имени пользователя.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя - /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя - username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля - /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля - password1 .

Identifier -> (string)

Имя поля пароля.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля - /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля - password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа в систему клиента, ведя подсчет успешных и неудачных попыток для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа в систему за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешной, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачной, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно точно соответствовать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешной, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачной, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешной, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачной, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешной, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачной, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа в систему.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet . Используйте это для предоставления информации о запросах на создание учетной записи в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив отвечает на запросы на создание учетной записи.

Информацию об использовании управляемой группы правил ACFP см. в разделе «Предотвращение мошенничества при создании учетной записи (ACFP) в WAF Fraud Control» и «Предотвращение мошенничества при создании учетной записи (ACFP) в WAF Fraud Control» в Руководстве разработчика WAF.

CreationPath -> (string)

Путь конечной точки создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать запросы POST.

Например, для URL-адреса https://example.com/web/newaccount вы предоставите путь /web/newaccount. Пути страниц создания учетной записи, которые начинаются с предоставленного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь конечной точки регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, на которой форма регистрации представлена новым пользователям.

Примечание

Эта страница должна принимать запросы text/html GET.

Например, для URL-адреса https://example.com/web/registration вы предоставите путь /web/registration. Пути страниц регистрации, которые начинаются с предоставленного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или закодированная форма.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя: /form/username .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя: username1

Identifier -> (string)

Название поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя: /form/username .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя: username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля: /form/password .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля: password1 .

Identifier -> (string)

Название поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля: /form/password .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля: password1 .

EmailField -> (structure)

Название поля в полезной нагрузке запроса, содержащего адрес электронной почты вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты: /form/email .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 спецификация поля электронной почты: email1 .

Identifier -> (string)

Название поля электронной почты.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты: /form/email .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 спецификация поля электронной почты: email1 .

PhoneNumberFields -> (list)

Названия полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так, как они упорядочены в полезной нагрузке запроса.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона: primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Название поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Название одного поля основного номера телефона.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона: primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Названия полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так, как они упорядочены в полезной нагрузке запроса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса: /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Название поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Название одного поля основного адреса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса: /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с закодированной формой используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответов доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиента, подсчитывая успешные и неудачные попытки с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиента и IP-адресов, которые имели слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа на индикаторы успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа на индикаторы успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно точно соответствовать, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] and "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] and "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа на индикаторы успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] and "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, строка может быть в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа на индикаторы успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно соответствовать, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] and "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

Настройки действий, которые следует использовать вместо действий правил, настроенных внутри группы правил. Вы указываете одну переопределяющую настройку для каждого правила, действие которого вы хотите изменить.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(структура)

Настройка действия, которое следует использовать вместо действия правила, настроенного внутри группы правил. Вы указываете одну переопределяющую настройку для каждого правила, действие которого вы хотите изменить.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Переопределяющее действие для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP, который будет возвращен клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Указывает на тело ответа, которое WAF должен вернуть клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL настройке BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер настроек пользовательских запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Инструкция правила для сопоставления с метками, которые были добавлены в веб-запрос правилами, которые уже были запущены в веб-ACL.

Инструкция соответствия метки предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю полностью определенную имя метки, которая была добавлена в веб-запрос. Полностью определенные метки имеют префикс, необязательные пространства имен и имя метки. Префикс определяет группу правил или контекст веб-ACL правила, которое добавило метку. Если вы не предоставите полное имя в строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и инструкция сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Параметр, который вы предоставляете для этого, зависит от настройки Scope инструкции соответствия:

  • Если Scope указывает LABEL, то эта спецификация должна включать имя и может включать любое количество предшествующих спецификаций пространства имен и префикс вплоть до предоставления полного имени метки.
  • Если Scope указывает NAMESPACE, то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, а компоненты метки должны разделяться двоеточием, например NS1:NS2:name.

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers , чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого заголовков большого размера в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правил. Если указать ALL , WAF проверит как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правил.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого файлов cookie большого размера в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie, которые необходимо проверить с помощью критериев проверки правил. Если указать ALL , WAF проверит как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что должен делать WAF, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правил.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке с использованием двоеточий без добавления пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правил.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот параметр можно использовать только с соответствием строк ByteMatchStatement , где PositionalConstraint имеет значение EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора соответствия строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные параметры:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правил.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот параметр можно использовать только с соответствием строк ByteMatchStatement , где PositionalConstraint имеет значение EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора соответствия строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные параметры:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правил.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment , чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого фрагментов URI большого размера в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правил.

Если этот параметр не указан, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе «Преобразования текста» в Руководстве разработчика WAF.

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Нельзя вкладывать ManagedRuleGroupStatement , например для использования внутри NotStatement или OrStatement . Нельзя использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня внутри правила, которое вы определяете в веб-ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил Bot Control WAF AWSManagedRulesBotControlRuleSet , управляемой группы правил предотвращения захвата учетной записи (ATP) Fraud Control WAF AWSManagedRulesATPRuleSet или управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP) Fraud Control WAF AWSManagedRulesACFPRuleSet . Дополнительные сведения см. в разделе Цены на WAF .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил, чтобы идентифицировать группу правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика, чтобы идентифицировать группу правил.

Version -> (string)

Версия используемой управляемой группы правил. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию от поставщика, а затем сохраняет версию по умолчанию от поставщика, когда поставщик обновляет настройки управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылающейся группе правил, для которых действия установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(структура)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

ScopeDownStatement -> (structure)

Необязательный вложенный оператор, который сужает область веб-запросов, оцениваемых управляемой группой правил. Запросы оцениваются только группой правил, если они соответствуют оператору понижения области. Вы можете использовать любой вкладываемый оператор в операторе понижения области, и вы можете вкладывать операторы на любом уровне, так же, как и для оператора правила.

ByteMatchStatement -> (structure)

Оператор правила, который определяет поиск соответствия строк для WAF, применяемый к веб-запросам. Оператор соответствия байтов предоставляет байты для поиска, местоположение в запросах, которое вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска обычно представляют собой строку, соответствующую символам ASCII. В консоли WAF и руководстве разработчика это называется оператором соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF ищет только в той части веб-запросов, которую вы назначаете для проверки в FieldToMatch . Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : HTTP-метод, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. Вы можете использовать этот вариант только с соответствием строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY . Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, которая содержит упорядоченный список имен заголовков из заголовков в веб-запросе, а затем сопоставляет ее с этой строкой.

Если SearchString включает буквенные символы A-Z и a-z, обратите внимание, что значение учитывает регистр.

Если вы используете API WAF

Укажите версию значения, закодированную в base64. Максимальная длина значения до его кодирования в base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER , а значение Data равно User-Agent . Если вы хотите искать в заголовке User-Agent значение BadBot , вы кодируете BadBot в base64 с использованием кодирования MIME base64 и включаете полученное значение, QmFkQm90 , в значение SearchString .

Если вы используете CLI или один из SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение в base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки oversize следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки oversize с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью параметра MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, в значениях или и в том, и в другом. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки oversize следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки oversize с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения ни в ключах, ни в значениях. Он требует совпадения в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (структура)

Проверить файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie превышающего размер в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения ни в ключах, ни в значениях. Он требует совпадения в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления поля при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например, host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором содержится достаточная информация TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы она соответствовала любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором содержится достаточная информация TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы она соответствовала любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI превышающего размер в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с наименьшего приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

PositionalConstraint -> (string)

Область в части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString . Допустимые значения включают следующее:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString , но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString , а SearchString должно содержать только буквенно-цифровые символы или символ подчеркивания (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что выполняются оба следующих условия:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или символа подчеркивания (_). Примеры включают значение заголовка и ;BadBot .
  • SearchString находится в конце указанной части веб-запроса или после него следует символ, отличный от буквенно-цифрового символа или символа подчеркивания (_), например, BadBot; и -BadBot; .
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString .

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного кода SQL. Злоумышленники вставляют вредоносный код SQL в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Необходимо указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Рабочей группы разработки Internet (IETF) JavaScript Object Notation (JSON) Pointer.

Необходимо указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое AND утверждение для объединения двух правил сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для неверного JSON. Когда анализ успешно завершен, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков передаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверит и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах, и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie передаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверит и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах, и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает в журнал этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Состояние сопоставления, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает в журнал этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Состояние сопоставления, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF следует делать, если ему не удается полностью разобрать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недопустимого JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer) (целое число)

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

Тип -> (string) (строка)

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

SensitivityLevel -> (string) (строка)

Чувствительность, которую вы хотите, чтобы WAF использовал для проверки на предмет атак типа SQL-инъекций.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Для получения информации об определении и смягчении ложных срабатываний см. раздел Тестирование и настройка в Руководстве разработчика WAF .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другую защиту от атак типа SQL-инъекций или имеют низкую толерантность к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (structure) (структура)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). В атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских сценариев в другие законные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как простой текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в web ACL AssociationConfig для дополнительных сборов за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в web ACL AssociationConfig для дополнительных сборов за обработку.
  • Для Amplify используйте лимит CloudFront.

Доступны следующие варианты обработки больших размеров:

  • CONTINUE - Проверять доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и web ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить HTTP-метод. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в web ACL AssociationConfig для дополнительных сборов за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в web ACL AssociationConfig для дополнительных сборов за обработку.
  • Для Amplify используйте лимит CloudFront.

Доступны следующие варианты обработки больших размеров:

  • CONTINUE - Проверять доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и web ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах, и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах, и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что должен делать WAF, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если в запросе нет отпечатка JA3.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если в запросе нет отпечатка JA4.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования FieldToMatch компонента запроса перед его проверкой, а также в операторах правил на основе частоты для преобразования компонентов запроса перед использованием их в качестве настраиваемых ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования указанного содержимого, начиная с параметра самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

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

SizeConstraintStatement -> (структура)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, вы можете использовать оператор ограничения размера для поиска строк запроса, которые длиннее 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле вплоть до лимита для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера для блокировки запросов с большим размером тела запроса. Дополнительные сведения об ограничениях проверки см. в настройках Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI для значения параметра Part of the request to filter on (Часть запроса для фильтрации), косая черта (/) в URI учитывается как один символ. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как простой текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения об обработке тел запросов, превышающих размер, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос требует от источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения об обработке тел запросов, превышающих размер, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логический оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, и чтобы соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, и чтобы соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что должен делать WAF, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE — проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при резервировании:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при резервировании:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел JSON body в Руководстве разработчика WAF.

ComparisonOperator -> (string)

Оператор для использования для сравнения части запроса с настройкой размера.

Размер -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторые необычные форматирования, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Текстовые преобразования устраняют некоторые необычные форматирования, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и который соответствует веб-запросам на основе кода страны. Правило гео-соответствия помечает каждый запрос, который оно проверяет, независимо от того, нашло ли оно соответствие.

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор сам по себе и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes.
  • В противном случае настройте свое правило гео-соответствия с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам для запуска после правила гео-соответствия и настройте их для соответствия географическим меткам и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухбуквенные коды страны и региона из международного стандарта ISO 3166 Международной организации по стандартизации (ISO). WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в гео-соответствии ForwardedIPConfig .

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете перенаправленный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Дополнительные сведения см. в разделе Оператор правила соответствия географии в Руководстве разработчика WAF .

CountryCodes -> (list)

Массив двухсимвольных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ] , из кодов стран ISO alpha-2 международного стандарта ISO 3166.

Когда вы используете оператор гео-соответствия только для меток региона и страны, которые он добавляет к запросам, вам все равно нужно предоставить код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета совпадающих запросов, но оно по-прежнему будет генерировать логи и метрики подсчета для любых совпадений. Вы можете уменьшить количество журналов и метрик, которые создает правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке, а не использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка для использования для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем предоставьте ARN группы правил в этом операторе.

Нельзя вкладывать RuleGroupReferenceStatement, например, для использования внутри NotStatement или OrStatement. Нельзя использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня внутри правила, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, для которых действия установлены в Count.

Примечание

Вместо этого параметра используйте RuleActionOverrides. Он принимает любую допустимую настройку действия, включая Count.

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count.

Примечание

Вместо этого параметра используйте RuleActionOverrides. Он принимает любую допустимую настройку действия, включая Count.

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count.

RuleActionOverrides -> (list)

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

Примечание

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

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

(structure)

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

Примечание

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

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

Name -> (string)

Имя правила для переопределения.

Примечание

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

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в ваших пользовательских ответах, см. в разделе Поддерживаемые коды состояния для настраиваемого ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить настраиваемый ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блокировку. Чтобы сделать это, вы сначала определяете ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или в настройке по умолчанию веб-ACL BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса с использованием оставшихся правил в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA против веб-запроса.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не просрочен.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge против веб-запроса.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не просрочен.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правила, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который определяет адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать набор IP, см. CreateIPSet.

Каждый оператор правила IP set ссылается на IP set. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Amazon Resource Name (ARN) IPSet, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка, который следует использовать для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите его в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отступлении:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Position -> (string)

Положение в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные — прокси-серверы, через которые прошел запрос.

Для этого параметра доступны следующие варианты:

  • FIRST — проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST — проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY — проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Инструкция по правилу, используемая для поиска соответствий в компонентах веб-запроса с использованием регулярных выражений. Чтобы использовать это, создайте RegexPatternSet, который определяет выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этой инструкции. Веб-запрос соответствует инструкции правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов регулярных выражений, см. CreateRegexPatternSet.

Каждая инструкция правила набора шаблонов регулярных выражений ссылается на набор шаблонов регулярных выражений. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Amazon Resource Name (ARN) набора RegexPatternSet, на который ссылается эта инструкция.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может иметь длину до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий инструкции правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками вашего правила и действия веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Совпадение со всеми элементами. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Совпадение только с указанными путями включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью разобрать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий инструкции правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе о теле JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий инструкции правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками вашего правила и действия веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверьте только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedHeaders -> (список)

Проверьте только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверьте только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedCookies -> (список)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Обычным образом проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления поля при проверке. WAF разделяет имена заголовков в строке, используя двоеточия, и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации утверждения сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Состояние сопоставления, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации утверждения сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Состояние сопоставления, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Возможные варианты:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразований см. в разделе Text transformations в WAF Developer Guide .

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает скорость запросов, когда они поступают со слишком большой скоростью. Правило классифицирует запросы в соответствии с критериями агрегирования, собирает их в экземпляры агрегирования, а также подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в используемом правиле, изменение приведет к сбросу счетчиков ограничения скорости правила. Это может приостановить действия правила по ограничению скорости на срок до одной минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегирования, такие как IP-адрес и метод HTTP, или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для указанных вами ключей агрегирования представляет собой отдельный экземпляр агрегирования, при этом значение каждого ключа вносит вклад в определение экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило создаст разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого из них. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегирования является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: количество 2
    • Метод HTTP GET: количество 2
  • Если критериями агрегирования являются IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в объединенный экземпляр агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любой n-кортежа ключей агрегирования каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает по скорости по отдельности.

При необходимости вы можете вложить другой оператор внутри оператора на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только тех запросов, которые соответствуют вложенному оператору. Вы можете использовать этот вложенный оператор сужения области действия в сочетании со спецификациями ключей агрегирования или просто подсчитывать и ограничивать скорость всех запросов, соответствующих оператору сужения области действия, без дополнительного агрегирования. Когда вы решите просто управлять всеми запросами, соответствующими оператору сужения области действия, экземпляр агрегирования является единственным для правила.

Вы не можете вложить RateBasedStatement внутри другого оператора, например, внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Дополнительную информацию о параметрах см. в разделе Rate limiting web requests using rate-based rules в WAF Developer Guide .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, которые WAF в настоящее время ограничивает по скорости для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставите одни и те же настройки правила на основе скорости в двух веб-ACL, каждый из двух операторов правил представляет собой отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление WAF.

Лимит -> (long)

Предел по запросам в течение указанного окна оценки для одного экземпляра агрегирования для правила на основе скорости. Если оператор на основе скорости включает в себя ScopeDownStatement , этот предел применяется только к запросам, соответствующим оператору.

Примеры:

  • Если вы агрегируете только по IP-адресу, это предел по запросам с любого отдельного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это предел по запросам для любой отдельной пары метод-город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в подсчет своих запросов, оглядываясь назад с текущего момента времени. Например, для настройки 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые значения: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а то, как далеко назад он смотрит каждый раз, когда проверяет. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 minutes)

AggregateKeyType -> (string)

Настройка, которая указывает, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте запросы, соответствующие оператору сужения области действия правила на основе скорости. С помощью этого параметра подсчитываемые запросы не агрегируются дополнительно. Оператор сужения области действия — единственная используемая спецификация. Когда количество всех запросов, удовлетворяющих оператору сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим оператору сужения области действия. С этим параметром необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. С этим параметром необходимо указать ключи агрегирования в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите для типа ключа агрегирования значение IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. С этим параметром необходимо указать заголовок, который будет использоваться в свойстве ForwardedIPConfig . Чтобы агрегировать по комбинации перенаправленного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу от источника веб-запроса. Чтобы агрегировать по комбинации IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (string)

Имя заголовка HTTP для использования для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные режимы:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

CustomKeys -> (list)

Задает совокупные ключи для использования в правиле на основе скорости.

(структура)

Задает один пользовательский совокупный ключ для правила на основе скорости.

Примечание

Web-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, исключаются из оценки и обработки правила на основе скорости.

Заголовок -> (структура)

Используйте значение заголовка в запросе в качестве совокупного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегации. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя заголовка для использования.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

Cookie -> (структура)

Используйте значение cookie в запросе в качестве совокупного ключа. Каждое отдельное значение cookie вносит вклад в экземпляр агрегации. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя cookie для использования.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryArgument -> (структура)

Используйте указанный аргумент запроса в качестве совокупного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегации. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя аргумента запроса для использования.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryString -> (структура)

Используйте строку запроса запроса в качестве совокупного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегации. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегации.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

HTTPMethod -> (структура)

Используйте HTTP-метод запроса в качестве совокупного ключа. Каждый отдельный HTTP-метод вносит вклад в экземпляр агрегации. Если вы используете только HTTP-метод в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегации.

ForwardedIP -> (структура)

Используйте первый IP-адрес в HTTP-заголовке в качестве совокупного ключа. Каждый отдельный пересланный IP-адрес вносит вклад в экземпляр агрегации.

Когда вы указываете IP-адрес или пересланный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум еще один ключ для использования. Вы можете агрегировать только по пересланному IP-адресу, указав FORWARDED_IP в вашем операторе на основе скорости AggregateKeyType .

С этим параметром вы должны указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (структура)

Используйте исходный IP-адрес запроса в качестве совокупного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегации.

Когда вы указываете IP-адрес или пересланный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум еще один ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в вашем операторе на основе скорости AggregateKeyType .

LabelNamespace -> (структура)

Используйте указанное пространство имен метки в качестве совокупного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегации. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегации.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

Информацию о пространствах имен и именах меток см. в разделе Синтаксис и требования к именованию меток в Руководстве разработчика WAF .

Namespace -> (строка)

Пространство имен для использования для агрегации.

UriPath -> (структура)

Используйте путь URI запроса в качестве совокупного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегации. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегации.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

JA3Fingerprint -> (структура)

Используйте отпечаток пальца JA3 запроса в качестве совокупного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Состояние соответствия, которое следует присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой AND. Вы предоставляете более одного оператора в рамках AndStatement .

Statements -> (list)

Операторы для объединения с логикой AND. Вы можете использовать любые операторы, которые можно вложить.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой OR. Вы предоставляете более одного оператора в рамках OrStatement .

Statements -> (list)

Операторы для объединения с логикой OR. Вы можете использовать любые операторы, которые можно вложить.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один оператор в рамках NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Нельзя вкладывать ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Нельзя использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

Примечание

Взимается дополнительная плата при использовании управляемой группы правил управления ботами WAF AWSManagedRulesBotControlRuleSet , управляемой группы правил предотвращения захвата учетной записи (ATP) управления мошенничеством WAF AWSManagedRulesATPRuleSet или управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP) управления мошенничеством WAF AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксирована, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика при обновлении поставщиком настроек управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылаемой группе правил, действия которых установлены на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты пользователя и номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа вашего приложения и местоположения в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил управления ботами.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты пользователя и номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа вашего приложения и местоположения в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил управления ботами.

Например, спецификации см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запросов для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запросов для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезных нагрузок, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запросов для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезных нагрузок, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Информацию об использовании управляемой группы правил Bot Control см. в разделе Группа правил управления ботами WAF и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки для использования для группы правил Bot Control. Общий уровень является наименее затратным. Целевой уровень включает в себя все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе Группа правил управления ботами WAF в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет действий, связанных с ботами. Машинное обучение требуется для правил управления ботами TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Список правил управления ботами в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил защиты от захвата учетной записи (ATP), AWSManagedRulesATPRuleSet. Используйте это, чтобы предоставить информацию о запросе на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. раздел WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в WAF Developer Guide.

LoginPath -> (string)

Путь к конечной точке входа для вашего приложения. Например, для URL https://example.com/web/login вы должны предоставить путь /web/login. Пути входа, которые начинаются с предоставленного вами пути, считаются соответствующими. Например, /web/login соответствует путям входа /web/login, /web/login/, /web/loginPage и /web/login/thisPage, но не соответствует пути входа /home/web/login или /website/login.

Группа правил проверяет только HTTP POST запросы к указанной конечной точке входа.

RequestInspection -> (structure)

Критерии для проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа, либо JSON, либо форма с кодировкой.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для JSON-полезных нагрузок укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для JSON-полезной нагрузки { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username.
  • Для типов полезных нагрузок с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для JSON-полезных нагрузок укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для JSON-полезной нагрузки { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username.
  • Для типов полезных нагрузок с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для JSON-полезных нагрузок укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для JSON-полезной нагрузки { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password.
  • Для типов полезных нагрузок с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1.

Identifier -> (string)

Имя поля пароля.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для JSON-полезных нагрузок укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для JSON-полезной нагрузки { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password.
  • Для типов полезных нагрузок с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1.

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиента, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно быть точным совпадением, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачным, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON-ответа для индикаторов успеха и сбоя. WAF может проверять первые 65 536 байт (64 КБ) JSON-ответа.

Identifier -> (string)

Идентификатор значения, с которым нужно сопоставить в JSON. Идентификатор должен быть точным совпадением, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON-ответе, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON-ответе, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet . Используйте это, чтобы предоставить информацию о запросах на создание учетной записи в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив отвечает на запросы на создание учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. WAF Fraud Control account creation fraud prevention (ACFP) rule group и WAF Fraud Control account creation fraud prevention (ACFP) в WAF Developer Guide .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount, вы предоставите путь /web/newaccount . Пути к страницам создания учетных записей, начинающиеся с указанного вами пути, считаются совпадением. Например /web/newaccount соответствует путям создания учетной записи /web/newaccount , /web/newaccount/ , /web/newaccountPage и /web/newaccount/thisPage , но не соответствует пути /home/web/newaccount или /website/newaccount .

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая представляет форму регистрации новым пользователям.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL https://example.com/web/registration, вы предоставите путь /web/registration . Пути к страницам регистрации, начинающиеся с указанного вами пути, считаются совпадением. Например /web/registration соответствует путям регистрации /web/registration , /web/registration/ , /web/registrationPage и /web/registration/thisPage , но не соответствует пути /home/web/registration или /website/registration .

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или форма с кодировкой.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификацией поля имени пользователя является /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификацией поля имени пользователя является username1

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификацией поля имени пользователя является /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификацией поля имени пользователя является username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификацией поля пароля является /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификацией поля пароля является password1 .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификацией поля пароля является /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификацией поля пароля является password1 .

EmailField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего электронную почту вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификацией поля электронной почты является /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 , спецификацией поля электронной почты является email1 .

Identifier -> (string)

Имя поля электронной почты.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификацией поля электронной почты является /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 , спецификацией поля электронной почты является email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так, как они упорядочены в полезной нагрузке запроса.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторами поля номера телефона являются /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторами поля номера телефона являются primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного номера телефона.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторами поля номера телефона являются /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторами поля номера телефона являются primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так, как они упорядочены в полезной нагрузке запроса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторами поля адреса являются /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторами полей адреса являются primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного адреса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторами поля адреса являются /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторами полей адреса являются primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетных записей.

Примечание

Проверка ответов доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентами, ведя подсчет успешных и неудачных попыток с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Название заголовка для сопоставления. Название должно точно соответствовать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и сбоя. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

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

Примечание

Не забудьте проверить имена правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления вашим веб-трафиком группой правил.

(структура)

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

Примечание

Не забудьте проверить имена правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления вашим веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

Не забудьте проверить имена правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ на веб-запрос.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL настройке BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Можно указать любое имя заголовка, кроме content-type. Повторные имена заголовков запрещены.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Повторные имена заголовков запрещены.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Повторные имена заголовков запрещены.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Повторные имена заголовков запрещены.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Повторные имена заголовков запрещены.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, которые были добавлены к веб-запросу правилами, которые уже были запущены в веб-ACL.

Оператор сопоставления меток предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю строку полного имени метки, которая была добавлена к веб-запросу. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс определяет группу правил или контекст веб-ACL правила, добавившего метку. Если вы не предоставите полное имя в строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора соответствия:

  • Если Scope указывает LABEL, то это указание должно включать имя и может включать любое количество предшествующих спецификаций пространства имен и префикс до предоставления полного имени метки.
  • Если Scope указывает NAMESPACE, то это указание может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, где возникает метка.

Метки чувствительны к регистру, а компоненты метки должны разделяться двоеточием, например NS1:NS2:name.

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как простой текст. Тело запроса сразу следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать слишком большие тела запросов, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки негабаритных размеров с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса сразу следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать слишком большие тела запросов, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое заявление AND для объединения двух правил сопоставления, одного, которое проверяет ключи, и другого, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как простой текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки негабаритных размеров с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры сопоставления области видимости и шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка сверхразмерного формата в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки переразмерного формата следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области видимости и шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie сверхразмерного формата в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки переразмерного формата следующие:

  • CONTINUE - Обычно проверяйте доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки переразмерного формата следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY .

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое следует назначить веб-запросу, если у запроса нет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отступлении:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY .

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое следует назначить веб-запросу, если у запроса нет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отступлении:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области видимости и шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI сверхразмерного формата в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отступлении. Дополнительную информацию см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

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

ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса на создание учетной записи таких данных, как адрес электронной почты пользователя и номера телефонов.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и местоположения в полезной нагрузке запроса на вход таких данных, как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet, чтобы настроить уровень защиты, который вы хотите, чтобы использовала группа правил Bot Control.

(структура)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса на создание учетной записи таких данных, как адрес электронной почты пользователя и номера телефонов.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и местоположения в полезной нагрузке запроса на вход таких данных, как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet, чтобы настроить уровень защиты, который вы хотите, чтобы использовала группа правил Bot Control.

Примеры спецификаций см. в разделе примеров раздела CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя имеет вид /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя имеет вид username1

PasswordField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля имеет вид /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля имеет вид password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Сведения об использовании управляемой группы правил Bot Control см. в разделах WAF Bot Control rule group и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки для использования в группе правил Bot Control. Общий уровень является наименее дорогостоящим. Целевой уровень включает в себя все общие правила уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе WAF Bot Control rule group в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применимо только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют аномальное поведение, которое может указывать на распределенную, скоординированную активность ботов.

Дополнительные сведения об этом выборе см. в списке этих правил в таблице в разделе Bot Control rules listing в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet. Используйте это, чтобы предоставить информацию о запросе на вход в группу правил. Для списков управления доступом к сети (ACL), защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив отвечает на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функции.

Для получения информации об использовании управляемой группы правил ATP см. группу правил предотвращения захвата учетной записи (ATP) WAF Fraud Control и предотвращение захвата учетной записи (ATP) WAF Fraud Control в Руководстве разработчика WAF.

LoginPath -> (string)

Путь к конечной точке входа в ваше приложение. Например, для URL-адреса https://example.com/web/login, вы должны предоставить путь /web/login. Пути входа, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/login соответствует путям входа /web/login, /web/login/, /web/loginPage и /web/login/thisPage, но не соответствует пути входа /home/web/login или /website/login.

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии для проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезных данных для вашей конечной точки входа, либо JSON, либо закодированный в форме.

UsernameField -> (structure)

Имя поля в полезных данных запроса, которое содержит имя пользователя вашего клиента.

То, как вы это указываете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя - /form/username.
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя - username1

Identifier -> (string)

Имя поля имени пользователя.

То, как вы это указываете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя - /form/username.
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя - username1

PasswordField -> (structure)

Имя поля в полезных данных запроса, которое содержит пароль вашего клиента.

То, как вы это указываете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля - /form/password.
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля - password1.

Identifier -> (string)

Имя поля пароля.

То, как вы это указываете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля - /form/password.
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля - password1.

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в списках управления доступом к сети, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиентов, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно быть точным совпадением, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и сбоя. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно сопоставить в JSON. Идентификатор должен быть точным совпадением, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet. Используйте это, чтобы предоставить информацию о запросе на создание учетной записи группе правил. Для веб-ACL, которые защищают дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на создание учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. группу правил предотвращения мошенничества при создании учетной записи WAF Fraud Control (ACFP) и предотвращение мошенничества при создании учетной записи WAF Fraud Control (ACFP) в Руководстве разработчика WAF.

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount, вы должны предоставить путь /web/newaccount. Пути к страницам создания учетной записи, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая представляет форму регистрации новым пользователям.

Примечание

Эта страница должна принимать GET запросы text/html.

Например, для URL https://example.com/web/registration, вы должны предоставить путь /web/registration. Пути к страницам регистрации, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или закодированная форма.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } }, спецификация поля имени пользователя выглядит как /form/username.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя выглядит как username1

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя выглядит как /form/username.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя выглядит как username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля выглядит как /form/password.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля выглядит как password1.

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля выглядит как /form/password.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля выглядит как password1.

EmailField -> (structure)

Название поля в полезной нагрузке запроса, содержащего электронную почту вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты выглядит как /form/email.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 спецификация поля электронной почты выглядит как email1.

Identifier -> (string)

Имя поля электронной почты.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты выглядит как /form/email.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 спецификация поля электронной почты выглядит как email1.

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Укажите поля номера телефона в массиве именно в том порядке, в котором они указаны в полезной нагрузке запроса.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона — /form/primaryphoneline1, /form/primaryphoneline2 и /form/primaryphoneline3.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1, primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона — primaryphoneline1, primaryphoneline2 и primaryphoneline3.

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP.

Identifier -> (string)

Имя одного поля основного номера телефона.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона — /form/primaryphoneline1, /form/primaryphoneline2 и /form/primaryphoneline3.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1, primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона — primaryphoneline1, primaryphoneline2 и primaryphoneline3.

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Укажите поля адреса в массиве именно в том порядке, в котором они указаны в полезной нагрузке запроса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса — /form/primaryaddressline1, /form/primaryaddressline2 и /form/primaryaddressline3.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1, primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса — primaryaddressline1, primaryaddressline2 и primaryaddressline3.

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP.

Identifier -> (string)

Имя одного поля основного адреса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса — /form/primaryaddressline1, /form/primaryaddressline2 и /form/primaryaddressline3.
  • Для типов полезной нагрузки, закодированных формой, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1, primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса — primaryaddressline1, primaryaddressline2 и primaryaddressline3.

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответов доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентом, ведя подсчет успешных и неудачных попыток с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы из сеансов клиентов и IP-адресов, которые совершили слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным совпадением, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен быть точным совпадением, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(структура)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ на веб-запрос.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

ResponseCode -> (integer)

Код состояния HTTP, который необходимо вернуть клиенту.

For a list of status codes that you can use in your custom responses, see Supported status codes for custom response in the WAF Developer Guide .

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL BlockAction настройке, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, которые были добавлены в веб-запрос правилами, которые уже были запущены в веб-ACL.

Оператор сопоставления с метками предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю полностью определенную имя метки, которое было добавлено в веб-запрос. Полностью определенные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, добавившего метку. Если вы не предоставите полностью определенное имя в строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы сопоставлять, используя имя метки, или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора сопоставления:

  • Если Scope указывает LABEL , то это спецификация должна включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс, вплоть до предоставления полностью определенного имени метки.
  • Если Scope указывает NAMESPACE , то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен меток из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, и компоненты метки должны быть разделены двоеточием, например NS1:NS2:name .

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если он есть.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступного содержимого тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры обработки больших размеров MATCH или NO_MATCH с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверить тело запроса в формате JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Соответствует всем элементам. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствует только указанным путям включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр, чтобы включить все пути. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND, чтобы объединить два правила сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недействительного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступного содержимого тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры обработки больших размеров MATCH или NO_MATCH с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка негабаритного размера в объекте Headers. WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, значениях или обоих. Чтобы потребовать соответствия как в ключах, так и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie негабаритного размера в объекте Cookies. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, значениях или обоих. Чтобы потребовать соответствия как в ключах, так и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что должен делать WAF, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления поля при проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить отпечаток JA3 запроса. Отпечаток JA3 представляет собой 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, присваиваемый веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 представляет собой 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, присваиваемый веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

UriFragment -> (структура)

Проверка фрагментов URI запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI негабаритного размера в объекте UriFragment. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF parsing doesn’t fully validate the input JSON string, so parsing can succeed even for invalid JSON. When parsing succeeds, WAF doesn’t apply the fallback behavior. For more information, see JSON body in the WAF Developer Guide .

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного контента, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

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

Действие -> (structure)

Действие, которое WAF должен предпринять в отношении веб-запроса, когда он соответствует оператору правила. Настройки на уровне веб-ACL могут переопределить настройку действия правила.

Это используется только для правил, операторы которых не ссылаются на группу правил. Операторы правил, которые ссылаются на группу правил, включают RuleGroupReferenceStatement и ManagedRuleGroupStatement .

Вы должны указать либо эту настройку Action, либо настройку OverrideAction правила, но не обе:

  • Если оператор правила не ссылается на группу правил, используйте эту настройку действия правила, а не настройку действия переопределения правила.
  • Если оператор правила ссылается на группу правил, используйте действие переопределения, а не это действие.

Блокировать -> (structure)

Предписывает WAF блокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP, который нужно вернуть клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое настроено на блокировку. Чтобы сделать это, сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или в действии по умолчанию веб-ACL, настройке BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, за исключением content-type . Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Имя -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Разрешить -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Имя -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Считать -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Имя -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Имя -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Имя -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

OverrideAction -> (structure)

Действие, которое следует использовать вместо действия, полученного в результате оценки группы правил. Установите действие переопределения на none, чтобы оставить результат группы правил без изменений. Установите его на count, чтобы переопределить результат только для подсчета.

Вы можете использовать это только для операторов правил, которые ссылаются на группу правил, например RuleGroupReferenceStatement и ManagedRuleGroupStatement .

Примечание

Этот параметр обычно устанавливается в значение none. Он не влияет на то, как оцениваются правила в группе правил. Если вы хотите, чтобы правила в группе правил только подсчитывали совпадения, не используйте это, а вместо этого используйте параметр переопределения действия правила с действием Count в настройках оператора ссылки на группу правил.

Count -> (structure)

Переопределить результат оценки группы правил только для подсчета.

Примечание

Этот параметр обычно устанавливается в значение none. Он не влияет на то, как оцениваются правила в группе правил. Если вы хотите, чтобы правила в группе правил только подсчитывали совпадения, не используйте это, а вместо этого используйте параметр переопределения действия правила с действием Count в настройках оператора ссылки на группу правил.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

HTTP-заголовки, которые необходимо вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

None -> (structure)

Не переопределять результат оценки группы правил. Это наиболее распространенная настройка.

RuleLabels -> (list)

Метки для применения к веб-запросам, соответствующим оператору соответствия правилам. WAF применяет полностью квалифицированные метки к соответствующим веб-запросам. Полностью квалифицированная метка представляет собой конкатенацию пространства имен метки и имени метки правила. Группа правил или веб-ACL правила определяет пространство имен метки.

Примечание

Любое правило, которое не является оператором ссылки на группу правил или оператором управляемой группы правил, может добавлять метки к соответствующим веб-запросам.

Правила, которые выполняются после этого правила в веб-ACL, могут соответствовать этим меткам, используя LabelMatchStatement .

Для каждой метки укажите строку с учетом регистра, содержащую необязательные пространства имен и имя метки, в соответствии со следующими рекомендациями:

  • Разделите каждый компонент метки двоеточием.
  • Каждое пространство имен или имя может содержать до 128 символов.
  • Вы можете указать до 5 пространств имен в метке.
  • Не используйте следующие зарезервированные слова в спецификации метки: aws , waf , managed , rulegroup , webacl , regexpatternset или ipset .

Например, myLabelName или nameSpace1:nameSpace2:myLabelName .

(structure)

Один контейнер метки. Он используется в качестве элемента массива меток в нескольких контекстах, например, в RuleLabels внутри Rule и в Labels внутри SampledHTTPRequest .

Name -> (string)

Строка метки.

VisibilityConfig -> (structure)

Определяет и включает метрики Amazon CloudWatch и сбор образцов веб-запросов.

Если вы измените имя Rule после его создания и хотите, чтобы имя метрики правила отражало изменение, обновите также имя метрики. WAF не обновляет имя метрики автоматически.

SampledRequestsEnabled -> (boolean)

Указывает, следует ли WAF хранить выборку веб-запросов, соответствующих правилам. Вы можете просмотреть выборку запросов через консоль WAF.

Если вы настраиваете защиту данных для веб-ACL, защита применяется к данным выборки веб-запросов веб-ACL.

Примечание

Выборка запросов не предоставляет опцию редактирования полей, и любое редактирование полей, которое вы указываете в конфигурации ведения журнала, не влияет на выборку. Вы можете исключить поля из выборки запросов, только отключив выборку в конфигурации видимости веб-ACL или настроив защиту данных для веб-ACL.

CloudWatchMetricsEnabled -> (boolean)

Указывает, отправляет ли связанный ресурс метрики в Amazon CloudWatch. Список доступных метрик см. в разделе Метрики WAF в Руководстве разработчика WAF .

Для веб-ACL метрики предназначены для веб-запросов, к которым применено действие по умолчанию веб-ACL. WAF применяет действие по умолчанию к веб-запросам, которые проходят проверку всех правил в веб-ACL, не будучи разрешенными или заблокированными. Дополнительные сведения см. в разделе Действие по умолчанию веб-ACL в Руководстве разработчика WAF .

MetricName -> (string)

Имя измерения метрики Amazon CloudWatch. Имя может содержать только символы: A-Z, a-z, 0-9, - (дефис) и _ (подчеркивание). Длина имени может составлять от одного до 128 символов. Оно не может содержать пробелы или имена метрик, зарезервированные для WAF, например All и Default_Action .

CaptchaConfig -> (structure)

Указывает, как WAF должен обрабатывать оценки CAPTCHA . Если вы не укажете это, WAF использует конфигурацию CAPTCHA , которая определена для веб-ACL.

ImmunityTimeProperty -> (structure)

Определяет, как долго метка CAPTCHA в токене остается действительной после того, как клиент успешно решит головоломку CAPTCHA .

ImmunityTime -> (long)

Количество времени в секундах, в течение которого отметка времени CAPTCHA или проверки считается действительной WAF. Значение по умолчанию — 300.

Для действия Challenge минимальная настройка составляет 300.

ChallengeConfig -> (structure)

Указывает, как WAF должен обрабатывать оценки Challenge . Если вы не укажете это, WAF использует конфигурацию Challenge, которая определена для веб-ACL.

ImmunityTimeProperty -> (structure)

Определяет, как долго отметка времени проверки остается действительной в токене после того, как клиент успешно ответит на проверку.

ImmunityTime -> (long)

Количество времени в секундах, в течение которого отметка времени CAPTCHA или проверки считается действительной WAF. Значение по умолчанию — 300.

Для действия Challenge минимальная настройка составляет 300.

VisibilityConfig -> (structure)

Определяет и включает метрики Amazon CloudWatch и сбор образцов веб-запросов.

SampledRequestsEnabled -> (boolean)

Указывает, следует ли WAF хранить выборку веб-запросов, соответствующих правилам. Вы можете просмотреть выборку запросов через консоль WAF.

Если вы настраиваете защиту данных для веб-ACL, защита применяется к данным выборки веб-запросов веб-ACL.

Примечание

Выборка запросов не предоставляет опцию редактирования полей, и любое редактирование полей, которое вы указываете в конфигурации ведения журнала, не влияет на выборку. Вы можете исключить поля из выборки запросов, только отключив выборку в конфигурации видимости веб-ACL или настроив защиту данных для веб-ACL.

CloudWatchMetricsEnabled -> (boolean)

Указывает, отправляет ли связанный ресурс метрики в Amazon CloudWatch. Список доступных метрик см. в разделе Метрики WAF в Руководстве разработчика WAF .

Для веб-ACL метрики предназначены для веб-запросов, к которым применено действие по умолчанию веб-ACL. WAF применяет действие по умолчанию к веб-запросам, которые проходят проверку всех правил в веб-ACL, не будучи разрешенными или заблокированными. Дополнительные сведения см. в разделе Действие по умолчанию веб-ACL в Руководстве разработчика WAF .

MetricName -> (string)

Имя измерения метрики Amazon CloudWatch. Имя может содержать только символы: A-Z, a-z, 0-9, - (дефис) и _ (подчеркивание). Длина имени может составлять от одного до 128 символов. Оно не может содержать пробелы или имена метрик, зарезервированные для WAF, например All и Default_Action .

DataProtectionConfig -> (structure)

Определяет защиту данных, которую следует применить к данным веб-запроса для веб-ACL. Это параметр защиты данных на уровне веб-ACL.

Защита данных, которую вы настраиваете для веб-ACL, изменяет данные, доступные для любой другой деятельности по сбору данных, включая ваши журналы WAF, выборку запросов веб-ACL и сбор и управление данными Amazon Security Lake. Вашим другим вариантом защиты данных является конфигурация ведения журналов, которая влияет только на ведение журналов.

DataProtections -> (list)

Массив конфигураций защиты данных для определенных типов полей веб-запросов. Это определяется для каждого веб-ACL. WAF применяет указанную защиту ко всем веб-запросам, которые проверяет веб-ACL.

(structure)

Определяет поведение защиты для типа поля. Это часть конфигурации защиты данных для веб-ACL.

Field -> (structure)

Определяет тип поля и необязательные ключи для применения поведения защиты.

FieldType -> (string)

Указывает тип компонента веб-запроса для защиты.

FieldKeys -> (list)

Указывает ключи для защиты для указанного типа поля. Если вы не укажете ни одного ключа, будут защищены все ключи для типа поля.

(string)

Action -> (string)

Определяет, как защитить поле. WAF может применить односторонний хэш к полю или жестко закодировать подстановку строки.

  • Пример одностороннего хэширования: ade099751dEXAMPLEHASH2ea9f3393f80dd5d3bEXAMPLEHASH966ae0d3cd5a1e
  • Пример замены: REDACTED

ExcludeRuleMatchDetails -> (boolean)

Указывает, следует ли также исключать любые детали соответствия правилам из защиты данных, которую вы включили для данного поля. WAF регистрирует эти детали для нетерминальных соответствующих правил и для терминального соответствующего правила. Для получения дополнительной информации см. раздел Log fields for web ACL traffic в WAF Developer Guide .

По умолчанию: FALSE

ExcludeRateBasedDetails -> (boolean)

Указывает, следует ли также исключать любые детали правила на основе частоты из защиты данных, которую вы включили для данного поля. Если вы укажете это исключение, RateBasedDetails покажет значение поля. Для получения дополнительной информации см. поле журнала rateBasedRuleList в Log fields for web ACL traffic в WAF Developer Guide .

По умолчанию: FALSE

Capacity -> (long)

Единицы емкости веб-ACL (WCUs), которые в настоящее время используются этим веб-ACL.

WAF использует WCUs для расчета и управления операционными ресурсами, которые используются для запуска ваших правил, групп правил и веб-ACL. WAF вычисляет емкость по-разному для каждого типа правила, чтобы отразить относительную стоимость каждого правила. Простые правила, которые стоят недорого, используют меньше WCUs, чем более сложные правила, которые используют больше вычислительной мощности. Емкость группы правил фиксируется при создании, что помогает пользователям планировать использование WCU веб-ACL при использовании группы правил. Для получения дополнительной информации см. раздел WAF web ACL capacity units (WCU) в WAF Developer Guide .

PreProcessFirewallManagerRuleGroups -> (list)

Первый набор правил для обработки WAF в веб-ACL. Это определяется в политике Firewall Manager WAF и содержит только ссылки на группы правил. Вы не можете изменить их. Любые правила и группы правил, которые вы определяете для веб-ACL, имеют приоритет после них.

В политике Firewall Manager WAF администратор Firewall Manager может определить набор групп правил для запуска первыми в веб-ACL и набор групп правил для запуска последними. В каждом наборе администратор определяет приоритет групп правил, чтобы определить их относительный порядок обработки.

(structure)

Группа правил, определенная для политики Firewall Manager WAF.

Name -> (string)

Имя группы правил. Вы не можете изменить имя группы правил после ее создания.

Priority -> (integer)

Если вы определите более одной группы правил в первых или последних группах правил Firewall Manager, WAF оценивает каждый запрос по группам правил по порядку, начиная с самой низкой настройки приоритета. Приоритеты не должны быть последовательными, но все они должны быть разными.

FirewallManagerStatement -> (structure)

Руководство по обработке для правила Firewall Manager. Это как обычная Statement правила, но оно может содержать только ссылку на группу правил.

ManagedRuleGroupStatement -> (structure)

Инструкция, используемая Firewall Manager для запуска правил, определенных в управляемой группе правил. Управляется Firewall Manager для политики Firewall Manager WAF.

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика, когда поставщик обновляет настройки управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

ScopeDownStatement -> (structure)

Необязательная вложенная инструкция, которая сужает область веб-запросов, оцениваемых управляемой группой правил. Запросы оцениваются только группой правил, если они соответствуют инструкции сужения области. Вы можете использовать любую вложенную Statement в инструкции сужения области, и вы можете вкладывать инструкции на любом уровне, так же, как и для инструкции правила.

ByteMatchStatement -> (structure)

Инструкция правила, которая определяет поиск соответствия строк для WAF, который должен применяться к веб-запросам. Инструкция соответствия байтов предоставляет байты для поиска, местоположение в запросах, которые вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска обычно представляют собой строку, соответствующую символам ASCII. В консоли WAF и в руководстве для разработчиков это называется инструкцией соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF выполняет поиск только в той части веб-запросов, которую вы указываете для проверки в FieldToMatch . Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. Вы можете использовать этот параметр только с соответствием строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY . Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может рассчитать отпечаток, он включает его в журналы. Сведения о полях журнала см. в разделе Log fields в WAF Developer Guide .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, содержащую упорядоченный список имен заголовков из заголовков в веб-запросе, а затем выполняет сопоставление с этой строкой.

Если SearchString включает буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете API WAF

Укажите версию значения, закодированную в формате base64. Максимальная длина значения до кодирования base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER , а значение Data равно User-Agent . Если вы хотите выполнить поиск в заголовке User-Agent для значения BadBot , вы кодируете BadBot с использованием кодирования MIME base64 и включаете полученное значение, QmFkQm90 , в значение SearchString .

Если вы используете CLI или один из Amazon Web Services SDK

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg .

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в списке управления доступом к веб-ресурсам AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в списке управления доступом к веб-ресурсам AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и списка управления доступом к веб-ресурсам, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить с источником.

JsonBody -> (структура)

Проверьте тело запроса как JSON. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в списке управления доступом к веб-ресурсам AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (структура)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (список)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию рабочей группы Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах, или в значениях, или в обоих. Чтобы потребовать совпадение в ключах и в значениях, используйте логическое выражение AND , чтобы объединить два правила сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (строка)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для неверного JSON. Когда анализ проходит успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в списке управления доступом к веб-ресурсам AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и списка управления доступом к веб-ресурсам, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, либо IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует соответствия в ключах и соответствия в значениях. Требуется соответствие в ключах или в значениях, или и в том, и в другом. Чтобы потребовать соответствие в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, либо IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с использованием критериев проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует соответствия в ключах и соответствия в значениях. Требуется соответствие в ключах или в значениях, или и в том, и в другом. Чтобы потребовать соответствие в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления в своей проверке. WAF разделяет имена заголовков в строке двоеточиями и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, для которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement, где PositionalConstraint имеет значение EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора соответствия строки, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет отпечатка JA3.

Можно указать следующие резервные режимы:

  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, для которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement, где PositionalConstraint имеет значение EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора соответствия строки, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет отпечатка JA4.

Можно указать следующие резервные режимы:

  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если он не может полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING — проверять тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может выполняться успешно даже для неверного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости, чтобы преобразовать компоненты запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

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

PositionalConstraint -> (строка)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString. Допустимые значения включают следующие:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString, но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString, а SearchString должен содержать только буквенно-цифровые символы или подчеркивания (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что выполняются оба следующих условия:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot.
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot;.
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString.

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (структура)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Альтернативно вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — проверять доступное содержимое тела обычным способом в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Требуется найти совпадение в ключах или значениях, или в обоих. Чтобы потребовать совпадение в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — проверять доступное содержимое тела обычным способом в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента соответствия поля при проверке. WAF разделяет имена заголовков в строке двоеточиями без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях журнала см. Log fields в WAF Developer Guide.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора соответствия строки, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях журнала см. Log fields в WAF Developer Guide.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора соответствия строки, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагментов URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в WAF Developer Guide.

TextTransformations -> (list)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

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

SensitivityLevel -> (строка)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на атаки типа SQL injection.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию об обнаружении и смягчении последствий ложных срабатываний см. в разделе Тестирование и настройка в Руководстве разработчика WAF.

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак типа SQL injection или имеют низкую толерантность к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (структура)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). При XSS-атаках злоумышленник использует уязвимости на безобидном веб-сайте как средство внедрения вредоносных клиентских скриптов в другие легитимные веб-браузеры.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это та часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверьте строку запроса. Это та часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычно в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с вашими параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Возможные варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ успешен, WAF не применяет поведение отката. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что должен делать WAF, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычно в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с вашими параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для определения подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие - в значениях. Требуется, чтобы соответствие было найдено в ключах или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей и другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать, что веб-запрос не соответствует оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для определения подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие - в значениях. Требуется, чтобы соответствие было найдено в ключах или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей и другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать, что веб-запрос не соответствует оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в каком они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента соответствия поля в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать, что веб-запрос не соответствует оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать, что веб-запрос не соответствует оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать, что веб-запрос не соответствует оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагментов URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать, что веб-запрос не соответствует оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

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

SizeConstraintStatement -> (структура)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, вы можете использовать оператор ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле запроса до предела для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать предел проверки, вы можете использовать оператор ограничения размера для блокировки запросов, размер тела которых больше. Для получения дополнительной информации об ограничениях проверки см. параметры Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI учитывается как один символ. Например, URI /logo.jpg состоит из девяти символов.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело запроса превышает предел для типа ресурса. Когда тело веб-запроса больше предела, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, для проверки WAF.

  • Для Application Load Balancer и AppSync ограничение установлено в 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте ограничение CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело запроса превышает предел для типа ресурса. Когда тело веб-запроса больше предела, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, для проверки WAF.

  • Для Application Load Balancer и AppSync ограничение установлено в 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте ограничение CloudFront.

Параметры обработки больших размеров:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает для выполнения источником.

JsonBody -> (структура)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело запроса превышает предел для типа ресурса. Когда тело веб-запроса больше предела, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, для проверки WAF.

  • Для Application Load Balancer и AppSync ограничение установлено в 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте ограничение CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (структура)

Соответствие всем элементам. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (список)

Соответствует только указанным путям включения. См. также MatchScope в JsonBody.

Укажите пути включения с использованием синтаксиса JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки анализа, с которой сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело запроса превышает предел для типа ресурса. Когда тело веб-запроса больше предела, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, для проверки WAF.

  • Для Application Load Balancer и AppSync ограничение установлено в 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте ограничение CloudFront.

Параметры обработки больших размеров:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверьте все заголовки.

IncludedHeaders -> (список)

Проверяйте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверяйте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверит как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое оператор AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL , WAF проверит как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое оператор AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлов cookie в запросе больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Это можно использовать только с сопоставлением строк ByteMatchStatement с установленным PositionalConstraint в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Это можно использовать только с сопоставлением строк ByteMatchStatement с установленным PositionalConstraint в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment , чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для недопустимого JSON. Когда синтаксический анализ прошел успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

ComparisonOperator -> (строка)

Оператор для сравнения части запроса с настройкой размера.

Размер -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого типа преобразования см. в разделе Преобразования текста в Руководстве разработчика WAF .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и который сопоставляет веб-запросы на основе кода страны. Правило географического соответствия помечает каждый запрос, который оно проверяет, независимо от того, находит ли оно совпадение.

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор самостоятельно и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes .
  • В противном случае настройте свое правило географического соответствия с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам для запуска после правила географического соответствия и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухбуквенные коды стран и регионов из международного стандарта ISO 3166 Международной организации по стандартизации (ISO). WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в географическом соответствии ForwardedIPConfig .

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете переадресованный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Дополнительные сведения см. в разделе Оператор правила географического соответствия в руководстве разработчика WAF .

CountryCodes -> (list)

Массив двухбуквенных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ] , из двухбуквенных кодов стран ISO международного стандарта ISO 3166.

Когда вы используете оператор географического соответствия только для меток региона и страны, которые он добавляет к запросам, вам все равно нужно предоставить код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета совпадающих запросов, но оно все равно будет создавать ведение журнала и показатели подсчета для любых совпадений. Вы можете уменьшить ведение журнала и показатели, которые создает правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правил, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Вы не можете вложить RuleGroupReferenceStatement, например, для использования внутри NotStatement или OrStatement. Нельзя использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в web ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылающейся группе правил, для которых действия установлены в Count.

Примечание

Вместо этого параметра используйте RuleActionOverrides. Он принимает любое допустимое значение действия, включая Count.

(structure)

Указывает отдельное правило в группе правил, действие которого вы хотите переопределить на Count.

Примечание

Вместо этого параметра используйте RuleActionOverrides. Он принимает любое допустимое значение действия, включая Count.

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count.

RuleActionOverrides -> (list)

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

Примечание

Позаботьтесь о проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет настройку переопределения.

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

(structure)

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

Примечание

Позаботьтесь о проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Позаботьтесь о проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет настройку переопределения.

ActionToUse -> (structure)

Действие переопределения, которое нужно использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Указывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ на веб-запрос.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в настраиваемых ответах, см. в разделе Поддерживаемые коды состояния для настраиваемого ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить настраиваемый ответ для действия правила или действия web ACL по умолчанию, которое установлено в блок. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию web ACL настройке BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP, которые необходимо использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

Allow -> (structure)

Указывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

Count -> (structure)

Указывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в web ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

Captcha -> (structure)

Указывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не просрочен.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

Challenge -> (structure)

Указывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не просрочен.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

IPSetReferenceStatement -> (structure)

Заявление правила, используемое для обнаружения веб-запросов, поступающих с конкретных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом заявлении. Чтобы создать набор IP, см. CreateIPSet.

Каждое утверждение правила набора IP ссылается на набор IP. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Amazon Resource Name (ARN) набора IP, на который ссылается это утверждение.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо назначить веб-запросу, если запрос не имеет действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие режимы резервного копирования:

  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси, через которые прошел запрос.

Параметры этой настройки следующие:

  • FIRST - Проверьте первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверьте последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверьте все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий в компонентах веб-запроса с помощью регулярных выражений. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Amazon Resource Name (ARN) RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может быть длиной до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это та часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg.

QueryString -> (structure)

Проверьте строку запроса. Это та часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков большого размера в объекте Headers. WAF применяет фильтры соответствия шаблонам к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Для этого требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывайте веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий утверждению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры соответствия шаблонам к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Для этого требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что должен делать WAF, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывайте веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для соответствия компоненту в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывайте веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отступлении:

  • MATCH - Обрабатывайте веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отступлении:

  • MATCH - Обрабатывайте веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий утверждению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагментов URI большого размера в объекте UriFragment. WAF применяет фильтры соответствия шаблонам к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывайте веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий утверждению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body (Тело JSON) в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

RateBasedStatement -> (структура)

Правило на основе скорости подсчитывает входящие запросы и ограничивает скорость запросов, когда они поступают со слишком высокой скоростью. Правило классифицирует запросы в соответствии с вашими критериями агрегации, собирает их в экземпляры агрегации, а также подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в используемом правиле, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия правила по ограничению скорости на срок до минуты.

Можно указать отдельные ключи агрегации, такие как IP-адрес или метод HTTP. Можно также указать комбинации ключей агрегации, такие как IP-адрес и метод HTTP или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для указанных вами ключей агрегации является отдельным экземпляром агрегации, при этом значение каждого ключа вносит вклад в определение экземпляра агрегации.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило будет создавать разные экземпляры агрегации в соответствии с вашими критериями агрегации, например:

  • Если критерием агрегации является только IP-адрес, то каждый отдельный адрес является экземпляром агрегации, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегации является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: количество 2
    • Метод HTTP GET: количество 2
  • Если критерием агрегации является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в объединенный экземпляр агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любой n-кортежа ключей агрегации каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегации, который WAF подсчитывает и ограничивает по скорости индивидуально.

При желании можно вложить другое выражение внутрь выражения на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только тех запросов, которые соответствуют вложенному выражению. Это вложенное выражение для уменьшения области действия можно использовать в сочетании со спецификациями ключей агрегации или просто подсчитывать и ограничивать скорость всех запросов, соответствующих выражению для уменьшения области действия, без дополнительной агрегации. Когда вы выбираете просто управлять всеми запросами, соответствующими выражению для уменьшения области действия, экземпляр агрегации является единственным для правила.

Нельзя вкладывать RateBasedStatement внутри другого выражения, например внутри NotStatement или OrStatement . Можно определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Для получения дополнительной информации об опциях см. раздел «Ограничение скорости веб-запросов с помощью правил на основе скорости» в Руководстве разработчика WAF.

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, можно получить список IP-адресов, для которых WAF в настоящее время ограничивает скорость для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегации.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставляете одни и те же параметры правила на основе скорости в двух веб-ACL, каждое из двух выражений правил представляет отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление WAF.

Limit -> (long)

Предел для запросов в течение указанного окна оценки для одного экземпляра агрегации для правила на основе скорости. Если выражение на основе скорости включает ScopeDownStatement , этот предел применяется только к запросам, соответствующим выражению.

Примеры:

  • Если вы агрегируете только по IP-адресу, это ограничение на запросы с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это ограничение на запросы для любой одной пары метод, город.

EvaluationWindowSec -> (long)

Промежуток времени в секундах, который WAF должен включать в свои подсчеты запросов, оглядываясь назад с текущего момента времени. Например, при настройке 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые значения: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а то, как далеко назад он смотрит при каждой проверке. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 minutes)

AggregateKeyType -> (string)

Настройка, указывающая, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, исключаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте скорость запросов, соответствующих выражению уменьшения области действия правила на основе скорости. С этим параметром подсчитанные запросы не подвергаются дальнейшей агрегации. Выражение уменьшения области действия является единственной используемой спецификацией. Когда количество всех запросов, удовлетворяющих выражению уменьшения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим выражению уменьшения области действия. С этим параметром необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегации. С этим параметром необходимо указать ключи агрегации в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегации в значение IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы агрегировать по комбинации перенаправленного IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать по комбинации IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .

ScopeDownStatement -> (structure)

Необязательное вложенное выражение, которое сужает область веб-запросов, которые оцениваются и управляются выражением на основе скорости. При использовании выражения уменьшения области действия правило на основе скорости отслеживает и ограничивает скорость только тех запросов, которые соответствуют выражению уменьшения области действия. Вы можете использовать любое вкладываемое выражение в выражении уменьшения области действия, и вы можете вкладывать выражения на любом уровне, так же, как и для выражения правила.

ByteMatchStatement -> (structure)

Выражение правила, которое определяет поиск соответствия строк для WAF, который необходимо применить к веб-запросам. Выражение соответствия байтам предоставляет байты для поиска, местоположение в запросах, которое вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска, как правило, представляют собой строку, которая соответствует символам ASCII. В консоли WAF и в руководстве для разработчиков это называется выражением соответствия строкам.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF ищет только в той части веб-запросов, которую вы назначаете для проверки в FieldToMatch . Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. Этот выбор можно использовать только с выражением соответствия строкам ByteMatchStatement с PositionalConstraint , установленным в EXACTLY . Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, содержащую упорядоченный список имен заголовков из заголовков в веб-запросе, а затем сопоставляет ее с этой строкой.

Если SearchString включает буквенные символы A-Z и a-z, обратите внимание, что значение учитывает регистр.

Если вы используете API WAF

Укажите версию значения в кодировке base64. Максимальная длина значения до кодирования base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER , а значение Data равно User-Agent . Если вы хотите выполнить поиск в заголовке User-Agent значения BadBot , вы кодируете BadBot с помощью кодировки MIME base64 и включаете полученное значение QmFkQm90 в значение SearchString .

Если вы используете CLI или один из пакетов SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Альтернативно, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать слишком большие тела запросов, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки слишком больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки слишком больших размеров с вашими настройками правил и действий веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить исходник.

JsonBody -> (структура)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать слишком большие тела запросов, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполняет синтаксический анализ и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF парсинг не полностью проверяет входную строку JSON, поэтому парсинг может завершиться успешно даже для неверного JSON. Когда парсинг завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки слишком больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки слишком больших размеров с вашими настройками правил и действий веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. При указании ALL WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки переразмера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. При указании ALL WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки переразмера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки переразмера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Поля журналов в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Поля журналов в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON-тело в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста —> (list) Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если указать одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer) Приоритет —> (integer) Устанавливает относительный порядок обработки нескольких преобразований. WAF обрабатывает все преобразования, от наименьшего приоритета к наибольшему, перед проверкой преобразованного содержимого. Приоритеты не должны быть последовательными, но все они должны быть разными.

Type -> (string) Тип —> (string) Подробные описания каждого из типов преобразований см. в разделе Преобразования текста в Руководстве разработчика WAF .

PositionalConstraint -> (string) PositionalConstraint -> (string) Область в части веб-запроса, в которой WAF должен искать SearchString . Допустимые значения:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString , но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString , а SearchString должны содержать только буквенно-цифровые символы или символ подчеркивания (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает истинность обоих следующих условий:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или символа подчеркивания (_). Примеры включают значение заголовка и ;BadBot .
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или символа подчеркивания (_), например, BadBot; и -BadBot; .
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString .

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может быть длиной до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Чтобы узнать, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE — Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос требует от источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Чтобы узнать, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Соответствие всем элементам. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствие только указанным путям включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON, с которыми нужно сопоставить, используя MatchPattern . Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING — Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH — Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE — Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры области видимости и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков передаются WAF для проверки базовой хост-службой. Необходимо настроить обработку любого содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой хост-службы.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Он требует нахождения совпадения в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая хост-служба пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области видимости и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются WAF для проверки базовой хост-службой. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой хост-службы.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Он требует нахождения совпадения в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая хост-служба пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая хост-служба пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить отпечаток JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить отпечаток JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области видимости и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются WAF для проверки базовой хост-службой. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой хост-службы.

FallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста –> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого типа преобразования см. в разделе Преобразования текста в Руководстве разработчика WAF .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на атаки путем внедрения SQL-кода.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию об определении и смягчении последствий ложных срабатываний см. в разделе Тестирование и настройка в Руководстве разработчика WAF .

LOW, как правило, является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак путем внедрения SQL-кода или имеют низкую толерантность к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (structure)

Оператор правила, который выполняет проверку на атаки межсайтового скриптинга (XSS). При атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских скриптов в другие легитимные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может быть длиной до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в ACL веб-сайта AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте ограничение CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в ACL веб-сайта AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте ограничение CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с вашими настройками действий правила и ACL веб-сайта, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка метода HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в ACL веб-сайта AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте ограничение CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр, чтобы включить все пути. Вместо этого используйте настройку All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если он не может полностью проанализировать тело JSON. Возможные варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе "Тело JSON" в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в ACL веб-сайта AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте ограничение CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с вашими настройками действий правила и ACL веб-сайта, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Headers , чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка с превышением размера в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie с превышением размера в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например, host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в значение EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления для назначения веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в значение EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления для назначения веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

UriFragment -> (structure)

Проверка фрагментов URI запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте UriFragment , чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагментов URI с превышением размера в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе «Тело JSON» в Руководстве разработчика WAF .

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, вы можете использовать оператор ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверит только количество байтов в теле до лимита для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера для блокировки запросов с большим размером тела запроса. Для получения дополнительной информации об ограничениях проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI будет считаться одним символом. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки большого размера следующие:

  • CONTINUE - Проверять доступное содержимое тела обычным образом, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки большого размера с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью разобрать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать контент только до первой ошибки анализа, которую он обнаружит.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. Тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки большого размера следующие:

  • CONTINUE - Проверять доступное содержимое тела обычным образом, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки большого размера с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое — для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с использованием критериев проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое — для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние сопоставления, которое необходимо назначить веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние сопоставления, которое необходимо назначить веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого содержимого фрагментов URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для неверного JSON. Если анализ прошел успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

ComparisonOperator -> (string)

Оператор для сравнения части запроса с настройкой размера.

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам, чтобы преобразовать компонент запроса FieldToMatch перед его проверкой, и они используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF.

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и сопоставляет веб-запросы на основе кода страны. Правило соответствия географическим данным помечает каждый запрос, который он проверяет, независимо от того, находит ли он соответствие.

  • Для управления запросами только по стране вы можете использовать этот оператор сам по себе и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes .
  • В противном случае настройте свое правило соответствия географическим данным с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам для запуска после правила соответствия географическим данным и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухбуквенные коды стран и регионов из международного стандарта ISO 3166 Международной организации по стандартизации (ISO). WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в соответствии с географическими данными ForwardedIPConfig .

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете перенаправленный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Дополнительные сведения см. в разделе Оператор правила соответствия географическим данным в руководстве разработчика WAF .

CountryCodes -> (list)

Массив двухбуквенных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ] , из двухбуквенных кодов стран ISO международного стандарта ISO 3166.

Когда вы используете оператор соответствия географическим данным только для меток региона и страны, которые он добавляет к запросам, вам все равно придется предоставить код страны, чтобы правило могло оцениваться. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно по-прежнему будет создавать журналы и показатели подсчета для любых совпадений. Вы можете сократить количество журналов и показателей, которые производит правило, указав страну, которая вряд ли станет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, который будет использоваться для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо назначить веб-запросу, если запрос не имеет допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Нельзя вкладывать RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Нельзя использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

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

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(structure)

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

Примечание

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

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

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

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Указывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блок. Чтобы сделать это, сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или настройке по умолчанию веб-ACL BlockAction , вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Указывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Указывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Указывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Указывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка запроса определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правил, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать IP-набор, см. CreateIPSet.

Каждый оператор правил IP-набора ссылается на IP-набор. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) набора IPSet, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для этого значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанном положении.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие режимы работы при сбое:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правил.

Position -> (string)

Положение в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значением заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси-серверы, через которые прошел запрос.

Варианты этого параметра следующие:

  • FIRST - Проверьте первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверьте последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверьте все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверит последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий с регулярными выражениями в компонентах веб-запроса. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Имя ресурса Amazon (ARN) набора RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковая имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в виде тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше предела, базовая служба хоста пересылает только содержимое, которое находится в пределах предела, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше предела, базовая служба хоста пересылает только содержимое, которое находится в пределах предела, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки большого размера следующие:

  • CONTINUE - Обычным образом проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в виде тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше предела, базовая служба хоста пересылает только содержимое, которое находится в пределах предела, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Соответствовать всем элементам. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствие в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше предела, базовая служба хоста пересылает только содержимое, которое находится в пределах предела, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки большого размера следующие:

  • CONTINUE - Обычным образом проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders или ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение - в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих случаях. Чтобы потребовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки переразмерности следующие:

  • CONTINUE - Обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies или ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение - в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих случаях. Чтобы потребовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF следует делать, если файлов cookie запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Варианты обработки переразмерности следующие:

  • CONTINUE - Обычная проверка доступных файлов cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки переразмерности следующие:

  • CONTINUE - Обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для расчета. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Вы можете указать следующие резервные режимы работы:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для расчета. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Вы можете указать следующие резервные режимы работы:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment , чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам, для преобразования компонента FieldToMatch запроса перед его проверкой, а также в операторах правил на основе частоты, для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробное описание каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

RateBasedStatement -> (структура)

Правило на основе частоты подсчитывает входящие запросы и ограничивает запросы по частоте, когда они поступают со слишком высокой скоростью. Правило классифицирует запросы в соответствии с вашими критериями агрегирования, собирает их в экземпляры агрегирования, а также подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в правиле, которое используется в настоящее время, изменение сбросит счетчики ограничения частоты правила. Это может приостановить действия по ограничению частоты правила на срок до одной минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегирования, такие как IP-адрес и метод HTTP, или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для указанных вами ключей агрегирования является отдельным экземпляром агрегирования, при этом значение из каждого ключа вносит вклад в определение экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило создаст разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого из них. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегирования является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: количество 2
    • Метод HTTP GET: количество 2
  • Если критерием агрегирования является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в объединенный экземпляр агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любого n-кортежа ключей агрегирования каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает по частоте отдельно.

При желании вы можете вложить другой оператор внутрь оператора на основе частоты, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало по частоте только те запросы, которые соответствуют вложенному оператору. Вы можете использовать этот вложенный оператор сужения области действия в сочетании со спецификациями ключей агрегирования или просто подсчитывать и ограничивать по частоте все запросы, которые соответствуют оператору сужения области действия, без дополнительного агрегирования. Когда вы выбираете просто управлять всеми запросами, которые соответствуют оператору сужения области действия, экземпляр агрегирования является единственным для правила.

Вы не можете вложить RateBasedStatement в другой оператор, например в NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Дополнительную информацию об опциях см. в разделе Rate limiting web requests using rate-based rules в WAF Developer Guide .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, которые WAF в настоящее время ограничивает по частоте для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе частоты, которое вы используете. Например, если вы предоставите одни и те же настройки правила на основе частоты в двух веб-ACL, каждый из двух операторов правил представляет собой отдельный экземпляр правила на основе частоты и получает собственное отслеживание и управление WAF. Если вы определяете правило на основе частоты внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе частоты, который получает собственное отслеживание и управление WAF.

Limit -> (long)

Лимит запросов в течение указанного окна оценки для одного экземпляра агрегирования для правила на основе частоты. Если оператор на основе частоты включает в себя ScopeDownStatement , этот лимит применяется только к запросам, соответствующим оператору.

Примеры:

  • Если вы агрегируете только по IP-адресу, это ограничение на запросы с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это ограничение на запросы для любой отдельной пары метод-город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в свои подсчеты запросов, оглядываясь назад с текущего момента времени. Например, для настройки 120, когда WAF проверяет частоту, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые значения: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет частоту, а определяет, как далеко назад он смотрит каждый раз, когда проверяет. WAF проверяет частоту примерно каждые 10 секунд.

По умолчанию: 300 (5 минут)

AggregateKeyType -> (string)

Настройка, которая указывает, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правила на основе частоты.
  • CONSTANT - Подсчитывать и ограничивать запросы, соответствующие оператору сужения области действия правила на основе частоты. С помощью этой опции подсчитанные запросы не подвергаются дальнейшему агрегированию. Оператор сужения области действия — это единственная используемая спецификация. Когда количество всех запросов, удовлетворяющих оператору сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим оператору сужения области действия. С помощью этой опции необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегировать количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. С помощью этой опции необходимо указать ключи агрегирования в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегирования в значение IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегировать количество запросов по первому IP-адресу в заголовке HTTP. С помощью этой опции необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы агрегировать комбинацию перенаправленного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .
  • IP - Агрегировать количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать комбинацию IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в заголовке HTTP, который вы указываете, вместо использования IP-адреса, который сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (string)

Имя заголовка HTTP, который следует использовать для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если в запросе нет действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие режимы резервирования:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

CustomKeys -> (list)

Указывает совокупные ключи для использования в правиле на основе скорости.

(структура)

Указывает один пользовательский совокупный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, опускаются из оценки и обработки правила на основе скорости.

Заголовок -> (структура)

Используйте значение заголовка в запросе в качестве совокупного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегации. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя заголовка для использования.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

Cookie -> (структура)

Используйте значение cookie в запросе в качестве совокупного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегации. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя cookie для использования.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

QueryArgument -> (структура)

Используйте указанный аргумент запроса в качестве совокупного ключа. Каждое отдельное значение для указанного аргумента запроса вносит вклад в экземпляр агрегации. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя аргумента запроса для использования.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

QueryString -> (структура)

Используйте строку запроса запроса в качестве совокупного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегации. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегации.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

HTTPMethod -> (структура)

Используйте метод HTTP запроса в качестве совокупного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегации. Если вы используете только метод HTTP в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегации.

ForwardedIP -> (структура)

Используйте первый IP-адрес в заголовке HTTP в качестве совокупного ключа. Каждый отдельный перенаправленный IP-адрес вносит вклад в экземпляр агрегации.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете агрегировать только по перенаправленному IP-адресу, указав FORWARDED_IP в заявлении на основе скорости AggregateKeyType.

С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (структура)

Используйте исходный IP-адрес запроса в качестве совокупного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегации.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в заявлении на основе скорости AggregateKeyType.

LabelNamespace -> (структура)

Используйте указанное пространство имен метки в качестве совокупного ключа. Каждое отдельное полностью определенное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегации. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегации.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

Для получения информации о пространствах имен и именах меток см. Label syntax and naming requirements в WAF Developer Guide .

Пространство имен -> (строка)

Пространство имен для использования для агрегации.

UriPath -> (структура)

Используйте путь URI запроса в качестве совокупного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегации. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегации.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

JA3Fingerprint -> (структура)

Используйте отпечаток JA3 запроса в качестве совокупного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (строка)

Статус соответствия, который следует назначить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве пользовательского ключа, каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия веб-запроса, который необходимо назначить, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой AND. Вы предоставляете более одного Statement в AndStatement .

Statements -> (list)

Операторы для объединения с логикой AND. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой OR. Вы предоставляете более одного Statement в OrStatement .

Statements -> (list)

Операторы для объединения с логикой OR. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один Statement в NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вкладывать ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control для предотвращения захвата учетных записей (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control для предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика при обновлении поставщиком настроек управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил для предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также расположение данных в полезной нагрузке запроса на создание учетной записи, таких как электронная почта пользователя и поля номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа вашего приложения и расположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил для предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также расположение данных в полезной нагрузке запроса на создание учетной записи, таких как электронная почта пользователя и поля номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа вашего приложения и расположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил Bot Control.

Например, спецификации см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию JavaScript Object Notation (JSON) Pointer от Internet Engineering Task Force (IETF). Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезных данных с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию JavaScript Object Notation (JSON) Pointer от Internet Engineering Task Force (IETF). Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезных данных с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. WAF Bot Control rule group и WAF Bot Control в WAF Developer Guide .

InspectionLevel -> (string)

Уровень проверки для использования для группы правил Bot Control. Общий уровень — наименее затратный. Целевой уровень включает все правила общего уровня и добавляет правила с более сложными критериями проверки. Для получения подробной информации см. WAF Bot Control rule group в WAF Developer Guide .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, координированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в списке правил Bot Control в WAF Developer Guide .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это, чтобы предоставить информацию о запросе на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы входа.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Информацию об использовании управляемой группы правил ATP см. в разделе WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в Руководстве разработчика WAF .

LoginPath -> (string)

Путь к конечной точке входа для вашего приложения. Например, для URL https://example.com/web/login , вы предоставите путь /web/login . Пути входа, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов входа, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа: JSON или форма, закодированная.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя: /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя: username1

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя: /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя: username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля: /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля: password1 .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля: /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля: password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиента, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход или попытку создания учетной записи. Чтобы быть засчитанным как успешный, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачный вход или попытку создания учетной записи. Чтобы быть засчитанным как неудачный, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным совпадением, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на успешный вход или попытку создания учетной записи. Чтобы быть засчитанным как успешный, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди успешных и неудачных значений.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на неудачный вход или попытку создания учетной записи. Чтобы быть засчитанным как неудачный, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди успешных и неудачных значений.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешный вход или попытку создания учетной записи. Чтобы быть засчитанным как успешный, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачный вход или попытку создания учетной записи. Чтобы быть засчитанным как неудачный, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен быть точным совпадением, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы быть засчитанным как успешный, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди успешных и неудачных значений.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы быть засчитанным как неудачный, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди успешных и неудачных значений.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet . Используйте это, чтобы предоставить информацию о запросе на создание учетной записи группе правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив отвечает на запросы на создание учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. группу правил предотвращения мошенничества при создании учетной записи WAF Fraud Control (ACFP) и предотвращение мошенничества при создании учетной записи WAF Fraud Control (ACFP) в Руководстве разработчика WAF .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница вашего веб-сайта, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount , вы должны предоставить путь /web/newaccount . Пути к страницам создания учетной записи, начинающиеся с предоставленного вами пути, считаются совпадением. Например /web/newaccount соответствует путям создания учетной записи /web/newaccount , /web/newaccount/ , /web/newaccountPage и /web/newaccount/thisPage , но не соответствует пути /home/web/newaccount или /website/newaccount .

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница вашего веб-сайта, на которой новым пользователям предлагается форма регистрации.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL https://example.com/web/registration , вы должны предоставить путь /web/registration . Пути к страницам регистрации, начинающиеся с предоставленного вами пути, считаются совпадением. Например /web/registration соответствует путям регистрации /web/registration , /web/registration/ , /web/registrationPage и /web/registration/thisPage , но не соответствует пути /home/web/registration или /website/registration .

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезных данных для конечной точки создания учетной записи: JSON или закодированный в форме.

UsernameField -> (structure)

Название поля в полезных данных запроса, содержащего имя пользователя вашего клиента.

То, как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя — username1

Identifier -> (string)

Название поля имени пользователя.

То, как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Название поля в полезных данных запроса, содержащего пароль вашего клиента.

То, как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля — password1 .

Identifier -> (string)

Название поля пароля.

То, как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля — password1 .

EmailField -> (structure)

Название поля в полезных данных запроса, содержащего адрес электронной почты вашего клиента.

То, как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты — /form/email .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем email1 спецификация поля электронной почты — email1 .

Identifier -> (string)

Название поля электронной почты.

То, как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты — /form/email .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем email1 спецификация поля электронной почты — email1 .

PhoneNumberFields -> (list)

Названия полей в полезных данных запроса, содержащих основной номер телефона вашего клиента.

Упорядочьте поля номера телефона в массиве точно так же, как они упорядочены в полезных данных запроса.

То, как вы укажете поля номера телефона, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами input с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Название поля в полезных данных запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Название одного поля основного номера телефона.

То, как вы укажете поля номера телефона, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами input с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Названия полей в полезных данных запроса, содержащих основной физический адрес вашего клиента.

Упорядочьте поля адреса в массиве точно так же, как они упорядочены в полезных данных запроса.

То, как вы укажете поля адреса, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами input с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Название поля в полезных данных запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Название одного поля основного адреса.

То, как вы укажете поля адреса, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами input с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответов доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентом, ведя подсчет успешных и неудачных попыток с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы из клиентских сеансов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным соответствием, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа на индикаторы успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна быть точным соответствием, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, строка может быть в любом месте тела и должна быть точным соответствием, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON-ответа на индикаторы успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) JSON-ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно сопоставить в JSON. Идентификатор должен быть точным соответствием, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON-ответе, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON-ответе, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(структура)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Имя -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательских ответов в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF возвращал клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, для которого установлено значение block. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или в действии по умолчанию веб-ACL настройке BlockAction вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, которые были добавлены к веб-запросу правилами, которые уже были запущены в веб-ACL.

Оператор сопоставления меток предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или все полностью определенное имя метки, которое было добавлено к веб-запросу. Полностью определенные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, которое добавило метку. Если вы не предоставите полное имя в строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы выполнить сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от параметра Scope оператора сопоставления:

  • Если Scope указывает LABEL, то это указание должно включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс вплоть до предоставления полностью определенного имени метки.
  • Если Scope указывает NAMESPACE, то это указание может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, а компоненты метки должны быть разделены двоеточием, например NS1:NS2:name.

RegexMatchStatement -> (structure)

Оператор правила, используемый для поиска соответствия компонентам веб-запроса одному регулярному выражению.

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации об обработке больших тел запросов см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки негабаритных размеров с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации об обработке больших тел запросов см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе Тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки негабаритных размеров следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки негабаритных размеров с параметрами действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка превышающего размер в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если вы укажете ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Для этого требуется соответствие в ключах, значениях или и том, и другом. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Cookies -> (structure)

Проверить файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для сопоставления с критериями проверки правил. Если вы укажете ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Для этого требуется соответствие в ключах, значениях или и том, и другом. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для расчета. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может рассчитать отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы она соответствовала любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для расчета. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может рассчитать отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы она соответствовала любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

UriFragment -> (structure)

Проверка фрагментов URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment , чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может быть успешным даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

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

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном HTTP-заголовке вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но можно указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы укажете перенаправленный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (string)

Имя HTTP-заголовка для использования для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, присваиваемый веб-запросу, если запрос не имеет допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Можно указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

CustomKeys -> (list)

Указывает агрегированные ключи для использования в правиле на основе скорости.

(структура)

Указывает один пользовательский агрегированный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, исключаются из оценки и обработки правила на основе скорости.

Заголовок -> (структура)

Используйте значение заголовка в запросе в качестве агрегированного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегации. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя заголовка для использования.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

Cookie -> (структура)

Используйте значение cookie в запросе в качестве агрегированного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегации. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя cookie для использования.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryArgument -> (структура)

Используйте указанный аргумент запроса в качестве агрегированного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегации. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя аргумента запроса для использования.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryString -> (структура)

Используйте строку запроса запроса в качестве агрегированного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегации. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегации.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

HTTPMethod -> (структура)

Используйте HTTP-метод запроса в качестве агрегированного ключа. Каждый отдельный HTTP-метод вносит вклад в экземпляр агрегации. Если вы используете только HTTP-метод в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегации.

ForwardedIP -> (структура)

Используйте первый IP-адрес в заголовке HTTP в качестве агрегированного ключа. Каждый отдельный перенаправленный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или перенаправленного IP-адреса в настройках пользовательского ключа необходимо также указать как минимум еще один ключ для использования. Вы можете выполнять агрегирование только по перенаправленному IP-адресу, указав FORWARDED_IP в AggregateKeyType вашего оператора на основе скорости.

С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (структура)

Используйте исходный IP-адрес запроса в качестве агрегированного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или перенаправленного IP-адреса в настройках пользовательского ключа необходимо также указать как минимум еще один ключ для использования. Вы можете выполнять агрегирование только по IP-адресу, указав IP в AggregateKeyType вашего оператора на основе скорости.

LabelNamespace -> (структура)

Используйте указанное пространство имен метки в качестве агрегированного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегации. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегации.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

Информацию о пространствах имен и именах меток см. в разделе Синтаксис и требования к именованию меток в Руководстве разработчика WAF .

Пространство имен -> (строка)

Пространство имен для использования для агрегации.

UriPath -> (структура)

Используйте путь URI запроса в качестве агрегированного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегации. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегации.

TextTransformations -> (список)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

JA3Fingerprint -> (структура)

Используйте отпечаток JA3 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (строка)

Состояние соответствия, которое нужно назначить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Можно указать следующие fallback-поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

AndStatement -> (структура)

Логическое утверждение правила, используемое для объединения других утверждений правил с логикой AND. Вы предоставляете более одного Statement в пределах AndStatement .

Statements -> (список)

Утверждения, которые нужно объединить с логикой AND. Можно использовать любые утверждения, которые могут быть вложенными.

(структура)

Руководство по обработке для Rule , используемое WAF для определения того, соответствует ли веб-запрос правилу.

Например, спецификации см. в разделе examples раздела CreateWebACL .

ByteMatchStatement -> (структура)

Утверждение правила, определяющее поиск соответствия строки для WAF, который будет применен к веб-запросам. Утверждение соответствия байтов предоставляет байты для поиска, местоположение в запросах, которые вы хотите, чтобы WAF искал, и другие параметры. Байты для поиска, как правило, представляют собой строку, которая соответствует символам ASCII. В консоли WAF и в руководстве разработчика это называется утверждением соответствия строки.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF ищет только в той части веб-запросов, которую вы назначаете для проверки в FieldToMatch . Максимальная длина значения - 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : HTTP-метод, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 - это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint , установленным в EXACTLY . Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. Log fields в WAF Developer Guide .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, содержащую упорядоченный список имен заголовков из заголовков в веб-запросе, а затем сопоставляет с этой строкой.

Если SearchString содержит буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете WAF API

Укажите версию значения в кодировке base64. Максимальная длина значения перед кодированием base64 составляет 200 байт.

Например, предположим, что значение Type - HEADER , а значение Data - User-Agent . Если вы хотите искать в заголовке User-Agent значение BadBot , вы кодируете BadBot с помощью MIME-кодировки base64 и включаете полученное значение, QmFkQm90 , в значение SearchString .

Если вы используете CLI или один из пакетов SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, который идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с вашими настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (структура)

Проверить тело запроса как JSON. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (список)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах, и не требует, чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (строка)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. body JSON в Руководстве разработчика WAF.

OversizeHandling -> (строка)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с вашими настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка большого размера в объекте Headers . WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для определения подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders или ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые нужно сопоставить с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки oversize следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie большого размера в объекте Cookies . WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для определения подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies или ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки oversize следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента поля для сопоставления в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки oversize следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancer. Сопоставьте отпечаток JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе Log fields в WAF Developer Guide .

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние сопоставления, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancer. Сопоставьте отпечаток JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе Log fields в WAF Developer Guide .

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние сопоставления, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте UriFragment , чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI большого размера в объекте UriFragment . WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Доступны следующие параметры:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в WAF Developer Guide .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF.

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString. Допустимые значения включают следующие:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString, но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString, и SearchString должен содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что верны оба следующих утверждения:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot.
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot;.
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString.

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью Headers FieldToMatch setting.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может иметь длину до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверьте строку запроса. Это часть URL, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить исходный сервер.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо эту настройку, либо настройку IncludedPaths , но не обе.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо эту настройку, либо настройку All , но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих случаях. Чтобы требовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если он не может полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел Body JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Он требует нахождения соответствия в ключах, в значениях или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки переразмерности следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверить файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Он требует нахождения соответствия в ключах, в значениях или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie.

Варианты обработки переразмерности следующие:

  • CONTINUE - Обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки переразмерности следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint установлено в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint установлено в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста —> (список)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет —> (integer)

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

Тип —> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на наличие атак путем внедрения SQL-кода.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Сведения об определении и смягчении ложных срабатываний см. в разделе Testing and tuning в WAF Developer Guide .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другую защиту от атак путем внедрения SQL-кода или имеют низкую устойчивость к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (structure)

Инструкция по правилу, которое проверяет наличие атак межсайтового скриптинга (XSS). В XSS-атаках злоумышленник использует уязвимости на безобидном веб-сайте как средство для внедрения вредоносных клиентских скриптов в другие легитимные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверка тела запроса как простого текста. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими настройками правил и действий веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка метода HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов с критериями проверки правил.

All -> (structure)

Совпадение со всеми элементами. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Совпадение только с указанными путями включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Рабочей группы разработки Интернет-протоколов (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON, с которыми нужно сопоставить, используя MatchPattern . Если вы укажете ALL, WAF сопоставляет с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими настройками правил и действий веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать только один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует обнаружения соответствия в ключах и соответствия в значениях. Требуется соответствие в ключах, значениях или обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND, чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать только один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует обнаружения соответствия в ключах и соответствия в значениях. Требуется соответствие в ключах, значениях или обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND, чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычная проверка доступных файлов cookie в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента поля для соответствия в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может рассчитать отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие варианты поведения при возврате к резервному варианту:

  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может рассчитать отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие варианты поведения при возврате к резервному варианту:

  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING — проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует заявлению правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF parsing doesn’t fully validate the input JSON string, so parsing can succeed even for invalid JSON. When parsing succeeds, WAF doesn’t apply the fallback behavior. For more information, see JSON body in the WAF Developer Guide .
```

TextTransformations -> (list)

Преобразования текста —> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным контентом, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого типа преобразования см. в разделе Преобразования текста в Руководстве разработчика WAF.

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, такой как «больше чем» (>) или «меньше чем» (<). Например, вы можете использовать оператор ограничения размера для поиска строк запросов, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле до предела для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера для блокировки запросов с большим размером тела запроса. Для получения дополнительной информации об ограничениях проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI считается одним символом. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

В качестве альтернативы вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это та часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это та часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса сразу следует за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF только содержимое, которое находится в пределах лимита, для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать слишком большие тела запросов, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF только содержимое, которое находится в пределах лимита, для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса сразу следует за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF только содержимое, которое находится в пределах лимита, для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать слишком большие тела запросов, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение отката. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает в WAF только содержимое, которое находится в пределах лимита, для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован и составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для соответствия в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел Log fields в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора соответствия строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел Log fields в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора соответствия строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверка фрагментов URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment , чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment . WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможные варианты:

  • EVALUATE_AS_STRING - Проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе JSON body в Руководстве разработчика WAF .

ComparisonOperator -> (string)

Оператор для сравнения части запроса с настройкой размера.

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Текстовые преобразования исключают некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Текстовые преобразования исключают некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Text transformations (Текстовые преобразования) в WAF Developer Guide .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и выполняет сопоставление с веб-запросами на основе кода страны. Правило соответствия геолокации помечает каждый проверяемый запрос, независимо от того, находит ли оно соответствие.

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор сам по себе и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes .
  • В противном случае настройте правило соответствия геолокации с действием Count (Подсчет), чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам, чтобы они выполнялись после правила соответствия геолокации, и настройте их на сопоставление с географическими метками и обработку запросов по мере необходимости.

WAF помечает запросы, используя альфа-2 коды стран и регионов из стандарта Международной организации по стандартизации (ISO) 3166. WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в гео-соответствии ForwardedIPConfig .

Если вы используете источник веб-запроса, форматы меток выглядят следующим образом: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете переадресованный IP-адрес, форматы меток выглядят следующим образом: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Дополнительные сведения см. в разделе Geographic match rule statement (Оператор правила соответствия геолокации) в WAF Developer Guide .

CountryCodes -> (list)

Массив двухсимвольных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ] , из альфа-2 кодов стран ISO международного стандарта ISO 3166.

Когда вы используете оператор соответствия геолокации только для меток региона и страны, которые он добавляет к запросам, вам все равно придется предоставить код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно все равно будет генерировать журналы и метрики подсчета для любых совпадений. Вы можете уменьшить ведение журналов и метрики, которые создает правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в HTTP-заголовке, который вы указываете, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при резервном копировании:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, затем укажите ARN группы правил в этом операторе.

Вы не можете вложить RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня внутри правила, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любой допустимый параметр действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любой допустимый параметр действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правила на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(structure)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правила на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ на веб-запрос.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL настройке BlockAction , вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правила, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который определяет адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать набор IP, см. CreateIPSet.

Каждый оператор правила набора IP ссылается на набор IP. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Amazon Resource Name (ARN) набора IP, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка, который следует использовать для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Position -> (string)

Положение в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значением заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси-серверы, через которые прошел запрос.

Параметры для этого параметра следующие:

  • FIRST — Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST — Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY — Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий регулярным выражениям в компонентах веб-запроса. Чтобы использовать это, создайте RegexPatternSet, который определяет выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Имя ресурса Amazon (ARN) набора RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр нечувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может иметь длину до 30 символов и нечувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действий правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действий правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое оператор AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое оператор AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления поля в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие варианты резервного поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие варианты резервного поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

RateBasedStatement -> (structure)

A rate-based rule counts incoming requests and rate limits requests when they are coming at too fast a rate. The rule categorizes requests according to your aggregation criteria, collects them into aggregation instances, and counts and rate limits the requests for each instance.

Note

If you change any of these settings in a rule that’s currently in use, the change resets the rule’s rate limiting counts. This can pause the rule’s rate limiting activities for up to a minute.

You can specify individual aggregation keys, like IP address or HTTP method. You can also specify aggregation key combinations, like IP address and HTTP method, or HTTP method, query argument, and cookie.

Each unique set of values for the aggregation keys that you specify is a separate aggregation instance, with the value from each key contributing to the aggregation instance definition.

For example, assume the rule evaluates web requests with the following IP address and HTTP method values:

  • IP address 10.1.1.1, HTTP method POST
  • IP address 10.1.1.1, HTTP method GET
  • IP address 127.0.0.0, HTTP method POST
  • IP address 10.1.1.1, HTTP method GET

The rule would create different aggregation instances according to your aggregation criteria, for example:

  • If the aggregation criteria is just the IP address, then each individual address is an aggregation instance, and WAF counts requests separately for each. The aggregation instances and request counts for our example would be the following:
    • IP address 10.1.1.1: count 3
    • IP address 127.0.0.0: count 1
  • If the aggregation criteria is HTTP method, then each individual HTTP method is an aggregation instance. The aggregation instances and request counts for our example would be the following:
    • HTTP method POST: count 2
    • HTTP method GET: count 2
  • If the aggregation criteria is IP address and HTTP method, then each IP address and each HTTP method would contribute to the combined aggregation instance. The aggregation instances and request counts for our example would be the following:
    • IP address 10.1.1.1, HTTP method POST: count 1
    • IP address 10.1.1.1, HTTP method GET: count 2
    • IP address 127.0.0.0, HTTP method POST: count 1

For any n-tuple of aggregation keys, each unique combination of values for the keys defines a separate aggregation instance, which WAF counts and rate-limits individually.

You can optionally nest another statement inside the rate-based statement, to narrow the scope of the rule so that it only counts and rate limits requests that match the nested statement. You can use this nested scope-down statement in conjunction with your aggregation key specifications or you can just count and rate limit all requests that match the scope-down statement, without additional aggregation. When you choose to just manage all requests that match a scope-down statement, the aggregation instance is singular for the rule.

You cannot nest a RateBasedStatement inside another statement, for example inside a NotStatement or OrStatement . You can define a RateBasedStatement inside a web ACL and inside a rule group.

For additional information about the options, see Rate limiting web requests using rate-based rules in the WAF Developer Guide .

If you only aggregate on the individual IP address or forwarded IP address, you can retrieve the list of IP addresses that WAF is currently rate limiting for a rule through the API call GetRateBasedStatementManagedKeys . This option is not available for other aggregation configurations.

WAF tracks and manages web requests separately for each instance of a rate-based rule that you use. For example, if you provide the same rate-based rule settings in two web ACLs, each of the two rule statements represents a separate instance of the rate-based rule and gets its own tracking and management by WAF. If you define a rate-based rule inside a rule group, and then use that rule group in multiple places, each use creates a separate instance of the rate-based rule that gets its own tracking and management by WAF.

Limit -> (long)

The limit on requests during the specified evaluation window for a single aggregation instance for the rate-based rule. If the rate-based statement includes a ScopeDownStatement , this limit is applied only to the requests that match the statement.

Examples:

  • If you aggregate on just the IP address, this is the limit on requests from any single IP address.
  • If you aggregate on the HTTP method and the query argument name “city”, then this is the limit on requests for any single method, city pair.

EvaluationWindowSec -> (long)

The amount of time, in seconds, that WAF should include in its request counts, looking back from the current time. For example, for a setting of 120, when WAF checks the rate, it counts the requests for the 2 minutes immediately preceding the current time. Valid settings are 60, 120, 300, and 600.

This setting doesn’t determine how often WAF checks the rate, but how far back it looks each time it checks. WAF checks the rate about every 10 seconds.

Default: 300 (5 minutes)

AggregateKeyType -> (string)

Setting that indicates how to aggregate the request counts.

Note

Web requests that are missing any of the components specified in the aggregation keys are omitted from the rate-based rule evaluation and handling.
  • CONSTANT - Count and limit the requests that match the rate-based rule’s scope-down statement. With this option, the counted requests aren’t further aggregated. The scope-down statement is the only specification used. When the count of all requests that satisfy the scope-down statement goes over the limit, WAF applies the rule action to all requests that satisfy the scope-down statement. With this option, you must configure the ScopeDownStatement property.
  • CUSTOM_KEYS - Aggregate the request counts using one or more web request components as the aggregate keys. With this option, you must specify the aggregate keys in the CustomKeys property. To aggregate on only the IP address or only the forwarded IP address, don’t use custom keys. Instead, set the aggregate key type to IP or FORWARDED_IP .
  • FORWARDED_IP - Aggregate the request counts on the first IP address in an HTTP header. With this option, you must specify the header to use in the ForwardedIPConfig property. To aggregate on a combination of the forwarded IP address with other aggregate keys, use CUSTOM_KEYS .
  • IP - Aggregate the request counts on the IP address from the web request origin. To aggregate on a combination of the IP address with other aggregate keys, use CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

The configuration for inspecting IP addresses in an HTTP header that you specify, instead of using the IP address that’s reported by the web request origin. Commonly, this is the X-Forwarded-For (XFF) header, but you can specify any header name.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

This is required if you specify a forwarded IP in the rule’s aggregate key settings.

HeaderName -> (string)

The name of the HTTP header to use for the IP address. For example, to use the X-Forwarded-For (XFF) header, set this to X-Forwarded-For .

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

FallbackBehavior -> (string)

The match status to assign to the web request if the request doesn’t have a valid IP address in the specified position.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

You can specify the following fallback behaviors:

  • MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.
  • NO_MATCH - Treat the web request as not matching the rule statement.

CustomKeys -> (list)

Задает агрегированные ключи для использования в правиле на основе скорости.

(структура)

Задает один настраиваемый агрегированный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, исключаются из оценки и обработки правила на основе скорости.

Header -> (структура)

Используйте значение заголовка в запросе в качестве агрегированного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегации. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя заголовка для использования.

TextTransformations -> (list)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с параметра самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве агрегированного ключа. Каждое отдельное значение cookie вносит вклад в экземпляр агрегации. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя cookie для использования.

TextTransformations -> (list)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с параметра самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве агрегированного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегации. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя аргумента запроса для использования.

TextTransformations -> (list)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с параметра самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryString -> (structure)

Используйте строку запроса запроса в качестве агрегированного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегации. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с параметра самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

HTTPMethod -> (structure)

Используйте метод HTTP запроса в качестве агрегированного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегации. Если вы используете только метод HTTP в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегации.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве агрегированного ключа. Каждый отдельный переадресованный IP-адрес вносит вклад в экземпляр агрегации.

Когда вы указываете IP-адрес или переадресованный IP-адрес в настройках пользовательского ключа, вы также должны указать хотя бы один другой ключ для использования. Вы можете агрегировать только по переадресованному IP-адресу, указав FORWARDED_IP в операторе на основе скорости AggregateKeyType .

С помощью этой опции необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве агрегированного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегации.

Когда вы указываете IP-адрес или переадресованный IP-адрес в настройках пользовательского ключа, вы также должны указать хотя бы один другой ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в операторе на основе скорости AggregateKeyType .

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве агрегированного ключа. Каждое отдельное полностью квалифицированное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегации. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегации.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

Для получения информации о пространствах имен и именах меток см. раздел Синтаксис и требования к именованию меток в Руководстве разработчика WAF .

Namespace -> (string)

Пространство имен для использования для агрегации.

UriPath -> (structure)

Используйте путь URI запроса в качестве агрегированного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегации. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение. Текстовые преобразования используются в операторах соответствия правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с параметра самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах в попытке обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

JA3Fingerprint -> (structure)

Используйте отпечаток JA3 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если недостаточно информации о TSL Client Hello для вычисления отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток пальца JA4 запроса в качестве агрегатного ключа. Если вы используете один отпечаток пальца JA4 в качестве пользовательского ключа, каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка пальца JA4.

Вы можете указать следующие варианты поведения при отступлении:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой AND. Вы предоставляете более одного Statement в AndStatement .

Statements -> (list)

Операторы для объединения с логикой AND. Вы можете использовать любые операторы, которые можно вложить.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой OR. Вы предоставляете более одного Statement в OrStatement .

Statements -> (list)

Операторы для объединения с логикой OR. Вы можете использовать любые операторы, которые можно вложить.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один Statement в NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вложить ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Нельзя использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control account takeover prevention (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control account creation fraud prevention (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия используемой управляемой группы правил. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика при обновлении настроек управляемой группы правил поставщика.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любые действительные настройки действий, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любые действительные настройки действий, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также места в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в ваше приложение и места в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать в группе правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также места в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в ваше приложение и места в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать в группе правил Bot Control.

Примеры спецификаций см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этого параметра укажите свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этого параметра укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этого параметра укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя - /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя - username1

PasswordField -> (structure)

Примечание

Вместо этого параметра укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля - /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля - password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. WAF Bot Control rule group и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки, который следует использовать для группы правил Bot Control. Общий уровень - самый дешевый. Целевой уровень включает в себя все общие правила и добавляет правила с более сложными критериями проверки. Подробнее см. WAF Bot Control rule group в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, использовать ли машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Листинг правил Bot Control в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетных записей (ATP), AWSManagedRulesATPRuleSet. Используйте это, чтобы предоставить информацию о запросе на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив отвечает на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в WAF Developer Guide .

LoginPath -> (string)

Путь конечной точки входа для вашего приложения. Например, для URL https://example.com/web/login, вы предоставите путь /web/login. Пути входа, начинающиеся с указанного вами пути, считаются соответствующими. Например, /web/login соответствует путям входа /web/login, /web/login/, /web/loginPage и /web/login/thisPage, но не соответствует пути входа /home/web/login или /website/login.

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа, либо JSON, либо закодирован в форму.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, которое содержит имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } }, спецификация поля имени пользователя — /form/username.
  • Для типов полезной нагрузки, закодированных в форму, используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1, спецификация поля имени пользователя — username1

Identifier -> (string)

Название поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } }, спецификация поля имени пользователя — /form/username.
  • Для типов полезной нагрузки, закодированных в форму, используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1, спецификация поля имени пользователя — username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, которое содержит пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } }, спецификация поля пароля — /form/password.
  • Для типов полезной нагрузки, закодированных в форму, используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1, спецификация поля пароля — password1.

Identifier -> (string)

Название поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } }, спецификация поля пароля — /form/password.
  • Для типов полезной нагрузки, закодированных в форму, используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1, спецификация поля пароля — password1.

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно в попытках входа клиентов, ведя подсчет успешных и неудачных попыток для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

JSON пример: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

JSON пример: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Название заголовка для сопоставления. Имя должно быть точным совпадением, включая регистр.

JSON пример: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON примеры: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON примеры: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON примеры: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON пример: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен быть точным совпадением, включая регистр.

JSON примеры: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON пример: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON пример: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet . Используйте это, чтобы предоставить информацию о запросе создания учетной записи группе правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы создания учетной записи.

Информацию об использовании управляемой группы правил ACFP см. в разделе Предотвращение мошенничества при создании учетной записи (ACFP) группы правил WAF Fraud Control и Предотвращение мошенничества при создании учетной записи (ACFP) в Руководстве разработчика WAF.

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount, вы должны предоставить путь /web/newaccount. Пути к страницам создания учетной записи, начинающиеся с указанного вами пути, считаются совпадающими. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, на которой форма регистрации представлена новым пользователям.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL https://example.com/web/registration, вы должны предоставить путь /web/registration. Пути к страницам регистрации, начинающиеся с указанного вами пути, считаются совпадающими. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или закодированная форма.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, которое содержит имя пользователя вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 , спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, которое содержит пароль вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 , спецификация поля пароля — password1 .

Identifier -> (string)

Имя поля пароля.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 , спецификация поля пароля — password1 .

EmailField -> (structure)

Имя поля в полезной нагрузке запроса, которое содержит электронную почту вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем email1 , спецификация поля электронной почты — email1 .

Identifier -> (string)

Имя поля электронной почты.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем email1 , спецификация поля электронной почты — email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, которые содержат основной номер телефона вашего клиента.

Упорядочивайте поля номера телефона в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, которое содержит часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного номера телефона.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, которые содержат основной физический адрес вашего клиента.

Упорядочивайте поля адреса в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, которое содержит часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного адреса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентом, подсчитывая успешные и неудачные попытки с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы из сеансов клиентов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (структура)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (список)

Коды состояния в ответе, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(целое число)

FailureCodes -> (список)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(целое число)

Header -> (структура)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (строка)

Имя заголовка для сопоставления. Имя должно точно совпадать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (список)

Значения в заголовке ответа с указанным именем, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(строка)

FailureValues -> (список)

Значения в заголовке ответа с указанным именем, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(строка)

BodyContains -> (структура)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (список)

Строки в теле ответа, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(строка)

FailureStrings -> (список)

Строки в теле ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(строка)

Json -> (структура)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (строка)

Идентификатор для сопоставления значения в JSON. Идентификатор должен точно совпадать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (список)

Значения для указанного идентификатора в JSON ответа, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(строка)

FailureValues -> (список)

Значения для указанного идентификатора в JSON ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(строка)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

Настройки действия для использования вместо действий правил, настроенных внутри группы правил. Вы указываете один override для каждого правила, действие которого хотите изменить.

Примечание

Убедитесь, что имена правил в ваших override совпадают. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку override.

Вы можете использовать override для тестирования, например, вы можете переопределить все действия правил на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно переопределять некоторые или все действия, чтобы изменить то, как группа правил управляет вашим веб-трафиком.

(структура)

Настройка действия для использования вместо действия правила, настроенного внутри группы правил. Вы указываете один override для каждого правила, действие которого хотите изменить.

Примечание

Убедитесь, что имена правил в ваших override совпадают. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку override.

Вы можете использовать override для тестирования, например, вы можете переопределить все действия правил на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно переопределять некоторые или все действия, чтобы изменить то, как группа правил управляет вашим веб-трафиком.

Name -> (string)

Имя правила для переопределения.

Примечание

Убедитесь, что имена правил в ваших override совпадают. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку override.

ActionToUse -> (structure)

Действие переопределения, которое следует использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

HTTP-код состояния, который необходимо вернуть клиенту.

Список кодов состояния, которые можно использовать в настраиваемых ответах, см. в разделе Поддерживаемые коды состояния для настраиваемого ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF возвращал клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое настроено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию для web ACL BlockAction , вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

HTTP-заголовки, которые необходимо использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в web ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, которые были добавлены к веб-запросу правилами, которые уже были запущены в web ACL.

Оператор соответствия меткам предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или все полностью определенное имя метки, которое было добавлено к веб-запросу. Полностью определенные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст web ACL правила, которое добавило метку. Если вы не предоставите полностью определенное имя в своей строке соответствия меткам, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор соответствия меткам.

Scope -> (string)

Укажите, хотите ли вы выполнить сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора сопоставления:

  • Если Scope указывает LABEL , то это указание должно включать имя и может включать любое количество предыдущих указаний пространства имен и префикс до предоставления полностью определенного имени метки.
  • Если Scope указывает NAMESPACE , то это указание может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или web ACL, где метка берет свое начало.

Метки чувствительны к регистру, и компоненты метки должны быть разделены двоеточием, например NS1:NS2:name .

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные комиссии за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные комиссии за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела запроса в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками вашего правила и действия веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные комиссии за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки анализа, с которой он столкнется.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. body JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные комиссии за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела запроса в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками вашего правила и действия веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для определения подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для определения подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и чтобы совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления поля при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с соответствием строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие резервные поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с соответствием строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие резервные поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, которую он обнаружит.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Если синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматирования, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматирования, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Text transformations в Руководстве разработчика WAF .

OrStatement -> (structure)

Логический оператор правил, используемый для объединения других операторов правил с логикой ИЛИ. Вы предоставляете более одного оператора в OrStatement .

Statements -> (list)

Операторы для объединения с логикой ИЛИ. Вы можете использовать любые операторы, которые могут быть вложенными.

(структура)

Руководство по обработке для правила, используемое WAF для определения того, соответствует ли веб-запрос правилу.

Примеры спецификаций см. в разделе примеров CreateWebACL .

ByteMatchStatement -> (structure)

Оператор правила, определяющий поиск соответствия строк для WAF для применения к веб-запросам. Оператор соответствия байтов предоставляет байты для поиска, местоположение в запросах, которые вы хотите, чтобы WAF искал, и другие параметры. Байты для поиска, как правило, являются строкой, соответствующей символам ASCII. В консоли WAF и руководстве разработчика это называется оператором соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF выполняет поиск только в той части веб-запросов, которую вы указываете для проверки в FieldToMatch . Максимальная длина значения — 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с соответствием строкам ByteMatchStatement с PositionalConstraint , установленным в EXACTLY . Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе Log fields в Руководстве разработчика WAF .
  • HeaderOrder : Список имен заголовков для соответствия. WAF создает строку, содержащую упорядоченный список имен заголовков из заголовков в веб-запросе, а затем сопоставляет ее с этой строкой.

Если SearchString включает в себя буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете API WAF

Укажите версию значения, закодированную в base64. Максимальная длина значения перед кодированием в base64 составляет 200 байт.

Например, предположим, что значение Type — HEADER , а значение Data — User-Agent . Если вы хотите выполнить поиск в заголовке User-Agent значения BadBot , вы кодируете BadBot с помощью кодировки MIME base64 и включаете результирующее значение QmFkQm90 в значение SearchString .

Если вы используете CLI или один из SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение в base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса сразу следует за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса сразу следует за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо эту настройку, либо настройку IncludedPaths , но не обе.

IncludedPaths -> (list)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо эту настройку, либо настройку All , но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью разобрать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All , IncludedHeaders или ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Он требует, чтобы совпадение было найдено в ключах, значениях или обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил соответствия: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 заголовков всего. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует утверждению правила.

Cookies -> (структура)

Проверить файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All , IncludedCookies или ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Он требует, чтобы совпадение было найдено в ключах, значениях или обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил соответствия: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запросов, если они превышают 8 КБ (8192 байта) или 200 файлов cookie всего. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH — считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует утверждению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для соответствия при проверке. WAF разделяет имена заголовков в строке с использованием двоеточий и без добавления пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 заголовков всего. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует утверждению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в значение EXACTLY .

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Укажите строку отпечатка пальца JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA3.

Можно указать следующие варианты резервного поведения:

  • MATCH — считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует утверждению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в значение EXACTLY .

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Укажите строку отпечатка пальца JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA4.

Можно указать следующие варианты резервного поведения:

  • MATCH — считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует утверждению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment , чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует утверждению правила.

Если этот параметр не указан, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF parsing doesn’t fully validate the input JSON string, so parsing can succeed even for invalid JSON. When parsing succeeds, WAF doesn’t apply the fallback behavior. For more information, see JSON body in the WAF Developer Guide .

TextTransformations -> (list)

Преобразования текста —> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самой низкой приоритетности, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе «Преобразования текста» в Руководстве разработчика WAF .

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF выполнял поиск SearchString. Допустимые значения включают следующие:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString, но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString, а SearchString должен содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что оба следующих условия верны:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot.
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot;.
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString.

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного кода SQL. Злоумышленники вставляют вредоносный код SQL в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса в виде обычного текста. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает WAF для проверки только содержимое, находящееся в пределах лимита.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает WAF для проверки только содержимое, находящееся в пределах лимита.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с вашими настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает WAF для проверки только содержимое, находящееся в пределах лимита.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствие только указанным путям включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе "Тело JSON" в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает WAF для проверки только содержимое, находящееся в пределах лимита.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с вашими настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байт) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для определения подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Он требует совпадения в ключах, значениях или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки негабаритного размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байт) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для определения подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Он требует совпадения в ключах, значениях или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Параметры обработки негабаритного размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления поля в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки негабаритного размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка пальца JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка пальца JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверить фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью обработать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF обработает и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Если синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

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

Type -> (string)

Для подробного описания каждого типа преобразований см. Text transformations в WAF Developer Guide .

SensitivityLevel -> (string)

The sensitivity that you want WAF to use to inspect for SQL injection attacks.

HIGH detects more attacks, but might generate more false positives, especially if your web requests frequently contain unusual strings. For information about identifying and mitigating false positives, see Testing and tuning in the WAF Developer Guide .

LOW is generally a better choice for resources that already have other protections against SQL injection attacks or that have a low tolerance for false positives.

Default: LOW

XssMatchStatement -> (structure)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). В атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских скриптов в другие легитимные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Соответствовать всем элементам. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF сопоставит ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможные варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может завершиться успехом даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

Cookies -> (структура)

Проверить файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве поля для сопоставления компонентов при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот выбор можно использовать только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено в значение EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» руководства разработчика по WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот выбор можно использовать только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено в значение EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» руководства разработчика по WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

UriFragment -> (структура)

Проверка фрагментов URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие параметры:

  • EVALUATE_AS_STRING — проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим заявлению правила.

Если не указать этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда анализ завершается успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе «Тело JSON» руководства разработчика по WAF.
```

TextTransformations -> (list)

Преобразования текста -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробное описание каждого типа преобразования см. в разделе Text transformations в Руководстве разработчика WAF .

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, вы можете использовать оператор ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF будет проверять только количество байтов в теле до лимита для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера для блокировки запросов с большим размером тела запроса. Для получения дополнительной информации об ограничениях проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI для значения параметра Часть запроса для фильтрации, косая черта (/) в URI будет считаться одним символом. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может иметь длину до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в виде тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, размер которых превышает допустимый, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить исходный сервер.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в виде тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, размер которых превышает допустимый, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует обнаружения совпадения в ключах и обнаружения совпадения в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ успешен, WAF не применяет поведение резервного копирования. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого негабаритного содержимого заголовка в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков, соответствующие критериям проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Для этого требуется совпадение в ключах, значениях или в обоих случаях. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки переразмерности следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого негабаритного содержимого cookie в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверьте все файлы cookie.

IncludedCookies -> (список)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Для этого требуется совпадение в ключах, значениях или в обоих случаях. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлов cookie в запросе больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки переразмерности следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления поля при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки переразмерности следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с установленным параметром PositionalConstraint в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие резервные поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с установленным параметром PositionalConstraint в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие резервные поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого негабаритного содержимого фрагмента URI в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может пройти даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

ComparisonOperator -> (string)

Оператор для сравнения части запроса с настройкой размера.

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и сопоставляет их с веб-запросами на основе кода страны. Правило соответствия геолокации помечает каждый проверяемый им запрос, независимо от того, нашло ли оно соответствие.

  • Чтобы управлять запросами только по странам, вы можете использовать этот оператор отдельно и указать страны, с которыми вы хотите сопоставить в массиве CountryCodes.
  • В противном случае настройте свое правило соответствия геолокации с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам, чтобы запустить их после правила соответствия геолокации, и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухбуквенные коды стран и регионов из международного стандарта ISO (ISO) 3166. WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы укажете его, адрес в ForwardedIPConfig соответствия геолокации.

Если вы используете источник веб-запроса, форматы меток - awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете переадресованный IP-адрес, форматы меток - awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Для получения дополнительных сведений см. Geographic match rule statement in the WAF Developer Guide .

CountryCodes -> (list)

Массив двухбуквенных кодов стран, с которыми вы хотите сопоставить, например [ "US", "CN" ] , из двухбуквенных кодов ISO страны международного стандарта ISO 3166.

Когда вы используете оператор соответствия геолокации только для меток региона и страны, которые он добавляет в запросы, вам все равно придется предоставить код страны, чтобы правило оценивалось. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно по-прежнему будет генерировать журналы и показатели подсчета для любых соответствий. Вы можете уменьшить количество журналов и показателей, которые создает правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в HTTP-заголовке, который вы указываете, вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для этого значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при резервном копировании:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Нельзя вкладывать RuleGroupReferenceStatement, например, для использования внутри NotStatement или OrStatement. Нельзя использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, для которых действия установлены в Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любой допустимый параметр действия, включая Count.

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любой допустимый параметр действия, включая Count.

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count.

RuleActionOverrides -> (list)

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

Примечание

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

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно переопределять некоторые или все действия, чтобы изменить способ управления вашим веб-трафиком группой правил.

(structure)

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

Примечание

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

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно переопределять некоторые или все действия, чтобы изменить способ управления вашим веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

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

ActionToUse -> (structure)

Действие переопределения, которое нужно использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP, который нужно вернуть клиенту.

Список кодов состояния, которые можно использовать в ваших пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое настроено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или настройке BlockAction действия веб-ACL по умолчанию, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правила, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который определяет адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать набор IP, см. CreateIPSet.

Каждый оператор правила IP-набора ссылается на IP-набор. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Amazon Resource Name (ARN) IPSet, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значением заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные — прокси-серверы, через которые прошел запрос.

Параметры этого параметра следующие:

  • FIRST - Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий в компонентах веб-запроса с помощью регулярных выражений. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов регулярных выражений, см. CreateRegexPatternSet .

Каждый оператор правила набора шаблонов регулярных выражений ссылается на набор шаблонов регулярных выражений. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Имя ресурса Amazon (ARN) набора RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Альтернативно, вы можете фильтровать и проверять все заголовки с параметром Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковая имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих соответствий шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение отката. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большего размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно одну настройку: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое утверждение AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

Cookies -> (структура)

Проверить файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie большего размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно одну настройку: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое утверждение AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлов cookie в запросе больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента соответствия поля в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации вашего оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации вашего оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не содержит отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагментов URI большего размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе JSON body в Руководстве разработчика WAF.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

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

Type -> (string)

Для подробного описания каждого типа преобразований см. Text transformations в WAF Developer Guide .

RateBasedStatement -> (structure)

A rate-based rule counts incoming requests and rate limits requests when they are coming at too fast a rate. The rule categorizes requests according to your aggregation criteria, collects them into aggregation instances, and counts and rate limits the requests for each instance.

Примечание

Если вы измените какие-либо из этих настроек в правиле, которое в настоящее время используется, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия по ограничению скорости правила на срок до одной минуты.

You can specify individual aggregation keys, like IP address or HTTP method. You can also specify aggregation key combinations, like IP address and HTTP method, or HTTP method, query argument, and cookie.

Each unique set of values for the aggregation keys that you specify is a separate aggregation instance, with the value from each key contributing to the aggregation instance definition.

For example, assume the rule evaluates web requests with the following IP address and HTTP method values:

  • IP address 10.1.1.1, HTTP method POST
  • IP address 10.1.1.1, HTTP method GET
  • IP address 127.0.0.0, HTTP method POST
  • IP address 10.1.1.1, HTTP method GET

The rule would create different aggregation instances according to your aggregation criteria, for example:

  • If the aggregation criteria is just the IP address, then each individual address is an aggregation instance, and WAF counts requests separately for each. The aggregation instances and request counts for our example would be the following:
    • IP address 10.1.1.1: count 3
    • IP address 127.0.0.0: count 1
  • If the aggregation criteria is HTTP method, then each individual HTTP method is an aggregation instance. The aggregation instances and request counts for our example would be the following:
    • HTTP method POST: count 2
    • HTTP method GET: count 2
  • If the aggregation criteria is IP address and HTTP method, then each IP address and each HTTP method would contribute to the combined aggregation instance. The aggregation instances and request counts for our example would be the following:
    • IP address 10.1.1.1, HTTP method POST: count 1
    • IP address 10.1.1.1, HTTP method GET: count 2
    • IP address 127.0.0.0, HTTP method POST: count 1

For any n-tuple of aggregation keys, each unique combination of values for the keys defines a separate aggregation instance, which WAF counts and rate-limits individually.

You can optionally nest another statement inside the rate-based statement, to narrow the scope of the rule so that it only counts and rate limits requests that match the nested statement. You can use this nested scope-down statement in conjunction with your aggregation key specifications or you can just count and rate limit all requests that match the scope-down statement, without additional aggregation. When you choose to just manage all requests that match a scope-down statement, the aggregation instance is singular for the rule.

You cannot nest a RateBasedStatement inside another statement, for example inside a NotStatement or OrStatement . You can define a RateBasedStatement inside a web ACL and inside a rule group.

For additional information about the options, see Rate limiting web requests using rate-based rules in the WAF Developer Guide .

If you only aggregate on the individual IP address or forwarded IP address, you can retrieve the list of IP addresses that WAF is currently rate limiting for a rule through the API call GetRateBasedStatementManagedKeys . This option is not available for other aggregation configurations.

WAF tracks and manages web requests separately for each instance of a rate-based rule that you use. For example, if you provide the same rate-based rule settings in two web ACLs, each of the two rule statements represents a separate instance of the rate-based rule and gets its own tracking and management by WAF. If you define a rate-based rule inside a rule group, and then use that rule group in multiple places, each use creates a separate instance of the rate-based rule that gets its own tracking and management by WAF.

Limit -> (long)

The limit on requests during the specified evaluation window for a single aggregation instance for the rate-based rule. If the rate-based statement includes a ScopeDownStatement , this limit is applied only to the requests that match the statement.

Examples:

  • If you aggregate on just the IP address, this is the limit on requests from any single IP address.
  • If you aggregate on the HTTP method and the query argument name “city”, then this is the limit on requests for any single method, city pair.

EvaluationWindowSec -> (long)

The amount of time, in seconds, that WAF should include in its request counts, looking back from the current time. For example, for a setting of 120, when WAF checks the rate, it counts the requests for the 2 minutes immediately preceding the current time. Valid settings are 60, 120, 300, and 600.

This setting doesn’t determine how often WAF checks the rate, but how far back it looks each time it checks. WAF checks the rate about every 10 seconds.

Default: 300 (5 minutes)

AggregateKeyType -> (string)

Setting that indicates how to aggregate the request counts.

Примечание

Web requests that are missing any of the components specified in the aggregation keys are omitted from the rate-based rule evaluation and handling.
  • CONSTANT - Count and limit the requests that match the rate-based rule’s scope-down statement. With this option, the counted requests aren’t further aggregated. The scope-down statement is the only specification used. When the count of all requests that satisfy the scope-down statement goes over the limit, WAF applies the rule action to all requests that satisfy the scope-down statement. With this option, you must configure the ScopeDownStatement property.
  • CUSTOM_KEYS - Aggregate the request counts using one or more web request components as the aggregate keys. With this option, you must specify the aggregate keys in the CustomKeys property. To aggregate on only the IP address or only the forwarded IP address, don’t use custom keys. Instead, set the aggregate key type to IP or FORWARDED_IP .
  • FORWARDED_IP - Aggregate the request counts on the first IP address in an HTTP header. With this option, you must specify the header to use in the ForwardedIPConfig property. To aggregate on a combination of the forwarded IP address with other aggregate keys, use CUSTOM_KEYS .
  • IP - Aggregate the request counts on the IP address from the web request origin. To aggregate on a combination of the IP address with other aggregate keys, use CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

The configuration for inspecting IP addresses in an HTTP header that you specify, instead of using the IP address that’s reported by the web request origin. Commonly, this is the X-Forwarded-For (XFF) header, but you can specify any header name.

Примечание

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

This is required if you specify a forwarded IP in the rule’s aggregate key settings.

HeaderName -> (string)

The name of the HTTP header to use for the IP address. For example, to use the X-Forwarded-For (XFF) header, set this to X-Forwarded-For .

Примечание

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

FallbackBehavior -> (string)

The match status to assign to the web request if the request doesn’t have a valid IP address in the specified position.

Примечание

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

You can specify the following fallback behaviors:

  • MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.
  • NO_MATCH - Treat the web request as not matching the rule statement.

CustomKeys -> (list)

Определяет совокупные ключи для использования в правиле rate-base.

(структура)

Определяет один пользовательский совокупный ключ для правила rate-base.

Note

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, опускаются из оценки и обработки правила rate-based.

Header -> (структура)

Используйте значение заголовка в запросе в качестве совокупного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегирования. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя заголовка для использования.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве совокупного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегирования. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя cookie для использования.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве совокупного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегирования. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя аргумента запроса для использования.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

QueryString -> (structure)

Используйте строку запроса запроса в качестве совокупного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегирования. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

HTTPMethod -> (structure)

Используйте метод HTTP запроса в качестве совокупного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегирования. Если вы используете только метод HTTP в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегирования.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве совокупного ключа. Каждый отдельный переадресованный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или переадресованный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете выполнять агрегирование только по переадресованному IP-адресу, указав FORWARDED_IP в заявлении rate-based AggregateKeyType .

С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве совокупного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или переадресованный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете выполнять агрегирование только по IP-адресу, указав IP в заявлении rate-based AggregateKeyType .

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве совокупного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегирования. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегирования.

Это использует только метки, добавленные в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

Сведения о пространствах имен и именах меток см. в разделе Синтаксис меток и требования к именованию в WAF Developer Guide .

Namespace -> (string)

Пространство имен для использования для агрегирования.

UriPath -> (structure)

Используйте путь URI запроса в качестве совокупного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегирования. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

JA3Fingerprint -> (structure)

Используйте отпечаток JA3 запроса в качестве совокупного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если информации о Client Hello TSL недостаточно для вычисления отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток пальца JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток пальца JA4 в качестве пользовательского ключа, каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия для назначения веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка пальца JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой И. Вы предоставляете более одного Statement в рамках AndStatement .

Statements -> (list)

Операторы для объединения с логикой И. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой ИЛИ. Вы предоставляете более одного Statement в рамках OrStatement .

Statements -> (list)

Операторы для объединения с логикой ИЛИ. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один Statement в рамках NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вложить ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control account takeover prevention (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control account creation fraud prevention (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил, чтобы идентифицировать группу правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика, чтобы идентифицировать группу правил.

Version -> (string)

Версия используемой управляемой группы правил. Если вы укажете это, настройка версии будет зафиксирована до тех пор, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию от поставщика, а затем сохраняет версию по умолчанию от поставщика, когда поставщик обновляет настройки управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любые допустимые настройки действий, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любые допустимые настройки действий, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группам правил, используемым для смягчения интеллектуальных угроз, требуется дополнительная настройка:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в ваше приложение и местоположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группам правил, используемым для смягчения интеллектуальных угроз, требуется дополнительная настройка:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в ваше приложение и местоположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

Например, спецификации см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этого параметра укажите свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этого параметра укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этого параметра укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя - /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 , спецификация поля имени пользователя - username1

PasswordField -> (structure)

Примечание

Вместо этого параметра укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля - /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 , спецификация поля пароля - password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. группу правил WAF Bot Control и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки для использования для группы правил Bot Control. Общий уровень является наименее дорогим. Целевой уровень включает все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в группе правил WAF Bot Control в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в списке правил Bot Control в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet. Используйте это для предоставления информации о запросе входа в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы входа.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в Руководстве разработчика WAF.

LoginPath -> (string)

Путь к конечной точке входа в ваше приложение. Например, для URL-адреса https://example.com/web/login вы предоставите путь /web/login. Пути входа, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/login соответствует путям входа /web/login, /web/login/, /web/loginPage и /web/login/thisPage, но не соответствует пути входа /home/web/login или /website/login.

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов входа, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа: JSON или форма с кодировкой.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя выглядит как /form/username.
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя выглядит как username1

Identifier -> (string)

Название поля имени пользователя.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя выглядит как /form/username.
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя выглядит как username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля выглядит как /form/password.
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля выглядит как password1.

Identifier -> (string)

Название поля пароля.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля выглядит как /form/password.
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля выглядит как password1.

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа в систему клиентов, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Название заголовка для сопоставления. Название должно точно соответствовать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для сопоставления значения в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet. Используйте это, чтобы предоставить информацию о запросах на создание учетной записи в группу правил. Для веб-ACL, которые защищают дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы создания учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) rule group и WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) в Руководстве разработчика WAF .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL-адреса https://example.com/web/newaccount, вы предоставите путь /web/newaccount. Пути страниц создания учетной записи, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая представляет форму регистрации новым пользователям.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL-адреса https://example.com/web/registration, вы предоставите путь /web/registration. Пути страниц регистрации, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или форма с кодировкой.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя: /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя: username1

Identifier -> (string)

Имя поля имени пользователя.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя: /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя: username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля: /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля: password1 .

Identifier -> (string)

Имя поля пароля.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля: /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля: password1 .

EmailField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего электронную почту вашего клиента.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты: /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты: email1 .

Identifier -> (string)

Имя поля электронной почты.

Как это указать, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты: /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты: email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Как указать поля номера телефона, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона: primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного номера телефона.

Как указать поля номера телефона, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона: primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Как указать поля адреса, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса: /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного адреса.

Как указать поля адреса, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса: /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания коэффициентов успешности создания учетной записи.

Примечание

Проверка ответов доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентом, ведя подсчет успешных и неудачных попыток с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от клиентских сеансов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка, с которым нужно выполнить сопоставление. Имя должно быть точным совпадением, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешной, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачной, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения, с которым нужно выполнить сопоставление в JSON. Идентификатор должен быть точным совпадением, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

Настройки действий для использования вместо действий правил, настроенных внутри группы правил. Вы указываете одну переоценку для каждого правила, действие которого вы хотите изменить.

Примечание

Не забудьте проверить имена правил в своих переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ, которым группа правил управляет вашим веб-трафиком.

(структура)

Настройка действия для использования вместо действия правила, настроенного внутри группы правил. Вы указываете одну переоценку для каждого правила, действие которого вы хотите изменить.

Примечание

Не забудьте проверить имена правил в своих переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ, которым группа правил управляет вашим веб-трафиком.

Имя -> (string)

Имя правила для переопределения.

Примечание

Не забудьте проверить имена правил в своих переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения, которое необходимо использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF блокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP, который необходимо вернуть клиенту.

Список кодов состояния, которые можно использовать в своих пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Указывает на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или настройке веб-ACL по умолчанию BlockAction вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP, которые необходимо использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type. Повторные имена заголовков не допускаются.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Повторные имена заголовков не допускаются.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Повторные имена заголовков не допускаются.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Повторные имена заголовков не допускаются.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Повторные имена заголовков не допускаются.

Информацию об ограничениях на количество и размер для пользовательских настроек запроса и ответа см. в разделе Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Инструкция правила для сопоставления с метками, которые были добавлены к веб-запросу правилами, которые уже запущены в веб-ACL.

Инструкция сопоставления меток предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или все полностью квалифицированное имя метки, которое было добавлено к веб-запросу. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, которое добавило метку. Если вы не предоставите полностью квалифицированное имя в строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и инструкция сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки, или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope инструкции сопоставления:

  • Если Scope указывает LABEL, то эта спецификация должна включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс до предоставления полностью квалифицированного имени метки.
  • Если Scope указывает NAMESPACE, то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен меток из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, и компоненты метки должны разделяться двоеточием, например NS1:NS2:name.

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с настройками вашего правила и действия веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка HTTP-метода. Метод указывает тип операции, которую запрос требует от источника для выполнения.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов по критериям проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих случаях. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с настройками вашего правила и действия веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для определения подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, либо IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать веб-запрос не соответствующим утверждению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для определения подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, либо IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать веб-запрос не соответствующим утверждению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать веб-запрос не соответствующим утверждению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать веб-запрос не соответствующим утверждению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать веб-запрос не соответствующим утверждению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать веб-запрос не соответствующим утверждению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

ПреобразованияТекста -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

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

NotStatement -> (структура)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один Statement в NotStatement .

Statement -> (structure)

Оператор для отрицания. Вы можете использовать любой оператор, который можно вложить.

ByteMatchStatement -> (structure)

Оператор правила, определяющий поиск соответствия строк для WAF для применения к веб-запросам. Оператор соответствия байтам предоставляет байты для поиска, местоположение в запросах, которое вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска обычно представляют собой строку, соответствующую символам ASCII. В консоли WAF и руководстве для разработчиков это называется оператором соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF ищет только в той части веб-запросов, которую вы назначаете для проверки в FieldToMatch . Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : HTTP-метод, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с соответствием строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY . Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Поля журналов в Руководстве разработчика WAF .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, которая содержит упорядоченный список имен заголовков из заголовков в веб-запросе, а затем сопоставляет ее с этой строкой.

Если SearchString включает буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете WAF API

Укажите версию значения, закодированную в base64. Максимальная длина значения до кодирования base64 составляет 200 байт.

Например, предположим, что значение Type — HEADER , а значение Data — User-Agent . Если вы хотите найти заголовок User-Agent для значения BadBot , вы кодируете base64 BadBot с использованием кодирования MIME base64 и включаете полученное значение, QmFkQm90 , в значение SearchString .

Если вы используете CLI или один из Amazon Web Services SDK

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это та часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверьте строку запроса. Это та часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверьте тело запроса как простой текст. Тело запроса следует сразу после заголовков запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (структура)

Проверьте тело запроса как JSON. Тело запроса следует сразу после заголовков запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (структура)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (строка)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах, и чтобы совпадение было найдено в значениях. Это требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (строка)

Что WAF следует делать, если ему не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. body JSON в Руководстве разработчика WAF.

OversizeHandling -> (строка)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков передаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверьте все заголовки.

IncludedHeaders -> (список)

Проверяйте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверяйте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков, которые необходимо сопоставить с критериями проверки правила. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Доступны следующие варианты обработки негабаритного размера:

  • CONTINUE — Обычным образом проверяйте доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривайте веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверяйте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверяйте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF следует делать, если файлов cookie в запросе больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Доступны следующие варианты обработки негабаритного размера:

  • CONTINUE — Обычным образом проверяйте доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH — Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента сопоставления поля при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Доступны следующие варианты обработки негабаритного размера:

  • CONTINUE — Обычным образом проверяйте доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH — Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH — Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагментов URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF следует делать, если он не может полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING — Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

Преобразования текста -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразования см. в разделе Преобразования текста в Руководстве разработчика WAF .

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString . Допустимые значения включают следующие:

СОДЕРЖИТ

Указанная часть веб-запроса должна включать значение SearchString , но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString , и SearchString должно содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что выполняются оба следующих условия:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot .
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot; .
ТОЧНО

Значение указанной части веб-запроса должно точно соответствовать значению SearchString .

НАЧИНАЕТСЯ_С

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ЗАКАНЧИВАЕТСЯ_С

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов с увеличенным размером, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки негабаритного размера с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверить тело запроса в формате JSON. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов с увеличенным размером, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны, которые нужно искать в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр, чтобы включить все пути. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки негабаритного размера с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверьте все заголовки.

IncludedHeaders -> (список)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверьте все файлы cookie.

IncludedCookies -> (список)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Обычно проверяйте доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Это можно использовать только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отступлении:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Это можно использовать только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отступлении:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отступлении. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

SensitivityLevel -> (string)

The sensitivity that you want WAF to use to inspect for SQL injection attacks.

HIGH detects more attacks, but might generate more false positives, especially if your web requests frequently contain unusual strings. For information about identifying and mitigating false positives, see Testing and tuning in the WAF Developer Guide .

LOW is generally a better choice for resources that already have other protections against SQL injection attacks or that have a low tolerance for false positives.

Default: LOW

XssMatchStatement -> (structure)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). В атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства внедрения вредоносных клиентских скриптов в другие легитимные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковая имеется.

Body -> (structure)

Проверьте тело запроса как простой текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить оригинал.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND , чтобы объединить два правила соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - проверять тело как простой текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Вы должны указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах или значениях, или в обоих. Чтобы требовать совпадение в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах или значениях, или в обоих. Чтобы требовать совпадение в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie в запросе больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента соответствия поля в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, когда они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие резервные поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие резервные поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ успешен, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations in the WAF Developer Guide .

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например «больше чем» (>) или «меньше чем» (<). Например, вы можете использовать оператор ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле до предела для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать предел проверки, вы можете использовать оператор ограничения размера, чтобы блокировать запросы с большим размером тела запроса. Для получения дополнительной информации об ограничениях проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI для значения параметра Часть запроса для фильтрации, косая черта (/) в URI учитывается как один символ. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить исходный сервер.

JsonBody -> (структура)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (список)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах, а соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (строка)

Что WAF следует делать, если он не может полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (строка)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, соответствующие критериям проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно для проверки ключей, а другое — для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает в WAF не более 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверить файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie превышающего размер в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie, подлежащих проверке в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверять все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie, которые необходимо проверить с использованием критериев проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно для проверки ключей, а другое — для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 файлов cookie. Базовая служба хоста пересылает в WAF не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента соответствия поля в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий, без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или в общей сложности 200 заголовков. Базовая служба хоста пересылает в WAF не более 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и балансировщиками нагрузки приложений. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA3.

Можно указать следующие резервные поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и балансировщиками нагрузки приложений. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA4.

Можно указать следующие резервные поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверка фрагментов URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI превышающего размер в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Если анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе Тело JSON в Руководстве разработчика WAF.

ComparisonOperator -> (string)

Оператор для сравнения части запроса с настройкой размера.

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Текстовые преобразования устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе «Текстовые преобразования» в Руководстве разработчика WAF .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и который сопоставляет веб-запросы по коду страны. Правило соответствия географическому положению помечает каждый проверяемый запрос независимо от того, находит ли оно совпадение.

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор сам по себе и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes .
  • В противном случае настройте свое правило соответствия географическому положению с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам для запуска после правила соответствия географическому положению и настройте их для соответствия географическим меткам и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухсимвольные коды страны и региона из международного стандарта ISO (ISO) 3166. WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в ForwardedIPConfig соответствия географическому положению .

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете переадресованный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Дополнительные сведения см. в разделе «Оператор правила соответствия географическому положению» в Руководстве разработчика WAF .

CountryCodes -> (list)

Массив двухсимвольных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ] , из двухсимвольных кодов стран ISO международного стандарта ISO 3166.

Когда вы используете оператор соответствия географическому положению только для меток региона и страны, которые он добавляет к запросам, вы все равно должны предоставить код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно по-прежнему будет создавать ведение журнала и метрики подсчета для любых совпадений. Вы можете уменьшить ведение журнала и метрики, которые создает правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который следует назначить веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правил, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Нельзя вкладывать RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Нельзя использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня внутри правила, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, для которых действия установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(structure)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блок. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в настройке действия правила или действия веб-ACL по умолчанию BlockAction , вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP, которые следует использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые следует вставить в запрос. Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер настроек пользовательских запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правил, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать IP-набор, см. CreateIPSet.

Каждый оператор правила IP-набора ссылается на IP-набор. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) IPSet, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при резервировании:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные - прокси-серверы, через которые прошел запрос.

Варианты этой настройки следующие:

  • FIRST - Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий веб-запросов с регулярными выражениями. Чтобы использовать это, создайте RegexPatternSet, который определяет выражения, которые вы хотите обнаружить, а затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) набора RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить в WAF.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов нестандартного размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки нестандартных размеров следующие:

  • CONTINUE - Обычным образом проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки нестандартных размеров с настройками действий вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов нестандартного размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе "Тело JSON" в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки нестандартных размеров следующие:

  • CONTINUE - Обычным образом проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки нестандартных размеров с настройками действий вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать только один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие — в значениях. Требуется найти соответствие в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверить файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать только один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие — в значениях. Требуется найти соответствие в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND, чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Этот выбор можно использовать только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Вы можете указать следующие варианты поведения при резервировании:

  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Этот выбор можно использовать только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Вы можете указать следующие варианты поведения при резервировании:

  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает запросы по скорости, когда они поступают слишком быстро. Правило категоризирует запросы в соответствии с вашими критериями агрегирования, собирает их в экземпляры агрегирования, а также подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в правиле, которое в настоящее время используется, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия по ограничению скорости правила на срок до минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или HTTP-метод. Вы также можете указать комбинации ключей агрегирования, такие как IP-адрес и HTTP-метод, или HTTP-метод, аргумент запроса и cookie.

Каждый уникальный набор значений для указанных вами ключей агрегирования представляет собой отдельный экземпляр агрегирования, при этом значение каждого ключа вносит вклад в определение экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и HTTP-метода:

  • IP-адрес 10.1.1.1, HTTP-метод POST
  • IP-адрес 10.1.1.1, HTTP-метод GET
  • IP-адрес 127.0.0.0, HTTP-метод POST
  • IP-адрес 10.1.1.1, HTTP-метод GET

Правило создаст разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого из них. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегирования является HTTP-метод, то каждый отдельный HTTP-метод является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • HTTP-метод POST: количество 2
    • HTTP-метод GET: количество 2
  • Если критерием агрегирования являются IP-адрес и HTTP-метод, то каждый IP-адрес и каждый HTTP-метод будут вносить вклад в объединенный экземпляр агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, HTTP-метод POST: количество 1
    • IP-адрес 10.1.1.1, HTTP-метод GET: количество 2
    • IP-адрес 127.0.0.0, HTTP-метод POST: количество 1

Для любого n-кортежа ключей агрегирования каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает по скорости индивидуально.

При необходимости вы можете вложить другой оператор внутри оператора на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало по скорости только запросы, соответствующие вложенному оператору. Вы можете использовать этот вложенный оператор уменьшения области действия в сочетании со спецификациями ключей агрегирования или просто подсчитывать и ограничивать по скорости все запросы, соответствующие оператору уменьшения области действия, без дополнительного агрегирования. Когда вы выбираете просто управлять всеми запросами, соответствующими оператору уменьшения области действия, экземпляр агрегирования является единственным для правила.

Вы не можете вложить RateBasedStatement внутри другого оператора, например, внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Дополнительные сведения об опциях см. в разделе Rate limiting web requests using rate-based rules в WAF Developer Guide .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, которые WAF в настоящее время ограничивает по скорости для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставите одни и те же настройки правила на основе скорости в двух веб-ACL, каждый из двух операторов правил представляет собой отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление со стороны WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление со стороны WAF.

Limit -> (long)

Лимит запросов в течение указанного окна оценки для одного экземпляра агрегирования для правила на основе скорости. Если оператор на основе скорости включает в себя ScopeDownStatement , этот лимит применяется только к запросам, соответствующим оператору.

Примеры:

  • Если вы агрегируете только по IP-адресу, это лимит на запросы с любого одного IP-адреса.
  • Если вы агрегируете по HTTP-методу и имени аргумента запроса «city», то это лимит на запросы для любой одной пары method, city.

EvaluationWindowSec -> (long)

Промежуток времени в секундах, который WAF должен включать в свои подсчеты запросов, оглядываясь назад с текущего момента времени. Например, при настройке 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые значения: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а насколько далеко назад он смотрит каждый раз, когда проверяет. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 minutes)

AggregateKeyType -> (string)

Настройка, указывающая, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правил на основе скорости.
  • CONSTANT - Подсчитайте и ограничьте количество запросов, соответствующих оператору уменьшения области действия правила на основе скорости. С помощью этого параметра подсчитанные запросы больше не агрегируются. Спецификация оператора уменьшения области действия является единственной используемой. Когда количество всех запросов, удовлетворяющих оператору уменьшения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим оператору уменьшения области действия. С помощью этого параметра необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. С помощью этого параметра необходимо указать ключи агрегирования в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегирования в IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. С помощью этого параметра необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы агрегировать комбинацию перенаправленного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать комбинацию IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (string)

Имя заголовка HTTP для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для этого значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанном положении.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

CustomKeys -> (list)

Указывает совокупные ключи для использования в правиле ограничения скорости.

(структура)

Указывает один настраиваемый совокупный ключ для правила ограничения скорости.

Примечание

Web-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, опускаются при оценке и обработке правил ограничения скорости.

Заголовок -> (структура)

Используйте значение заголовка в запросе в качестве совокупного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегации. Если вы используете один заголовок в качестве настраиваемого ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя заголовка для использования.

TextTransformations -> (список)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF.

Cookie -> (структура)

Используйте значение cookie в запросе в качестве совокупного ключа. Каждое отдельное значение cookie вносит вклад в экземпляр агрегации. Если вы используете один cookie в качестве настраиваемого ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя cookie для использования.

TextTransformations -> (список)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF.

QueryArgument -> (структура)

Используйте указанный аргумент запроса в качестве совокупного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегации. Если вы используете один аргумент запроса в качестве настраиваемого ключа, то каждое значение полностью определяет экземпляр агрегации.

Имя -> (строка)

Имя аргумента запроса для использования.

TextTransformations -> (список)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF.

QueryString -> (структура)

Используйте строку запроса запроса в качестве совокупного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегации. Если вы используете только строку запроса в качестве своего настраиваемого ключа, то каждая строка полностью определяет экземпляр агрегации.

TextTransformations -> (список)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF.

HTTPMethod -> (структура)

Используйте метод HTTP запроса в качестве совокупного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегации. Если вы используете только метод HTTP в качестве своего настраиваемого ключа, то каждый метод полностью определяет экземпляр агрегации.

ForwardedIP -> (структура)

Используйте первый IP-адрес в заголовке HTTP в качестве совокупного ключа. Каждый отдельный переадресованный IP-адрес вносит вклад в экземпляр агрегации.

Когда вы указываете IP или переадресованный IP в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете агрегировать только по переадресованному IP-адресу, указав FORWARDED_IP в операторе ограничения скорости AggregateKeyType.

С помощью этой опции вы должны указать заголовок для использования в правиле ограничения скорости ForwardedIPConfig.

IP -> (структура)

Используйте исходный IP-адрес запроса в качестве совокупного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегации.

Когда вы указываете IP или переадресованный IP в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в операторе ограничения скорости AggregateKeyType.

LabelNamespace -> (структура)

Используйте указанное пространство имен метки в качестве совокупного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегации. Если вы используете только одно пространство имен метки в качестве своего настраиваемого ключа, то каждое имя метки полностью определяет экземпляр агрегации.

Это использует только метки, которые были добавлены к запросу правилами, которые оцениваются перед этим правилом ограничения скорости в веб-ACL.

Информацию о пространствах имен и именах меток см. в разделе Синтаксис метки и требования к именованию в Руководстве разработчика WAF.

Пространство имен -> (строка)

Пространство имен для использования для агрегирования.

UriPath -> (структура)

Используйте путь URI запроса в качестве совокупного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегации. Если вы используете только путь URI в качестве своего настраиваемого ключа, то каждый путь URI полностью определяет экземпляр агрегации.

TextTransformations -> (список)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Текстовые преобразования исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF.

JA3Fingerprint -> (структура)

Используйте отпечаток JA3 запроса в качестве совокупного ключа. Если вы используете один отпечаток JA3 в качестве своего настраиваемого ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (строка)

Статус соответствия, который следует назначить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия для назначения веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Вы можете указать следующие варианты поведения при резервировании:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой AND. Вы предоставляете более одного оператора в пределах AndStatement .

Statements -> (list)

Операторы для объединения с логикой AND. Вы можете использовать любые операторы, которые могут быть вложенными.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой OR. Вы предоставляете более одного оператора в пределах OrStatement .

Statements -> (list)

Операторы для объединения с логикой OR. Вы можете использовать любые операторы, которые могут быть вложенными.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один оператор в пределах NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вложить ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в web ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control account takeover prevention (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control account creation fraud prevention (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика при обновлении поставщиком настроек управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылаемой группе правил, действия которых установлены в Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группам правил, используемым для смягчения интеллектуальных угроз, требуется дополнительная настройка:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet , чтобы настроить управляемую группу правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также места в полезной нагрузке запроса на создание учетной записи данных, таких как поля электронной почты пользователя и номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа вашего приложения и места в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группам правил, используемым для смягчения интеллектуальных угроз, требуется дополнительная настройка:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet , чтобы настроить управляемую группу правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также места в полезной нагрузке запроса на создание учетной записи данных, таких как поля электронной почты пользователя и номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа вашего приложения и места в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил Bot Control.

For example specifications, see the examples section of CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Сведения об использовании управляемой группы правил Bot Control см. в разделе Группа правил WAF Bot Control и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки для использования для группы правил Bot Control. Общий уровень является наименее дорогостоящим. Целевой уровень включает все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе Группа правил WAF Bot Control в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Список правил Bot Control в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная настройка для использования управляемой группы правил предотвращения перехвата учетных записей (ATP), AWSManagedRulesATPRuleSet . Используйте это, чтобы предоставить информацию о запросах на вход в группу правил. Для web ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в WAF Developer Guide .

LoginPath -> (string)

Путь к конечной точке входа для вашего приложения. Например, для URL https://example.com/web/login , вы предоставите путь /web/login . Пути входа, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии для проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезных данных для вашей конечной точки входа: JSON или форма с кодировкой.

UsernameField -> (structure)

Название поля в полезных данных запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя - /form/username .
  • Для типов полезных данных с кодировкой формы используйте имена форм HTML. Например, для формы HTML с элементом ввода с именем username1 , спецификация поля имени пользователя - username1

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "username": "THE_USERNAME" } } , the username field specification is /form/username .
  • Для типов полезных данных с кодировкой формы используйте имена форм HTML. Например, для формы HTML с элементом ввода с именем username1 , спецификация поля имени пользователя - username1

PasswordField -> (structure)

Имя поля в полезных данных запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "password": "THE_PASSWORD" } } , the password field specification is /form/password .
  • Для типов полезных данных с кодировкой формы используйте имена форм HTML. Например, для формы HTML с элементом ввода с именем password1 , спецификация поля пароля - password1 .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "password": "THE_PASSWORD" } } , the password field specification is /form/password .
  • Для типов полезных данных с кодировкой формы используйте имена форм HTML. Например, для формы HTML с элементом ввода с именем password1 , спецификация поля пароля - password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответов доступна только в web ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиента, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным совпадением, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешной, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

JSON examples: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно сопоставить в JSON. Идентификатор должен быть точным совпадением, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Allow the use of regular expressions in the login page path.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил по предотвращению мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet . Используйте это, чтобы предоставить информацию о запросе на создание учетной записи группе правил. Для списков управления доступом к сети, которые защищают CloudFront-распределения, используйте это, чтобы также предоставить информацию о том, как ваше распределение реагирует на запросы на создание учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. WAF Fraud Control account creation fraud prevention (ACFP) rule group и WAF Fraud Control account creation fraud prevention (ACFP) в WAF Developer Guide .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница вашего веб-сайта, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL-адреса https://example.com/web/newaccount , вы предоставите путь /web/newaccount . Пути к страницам создания учетной записи, начинающиеся с указанного вами пути, считаются совпадением. Например /web/newaccount соответствует путям создания учетной записи /web/newaccount , /web/newaccount/ , /web/newaccountPage и /web/newaccount/thisPage , но не соответствует пути /home/web/newaccount или /website/newaccount .

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница вашего веб-сайта, которая представляет форму регистрации новым пользователям.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL-адреса https://example.com/web/registration , вы предоставите путь /web/registration . Пути к страницам регистрации, начинающиеся с указанного вами пути, считаются совпадением. Например /web/registration соответствует путям регистрации /web/registration , /web/registration/ , /web/registrationPage и /web/registration/thisPage , но не соответствует пути /home/web/registration или /website/registration .

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или закодировано в форме.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификацией поля имени пользователя является /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификацией поля имени пользователя является username1

Identifier -> (string)

Название поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификацией поля имени пользователя является /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификацией поля имени пользователя является username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификацией поля пароля является /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификацией поля пароля является password1 .

Identifier -> (string)

Название поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификацией поля пароля является /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификацией поля пароля является password1 .

EmailField -> (structure)

Название поля в полезной нагрузке запроса, содержащего электронную почту вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификацией поля электронной почты является /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификацией поля электронной почты является email1 .

Identifier -> (string)

Название поля электронной почты.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } спецификацией поля электронной почты является /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификацией поля электронной почты является email1 .

PhoneNumberFields -> (list)

Названия полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так, как они упорядочены в полезной нагрузке запроса.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторами поля номера телефона являются /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторами поля номера телефона являются primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Название поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Название одного поля основного номера телефона.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторами поля номера телефона являются /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторами поля номера телефона являются primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Названия полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так, как они упорядочены в полезной нагрузке запроса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторами поля адреса являются /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторами полей адреса являются primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Название поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Название одного поля основного адреса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторами поля адреса являются /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторами полей адреса являются primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответа доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентом, ведя подсчет успешных и неудачных попыток с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы из сеансов клиента и с IP-адресов, которые совершили слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа на индикаторы успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа на индикаторы успеха и неудачи.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно точно соответствовать, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] and "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] and "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа на индикаторы успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] and "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа на индикаторы успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения, с которым нужно сопоставить в JSON. Идентификатор должен точно соответствовать, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] and "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Allow the use of regular expressions in the registration page path and the account creation path.

RuleActionOverrides -> (list)

Настройки действия, которые следует использовать вместо действий правил, настроенных внутри группы правил. Вы указываете одну переопределяющую настройку для каждого правила, действие которого вы хотите изменить.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет параметр переопределения.

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

(структура)

Настройка действия, которая используется вместо действия правила, настроенного внутри группы правил. Вы указываете одну переопределяющую настройку для каждого правила, действие которого вы хотите изменить.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет параметр переопределения.

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

Name -> (string)

Имя правила, которое необходимо переопределить.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет параметр переопределения.

ActionToUse -> (structure)

Действие переопределения, которое необходимо использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF блокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP, который необходимо вернуть клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на текст ответа, который вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, настроенного на блокировку. Для этого сначала определите ключ и значение текста ответа в параметре CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или параметре действия по умолчанию веб-ACL BlockAction вы ссылаетесь на текст ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, за исключением content-type . Дубликаты имен заголовков не допускаются.

Сведения об ограничениях на количество и размер пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса при вставке заголовка в запрос WAF добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Сведения об ограничениях на количество и размер пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса при вставке заголовка в запрос WAF добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Сведения об ограничениях на количество и размер пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса при вставке заголовка в запрос WAF добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что маркер запроса действителен и не истек.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Сведения об ограничениях на количество и размер пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса при вставке заголовка в запрос WAF добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что маркер запроса действителен и не истек.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Сведения об ограничениях на количество и размер пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса при вставке заголовка в запрос WAF добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Инструкция правила для сопоставления с метками, которые были добавлены к веб-запросу правилами, которые уже выполнялись в веб-ACL.

Инструкция соответствия метке предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или все полностью определенное имя метки, которое было добавлено к веб-запросу. Полностью определенные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, добавившего метку. Если вы не предоставите полное имя в своей строке соответствия метке, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и инструкция соответствия метке.

Scope -> (string)

Укажите, хотите ли вы сопоставлять, используя имя метки, или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от параметра Scope оператора соответствия:

  • Если Scope указывает LABEL , то эта спецификация должна включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс до предоставления полного имени метки.
  • Если Scope указывает NAMESPACE , то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, и компоненты метки должны быть разделены двоеточием, например NS1:NS2:name .

RegexMatchStatement -> (structure)

Инструкция правила, используемая для поиска соответствия компонентов веб-запроса с использованием одного регулярного выражения.

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может быть длиной до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий инструкции правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки превышения размера с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения с использованием синтаксиса JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое AND утверждение для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий инструкции правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ успешен, WAF не применяет поведение отката. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий инструкции правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки превышения размера с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка нестандартного размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать совпадение в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Параметры обработки нестандартного размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie нестандартного размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверьте все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать совпадение в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie.

Параметры обработки нестандартного размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, отсортированных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве поля для сопоставления компонентов в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Параметры обработки нестандартного размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот выбор можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо назначить веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот выбор можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо назначить веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI нестандартного размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью обработать тело JSON. Возможные варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если этот параметр не предоставлен, WAF обрабатывает и оценивает содержимое только до первой ошибки обработки, с которой сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Обработка WAF не полностью проверяет входную строку JSON, поэтому обработка может быть успешной даже для недопустимого JSON. Когда обработка прошла успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования указанного содержимого, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations in the WAF Developer Guide .

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вложить ManagedRuleGroupStatement , например для использования внутри NotStatement или OrStatement . Вы не можете использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control account takeover prevention (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control account creation fraud prevention (ACFP) AWSManagedRulesACFPRuleSet . Дополнительную информацию см. в разделе WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия используемой управляемой группы правил. Если вы укажете это, настройка версии будет фиксированной до тех пор, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика при обновлении поставщиком настроек управляемой группы правил.

ExcludedRules -> (list)

Правила в указанной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

ScopeDownStatement -> (structure)

Необязательный вложенный оператор, который сужает область веб-запросов, оцениваемых управляемой группой правил. Запросы оцениваются только группой правил, если они соответствуют оператору уменьшения области. Вы можете использовать любой вложенный оператор Statement в операторе уменьшения области, и вы можете вкладывать операторы на любом уровне, так же, как и для оператора правила.

ByteMatchStatement -> (structure)

Оператор правила, определяющий поиск соответствия строк для WAF, который будет применяться к веб-запросам. Оператор соответствия байтов предоставляет байты для поиска, местоположение в запросах, в которых вы хотите, чтобы WAF выполнял поиск, и другие настройки. Байт для поиска обычно является строкой, соответствующей символам ASCII. В консоли WAF и руководстве разработчика это называется оператором соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF выполняет поиск только в той части веб-запросов, которую вы назначаете для проверки в FieldToMatch . Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с установкой PositionalConstraint в EXACTLY . Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может рассчитать отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Log fields in the WAF Developer Guide .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, которая содержит упорядоченный список имен заголовков из заголовков в веб-запросе, а затем сопоставляет с этой строкой.

Если SearchString включает буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете WAF API

Укажите версию значения, закодированную в формате base64. Максимальная длина значения до его кодирования base64 составляет 200 байт.

Например, предположим, что значение Type — HEADER , а значение Data — User-Agent . Если вы хотите выполнить поиск в заголовке User-Agent для значения BadBot , вы кодируете base64 BadBot с использованием кодирования MIME base64 и включаете полученное значение, QmFkQm90 , в значение SearchString .

Если вы используете CLI или один из пакетов SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковая имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов больших размеров, смотрите конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF следует делать, если размер тела превышает лимит, который WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (структура)

Проверить тело запроса как JSON. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов больших размеров, смотрите конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (структура)

Соответствует всем элементам. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (список)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и чтобы совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (строка)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. body JSON в Руководстве разработчика WAF .

OversizeHandling -> (строка)

Что WAF следует делать, если размер тела превышает лимит, который WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовков с большим размером в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie с большим размером в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверяйте доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено на EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено на EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагментов URI с большим размером в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с настройки с наименьшим приоритетом, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

PositionalConstraint -> (string)

Область в части веб-запроса, в которой необходимо, чтобы WAF искал SearchString. Допустимые значения включают следующее:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString, но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString, а SearchString должно содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает истинность обоих следующих утверждений:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot.
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot;.
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString.

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Заявление правила, которое проверяет наличие вредоносного кода SQL. Злоумышленники вставляют вредоносный код SQL в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить исходник.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL , WAF сопоставляет с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое заявление AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успехом даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе body JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества заголовков, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверьте все заголовки.

IncludedHeaders -> (список)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверяйте доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверьте все файлы cookie.

IncludedCookies -> (список)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверяйте доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверяйте доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с установленным параметром PositionalConstraint в значение EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях журнала см. раздел «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные параметры:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с установленным параметром PositionalConstraint в значение EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях журнала см. раздел «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные параметры:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на атаки типа SQL injection.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию об идентификации и смягчении ложных срабатываний см. в разделе Testing and tuning в WAF Developer Guide .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак типа SQL injection или имеют низкую толерантность к ложным срабатываниям.

Default: LOW

XssMatchStatement -> (structure)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). При XSS-атаках злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских скриптов в другие законные веб-браузеры.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с параметром Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большего размера, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE - Проверять доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки переразмеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверить метод HTTP. Метод указывает тип операции, которую запрос требует от источника для выполнения.

JsonBody -> (структура)

Проверить тело запроса как JSON. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большего размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (список)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения с использованием синтаксиса JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE - Проверять доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки переразмеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка нестандартного размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует нахождения соответствия в ключах и соответствия в значениях. Требуется совпадение в ключах, значениях или в обоих. Чтобы потребовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое — для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверка файлов cookie запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie нестандартного размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует нахождения соответствия в ключах и соответствия в значениях. Требуется совпадение в ключах, значениях или в обоих. Чтобы потребовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое — для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверка строки, содержащей список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту возможность можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия для присвоения веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту возможность можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия для присвоения веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверка фрагментов URI запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI нестандартного размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «JSON body» в Руководстве разработчика WAF.

Преобразования текста -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

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

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, вы можете использовать оператор ограничения размера, чтобы искать строки запросов, которые длиннее 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверит только количество байтов в теле до предела для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать предел проверки, вы можете использовать оператор ограничения размера, чтобы блокировать запросы с большим размером тела запроса. Для получения дополнительной информации об ограничениях проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI учитывается как один символ. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

В качестве альтернативы вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать большие тела запросов, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить HTTP-метод. Метод указывает тип операции, которую запрос просит выполнить исходный сервер.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать большие тела запросов, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Соответствовать всем элементам. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр, чтобы включить все пути. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для неверного JSON. Когда синтаксический анализ проходит успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в WAF Developer Guide.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого заголовков, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков, которые нужно сопоставить с критериями проверки правила. Если вы укажете ALL , WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадение в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL , WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадение в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента соответствия поля при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint , установленным в значение EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журналов см. в разделе Поля журналов в Руководстве разработчика WAF .

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint , установленным в значение EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журналов см. в разделе Поля журналов в Руководстве разработчика WAF .

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment , чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе Тело JSON в Руководстве разработчика WAF .

ComparisonOperator -> (string)

The operator to use to compare the request part to the size setting.

Size -> (long)

The size, in byte, to compare to the request part, after any transformations.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Text transformations are used in rule match statements, to transform the FieldToMatch request component before inspecting it, and they’re used in rate-based rule statements, to transform request components before using them as custom aggregation keys. If you specify one or more transformations to apply, WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

(structure)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

GeoMatchStatement -> (structure)

A rule statement that labels web requests by country and region and that matches against web requests based on country code. A geo match rule labels every request that it inspects regardless of whether it finds a match.

  • To manage requests only by country, you can use this statement by itself and specify the countries that you want to match against in the CountryCodes array.
  • Otherwise, configure your geo match rule with Count action so that it only labels requests. Then, add one or more label match rules to run after the geo match rule and configure them to match against the geographic labels and handle the requests as needed.

WAF labels requests using the alpha-2 country and region codes from the International Organization for Standardization (ISO) 3166 standard. WAF determines the codes using either the IP address in the web request origin or, if you specify it, the address in the geo match ForwardedIPConfig .

If you use the web request origin, the label formats are awswaf:clientip:geo:region:<ISO country code>-<ISO region code> and awswaf:clientip:geo:country:<ISO country code> .

If you use a forwarded IP address, the label formats are awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> and awswaf:forwardedip:geo:country:<ISO country code> .

For additional details, see Geographic match rule statement in the WAF Developer Guide .

CountryCodes -> (list)

An array of two-character country codes that you want to match against, for example, [ "US", "CN" ] , from the alpha-2 country ISO codes of the ISO 3166 international standard.

When you use a geo match statement just for the region and country labels that it adds to requests, you still have to supply a country code for the rule to evaluate. In this case, you configure the rule to only count matching requests, but it will still generate logging and count metrics for any matches. You can reduce the logging and metrics that the rule produces by specifying a country that’s unlikely to be a source of traffic to your site.

(string)

ForwardedIPConfig -> (structure)

The configuration for inspecting IP addresses in an HTTP header that you specify, instead of using the IP address that’s reported by the web request origin. Commonly, this is the X-Forwarded-For (XFF) header, but you can specify any header name.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

HeaderName -> (string)

The name of the HTTP header to use for the IP address. For example, to use the X-Forwarded-For (XFF) header, set this to X-Forwarded-For .

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

FallbackBehavior -> (string)

The match status to assign to the web request if the request doesn’t have a valid IP address in the specified position.

Note

If the specified header isn’t present in the request, WAF doesn’t apply the rule to the web request at all.

You can specify the following fallback behaviors:

  • MATCH - Treat the web request as matching the rule statement. WAF applies the rule action to the request.
  • NO_MATCH - Treat the web request as not matching the rule statement.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, затем укажите ARN группы правил в этом операторе.

Вы не можете вкладывать RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня внутри правила, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылаемой группе правил, для которых действия установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Пожалуйста, внимательно проверьте имена правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правила на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить то, как группа правил управляет вашим веб-трафиком.

(structure)

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

Примечание

Пожалуйста, внимательно проверьте имена правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правила на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить то, как группа правил управляет вашим веб-трафиком.

Name -> (string)

Имя правила для переопределения.

Примечание

Пожалуйста, внимательно проверьте имена правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения, которое будет использоваться вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP, который нужно вернуть клиенту.

Список кодов состояния, которые можно использовать в ваших пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блок. Чтобы сделать это, сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL настройке BlockAction , вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP, которые будут использоваться в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые будут вставлены в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые будут вставлены в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA против веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые будут вставлены в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge против веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые будут вставлены в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правила, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который определяет адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать набор IP, см. CreateIPSet.

Каждый оператор правила набора IP ссылается на набор IP. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Amazon Resource Name (ARN) набора IP, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, вместо использования IP-адреса, который сообщается источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите его значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если запрос не имеет допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси-серверы, через которые прошел запрос.

Варианты этого параметра следующие:

  • FIRST - Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий регулярным выражениям в компонентах веб-запроса. Чтобы использовать это, создайте RegexPatternSet, который определяет выражения, которые вы хотите обнаружить, а затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet .

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) RegexPatternSet, на которое ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверьте все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте ограничение CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте ограничение CloudFront.

Варианты обработки чрезмерных размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Считайте веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считайте веб-запрос не соответствующим оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерных размеров с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте ограничение CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF сопоставляет с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считайте веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считайте веб-запрос не соответствующим оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недопустимого JSON. Когда анализ успешен, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение составляет 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте ограничение CloudFront.

Варианты обработки чрезмерных размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Считайте веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считайте веб-запрос не соответствующим оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерных размеров с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка нестандартного размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков, соответствующие критериям проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует соответствия ключам и соответствия значениям. Он требует соответствия ключам, значениям или обоим. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки нестандартного размера следующие:

  • CONTINUE — обычная проверка доступных заголовков в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie нестандартного размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует соответствия ключам и соответствия значениям. Он требует соответствия ключам, значениям или обоим. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie.

Варианты обработки нестандартного размера следующие:

  • CONTINUE — обычная проверка доступных файлов cookie в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки нестандартного размера следующие:

  • CONTINUE — обычная проверка доступных заголовков в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancer. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие варианты резервного поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancer. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие варианты резервного поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI нестандартного размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста удаляют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста удаляют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

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

RateBasedStatement -> (структура)

Правило на основе скорости подсчитывает входящие запросы и ограничивает скорость запросов, когда они поступают со слишком высокой скоростью. Правило категоризирует запросы в соответствии с вашими критериями агрегирования, собирает их в экземпляры агрегирования, а также подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в правиле, которое в настоящее время используется, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия по ограничению скорости правила на срок до одной минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегирования, такие как IP-адрес и метод HTTP, или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для ключей агрегирования, которые вы указываете, является отдельным экземпляром агрегирования, при этом значение каждого ключа вносит вклад в определение экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило будет создавать разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегирования является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: количество 2
    • Метод HTTP GET: количество 2
  • Если критерием агрегирования является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в комбинированный экземпляр агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любого n-кортежа ключей агрегирования каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает по скорости индивидуально.

При желании вы можете вложить другой оператор внутри оператора на основе скорости, чтобы сузить область действия правила, чтобы оно учитывало и ограничивало скорость только запросов, соответствующих вложенному оператору. Вы можете использовать этот вложенный оператор сужения области действия в сочетании со спецификациями ключей агрегирования или просто подсчитывать и ограничивать скорость всех запросов, соответствующих оператору сужения области действия, без дополнительного агрегирования. Когда вы решите просто управлять всеми запросами, соответствующими оператору сужения области действия, экземпляр агрегирования является единственным для правила.

Нельзя вложить RateBasedStatement внутри другого оператора, например внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Дополнительную информацию о параметрах см. в разделе Ограничение скорости веб-запросов с помощью правил на основе скорости в Руководстве разработчика WAF .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, скорость которых WAF в настоящее время ограничивает для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставите одни и те же параметры правила на основе скорости в двух веб-ACL, каждый из двух операторов правила представляет собой отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление со стороны WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление со стороны WAF.

Лимит -> (длинное)

Лимит на запросы в течение указанного окна оценки для одного экземпляра агрегирования для правила на основе скорости. Если оператор на основе скорости включает в себя ScopeDownStatement , этот лимит применяется только к запросам, соответствующим оператору.

Примеры:

  • Если вы агрегируете только по IP-адресу, это лимит на запросы с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это лимит на запросы для любой одной пары метод-город.

EvaluationWindowSec -> (длинное)

Количество времени в секундах, которое WAF должен включать в свои подсчеты запросов, оглядываясь назад с текущего времени. Например, для настройки 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые параметры: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а определяет, как далеко назад он смотрит каждый раз, когда проверяет. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 минут)

AggregateKeyType -> (строка)

Настройка, указывающая, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо из компонентов, указанных в ключах агрегирования, исключаются из оценки и обработки правил на основе скорости.
  • CONSTANT - Подсчитывать и ограничивать скорость запросов, соответствующих оператору сужения области действия правила на основе скорости. С этим параметром подсчитываемые запросы не подвергаются дальнейшему агрегированию. Оператор сужения области действия — единственная используемая спецификация. Когда количество всех запросов, удовлетворяющих оператору сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим оператору сужения области действия. С этим параметром необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегировать количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. С этим параметром необходимо указать ключи агрегирования в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегирования в значение IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегировать количество запросов по первому IP-адресу в заголовке HTTP. С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы агрегировать по комбинации перенаправленного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .
  • IP - Агрегировать количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать по комбинации IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в заголовке HTTP, который вы указываете, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (строка)

Имя заголовка HTTP, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (строка)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

CustomKeys -> (list)

Указывает совокупные ключи для использования в правиле ограничения скорости.

(структура)

Указывает один пользовательский совокупный ключ для правила ограничения скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правил ограничения скорости.

Заголовок -> (структура)

Используйте значение заголовка в запросе в качестве совокупного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегирования. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Имя -> (string)

Имя заголовка для использования.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве совокупного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегирования. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Имя -> (string)

Имя cookie для использования.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве совокупного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегирования. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Имя -> (string)

Имя аргумента запроса для использования.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

QueryString -> (structure)

Используйте строку запроса запроса в качестве совокупного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегирования. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

HTTPMethod -> (structure)

Используйте метод HTTP-запроса в качестве совокупного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегирования. Если вы используете только метод HTTP в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегирования.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве совокупного ключа. Каждый отдельный перенаправленный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум еще один ключ для использования. Вы можете агрегировать только по перенаправленному IP-адресу, указав FORWARDED_IP в заявлении ограничения скорости AggregateKeyType .

С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила ограничения скорости.

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве совокупного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в настройках пользовательского ключа, вы также должны указать как минимум еще один ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в заявлении ограничения скорости AggregateKeyType .

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве совокупного ключа. Каждое отдельное полностью определенное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегирования. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегирования.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются до этого правила ограничения скорости в веб-ACL.

Сведения о пространствах имен и именах меток см. в разделе Label syntax and naming requirements в WAF Developer Guide .

Namespace -> (string)

Пространство имен для использования для агрегирования.

UriPath -> (structure)

Используйте путь URI запроса в качестве совокупного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегирования. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил ограничения скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

JA3Fingerprint -> (structure)

Используйте отпечаток JA3 запроса в качестве совокупного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Состояние соответствия, которое следует присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой AND. Вы предоставляете более одного Statement в пределах AndStatement .

Statements -> (list)

Операторы для объединения с логикой AND. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой OR. Вы предоставляете более одного Statement в пределах OrStatement .

Statements -> (list)

Операторы для объединения с логикой OR. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один Statement в пределах NotStatement .

( … recursive … )

( … recursive … )LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, добавленными к веб-запросу правилами, которые уже были запущены в веб-ACL.

Оператор сопоставления меток предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю полностью квалифицированную имя метки, которая была добавлена к веб-запросу. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует контекст группы правил или веб-ACL правила, которое добавило метку. Если вы не предоставите полное имя в строке сопоставления меток, WAF выполняет поиск меток, добавленных в том же контексте, что и оператор сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора сопоставления:

  • Если Scope указывает LABEL , то эта спецификация должна включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикса вплоть до предоставления полного квалифицированного имени метки.
  • Если Scope указывает NAMESPACE , то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, где берет начало метка.

Метки чувствительны к регистру, и компоненты метки должны быть разделены двоеточием, например NS1:NS2:name .

RegexMatchStatement -> (structure)

Оператор правила, используемый для поиска соответствия компонентов веб-запроса одному регулярному выражению.

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, идентифицирующая ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки переразмеров с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос требует от источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Требуется найти совпадение в ключах, значениях или и том, и другом. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое — для проверки значений.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, которую он встретит.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки переразмеров с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Вы должны настроить фильтры сопоставления области и шаблона в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку любого содержимого заголовка большого размера в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Вы должны указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверять все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL , WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Вы должны настроить фильтры сопоставления области и шаблона в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку любого содержимого файла cookie большого размера в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Вы должны указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверять все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для сопоставления с критериями проверки правила. Если вы укажете ALL , WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что должен делать WAF, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для расчета. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для расчета. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры сопоставления области и шаблона в объекте UriFragment , чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку любого содержимого фрагмента URI большого размера в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования FieldToMatch компонента запроса перед его проверкой, и они используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве настраиваемых ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations в WAF Developer Guide .

ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также расположение данных в полезной нагрузке запроса на создание учетной записи, например поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и расположение данных в полезной нагрузке запроса на вход, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил этого не требуют.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также расположение данных в полезной нагрузке запроса на создание учетной записи, например поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и расположение данных в полезной нагрузке запроса на вход, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

Примеры спецификаций см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. WAF Bot Control rule group и WAF Bot Control в WAF Developer Guide .

InspectionLevel -> (string)

Уровень проверки, который будет использоваться для группы правил Bot Control. Общий уровень является наименее дорогостоящим. Целевой уровень включает в себя все общие правила уровня и добавляет правила с более продвинутыми критериями проверки. Для получения подробной информации см. WAF Bot Control rule group в WAF Developer Guide .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют аномальное поведение, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Bot Control rules listing в WAF Developer Guide .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это, чтобы предоставить информацию о запросе на вход в группу правил. Для веб-ACL, которые защищают дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. группу правил WAF Fraud Control для предотвращения захвата учетной записи (ATP) и WAF Fraud Control для предотвращения захвата учетной записи (ATP) в Руководстве разработчика WAF .

LoginPath -> (string)

Путь к конечной точке входа для вашего приложения. Например, для URL-адреса https://example.com/web/login , вы предоставите путь /web/login . Пути входа, начинающиеся с предоставленного вами пути, считаются совпадением. Например, /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только запросы HTTP POST к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа: JSON или форма, закодированная.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя выглядит как /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя выглядит как username1

Identifier -> (string)

Название поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя выглядит как /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя выглядит как username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля выглядит как /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

Identifier -> (string)

Название поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля выглядит как /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиента, ведя подсчет успешных и неудачных попыток для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа на индикаторы успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться сбоем, код состояния ответа должен соответствовать одному из этих. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа на индикаторы успеха и сбоя.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно точно соответствовать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа на индикаторы успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачной, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа на индикаторы успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения, с которым нужно сопоставить в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути к странице входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet . Используйте это, чтобы предоставить информацию о запросе на создание учетной записи в группе правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы создания учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. WAF Fraud Control account creation fraud prevention (ACFP) rule group и WAF Fraud Control account creation fraud prevention (ACFP) в Руководстве разработчика WAF .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL-адреса https://example.com/web/newaccount , вы предоставите путь /web/newaccount . Пути страниц создания учетных записей, начинающиеся с указанного вами пути, считаются совпадением. Например /web/newaccount соответствует путям создания учетных записей /web/newaccount , /web/newaccount/ , /web/newaccountPage и /web/newaccount/thisPage , но не соответствует пути /home/web/newaccount или /website/newaccount .

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, на которой форма регистрации представляется новым пользователям.

Примечание

Эта страница должна принимать GET запросы text/html.

Например, для URL-адреса https://example.com/web/registration , вы предоставите путь /web/registration . Пути страниц регистрации, начинающиеся с указанного вами пути, считаются совпадением. Например /web/registration соответствует путям регистрации /web/registration , /web/registration/ , /web/registrationPage и /web/registration/thisPage , но не соответствует пути /home/web/registration или /website/registration .

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или закодированный в форме.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация имени пользователя выглядит как /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация имени пользователя выглядит как username1

Identifier -> (string)

Имя поля имени пользователя.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация имени пользователя выглядит как /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация имени пользователя выглядит как username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля выглядит как /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

Identifier -> (string)

Имя поля пароля.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля выглядит как /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

EmailField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего адрес электронной почты вашего клиента.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты выглядит как /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты выглядит как email1 .

Identifier -> (string)

Имя поля электронной почты.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты выглядит как /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты выглядит как email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Как указать поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона: primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного номера телефона.

Как указать поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона: primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Как указать поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса: /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного адреса.

Как указать поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса: /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответа доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентами, подсчитывая успешные и неудачные попытки с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, которые совершили слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (структура)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (список)

Коды состояния в ответе, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (список)

Коды состояния в ответе, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачной, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (структура)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Название заголовка для сопоставления. Название должно точно совпадать, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (список)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] and "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] and "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (структура)

Настраивает проверку тела ответа на индикаторы успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (список)

Строки в теле ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно совпадать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] and "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачной, строка может находиться в любом месте тела и должна точно совпадать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно совпадать, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] and "Identifier": [ "/sign-up/success" ]

SuccessValues -> (список)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(структура)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF блокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP, возвращаемый клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF возвращал клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое настроено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или действии по умолчанию веб-ACL настройке BlockAction вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

HTTP-заголовки, которые будут использоваться в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Сведения об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Сведения об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Сведения об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Сведения об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Сведения об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, которые были добавлены к веб-запросу правилами, которые уже были запущены в веб-ACL.

Оператор сопоставления меток предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю часть полностью квалифицированного имени метки, которая была добавлена к веб-запросу. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, добавившего метку. Если вы не укажете полностью квалифицированное имя в строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Параметр, который вы предоставляете для этого, зависит от параметра Scope оператора сопоставления:

  • Если Scope указывает LABEL, то это указание должно включать имя и может включать любое количество предшествующих спецификаций пространства имен и префикс до предоставления полностью квалифицированного имени метки.
  • Если Scope указывает NAMESPACE, то это указание может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, а компоненты метки должны быть разделены двоеточием, например NS1:NS2:name .

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверка тела запроса в виде обычного текста. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию ограничение составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию ограничение составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Доступны следующие варианты обработки чрезмерного размера:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерного размера с параметрами вашего правила и действий веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка HTTP-метода. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует непосредственно за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию ограничение составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Соответствие всем элементам. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Соответствие только указанным путям включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF выполнит сопоставление с ключами и значениями.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Для этого требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверка тела как обычного текста. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе Тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию ограничение составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Доступны следующие варианты обработки чрезмерного размера:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерного размера с параметрами вашего правила и действий веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Для проверки WAF, выполняемой базовой службой хоста, пересылаются только первые 8 КБ (8192 байт) заголовков запроса и только первые 200 заголовков. Необходимо настроить обработку любого содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Для проверки WAF, выполняемой базовой службой хоста, пересылаются только первые 8 КБ (8192 байт) файлов cookie запроса и только первые 200 файлов cookie. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie в запросе больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement, для которой PositionalConstraint установлено значение EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Log fields в WAF Developer Guide.

Предоставьте строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, назначаемый веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement, для которой PositionalConstraint установлено значение EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Log fields в WAF Developer Guide.

Предоставьте строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, назначаемый веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Для проверки WAF, выполняемой базовой службой хоста, пересылаются только первые 8 КБ (8192 байт) фрагментов URI запроса и только первые 200 фрагментов URI. Необходимо настроить обработку любого содержимого фрагментов URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Доступны следующие параметры:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий утверждению правила.

Если этот параметр не указан, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе JSON body в WAF Developer Guide.

TextTransformations -> (list)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Приоритет -> (целое число)

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

Тип -> (строка)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для смягчения интеллектуальных угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса создания учетной записи данных, таких как электронная почта пользователя и поля номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и местоположения в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил Bot Control.

(структура)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для смягчения интеллектуальных угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса создания учетной записи данных, таких как электронная почта пользователя и поля номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и местоположения в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил Bot Control.

Например, спецификации см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Информацию об использовании управляемой группы правил Bot Control см. в разделах WAF Bot Control rule group и WAF Bot Control в WAF Developer Guide .

InspectionLevel -> (string)

Уровень проверки, который будет использоваться для группы правил Bot Control. Общий уровень является наименее затратным. Целевой уровень включает в себя все общие правила уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе WAF Bot Control rule group в WAF Developer Guide .

EnableMachineLearning -> (boolean)

Применимо только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Bot Control rules listing в WAF Developer Guide .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это для предоставления информации о запросах на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это также для предоставления информации о том, как ваш дистрибутив реагирует на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Информацию об использовании управляемой группы правил ATP см. в разделе Предотвращение захвата учетной записи (ATP) группы правил WAF Fraud Control и Предотвращение захвата учетной записи (ATP) WAF Fraud Control в Руководстве разработчика WAF .

LoginPath -> (string)

Путь к конечной точке входа в ваше приложение. Например, для URL-адреса https://example.com/web/login вы должны предоставить путь /web/login . Пути входа, начинающиеся с предоставленного вами пути, считаются совпадением. Например /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только запросы HTTP POST к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии для проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа, либо JSON, либо форма с кодировкой.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя имеет вид /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя имеет вид username1

Identifier -> (string)

Имя поля имени пользователя.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя имеет вид /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя имеет вид username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля имеет вид /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля имеет вид password1 .

Identifier -> (string)

Имя поля пароля.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля имеет вид /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля имеет вид password1 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы на вход, используемые группой правил ATP для отслеживания частоты неудачных входов.

Примечание

Проверка ответов доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиента, ведя подсчет успешных и неудачных попыток для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы из сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно точно совпадать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна точно совпадать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, строка может быть в любом месте тела и должна точно совпадать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно сопоставить в JSON. Идентификатор должен точно совпадать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet . Используйте это, чтобы предоставить информацию о запросе на создание учетной записи группе правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это также, чтобы предоставить информацию о том, как ваш дистрибутив реагирует на запросы на создание учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) rule group и WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) в Руководстве разработчика WAF .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount , вы предоставите путь /web/newaccount . Пути страниц создания учетной записи, которые начинаются с указанного вами пути, считаются соответствием. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount , /web/newaccount/ , /web/newaccountPage и /web/newaccount/thisPage , но не соответствует пути /home/web/newaccount или /website/newaccount .

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая представляет форму регистрации новым пользователям.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL https://example.com/web/registration , вы предоставите путь /web/registration . Пути страниц регистрации, которые начинаются с указанного вами пути, считаются соответствием. Например, /web/registration соответствует путям регистрации /web/registration , /web/registration/ , /web/registrationPage и /web/registration/thisPage , но не соответствует пути /home/web/registration или /website/registration .

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи, либо JSON, либо закодированный в форме.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

EmailField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего электронную почту вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты — email1 .

Identifier -> (string)

Имя поля электронной почты.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты — email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве в том порядке, в котором они упорядочены в полезной нагрузке запроса.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP.

Identifier -> (string)

Имя отдельного поля основного номера телефона.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве в том порядке, в котором они упорядочены в полезной нагрузке запроса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP.

Identifier -> (string)

Имя отдельного поля основного адреса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответа доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентом, ведя подсчет успешных и неудачных попыток с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, для которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно точно соответствовать, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] and "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] and "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] and "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, строка может быть в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно соответствовать, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] and "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Allow the use of regular expressions in the registration page path and the account creation path.

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке названий правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(структура)

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

Примечание

Будьте внимательны при проверке названий правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке названий правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блок. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL, настройка BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса с использованием оставшихся правил в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

RuleGroupReferenceStatement -> (structure)

Оператор, используемый Firewall Manager для запуска правил, определенных в группе правил. Этим управляет Firewall Manager для политики Firewall Manager WAF.

ARN -> (string)

Amazon Resource Name (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

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

(structure)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в ваших настраиваемых ответах, см. в разделе Поддерживаемые коды состояния для настраиваемого ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить настраиваемый ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блок. Для этого сначала определите ключ и значение тела ответа в параметре CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или действии по умолчанию веб-ACL в параметре BlockAction вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых параметров запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых параметров запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых параметров запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых параметров запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых параметров запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

OverrideAction -> (structure)

Действие, которое следует использовать вместо действия, полученного в результате оценки группы правил. Установите переопределяющее действие в значение none, чтобы оставить результат группы правил неизменным. Установите его в значение count, чтобы переопределить результат только для подсчета.

Вы можете использовать это только для операторов правил, которые ссылаются на группу правил, например RuleGroupReferenceStatement и ManagedRuleGroupStatement .

Примечание

Обычно этот параметр имеет значение none. Это не влияет на то, как оцениваются правила в группе правил. Если вы хотите, чтобы правила в группе правил только подсчитывали совпадения, не используйте это, а вместо этого используйте параметр переопределения действия правила с действием Count в настройках оператора ссылки на группу правил.

Count -> (структура)

Переопределить результат оценки группы правил только для подсчета.

Примечание

Обычно этот параметр имеет значение none. Это не влияет на то, как оцениваются правила в группе правил. Если вы хотите, чтобы правила в группе правил только подсчитывали совпадения, не используйте это, а вместо этого используйте параметр переопределения действия правила с действием Count в настройках оператора ссылки на группу правил.

CustomRequestHandling -> (структура)

Определяет пользовательскую обработку веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (список)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Сведения об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

None -> (структура)

Не переопределять результат оценки группы правил. Это наиболее распространенный параметр.

VisibilityConfig -> (структура)

Определяет и включает метрики Amazon CloudWatch и сбор образцов веб-запросов.

SampledRequestsEnabled -> (boolean)

Указывает, должен ли WAF хранить выборку веб-запросов, соответствующих правилам. Вы можете просматривать выборочные запросы через консоль WAF.

Если вы настроили защиту данных для веб-ACL, защита применяется к данным выборочных веб-запросов веб-ACL.

Примечание

Выборка запросов не предоставляет параметр редуцирования полей, и любое редуцирование полей, указанное в конфигурации ведения журнала, не влияет на выборку. Вы можете исключить поля из выборки запросов, отключив выборку в конфигурации видимости веб-ACL или настроив защиту данных для веб-ACL.

CloudWatchMetricsEnabled -> (boolean)

Указывает, отправляет ли связанный ресурс метрики в Amazon CloudWatch. Список доступных метрик см. в разделе Метрики WAF в Руководстве разработчика WAF .

Для веб-ACL метрики предназначены для веб-запросов, к которым применено действие по умолчанию веб-ACL. WAF применяет действие по умолчанию к веб-запросам, которые проходят проверку всех правил в веб-ACL, не будучи разрешенными или заблокированными. Дополнительные сведения см. в разделе Действие по умолчанию веб-ACL в Руководстве разработчика WAF .

MetricName -> (string)

Имя измерения метрики Amazon CloudWatch. Имя может содержать только символы: A-Z, a-z, 0-9, - (дефис) и _ (подчеркивание). Имя может содержать от одного до 128 символов. Оно не может содержать пробелы или имена метрик, зарезервированные для WAF, например All и Default_Action .

PostProcessFirewallManagerRuleGroups -> (list)

Последний набор правил, которые WAF должен обработать в веб-ACL. Это определяется в политике Firewall Manager WAF и содержит только ссылки на группы правил. Вы не можете изменить их. Любые правила и группы правил, которые вы определяете для веб-ACL, имеют приоритет над этими.

В политике Firewall Manager WAF администратор Firewall Manager может определить набор групп правил, которые будут выполняться первыми в веб-ACL, и набор групп правил, которые будут выполняться последними. В каждом наборе администратор устанавливает приоритет для групп правил, чтобы определить их относительный порядок обработки.

(структура)

Группа правил, определенная для политики Firewall Manager WAF.

Name -> (string)

Имя группы правил. Нельзя изменить имя группы правил после ее создания.

Priority -> (integer)

Если вы определяете более одной группы правил в первых или последних группах правил Firewall Manager, WAF оценивает каждый запрос по отношению к группам правил по порядку, начиная с наименьшего значения приоритета. Приоритеты не должны быть последовательными, но они должны отличаться друг от друга.

FirewallManagerStatement -> (structure)

Руководство по обработке для правила Firewall Manager. Это похоже на обычный Statement , но может содержать только ссылку на группу правил.

ManagedRuleGroupStatement -> (structure)

Оператор, используемый Firewall Manager для запуска правил, определенных в управляемой группе правил. Этим управляет Firewall Manager для политики Firewall Manager WAF.

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика, когда поставщик обновляет настройки управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любой допустимый параметр действия, включая Count .

(структура)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любой допустимый параметр действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

ScopeDownStatement -> (structure)

Необязательный вложенный оператор, который сужает область веб-запросов, оцениваемых управляемой группой правил. Запросы оцениваются группой правил только в том случае, если они соответствуют оператору понижения области. Вы можете использовать любой вкладываемый Statement в операторе понижения области, и вы можете вкладывать операторы на любом уровне, так же, как и для оператора правила.

ByteMatchStatement -> (structure)

Оператор правила, определяющий поиск соответствия строк для WAF, который будет применяться к веб-запросам. Оператор соответствия байтов предоставляет байты для поиска, местоположение в запросах, которые вы хотите, чтобы WAF искал, и другие параметры. Байты для поиска обычно представляют собой строку, соответствующую символам ASCII. В консоли WAF и руководстве для разработчиков это называется оператором соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF выполняет поиск только в той части веб-запросов, которую вы указываете для проверки в FieldToMatch . Максимальная длина значения — 200 байтов.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и балансировщиками нагрузки приложений. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с оператором соответствия строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY . Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Поля журнала в Руководстве разработчика WAF .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, содержащую упорядоченный список имен заголовков, из заголовков в веб-запросе, а затем выполняет сопоставление с этой строкой.

Если SearchString включает буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете API WAF

Укажите версию значения, закодированную в формате base64. Максимальная длина значения перед кодированием в формате base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER , а значение Data равно User-Agent . Если вы хотите выполнить поиск в заголовке User-Agent значения BadBot , вы кодируете BadBot с помощью кодирования base64 MIME и включаете полученное значение QmFkQm90 в значение SearchString .

Если вы используете CLI или один из пакетов SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение в формате base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковая имеется.

Body -> (structure)

Проверьте тело запроса как простой текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать слишком большие тела запросов, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать слишком большие тела запросов, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF выполняет синтаксический анализ и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе Body JSON в WAF Developer Guide .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка большого размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать только один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах, или в значениях, или в обоих. Чтобы требовать совпадение в ключах и в значениях, используйте логическое AND выражение для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie большого размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать только один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах, или в значениях, или в обоих. Чтобы требовать совпадение в ключах и в значениях, используйте логическое AND выражение для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они появляются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента соответствия поля в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия, и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверить фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с параметра с самым низким приоритетом, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого типа преобразования см. в разделе Преобразования текста в Руководстве разработчика WAF .

PositionalConstraint -> (string)

Область в части веб-запроса, в которой вы хотите, чтобы WAF выполнял поиск SearchString . Допустимые значения включают следующие:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString , но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString , а SearchString должен содержать только буквенно-цифровые символы или символ подчеркивания (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что оба следующих условия верны:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или символа подчеркивания (_). Примеры включают значение заголовка и ;BadBot .
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или символа подчеркивания (_), например, BadBot; и -BadBot; .
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString .

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного кода SQL. Злоумышленники вставляют вредоносный код SQL в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки обработки больших размеров MATCH или NO_MATCH с настройками действий правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недопустимого JSON. Когда анализ завершен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки обработки больших размеров MATCH или NO_MATCH с настройками действий правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для определения подмножества заголовков, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверит и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Для этого требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое – значения.

OversizeHandling -> (строка)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie превышающего размер в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для определения подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверять все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для сопоставления с критериями проверки правил. Если указать ALL, WAF проверит и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Для этого требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое – значения.

OversizeHandling -> (строка)

Что должен делать WAF, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента сопоставления поля в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что должен делать WAF, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычным образом проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверить фрагменты URI запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI превышающего размер в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (строка)

Что должен делать WAF, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на атаки методом SQL-инъекции.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию об определении и смягчении ложных срабатываний см. в разделе Testing and tuning в WAF Developer Guide .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другую защиту от атак методом SQL-инъекции или имеют низкую толерантность к ложным срабатываниям.

Default: LOW

XssMatchStatement -> (structure)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). При атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских сценариев в другие законные веб-браузеры.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может быть длиной до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит зафиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит зафиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими настройками правил и действий веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка метода HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит зафиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Соответствует всем элементам. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Соответствие только указанным путям включения. См. также MatchScope в JsonBody .

Укажите пути включения с использованием синтаксиса указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON, для которых следует сопоставить с использованием MatchPattern . Если вы укажете ALL , WAF сопоставляет ключи и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит зафиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с вашими настройками правил и действий веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, значениях или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабарита следующие:

  • CONTINUE — проверка доступных заголовков в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie, которые необходимо проверить с помощью критериев проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, значениях или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки негабарита следующие:

  • CONTINUE — проверка доступных файлов cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонентов при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки негабарита следующие:

  • CONTINUE — проверка доступных заголовков в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагментов URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING — проверка тела как обычного текста. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет поведение при отказе. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с самой низкой приоритетной настройки, а затем использует содержимое преобразованного компонента.

(структура)

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection.

Priority -> (integer)

Sets the relative processing order for multiple transformations. WAF processes all transformations, from lowest priority to highest, before inspecting the transformed content. The priorities don’t need to be consecutive, but they must all be different.

Type -> (string)

Для подробного описания каждого из типов преобразований см. Text transformations в WAF Developer Guide .

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше чем (>) или меньше чем (<). Например, вы можете использовать оператор ограничения размера для поиска строк запросов, которые длиннее 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле до лимита для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера, чтобы блокировать запросы, размер тела которых больше. Для получения дополнительной информации об ограничениях проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI для значения Часть запроса для фильтрации, косая черта (/) в URI считается одним символом. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

В качестве альтернативы вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может быть длиной до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как простой текст. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела как обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки чрезмерного размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (list)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию JavaScript Object Notation (JSON) Pointer рабочей группы Internet Engineering Task Force (IETF).

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствие в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Возможные варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда синтаксический анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела как обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки чрезмерного размера с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Вы должны настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку любого негабаритного содержимого заголовка в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверьте все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, у которых ключ соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует соответствия ключам и соответствия значениям. Для этого требуется соответствие ключам, значениям или обоим. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса многочисленнее или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки негабаритных данных следующие:

  • CONTINUE — проверка доступных заголовков в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Вы должны настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку любого негабаритного содержимого файла cookie в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверьте все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, у которых ключ соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует соответствия ключам и соответствия значениям. Для этого требуется соответствие ключам, значениям или обоим. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Варианты обработки негабаритных данных следующие:

  • CONTINUE — проверка доступных файлов cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они появляются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента соответствия поля в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса многочисленнее или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки негабаритных данных следующие:

  • CONTINUE — проверка доступных заголовков в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, где PositionalConstraint имеет значение EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации вашего оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, где PositionalConstraint имеет значение EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации вашего оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры области действия и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку любого негабаритного содержимого фрагмента URI в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверка тела как обычного текста. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

ComparisonOperator -> (string)

Оператор для сравнения части запроса с настройкой размера.

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам, чтобы преобразовать компонент запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой приоритетной настройки, а затем использует содержимое преобразованного компонента.

(structure)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations in the WAF Developer Guide .

GeoMatchStatement -> (structure)

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

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор самостоятельно и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes .
  • В противном случае настройте правило гео-соответствия с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам для запуска после правила гео-соответствия и настройте их для соответствия географическим меткам и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухбуквенные коды страны и региона из международного стандарта ISO 3166 Международной организации по стандартизации (ISO). WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы укажете его, адрес в гео-совпадении ForwardedIPConfig .

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете переадресованный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Для получения дополнительной информации см. Geographic match rule statement in the WAF Developer Guide .

CountryCodes -> (list)

Массив двухбуквенных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ] , из кодов стран ISO alpha-2 международного стандарта ISO 3166.

Когда вы используете оператор гео-соответствия только для меток региона и страны, которые он добавляет к запросам, вам все равно придется предоставить код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно все равно будет генерировать ведение журнала и метрики подсчета для любых совпадений. Вы можете уменьшить ведение журнала и метрики, которые производит правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Настройка для проверки IP-адресов в указанном вами HTTP-заголовке вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правил, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать его, создайте группу правил с вашими правилами, затем укажите ARN группы правил в этом операторе.

Вы не можете вкладывать RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в указанной группе правил, для которых действия установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет настройку переопределения.

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

(structure)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не возвращает ошибку и не применяет настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF блокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ на веб-запрос.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блок. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или настройке BlockAction действия веб-ACL по умолчанию, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Информацию о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Информацию об ограничениях по количеству и размеру пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Инструкция правила, используемая для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этой инструкции. Чтобы создать набор IP, см. CreateIPSet.

Каждое утверждение правила набора IP ссылается на набор IP. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) IPSet, на который ссылается это утверждение.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, а не использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, используемое для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите его в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные режимы:

  • MATCH - Рассматривать веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий инструкции правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси-серверы, через которые прошел запрос.

Параметры для этой настройки следующие:

  • FIRST - Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска в компонентах веб-запроса соответствий регулярным выражениям. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки большого размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Для этого требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих случаях. Чтобы требовать соответствия в ключах и значениях, используйте логическое заявление AND , чтобы объединить два правила соответствия, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки большого размера следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать только один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки больших размеров следующие:

  • CONTINUE — Проверяйте доступные заголовки обычным способом, в соответствии с критериями проверки правил.
  • MATCH — Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считайте, что веб-запрос не соответствует заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать только один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie.

Варианты обработки больших размеров следующие:

  • CONTINUE — Проверять доступные файлы cookie обычным способом, в соответствии с критериями проверки правил.
  • MATCH — Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считайте, что веб-запрос не соответствует заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления поля в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки больших размеров следующие:

  • CONTINUE — Проверяйте доступные заголовки обычным способом, в соответствии с критериями проверки правил.
  • MATCH — Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считайте, что веб-запрос не соответствует заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое нужно присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные режимы:

  • MATCH — Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считайте, что веб-запрос не соответствует заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое нужно присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные режимы:

  • MATCH — Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считайте, что веб-запрос не соответствует заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считайте, что веб-запрос не соответствует заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться даже для недопустимого JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правил для преобразования FieldToMatch компонента запроса перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Приоритет -> (integer)

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

Тип -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает скорость запросов, когда они поступают слишком быстро. Правило классифицирует запросы в соответствии с вашими критериями агрегации, собирает их в экземпляры агрегации, подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в правиле, которое используется в настоящее время, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия по ограничению скорости правила на срок до минуты.

Вы можете указать отдельные ключи агрегации, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегации, такие как IP-адрес и метод HTTP, или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для ключей агрегации, которые вы указываете, является отдельным экземпляром агрегации, причем значение каждого ключа вносит вклад в определение экземпляра агрегации.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило будет создавать разные экземпляры агрегации в соответствии с вашими критериями агрегации, например:

  • Если критерием агрегации является только IP-адрес, то каждый отдельный адрес является экземпляром агрегации, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегации является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: количество 2
    • Метод HTTP GET: количество 2
  • Если критерием агрегации является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в объединенный экземпляр агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любого n-кортежа ключей агрегации каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегации, который WAF подсчитывает и ограничивает по скорости индивидуально.

При желании вы можете вложить другое утверждение внутри утверждения на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только запросов, соответствующих вложенному утверждению. Вы можете использовать это вложенное утверждение сужения области в сочетании со спецификациями ключа агрегации, или вы можете просто подсчитывать и ограничивать скорость всех запросов, соответствующих утверждению сужения области, без дополнительной агрегации. Когда вы решите просто управлять всеми запросами, соответствующими утверждению сужения области, экземпляр агрегации является единственным для правила.

Вы не можете вложить RateBasedStatement внутри другого утверждения, например внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Для получения дополнительной информации об опциях см. Ограничение скорости веб-запросов с помощью правил на основе скорости в Руководстве разработчика WAF .

Если вы агрегируете только по отдельному IP-адресу или переадресованному IP-адресу, вы можете получить список IP-адресов, которые WAF в настоящее время ограничивает по скорости для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегации.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставите одни и те же параметры правила на основе скорости в двух веб-ACL, каждое из двух утверждений правила представляет собой отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление WAF.

Limit -> (long)

Предел запросов во время указанного окна оценки для одного экземпляра агрегации для правила на основе скорости. Если утверждение на основе скорости включает в себя ScopeDownStatement , этот предел применяется только к запросам, соответствующим этому утверждению.

Примеры:

  • Если вы агрегируете только по IP-адресу, это ограничение запросов с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это ограничение запросов для любой отдельной пары метод-город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в свои подсчеты запросов, оглядываясь назад с текущего момента времени. Например, для настройки 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые настройки: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а определяет, насколько далеко назад он смотрит при каждой проверке. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 минут)

AggregateKeyType -> (string)

Настройка, которая указывает, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, исключаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте скорость запросов, соответствующих утверждению сужения области действия правила на основе скорости. С помощью этой опции подсчитанные запросы не агрегируются дальше. Утверждение сужения области является единственной спецификацией, используемой. Когда количество всех запросов, удовлетворяющих утверждению сужения области, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим утверждению сужения области. С этой опцией необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегации. С помощью этой опции необходимо указать ключи агрегации в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по переадресованному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегации в IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. С помощью этой опции необходимо указать заголовок, который будет использоваться в свойстве ForwardedIPConfig . Чтобы агрегировать по комбинации переадресованного IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать по комбинации IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .

ScopeDownStatement -> (structure)

Необязательное вложенное утверждение, которое сужает область веб-запросов, оцениваемых и управляемых утверждением на основе скорости. Когда вы используете утверждение сужения области, правило на основе скорости отслеживает и ограничивает скорость только запросов, соответствующих утверждению сужения области. Вы можете использовать любое вкладываемое утверждение в утверждении сужения области, и вы можете вкладывать утверждения на любом уровне, так же, как и для утверждения правила.

ByteMatchStatement -> (structure)

Утверждение правила, которое определяет поиск соответствия строк, который WAF должен применить к веб-запросам. Утверждение соответствия байтов предоставляет байты для поиска, местоположение в запросах, которое вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска обычно представляют собой строку, которая соответствует символам ASCII. В консоли WAF и руководстве для разработчиков это называется утверждением соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF ищет только в той части веб-запросов, которую вы указываете для проверки в FieldToMatch . Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает на тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с соответствием строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY . Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может рассчитать отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Поля журналов в Руководстве разработчика WAF .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, которая содержит упорядоченный список имен заголовков из заголовков в веб-запросе, а затем сопоставляет с этой строкой.

Если SearchString содержит алфавитные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете API WAF

Укажите версию значения, закодированную в base64. Максимальная длина значения перед кодированием base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER , а значение Data равно User-Agent . Если вы хотите найти в заголовке User-Agent значение BadBot , вы кодируете BadBot в base64 с использованием кодирования MIME base64 и включаете полученное значение QmFkQm90 в значение SearchString .

Если вы используете CLI или один из пакетов SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение в base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в виде тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в виде тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правила.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе сразу.

IncludedPaths -> (list)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо эту настройку, либо настройку All, но не обе сразу.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON, с которыми нужно сопоставить, используя MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для недопустимого JSON. Когда анализ успешен, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий заявлению правила.

Вы можете комбинировать настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Вы должны настроить фильтры сопоставления области действия и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение - в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Вы должны настроить фильтры сопоставления области действия и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie превышающего размер в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение - в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF следует делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления поля при проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы она соответствовала любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который следует присвоить веб-запросу, если у запроса нет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журналов см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы она соответствовала любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который следует присвоить веб-запросу, если у запроса нет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверяйте фрагменты URI запроса. Вы должны настроить область действия и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки службой-хостом. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы-хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если он не может полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполняет синтаксический анализ и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для неверного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в WAF Developer Guide .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой приоритетности, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString. Допустимые значения включают следующее:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString, но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString, а SearchString должен содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что верны оба следующих утверждения:

  • SearchString находится в начале указанной части веб-запроса или предшествует символу, отличному от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot.
  • SearchString находится в конце указанной части веб-запроса или следует за символом, отличным от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot;.
EXACTLY

Значение указанной части веб-запроса должно в точности соответствовать значению SearchString.

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы, например, изменить вашу базу данных или извлечь из нее данные.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмера следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры обработки переразмера MATCH или NO_MATCH с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON, с которыми необходимо выполнить сопоставление с помощью MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недействительного JSON. Когда анализ завершается успешно, WAF не применяет поведение резервного варианта. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмера следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры обработки переразмера MATCH или NO_MATCH с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков, которые необходимо сопоставить с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки как обычно, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить область и фильтры сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого cookie-файлов превышающего размер в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с помощью критериев проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно проверяет ключи, а другое - значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого cookie-файлов в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные файлы cookie как обычно, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки как обычно, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Вы должны настроить область и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку содержимого фрагментов URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам, для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости, для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным контентом, начиная с параметра самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Text transformations в Руководстве разработчика WAF .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на атаки путем внедрения SQL-кода.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию о выявлении и смягчении ложных срабатываний см. в разделе Testing and tuning в Руководстве разработчика WAF .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак путем внедрения SQL-кода или которые имеют низкую толерантность к ложным срабатываниям.

Default: LOW

XssMatchStatement -> (structure)

Оператор правила, который выполняет проверку на атаки межсайтового скриптинга (XSS). При атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте как средство для внедрения вредоносных клиентских скриптов в другие легитимные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это та часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это та часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, смотрите конфигурацию объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела запроса в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с вашими параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это та часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, смотрите конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одного, которое проверяет ключи, и другого, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело запроса как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела запроса.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать контент только до первой ошибки разбора, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. body JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что должен делать WAF, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела запроса в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с вашими параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка с избыточным размером в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовков запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie с избыточным размером в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих случаях. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлов cookie запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке с использованием двоеточий без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовков запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который следует назначить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы содержат эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который следует назначить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для недействительного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. Тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Преобразования текста в Руководстве разработчика WAF .

SizeConstraintStatement -> (structure)

Инструкция правила, которая сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, вы можете использовать инструкцию ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле до предела для веб-ACL и защищенного типа ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать предел проверки, вы можете использовать инструкцию ограничения размера для блокировки запросов, размер тела которых больше. Для получения дополнительной информации об ограничениях проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI для значения Части запроса для фильтрации, косая черта (/) в URI будет считаться одним символом. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела как обычно, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим инструкции правила.

Вы можете сочетать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью проанализировать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим инструкции правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недопустимого JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что должен делать WAF, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела как обычно, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим инструкции правила.

Вы можете сочетать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All , IncludedHeaders или ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL , WAF проверит как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах или значениях или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies или ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части файлов cookie, которые необходимо проверить с помощью критериев проверки правила. Если вы укажете ALL , WAF проверит как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах или значениях или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Log fields в WAF Developer Guide .

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте отпечаток пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Log fields в WAF Developer Guide .

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие варианты резервного поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Вы должны настроить область действия и фильтры сопоставления шаблонов в объекте UriFragment , чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить, как обрабатывать содержимое фрагмента URI, превышающее размер, в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие параметры:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться даже для неверного JSON. При успешном анализе WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

ComparisonOperator -> (string)

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

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с наименьшей приоритетности, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе «Преобразования текста» в Руководстве разработчика WAF .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и соответствует веб-запросам на основе кода страны. Правило соответствия геолокации помечает каждый проверяемый запрос независимо от того, находит ли он соответствие.

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор сам по себе и указать страны, которым вы хотите соответствовать, в массиве CountryCodes .
  • В противном случае настройте правило соответствия геолокации с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам, чтобы они выполнялись после правила соответствия геолокации, и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухзначные коды стран и регионов из международного стандарта ISO 3166 Международной организации по стандартизации (ISO). WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в ForwardedIPConfig геолокации.

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете переадресованный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Дополнительные сведения см. в разделе «Оператор правила соответствия геолокации» в Руководстве разработчика WAF .

CountryCodes -> (list)

Массив двухбуквенных кодов стран, которым вы хотите соответствовать, например, [ "US", "CN" ] , из кодов стран ISO alpha-2 международного стандарта ISO 3166.

Когда вы используете оператор соответствия геолокации только для меток региона и страны, которые он добавляет к запросам, вам все равно необходимо указать код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно по-прежнему будет генерировать журналы и метрики подсчета для любых совпадений. Вы можете уменьшить ведение журнала и метрики, которые производит правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, а не использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для этого значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, затем укажите ARN группы правил в этом операторе.

Вы не можете вкладывать RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в web ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылаемой группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

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

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком вашей группой правил.

(structure)

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

Примечание

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

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком вашей группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

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

ActionToUse -> (structure)

Действие переопределения, которое следует использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или настройке BlockAction действия веб-ACL по умолчанию вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Инструкция правила, используемая для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом утверждении. Чтобы создать набор IP, см. CreateIPSet.

Каждое правило IPset ссылается на IP set. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) IPSet, на который ссылается это утверждение.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, который сообщается источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите его в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий инструкции правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий инструкции правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси-серверы, через которые прошел запрос.

Параметры для этой настройки следующие:

  • FIRST — Проверьте первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST — Проверьте последний IP-адрес в списке IP-адресов в заголовке.
  • ANY — Проверьте все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий с регулярными выражениями в компонентах веб-запроса. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet .

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Amazon Resource Name (ARN) RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствовать только указанным путям включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF выполняет сопоставление по ключам и значениям.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадение в ключах и в значениях, используйте логическое заявление AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое проверяет значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если ему не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF parsing doesn’t fully validate the input JSON string, so parsing can succeed even for invalid JSON. When parsing succeeds, WAF doesn’t apply the fallback behavior. For more information, see JSON body in the WAF Developer Guide .

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Он требует нахождения соответствия в ключах, в значениях или в обоих случаях. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie превышающего размер в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Он требует нахождения соответствия в ключах, в значениях или в обоих случаях. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления поля в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие режимы работы при резервном копировании:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие режимы работы при резервном копировании:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает запросы, когда они поступают слишком быстро. Правило классифицирует запросы в соответствии с вашими критериями агрегирования, собирает их в экземпляры агрегирования, подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в используемом в данный момент правиле, изменение сбросит счетчики ограничения скорости правила. Это может приостановить действия правила по ограничению скорости на срок до минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегирования, например IP-адрес и метод HTTP или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для указанных вами ключей агрегирования представляет собой отдельный экземпляр агрегирования, при этом значение каждого ключа вносит вклад в определение экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило создаст разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегирования является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: количество 2
    • Метод HTTP GET: количество 2
  • Если критерием агрегирования является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в комбинированный экземпляр агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любого n-кортежа ключей агрегирования каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает скорость каждого из них.

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

Вы не можете вложить RateBasedStatement внутри другого выражения, например внутри NotStatement или OrStatement. Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Для получения дополнительной информации об опциях см. раздел Ограничение скорости веб-запросов с помощью правил на основе скорости в Руководстве разработчика WAF .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, для которых WAF в данный момент ограничивает скорость для правила, с помощью вызова API GetRateBasedStatementManagedKeys. Эта опция недоступна для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра используемого вами правила на основе скорости. Например, если вы предоставите одни и те же настройки правила на основе скорости в двух веб-ACL, каждое из двух выражений правила представляет отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление WAF.

Limit -> (long)

Лимит на запросы во время указанного окна оценки для одного экземпляра агрегирования для правила на основе скорости. Если выражение на основе скорости включает ScopeDownStatement, этот лимит применяется только к запросам, соответствующим этому выражению.

Примеры:

  • Если вы агрегируете только по IP-адресу, это лимит на запросы с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это лимит на запросы для любой одной пары метод, город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включить в свои счетчики запросов, оглядываясь назад с текущего момента времени. Например, при настройке 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые значения: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а то, как далеко назад он смотрит каждый раз, когда проверяет. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 минут)

AggregateKeyType -> (string)

Настройка, которая указывает, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо из компонентов, указанных в ключах агрегирования, исключаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте скорость запросов, соответствующих выражению сужения области действия правила на основе скорости. С помощью этой опции подсчитанные запросы не агрегируются дальше. Выражение сужения области действия является единственной используемой спецификацией. Когда количество всех запросов, удовлетворяющих выражению сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим выражению сужения области действия. С помощью этой опции необходимо настроить свойство ScopeDownStatement.
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. С помощью этой опции необходимо указать ключи агрегирования в свойстве CustomKeys. Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегирования в значение IP или FORWARDED_IP.
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. С помощью этой опции необходимо указать заголовок для использования в свойстве ForwardedIPConfig. Чтобы агрегировать по комбинации перенаправленного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS.
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать по комбинации IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS.

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (string)

Имя заголовка HTTP для использования для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не содержит допустимого IP-адреса в указанном положении.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при резервировании:

  • MATCH - Обрабатывать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий выражению правила.

CustomKeys -> (list)

Указывает совокупные ключи для использования в правиле на основе скорости.

(структура)

Указывает один пользовательский совокупный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правил на основе скорости.

Header -> (структура)

Используйте значение заголовка в запросе в качестве совокупного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегирования. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя используемого заголовка.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

Cookie -> (структура)

Используйте значение cookie в запросе в качестве совокупного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегирования. Если вы используете одно cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя используемого cookie.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

QueryArgument -> (структура)

Используйте указанный аргумент запроса в качестве совокупного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегирования. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя используемого аргумента запроса.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

QueryString -> (структура)

Используйте строку запроса запроса в качестве совокупного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегирования. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

HTTPMethod -> (структура)

Используйте HTTP-метод запроса в качестве совокупного ключа. Каждый отдельный HTTP-метод вносит вклад в экземпляр агрегирования. Если вы используете только HTTP-метод в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегирования.

ForwardedIP -> (структура)

Используйте первый IP-адрес в заголовке HTTP в качестве совокупного ключа. Каждый отдельный перенаправленный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP или перенаправленный IP в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете агрегировать только по перенаправленному IP-адресу, указав FORWARDED_IP в AggregateKeyType вашего правила на основе скорости.

С помощью этой опции необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (структура)

Используйте исходный IP-адрес запроса в качестве совокупного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP или перенаправленный IP в настройках пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в AggregateKeyType вашего правила на основе скорости.

LabelNamespace -> (структура)

Используйте указанное пространство имен метки в качестве совокупного ключа. Каждое отдельное полностью квалифицированное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегирования. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегирования.

Это использует только метки, которые были добавлены к запросу правилами, которые оцениваются до этого правила на основе скорости в веб-ACL.

Для получения информации о пространствах имен и именах меток см. Label syntax and naming requirements в WAF Developer Guide .

Namespace -> (string)

Пространство имен для использования для агрегирования.

UriPath -> (структура)

Используйте путь URI запроса в качестве совокупного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегирования. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования FieldToMatch компонента запроса перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого типа преобразования см. в разделе Text transformations в WAF Developer Guide .

JA3Fingerprint -> (структура)

Используйте отпечаток JA3 запроса в качестве совокупного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если информации TSL Client Hello недостаточно для вычисления отпечатка JA4.

Вы можете указать следующие варианты поведения при резервном копировании:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

AndStatement -> (structure)

Логическое утверждение правила, используемое для объединения других утверждений правил с логикой AND. Вы предоставляете более одного Statement в AndStatement .

Statements -> (list)

Утверждения для объединения с логикой AND. Вы можете использовать любые утверждения, которые могут быть вложены.

( … recursive … )

OrStatement -> (structure)

Логическое утверждение правила, используемое для объединения других утверждений правил с логикой OR. Вы предоставляете более одного Statement в OrStatement .

Statements -> (list)

Утверждения для объединения с логикой OR. Вы можете использовать любые утверждения, которые могут быть вложены.

( … recursive … )

NotStatement -> (structure)

Логическое утверждение правила, используемое для отрицания результатов другого утверждения правила. Вы предоставляете одно Statement в NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Утверждение правила, используемое для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом утверждении. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вложить ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на утверждение верхнего уровня в правиле, которое вы определяете в web ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control account takeover prevention (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control account creation fraud prevention (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксирована, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика при обновлении настроек управляемой группы правил поставщиком.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любой допустимый параметр действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любой допустимый параметр действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также места в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа вашего приложения и места в полезной нагрузке запроса входа таких данных, как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать группе правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также места в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа вашего приложения и места в полезной нагрузке запроса входа таких данных, как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать группе правил Bot Control.

Например, спецификации см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации JavaScript Object Notation (JSON) Pointer Internet Engineering Task Force (IETF) . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации JavaScript Object Notation (JSON) Pointer Internet Engineering Task Force (IETF) . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 , спецификация поля пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Информацию об использовании управляемой группы правил Bot Control см. в группе правил WAF Bot Control и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки для использования для группы правил Bot Control. Общий уровень является наименее дорогим. Целевой уровень включает в себя все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в группе правил WAF Bot Control в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применимо только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в списке правил Bot Control в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это, чтобы предоставить информацию о запросе на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив отвечает на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в Руководстве разработчика WAF.

LoginPath -> (string)

Путь конечной точки входа в систему для вашего приложения. Например, для URL https://example.com/web/login , вы предоставите путь /web/login . Пути входа в систему, которые начинаются с предоставленного вами пути, считаются совпадением. Например, /web/login соответствует путям входа в систему /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа в систему /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа в систему.

RequestInspection -> (structure)

Критерии для проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа в систему: JSON или форма с кодировкой.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя выглядит как /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя выглядит как username1

Identifier -> (string)

Имя поля имени пользователя.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя выглядит как /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя выглядит как username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля выглядит как /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

Identifier -> (string)

Имя поля пароля.

Как это указать, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля выглядит как /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа в систему клиентом, подсчитывая количество успешных и неудачных попыток для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа в систему за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешной, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачной, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно точно соответствовать, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешной, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачной, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешной, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачной, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения, с которым нужно сопоставить в JSON. Идентификатор должен точно соответствовать, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа в систему.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet . Используйте это для предоставления информации о запросе создания учетной записи группе правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы создания учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) rule group и WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) в Руководстве разработчика WAF .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount , вы должны предоставить путь /web/newaccount . Пути к страницам создания учетной записи, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount , /web/newaccount/ , /web/newaccountPage , и /web/newaccount/thisPage , но не соответствует пути /home/web/newaccount или /website/newaccount .

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая представляет форму регистрации новым пользователям.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL https://example.com/web/registration , вы должны предоставить путь /web/registration . Пути к страницам регистрации, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration , /web/registration/ , /web/registrationPage , и /web/registration/thisPage , но не соответствует пути /home/web/registration или /website/registration .

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или форма с кодировкой.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } }, спецификация поля имени пользователя — /form/username.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1, спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } }, спецификация поля имени пользователя — /form/username.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1, спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } }, спецификация поля пароля — /form/password.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1, спецификация поля пароля — password1.

Identifier -> (string)

Имя поля пароля.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } }, спецификация поля пароля — /form/password.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1, спецификация поля пароля — password1.

EmailField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего адрес электронной почты вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } }, спецификация поля электронной почты — /form/email.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1, спецификация поля электронной почты — email1.

Identifier -> (string)

Имя поля электронной почты.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } }, спецификация поля электронной почты — /form/email.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1, спецификация поля электронной почты — email1.

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } }, идентификаторы поля номера телефона — /form/primaryphoneline1, /form/primaryphoneline2 и /form/primaryphoneline3.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1, primaryphoneline2 и primaryphoneline3, идентификаторы поля номера телефона — primaryphoneline1, primaryphoneline2 и primaryphoneline3.

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP.

Identifier -> (string)

Имя одного поля основного номера телефона.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } }, идентификаторы поля номера телефона — /form/primaryphoneline1, /form/primaryphoneline2 и /form/primaryphoneline3.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1, primaryphoneline2 и primaryphoneline3, идентификаторы поля номера телефона — primaryphoneline1, primaryphoneline2 и primaryphoneline3.

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } }, идентификаторы поля адреса — /form/primaryaddressline1, /form/primaryaddressline2 и /form/primaryaddressline3.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1, primaryaddressline2 и primaryaddressline3, идентификаторы полей адреса — primaryaddressline1, primaryaddressline2 и primaryaddressline3.

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP.

Identifier -> (string)

Имя одного поля основного адреса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } }, идентификаторы поля адреса — /form/primaryaddressline1, /form/primaryaddressline2 и /form/primaryaddressline3.
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1, primaryaddressline2 и primaryaddressline3, идентификаторы полей адреса — primaryaddressline1, primaryaddressline2 и primaryaddressline3.

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетных записей, используемые группой правил ACFP для отслеживания показателей успешности создания учетных записей.

Примечание

Проверка ответа доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиента, подсчитывая успешные и неудачные попытки с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, которые совершили слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным совпадением, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] and "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] and "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] and "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно сопоставить в JSON. Идентификатор должен быть точным совпадением, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] and "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

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

Примечание

Позаботьтесь о проверке имен правил в ваших перезаписях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку перезаписи.

Вы можете использовать перезаписи для тестирования, например, вы можете перезаписать все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда перезаписать некоторые или все действия, чтобы изменить способ управления веб-трафиком в группе правил.

(структура)

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

Примечание

Позаботьтесь о проверке имен правил в ваших перезаписях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку перезаписи.

Вы можете использовать перезаписи для тестирования, например, вы можете перезаписать все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда перезаписать некоторые или все действия, чтобы изменить способ управления веб-трафиком в группе правил.

Name -> (string)

Имя правила для перезаписи.

Примечание

Позаботьтесь о проверке имен правил в ваших перезаписях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку перезаписи.

ActionToUse -> (structure)

Действие перезаписи для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF блокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP, который нужно вернуть клиенту.

Список кодов состояния, которые можно использовать в ваших настраиваемых ответах, см. в разделе Поддерживаемые коды состояния для настраиваемого ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое настроено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL настройке BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, за исключением content-type. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях количества и размера для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях количества и размера для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях количества и размера для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях количества и размера для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка вызова определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях количества и размера для пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, добавленными к веб-запросу правилами, которые уже были запущены в веб-ACL.

Оператор сопоставления меток предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю полностью определенную имя метки, которое было добавлено к веб-запросу. Полностью определенные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, добавившего метку. Если вы не укажете полностью определенное имя в своей строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки, или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора соответствия:

  • Если Scope указывает LABEL, то это указание должно включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс до предоставления полностью определенного имени метки.
  • Если Scope указывает NAMESPACE, то это указание может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда произошла метка.

Метки чувствительны к регистру, и компоненты метки должны разделяться двоеточием, например NS1:NS2:name.

RegexMatchStatement -> (structure)

Оператор правила, используемый для поиска соответствия компонентам веб-запроса одному регулярному выражению.

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка метода HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Соответствует всем элементам. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Соответствие только указанным путям включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области видимости и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, соответствующие критериям проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области видимости и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах, и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE — проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE — проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement со значением PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора соответствия строки, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строки ByteMatchStatement со значением PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора соответствия строки, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI недопустимого размера в объекте UriFragment. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью разобрать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, которую он обнаружит.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматирования, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе частоты, для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматирования, которые злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

ForwardedIPConfig -> (structure)

Настройка для проверки IP-адресов в указанном HTTP-заголовке вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но можно указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в параметрах ключа агрегирования правила.

HeaderName -> (string)

Имя HTTP-заголовка, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, присваиваемый веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

CustomKeys -> (list)

Указывает агрегированные ключи для использования в правиле на основе скорости.

(структура)

Указывает один настраиваемый агрегированный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правила на основе скорости.

Header -> (структура)

Используйте значение заголовка в запросе в качестве агрегированного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегирования. Если вы используете один заголовок в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя используемого заголовка.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве агрегированного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегирования. Если вы используете один cookie в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя используемого cookie.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве агрегированного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегирования. Если вы используете один аргумент запроса в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя используемого аргумента запроса.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

QueryString -> (structure)

Используйте строку запроса запроса в качестве агрегированного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегирования. Если вы используете только строку запроса в качестве своего пользовательского ключа, то каждая строка полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

HTTPMethod -> (structure)

Используйте метод HTTP запроса в качестве агрегированного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегирования. Если вы используете только метод HTTP в качестве своего пользовательского ключа, то каждый метод полностью определяет экземпляр агрегирования.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве агрегированного ключа. Каждый отдельный переадресованный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или переадресованный IP-адрес в параметрах пользовательского ключа, вы также должны указать хотя бы еще один ключ для использования. Вы можете агрегировать только по переадресованному IP-адресу, указав FORWARDED_IP в AggregateKeyType вашего правила на основе скорости.

С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве агрегированного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или переадресованный IP-адрес в параметрах пользовательского ключа, вы также должны указать хотя бы еще один ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в AggregateKeyType вашего правила на основе скорости.

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве агрегированного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегирования. Если вы используете только одно пространство имен метки в качестве своего пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегирования.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

Информацию о пространствах имен и именах меток см. в разделе Label syntax and naming requirements в WAF Developer Guide .

Namespace -> (string)

Пространство имен для использования для агрегирования.

UriPath -> (structure)

Используйте путь URI запроса в качестве агрегированного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегирования. Если вы используете только путь URI в качестве своего пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки наименьшего приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторую необычную форматировку, которую злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в WAF Developer Guide .

JA3Fingerprint -> (structure)

Используйте отпечаток пальца JA3 запроса в качестве агрегированного ключа. Если вы используете один отпечаток пальца JA3 в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если недостаточно информации о TSL Client Hello для вычисления отпечатка пальца JA3.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве пользовательского ключа, каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия для назначения веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Вы можете указать следующие fallback behaviors:

  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим заявлению правила.

AndStatement -> (structure)

Логическое заявление правила, используемое для объединения других заявлений правила с логикой AND. Вы предоставляете более одного Statement в рамках AndStatement .

Statements -> (list)

Заявления для объединения с логикой AND. Вы можете использовать любые заявления, которые могут быть вложены.

(structure)

Руководство по обработке для Rule , используемое WAF для определения того, соответствует ли веб-запрос правилу.

For example specifications, see the examples section of CreateWebACL .

ByteMatchStatement -> (structure)

Заявление правила, которое определяет поиск соответствия строк для WAF, который необходимо применить к веб-запросам. Заявление о соответствии байтов предоставляет байты для поиска, местоположение в запросах, в которых вы хотите, чтобы WAF выполнял поиск, и другие настройки. Байты для поиска, как правило, являются строкой, которая соответствует символам ASCII. В консоли WAF и в руководстве разработчика это называется заявлением о соответствии строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF ищет только в той части веб-запросов, которую вы назначаете для проверки в FieldToMatch . Максимальная длина значения - 200 байт.

Действительные значения зависят от компонента, который вы указываете для проверки в FieldToMatch :

  • Method : HTTP-метод, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg .
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY . Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. Log fields в WAF Developer Guide .
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, содержащую упорядоченный список имен заголовков из заголовков в веб-запросе, а затем сопоставляет ее с этой строкой.

Если SearchString включает буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете API WAF

Укажите версию значения, закодированную в base64. Максимальная длина значения до его кодирования в base64 - 200 байт.

Например, предположим, что значение Type равно HEADER , а значение Data равно User-Agent . Если вы хотите выполнить поиск в заголовке User-Agent для значения BadBot , вы кодируете BadBot в base64 с использованием кодирования MIME base64 и включаете полученное значение, QmFkQm90 , в значение SearchString .

Если вы используете CLI или один из Amazon Web Services SDK

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение в base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

В качестве альтернативы можно фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения об обработке чрезмерно больших тел запросов см. в конфигурации объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками правила и действия веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения об обработке чрезмерно больших тел запросов см. в конфигурации объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если указать ALL , WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое AND выражение для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками правила и действия веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения ни в ключах, ни в значениях. Требуется совпадение в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения ни в ключах, ни в значениях. Требуется совпадение в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий без добавления пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF .

Укажите строку отпечатка JA3 из журналов в спецификации выражения сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF .

Укажите строку отпечатка JA4 из журналов в спецификации выражения сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры сопоставления области и шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки службой-хостом. Вы должны настроить, как обрабатывать содержимое фрагментов URI, превышающее размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы-хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, которую он обнаружит.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ успешен, WAF не применяет поведение отката. Для получения дополнительной информации см. раздел JSON body в WAF Developer Guide .

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с параметра с самым низким приоритетом, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Преобразования текста в WAF Developer Guide .

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString. Допустимые значения включают следующее:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString, но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString, и SearchString должен содержать только буквенно-цифровые символы или символ подчеркивания (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что оба следующих условия верны:

  • SearchString находится в начале указанной части веб-запроса или предшествует ему символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot.
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot;.
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString.

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковая имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, размер которых превышает допустимый, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу после заголовков запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, размер которых превышает допустимый, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure) - Шаблон соответствия -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure) - Все -> (структура)

Проверить все заголовки.

IncludedHeaders -> (list) - IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string) - (строка)

ExcludedHeaders -> (list) - ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string) - (строка)

MatchScope -> (string) - MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string) - Обработка больших размеров -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Cookies -> (structure) - Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure) - Шаблон соответствия -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure) - Все -> (структура)

Проверять все файлы cookie.

IncludedCookies -> (list) - IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string) - (строка)

ExcludedCookies -> (list) - ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string) - (строка)

MatchScope -> (string) - MatchScope -> (строка)

Части файлов cookie для проверки с помощью критериев проверки правила. Если вы укажете ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string) - Обработка больших размеров -> (строка)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (structure) - HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string) - Обработка больших размеров -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (structure) - JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора соответствия строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string) - FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (structure) - JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора соответствия строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string) - FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

UriFragment -> (structure) - UriFragment -> (структура)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой хост-службой. Вы должны настроить, как обрабатывать содержимое фрагмента URI, превышающее размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой хост-службы.

FallbackBehavior -> (string)

Что WAF должен делать, если он не может полностью разобрать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе «Тело JSON» в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с параметра самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе «Преобразования текста» в Руководстве разработчика WAF .

SensitivityLevel -> (string)

Чувствительность, которую вы хотите, чтобы WAF использовал для проверки атак типа SQL-инъекций.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию об определении и смягчении ложных срабатываний см. в разделе «Тестирование и настройка» в Руководстве разработчика WAF .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак типа SQL-инъекций или имеют низкую толерантность к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (structure)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). В атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте для внедрения вредоносных клиентских скриптов в другие легитимные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно отфильтровать и проверить все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например /images/daily-ad.jpg.

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения об обработке слишком больших тел запросов см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерного размера с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка метода HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения об обработке слишком больших тел запросов см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствие только указанным путям включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр, чтобы включить все пути. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING — проверять тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не укажете этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе JSON body в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байт).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байт), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерного размера с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Вы должны настроить фильтры сопоставления области и шаблона в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку любого контента заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и чтобы соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Вы должны настроить фильтры сопоставления области и шаблона в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку любого контента файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и чтобы соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступных файлов cookie в соответствии с критериями проверки правила.
  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для соответствия компоненту в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступных заголовков в соответствии с критериями проверки правила.
  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие варианты поведения при отступлении:

  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел «Поля журнала» в Руководстве разработчика WAF .

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие варианты поведения при отступлении:

  • MATCH - Обрабатывайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше чем (>) или меньше чем (<). Например, вы можете использовать оператор ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле до предела для веб-ACL и защищенного типа ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера, чтобы блокировать запросы, размер тела которых больше. Для получения дополнительной информации об ограничениях проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI учитывается как один символ. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может иметь длину до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверьте тело запроса как простой текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (структура)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (структура)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставьте только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Требуется найти соответствие в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверять все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Требуется найти соответствие в ключах, в значениях или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий без добавления пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот вариант можно использовать только с сопоставлением строк ByteMatchStatement с установленным PositionalConstraint значением EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел Поля журнала в Руководстве разработчика WAF .

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, присваиваемый веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот вариант можно использовать только с сопоставлением строк ByteMatchStatement с установленным PositionalConstraint значением EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел Поля журнала в Руководстве разработчика WAF .

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, присваиваемый веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого фрагментов URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, которую он обнаруживает.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

ComparisonOperator -> (string)

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

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и сопоставляет веб-запросы на основе кода страны. Правило географического сопоставления помечает каждый проверяемый запрос независимо от того, нашло ли оно совпадение.

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор отдельно и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes.
  • В противном случае настройте правило географического сопоставления с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил сопоставления меток для запуска после правила географического сопоставления и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухбуквенные коды стран и регионов из международного стандарта ISO 3166 Международной организации по стандартизации (ISO). WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в географическом сопоставлении ForwardedIPConfig.

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code>.

Если вы используете переадресованный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code>.

Дополнительные сведения см. в разделе Geographic match rule statement в руководстве разработчика WAF.

CountryCodes -> (list)

Массив двухсимвольных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ] , из альфа-2 кодов стран ISO международного стандарта ISO 3166.

Когда вы используете оператор географического сопоставления только для меток региона и страны, которые он добавляет к запросам, вам все равно необходимо указать код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета совпадающих запросов, но оно по-прежнему будет генерировать ведение журнала и метрики подсчета для любых совпадений. Вы можете уменьшить ведение журнала и метрики, которые производит правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, который будет использоваться для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение равным X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, присваиваемое веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать его, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Нельзя вкладывать RuleGroupReferenceStatement, например, для использования внутри NotStatement или OrStatement. Нельзя использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в web ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любое допустимое значение действия, включая Count.

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любое допустимое значение действия, включая Count.

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count.

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(structure)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в настраиваемых ответах, см. в разделе Поддерживаемые коды состояния для настраиваемого ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить настраиваемый ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в block. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию web ACL настройка BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

HTTP-заголовки для использования в ответе. Вы можете указать любое имя заголовка, за исключением content-type. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых настроек запроса и ответа см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых настроек запроса и ответа см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в web ACL.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых настроек запроса и ответа см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA против веб-запроса.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не просрочен.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых настроек запроса и ответа см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge против веб-запроса.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не просрочен.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для настраиваемых настроек запроса и ответа см. раздел Квоты WAF в Руководстве разработчика WAF.

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже находятся в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение настраиваемого заголовка.

IPSetReferenceStatement -> (structure)

Утверждение правила, используемое для обнаружения веб-запросов, поступающих с конкретных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом утверждении. Чтобы создать набор IP, см. CreateIPSet.

Каждое утверждение правила набора IP ссылается на набор IP. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) набора IP, на который ссылается это утверждение.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для этого значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значением заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные — прокси-серверы, через которые прошел запрос.

Параметрами этой настройки являются следующие:

  • FIRST — Проверьте первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST — Проверьте последний IP-адрес в списке IP-адресов в заголовке.
  • ANY — Проверьте все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий в компонентах веб-запроса с помощью регулярных выражений. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, а затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Amazon Resource Name (ARN) RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверьте тело запроса как обычный текст. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с вашими настройками правил и действий веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих соответствий шаблонам в соответствии с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Для этого требуется, чтобы соответствие было найдено в ключах, значениях или в обоих. Чтобы потребовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если он не может полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, которую он обнаружит.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с вашими настройками правил и действий веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Для проверки WAF службой-хостом передаются только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы-хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правил. При указании ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Требуется найти совпадение в ключах, значениях или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовков запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба-хост пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Для проверки WAF службой-хостом пересылаются только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы-хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правил. При указании ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Требуется найти совпадение в ключах, значениях или в обоих. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF следует делать, если файлов cookie запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба-хост пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовков запроса больше или они больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба-хост пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только со строковым соответствием ByteMatchStatement, где параметр PositionalConstraint имеет значение EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо назначить веб-запросу, если у запроса нет отпечатка JA3.

Можно указать следующие варианты поведения при резервном копировании:

  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только со строковым соответствием ByteMatchStatement, где параметр PositionalConstraint имеет значение EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо назначить веб-запросу, если у запроса нет отпечатка JA4.

Можно указать следующие варианты поведения при резервном копировании:

  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос несоответствующим оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого контента фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью разобрать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. Тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

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

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает скорость запросов, когда они поступают со слишком высокой скоростью. Правило классифицирует запросы в соответствии с вашими критериями агрегации, собирает их в экземпляры агрегации и подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в используемом в данный момент правиле, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия по ограничению скорости правила на срок до минуты.

Вы можете указать отдельные ключи агрегации, такие как IP-адрес или HTTP-метод. Вы также можете указать комбинации ключей агрегации, например, IP-адрес и HTTP-метод, или HTTP-метод, аргумент запроса и cookie.

Каждый уникальный набор значений для ключей агрегации, которые вы указываете, является отдельным экземпляром агрегации, причем значение каждого ключа вносит вклад в определение экземпляра агрегации.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и HTTP-метода:

  • IP-адрес 10.1.1.1, HTTP-метод POST
  • IP-адрес 10.1.1.1, HTTP-метод GET
  • IP-адрес 127.0.0.0, HTTP-метод POST
  • IP-адрес 10.1.1.1, HTTP-метод GET

Правило создаст разные экземпляры агрегации в соответствии с вашими критериями агрегации, например:

  • Если критерием агрегации является только IP-адрес, то каждый отдельный адрес является экземпляром агрегации, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегации является HTTP-метод, то каждый отдельный HTTP-метод является экземпляром агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • HTTP-метод POST: количество 2
    • HTTP-метод GET: количество 2
  • Если критерием агрегации является IP-адрес и HTTP-метод, то каждый IP-адрес и каждый HTTP-метод будут вносить вклад в комбинированный экземпляр агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, HTTP-метод POST: количество 1
    • IP-адрес 10.1.1.1, HTTP-метод GET: количество 2
    • IP-адрес 127.0.0.0, HTTP-метод POST: количество 1

Для любой n-кортежа ключей агрегации каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегации, который WAF подсчитывает и ограничивает по скорости индивидуально.

При желании вы можете вложить другое выражение внутрь выражения на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только тех запросов, которые соответствуют вложенному выражению. Вы можете использовать это вложенное выражение для сужения области в сочетании со спецификациями ключей агрегации или просто подсчитывать и ограничивать скорость всех запросов, соответствующих выражению для сужения области, без дополнительной агрегации. Когда вы решите просто управлять всеми запросами, соответствующими выражению для сужения области, экземпляр агрегации является единственным для правила.

Вы не можете вкладывать RateBasedStatement внутри другого выражения, например внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Дополнительные сведения о параметрах см. в разделе Ограничение скорости веб-запросов с помощью правил на основе скорости в Руководстве разработчика WAF .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, для которых WAF в данный момент ограничивает скорость для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегации.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставите одинаковые настройки правила на основе скорости в двух веб-ACL, каждое из двух выражений правила представляет отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление со стороны WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление со стороны WAF.

Limit -> (long)

Предел запросов во время указанного окна оценки для одного экземпляра агрегации для правила на основе скорости. Если выражение на основе скорости включает ScopeDownStatement , этот предел применяется только к запросам, соответствующим выражению.

Примеры:

  • Если вы агрегируете только по IP-адресу, это предел запросов с любого одного IP-адреса.
  • Если вы агрегируете по HTTP-методу и имени аргумента запроса «city», то это предел запросов для любой одной пары метод, город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в подсчет запросов, оглядываясь назад с текущего момента времени. Например, для настройки 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые настройки: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а то, как далеко назад он смотрит при каждой проверке. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 minutes)

AggregateKeyType -> (string)

Настройка, указывающая, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, опускаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте запросы, соответствующие выражению сужения области правила на основе скорости. При этом варианте подсчитанные запросы не агрегируются далее. Выражение сужения области — единственная используемая спецификация. Когда количество всех запросов, удовлетворяющих выражению сужения области, превышает предел, WAF применяет действие правила ко всем запросам, удовлетворяющим выражению сужения области. С этим параметром необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегации. С этим параметром необходимо указать ключи агрегации в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегации в IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в HTTP-заголовке. С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы агрегировать по комбинации перенаправленного IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать по комбинации IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в настройках ключа агрегации правила.

HeaderName -> (string)

Имя HTTP-заголовка для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для этого значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные поведения:

  • MATCH - Считать веб-запрос соответствующим выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим выражению правила.

CustomKeys -> (list)

Указывает агрегированные ключи, используемые в правиле на основе частоты.

(structure)

Указывает один пользовательский агрегированный ключ для правила на основе частоты.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правила на основе частоты.

Header -> (structure)

Используйте значение заголовка в запросе в качестве агрегированного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегирования. Если вы используете один заголовок в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

The name of the header to use.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробного описания каждого типа преобразования см. Text transformations в WAF Developer Guide .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве агрегированного ключа. Каждое отдельное значение cookie вносит вклад в экземпляр агрегирования. Если вы используете один cookie в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

The name of the cookie to use.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробного описания каждого типа преобразования см. Text transformations в WAF Developer Guide .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве агрегированного ключа. Каждое отдельное значение для именованного аргумента запроса вносит вклад в экземпляр агрегирования. Если вы используете один аргумент запроса в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

The name of the query argument to use.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробного описания каждого типа преобразования см. Text transformations в WAF Developer Guide .

QueryString -> (structure)

Используйте строку запроса запроса в качестве агрегированного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегирования. Если вы используете только строку запроса в качестве своего пользовательского ключа, то каждая строка полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробного описания каждого типа преобразования см. Text transformations в WAF Developer Guide .

HTTPMethod -> (structure)

Используйте метод HTTP запроса в качестве агрегированного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегирования. Если вы используете только метод HTTP в качестве своего пользовательского ключа, то каждый метод полностью определяет экземпляр агрегирования.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве агрегированного ключа. Каждый отдельный перенаправленный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в параметрах пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете агрегировать только по перенаправленному IP-адресу, указав FORWARDED_IP в операторе на основе частоты AggregateKeyType .

С этим параметром вы должны указать заголовок для использования в свойстве правила на основе частоты ForwardedIPConfig .

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве агрегированного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегирования.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в параметрах пользовательского ключа, вы также должны указать как минимум один другой ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в операторе на основе частоты AggregateKeyType .

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве агрегированного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегирования. Если вы используете только одно пространство имен метки в качестве своего пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегирования.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе частоты в веб-ACL.

Для получения информации о пространствах имен и именах меток см. Label syntax and naming requirements в WAF Developer Guide .

Namespace -> (string)

Пространство имен для использования для агрегирования.

UriPath -> (structure)

Используйте путь URI запроса в качестве агрегированного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегирования. Если вы используете только путь URI в качестве своего пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробного описания каждого типа преобразования см. Text transformations в WAF Developer Guide .

JA3Fingerprint -> (structure)

Используйте отпечаток JA3 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA3 в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считать веб-запрос не соответствующим оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток пальца JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток пальца JA4 в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия для присвоения веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка пальца JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой И. Вы предоставляете более одного оператора Statement в пределах AndStatement .

Statements -> (list)

Операторы для объединения с логикой И. Вы можете использовать любые операторы, которые можно вложить.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой ИЛИ. Вы предоставляете более одного оператора Statement в пределах OrStatement .

Statements -> (list)

Операторы для объединения с логикой ИЛИ. Вы можете использовать любые операторы, которые можно вложить.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один оператор Statement в пределах NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить требуемые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вкладывать ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в web ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control для предотвращения захвата учетной записи (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control для предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. WAF Pricing .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика при обновлении настроек управляемой группы правил поставщика.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и местоположения в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и местоположения в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

Примеры спецификаций см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию JavaScript Object Notation (JSON) Pointer в Internet Engineering Task Force (IETF). Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация имени пользователя — /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию JavaScript Object Notation (JSON) Pointer в Internet Engineering Task Force (IETF). Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация пароля — /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это для указания уровня проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. WAF Bot Control rule group и WAF Bot Control в WAF Developer Guide .

InspectionLevel -> (string)

Уровень проверки для использования для группы правил Bot Control. Общий уровень является наименее затратным. Целевой уровень включает все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в WAF Bot Control rule group в WAF Developer Guide .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Bot Control rules listing в WAF Developer Guide .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это для предоставления информации о запросах на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это также для предоставления информации о том, как ваш дистрибутив реагирует на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. группу правил WAF Fraud Control account takeover prevention (ATP) и WAF Fraud Control account takeover prevention (ATP) в Руководстве разработчика WAF .

LoginPath -> (string)

Путь к конечной точке входа для вашего приложения. Например, для URL https://example.com/web/login , вы бы предоставили путь /web/login . Пути входа, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезных данных для вашей конечной точки входа: JSON или form encoded.

UsernameField -> (structure)

Имя поля в полезных данных запроса, содержащего имя пользователя вашего клиента.

Как это указать, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя: /form/username .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 , спецификация поля имени пользователя: username1

Identifier -> (string)

Имя поля имени пользователя.

Как это указать, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "username": "THE_USERNAME" } } , the username field specification is /form/username .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 , спецификация поля имени пользователя: username1

PasswordField -> (structure)

Имя поля в полезных данных запроса, содержащего пароль вашего клиента.

Как это указать, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "password": "THE_PASSWORD" } } , the password field specification is /form/password .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 , спецификация поля пароля: password1 .

Identifier -> (string)

Имя поля пароля.

Как это указать, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "password": "THE_PASSWORD" } } , the password field specification is /form/password .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 , спецификация поля пароля: password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно на попытки входа клиента, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиента и IP-адресов, которые имели слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным соответствием, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешной, строка может быть в любом месте тела и должна быть точным соответствием, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, строка может быть в любом месте тела и должна быть точным соответствием, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен быть точным соответствием, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешную попытку входа или создания учетной записи. Чтобы считаться успешным, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным соответствием, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути к странице входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетных записей (ACFP), AWSManagedRulesACFPRuleSet . Используйте это для предоставления информации о запросе создания учетной записи группе правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это также для предоставления информации о том, как ваш дистрибутив реагирует на запросы создания учетных записей.

Для получения информации об использовании управляемой группы правил ACFP см. группу правил предотвращения мошенничества при создании учетных записей (ACFP) в WAF Fraud Control и предотвращение мошенничества при создании учетных записей (ACFP) в WAF Developer Guide .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница вашего веб-сайта, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать запросы POST.

Например, для URL-адреса https://example.com/web/newaccount, вы предоставите путь /web/newaccount . Пути страниц создания учетной записи, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница вашего веб-сайта, на которой новым пользователям представлена форма регистрации.

Примечание

Эта страница должна принимать запросы GET text/html.

Например, для URL-адреса https://example.com/web/registration, вы предоставите путь /web/registration . Пути страниц регистрации, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезных данных для конечной точки создания учетной записи: JSON или закодированный в форме.

UsernameField -> (structure)

Имя поля в полезных данных запроса, содержащего имя пользователя вашего клиента.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификацией поля имени пользователя является /form/username .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификацией поля имени пользователя является username1

Identifier -> (string)

Имя поля имени пользователя.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификацией поля имени пользователя является /form/username .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 спецификацией поля имени пользователя является username1

PasswordField -> (structure)

Имя поля в полезных данных запроса, содержащего пароль вашего клиента.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификацией поля пароля является /form/password .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификацией поля пароля является password1 .

Identifier -> (string)

Имя поля пароля.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификацией поля пароля является /form/password .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 спецификацией поля пароля является password1 .

EmailField -> (structure)

Имя поля в полезных данных запроса, содержащего адрес электронной почты вашего клиента.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "email": "THE_EMAIL" } } спецификацией поля электронной почты является /form/email .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 спецификацией поля электронной почты является email1 .

Identifier -> (string)

Имя поля электронной почты.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "email": "THE_EMAIL" } } спецификацией поля электронной почты является /form/email .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем email1 спецификацией поля электронной почты является email1 .

PhoneNumberFields -> (list)

Имена полей в полезных данных запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так же, как они упорядочены в полезных данных запроса.

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

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторами поля номера телефона являются /form/primaryphoneline1 , /form/primaryphoneline2 , и /form/primaryphoneline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 идентификаторами поля номера телефона являются primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 .

(structure)

Имя поля в полезных данных запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного номера телефона.

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

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторами поля номера телефона являются /form/primaryphoneline1 , /form/primaryphoneline2 , и /form/primaryphoneline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 идентификаторами поля номера телефона являются primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезных данных запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так же, как они упорядочены в полезных данных запроса.

Способ указания полей адреса зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторами поля адреса являются /form/primaryaddressline1 , /form/primaryaddressline2 , и /form/primaryaddressline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 идентификаторами полей адреса являются primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 .

(structure)

Имя поля в полезных данных запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного адреса.

Способ указания полей адреса зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer. Например, для полезных данных JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторами поля адреса являются /form/primaryaddressline1 , /form/primaryaddressline2 , и /form/primaryaddressline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 идентификаторами полей адреса являются primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответов доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетных записей клиентами, подсчитывая успешные и неудачные попытки с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы из сеансов клиентов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным совпадением, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] and "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] and "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] and "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, строка может быть в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно сопоставить в JSON. Идентификатор должен быть точным совпадением, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] and "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Allow the use of regular expressions in the registration page path and the account creation path.

RuleActionOverrides -> (list)

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

Примечание

Убедитесь в правильности имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно переопределять некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(структура)

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

Примечание

Убедитесь в правильности имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно переопределять некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Имя -> (string)

Имя правила для переопределения.

Примечание

Убедитесь в правильности имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

ResponseCode -> (integer)

HTTP-код состояния, который необходимо вернуть клиенту.

For a list of status codes that you can use in your custom responses, see Supported status codes for custom response in the WAF Developer Guide .

CustomResponseBodyKey -> (string)

References the response body that you want WAF to return to the web request client. You can define a custom response for a rule action or a default web ACL action that is set to block. To do this, you first define the response body key and value in the CustomResponseBodies setting for the WebACL or RuleGroup where you want to use it. Then, in the rule action or web ACL default action BlockAction setting, you reference the response body using this key.

ResponseHeaders -> (list)

HTTP-заголовки для использования в ответе. Можно указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

HTTP-заголовки для вставки в запрос. Дублирование имен заголовков не допускается.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, которые были добавлены в веб-запрос правилами, уже запущенными в веб-ACL.

Оператор сопоставления меток предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю полностью квалифицированную имя метки, которая была добавлена в веб-запрос. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует контекст группы правил или веб-ACL правила, который добавил метку. Если вы не предоставите полностью квалифицированное имя в своей строке соответствия метке, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор соответствия метке.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора соответствия:

  • Если Scope указывает LABEL , то это указание должно включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс до предоставления полностью квалифицированного имени метки.
  • Если Scope указывает NAMESPACE , то это указание может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, где возникла метка.

Метки чувствительны к регистру, и компоненты метки должны быть разделены двоеточием, например NS1:NS2:name .

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с вашими настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо эту настройку, либо настройку IncludedPaths , но не обе.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения с использованием синтаксиса указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо эту настройку, либо настройку All , но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All .

(string)

MatchScope -> (string)

Части JSON, с которыми следует выполнять сопоставление с помощью MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадение в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение отката. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если размер тела больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с вашими настройками действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка негабаритного размера в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, соответствующие критериям проверки правила. Если указать ALL , WAF проверит как ключи, так и значения.

All не требует соответствия в ключах и соответствия в значениях. Для этого требуется соответствие в ключах, или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое – значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки негабаритного размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie негабаритного размера в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует соответствия в ключах и соответствия в значениях. Для этого требуется соответствие в ключах, или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое – значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Параметры обработки негабаритного размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента поля для соответствия в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки негабаритного размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строк ByteMatchStatement с параметром PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Log fields (Поля журнала) в WAF Developer Guide (Руководство разработчика WAF).

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора соответствия строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие резервные параметры:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строк ByteMatchStatement с параметром PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях ведения журнала см. в разделе Log fields (Поля журнала) в WAF Developer Guide (Руководство разработчика WAF).

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора соответствия строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие резервные параметры:

  • MATCH - Рассматривать веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий утверждению правила.

UriFragment -> (structure)

Проверка фрагментов URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI недопустимого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует сделать, если он не может полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, которую он обнаружит.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для неверного JSON. Если анализ выполнен успешно, WAF не применяет поведение при отступлении. Дополнительные сведения см. в разделе Тело JSON в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам, для преобразования компонента запроса FieldToMatch перед его проверкой, и они используются в операторах правил на основе скорости, для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным контентом, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

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

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правил с логикой ИЛИ. Вы предоставляете более одного Statement в пределах OrStatement.

Statements -> (list)

Операторы для объединения с логикой ИЛИ. Вы можете использовать любые операторы, которые можно вложить.

(structure)

Рекомендации по обработке Rule, используемые WAF для определения соответствия веб-запроса правилу.

Примеры спецификаций см. в разделе примеров CreateWebACL.

ByteMatchStatement -> (structure)

Оператор правила, определяющий поиск соответствия строк для WAF для применения к веб-запросам. Оператор соответствия байтам предоставляет байты для поиска, местоположение в запросах, которые вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска, как правило, представляют собой строку, соответствующую символам ASCII. В консоли WAF и руководстве разработчика это называется оператором соответствия строкам.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF выполняет поиск только в той части веб-запросов, которую вы назначаете для проверки в FieldToMatch. Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch:

  • Method : Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath : Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg.
  • JA3Fingerprint : Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. Вы можете использовать этот выбор только с соответствием строкам ByteMatchStatement с PositionalConstraint, установленным в EXACTLY. Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Поля журналов в Руководстве разработчика WAF.
  • HeaderOrder : Список имен заголовков для сопоставления. WAF создает строку, которая содержит упорядоченный список имен заголовков, из заголовков в веб-запросе, а затем выполняет сопоставление с этой строкой.

Если SearchString включает в себя буквенные символы A-Z и a-z, обратите внимание, что значение чувствительно к регистру.

Если вы используете API WAF

Укажите версию значения с кодировкой base64. Максимальная длина значения перед кодированием base64 составляет 200 байт.

Например, предположим, что значение Type — HEADER, а значение Data — User-Agent. Если вы хотите выполнить поиск в заголовке User-Agent значения BadBot, вы кодируете BadBot с помощью кодировки MIME base64 и включаете полученное значение QmFkQm90 в значение SearchString.

Если вы используете CLI или один из пакетов SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки чрезмерного размера следующие:

  • CONTINUE - Проверить доступное содержимое тела обычно в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерного размера с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Рабочей группы разработки интернет-решений (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing doesn’t fully validate the input JSON string, so parsing can succeed even for invalid JSON. When parsing succeeds, WAF doesn’t apply the fallback behavior. For more information, see JSON body in the WAF Developer Guide .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки чрезмерного размера следующие:

  • CONTINUE - Проверить доступное содержимое тела обычно в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки чрезмерного размера с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области действия и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или в обоих. Чтобы потребовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки негабаритных размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области действия и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр, используемый для идентификации подмножества файлов cookie, которые необходимо проверить в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки в соответствии с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или в обоих. Чтобы потребовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie в запросе больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки негабаритных размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, отсортированных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке с использованием двоеточий без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки негабаритных размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации строкового оператора сопоставления, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот параметр только со строковым соответствием ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации строкового оператора сопоставления, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить, как обрабатывать любое содержимое фрагмента URI, превышающее размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие параметры:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недопустимого JSON. Когда анализ завершается успешно, WAF не применяет поведение отката. Дополнительную информацию см. в разделе JSON body в руководстве WAF Developer Guide .

TextTransformations -> (list)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations в руководстве WAF Developer Guide .

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString. Допустимые значения включают следующее:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString, но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString, а SearchString должен содержать только буквенно-цифровые символы или подчеркивания (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что выполняются оба следующих условия:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot.
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например BadBot; и -BadBot;.
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString.

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного кода SQL. Злоумышленники внедряют вредоносный код SQL в веб-запросы для выполнения таких действий, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может быть длиной до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверить доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры обработки больших размеров MATCH или NO_MATCH с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON, с которыми нужно сопоставить с помощью MatchPattern. Если вы укажете ALL, WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое оператор AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью разобрать тело JSON. Возможные варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверить доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры обработки больших размеров MATCH или NO_MATCH с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All , IncludedHeaders или ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — Обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All , IncludedCookies или ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — Обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для соответствия в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE — Обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с соответствием строки ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе Поля журнала в Руководстве разработчика WAF .

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора соответствия строки, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хеш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с соответствием строки ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе Поля журнала в Руководстве разработчика WAF .

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора соответствия строки, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING — Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считать веб-запрос не соответствующим оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

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

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки на предмет атак с использованием SQL-инъекций.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию об идентификации и смягчении последствий ложных срабатываний см. в разделе Тестирование и настройка в Руководстве разработчика WAF .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другую защиту от атак с использованием SQL-инъекций или имеют низкую толерантность к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (structure)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). При атаках XSS злоумышленник использует уязвимости в безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских сценариев в другие легитимные веб-браузеры.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (структура)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (список)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр, чтобы включить все пути. Вместо этого используйте настройку All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF сопоставляет с ключами и значениями.

All не требует совпадения в ключах и совпадения в значениях. Он требует совпадения в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

InvalidFallbackBehavior -> (строка)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие параметры:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не укажете этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (строка)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры для обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого заголовков, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого файлов cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (строка)

Части файлов cookie для проверки с помощью критериев проверки правил. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Требуется совпадение в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлов cookie в запросе больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (строка)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Log fields (Поля журнала) в WAF Developer Guide (Руководство разработчика WAF) .

Предоставьте строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (строка)

Статус соответствия, назначаемый веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Log fields (Поля журнала) в WAF Developer Guide (Руководство разработчика WAF) .

Предоставьте строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить ее с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (строка)

Статус соответствия, назначаемый веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие варианты резервного поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

UriFragment -> (структура)

Проверяет фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI превышающего размер в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для неверного JSON. Когда синтаксический анализ проходит успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам, для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости, для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным контентом, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, можно использовать оператор ограничения размера для поиска строк запросов, длина которых превышает 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле до предела для веб-ACL и типа защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать лимит проверки, вы можете использовать оператор ограничения размера, чтобы заблокировать запросы с большим размером тела запроса. Дополнительные сведения об ограничениях проверки см. в настройках Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI для значения параметра Часть запроса для фильтрации, косая черта (/) в URI будет считаться одним символом. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - считайте веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считайте, что веб-запрос не соответствует оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос просит выполнить исходный сервер.

JsonBody -> (структура)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов, превышающие размер, см. в конфигурации объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставляйте только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Сведения об этом синтаксисе см. в документации Рабочей группы разработки Интернет (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если он не может полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - считайте веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считайте, что веб-запрос не соответствует оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он сталкивается.

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому разбор может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что должен делать WAF, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig, за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE — обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - считайте веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - считайте, что веб-запрос не соответствует оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка сверх размера в объекте Headers. WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , или ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Требуется найти совпадение в ключах, значениях или и в том, и в другом. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, проверяющего ключи, и другого, проверяющего значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого cookie сверх размера в объекте Cookies. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , или ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует нахождения совпадения в ключах и нахождения совпадения в значениях. Требуется найти совпадение в ключах, значениях или и в том, и в другом. Чтобы потребовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одного, проверяющего ключи, и другого, проверяющего значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступные файлы cookie в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они появляются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента поля для соответствия в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с соответствием строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если у запроса нет отпечатка пальца JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверяйте фрагменты URI запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

WAF пересылает для проверки базовой службой хоста только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Доступны следующие параметры:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

Если этот параметр не указан, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для неверного JSON. Если анализ прошел успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF .

ComparisonOperator -> (string)

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

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с параметра самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе «Преобразования текста» в Руководстве разработчика WAF .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и который сопоставляет веб-запросы на основе кода страны. Правило сопоставления по географическому признаку помечает каждый проверяемый запрос независимо от того, находит ли он соответствие.

  • Чтобы управлять запросами только по стране, можно использовать этот оператор самостоятельно и указать страны, с которыми требуется сопоставить, в массиве CountryCodes.
  • В противном случае настройте правило сопоставления по географическому признаку с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам, которые будут выполняться после правила сопоставления по географическому признаку, и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя коды стран и регионов альфа-2 из международного стандарта ISO 3166 Международной организации по стандартизации (ISO). WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в ForwardedIPConfig сопоставления по географическому признаку.

Если вы используете источник веб-запроса, форматы меток — awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code> .

Если вы используете перенаправленный IP-адрес, форматы меток — awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code> .

Для получения дополнительной информации см. раздел «Оператор правила сопоставления по географическому признаку» в Руководстве разработчика WAF.

CountryCodes -> (list)

Массив двухбуквенных кодов стран, с которыми вы хотите сопоставить, например [ "US", "CN" ], из кодов стран альфа-2 ISO международного стандарта ISO 3166.

Когда вы используете оператор сопоставления по географическому признаку только для меток региона и страны, которые он добавляет к запросам, вам все равно нужно указать код страны, чтобы правило было оценено. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно по-прежнему будет создавать журналы и метрики подсчета для любых совпадений. Вы можете сократить объем ведения журнала и метрик, создаваемых правилом, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но можно указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP для использования для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Можно указать следующие резервные варианты поведения:

  • MATCH — считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать, что веб-запрос не соответствует оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Вы не можете вложить RuleGroupReferenceStatement, например, для использования внутри NotStatement или OrStatement. Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в web ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в указанной группе правил, для которых действия установлены на Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любое допустимое значение действия, включая Count.

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любое допустимое значение действия, включая Count.

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count.

RuleActionOverrides -> (list)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(structure)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF возвращал клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Чтобы сделать это, сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в настройке BlockAction действия правила или действия по умолчанию для веб-ACL, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитывать веб-запрос, а затем продолжать оценивать запрос, используя оставшиеся правила в web ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA против веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge против веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков запрещено.

Информацию об ограничениях на количество и размер для пользовательских настроек запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Правило утверждения, используемое для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который определяет адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом утверждении. Чтобы создать набор IP, см. CreateIPSet.

Каждое утверждение правила IP-набора ссылается на IP-набор. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. Когда вы обновляете ссылочный набор, WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Amazon Resource Name (ARN) IPSet, на который ссылается это утверждение.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке, а не с использованием IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка, используемого для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите этот параметр в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет допустимого IP-адреса в указанном положении.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные поведения:

  • MATCH — считать веб-запрос соответствующим утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — считать веб-запрос не соответствующим утверждению правила.

Position -> (string)

Положение в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси-серверы, через которые прошел запрос.

Параметры для этого параметра следующие:

  • FIRST — проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST — проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY — проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий в компонентах веб-запроса с помощью регулярных выражений. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов regex, см. CreateRegexPatternSet.

Каждый оператор правила набора шаблонов regex ссылается на набор шаблонов regex. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, ссылающиеся на него.

ARN -> (string)

Имя ресурса Amazon (ARN) RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите проверить с помощью WAF.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как простой текст. Тело запроса сразу следует за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычным образом проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить HTTP-метод. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса сразу следует за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Необходимо указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствие только указанным путям включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Необходимо указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки анализа, с которой он сталкивается.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. body JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычным образом проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка большего размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверять все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одного для проверки ключей, а другого для проверки значений.

OversizeHandling -> (string)

Что WAF следует сделать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie большего размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверять все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одного для проверки ключей, а другого для проверки значений.

OversizeHandling -> (string)

Что WAF следует сделать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим заявлению правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует сделать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком JA3 запроса. Отпечаток JA3 - это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Log fields в WAF Developer Guide.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние сопоставления, которое нужно присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком JA4 запроса. Отпечаток JA4 - это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточную информацию TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Log fields в WAF Developer Guide.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние сопоставления, которое нужно присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос несоответствующим заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить область видимости и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если он не может полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

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

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает запросы по скорости, когда они поступают слишком быстро. Правило категоризирует запросы в соответствии с вашими критериями агрегации, собирает их в экземпляры агрегации, а также подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в используемом в данный момент правиле, изменение сбрасывает счетчики ограничения скорости правила. Это может приостановить действия по ограничению скорости правила на срок до минуты.

Вы можете указать отдельные ключи агрегации, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегации, такие как IP-адрес и метод HTTP или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для указанных вами ключей агрегации представляет собой отдельный экземпляр агрегации, при этом значение из каждого ключа вносит вклад в определение экземпляра агрегации.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило создаст различные экземпляры агрегации в соответствии с вашими критериями агрегации, например:

  • Если критерием агрегации является только IP-адрес, то каждый отдельный адрес является экземпляром агрегации, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегации является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: количество 2
    • Метод HTTP GET: количество 2
  • Если критерием агрегации является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут способствовать комбинированному экземпляру агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любого n-кортежа ключей агрегации каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегации, который WAF подсчитывает и ограничивает по скорости индивидуально.

При желании вы можете вложить другое выражение внутрь выражения на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только запросов, соответствующих вложенному выражению. Вы можете использовать это вложенное выражение сужения области действия в сочетании со спецификациями ключей агрегации или просто подсчитывать и ограничивать скорость всех запросов, соответствующих выражению сужения области действия, без дополнительной агрегации. Когда вы решите просто управлять всеми запросами, соответствующими выражению сужения области действия, экземпляр агрегации является сингулярным для правила.

Вы не можете вложить RateBasedStatement внутри другого выражения, например, внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Для получения дополнительной информации об опциях см. раздел Ограничение скорости веб-запросов с использованием правил на основе скорости в Руководстве разработчика WAF .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, которые WAF в настоящее время ограничивает по скорости для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегации.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставляете одни и те же настройки правила на основе скорости в двух веб-ACL, каждое из двух выражений правила представляет собой отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление со стороны WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление со стороны WAF.

Limit -> (long)

Лимит по запросам во время указанного окна оценки для одного экземпляра агрегации для правила на основе скорости. Если выражение на основе скорости включает ScopeDownStatement , этот лимит применяется только к запросам, соответствующим выражению.

Примеры:

  • Если вы агрегируете только по IP-адресу, это лимит по запросам с любого отдельного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это лимит по запросам для любой отдельной пары метод, город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в свои подсчеты запросов, заглядывая назад с текущего момента времени. Например, при настройке 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые настройки: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а определяет, как далеко назад он смотрит при каждой проверке. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 minutes)

AggregateKeyType -> (string)

Настройка, которая указывает, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, исключаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте запросы, соответствующие выражению сужения области действия правила на основе скорости. С помощью этого параметра подсчитываемые запросы не подвергаются дальнейшей агрегации. Выражение сужения области действия является единственной используемой спецификацией. Когда количество всех запросов, удовлетворяющих выражению сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим выражению сужения области действия. С помощью этого параметра необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегации. С помощью этого параметра необходимо указать ключи агрегации в свойстве CustomKeys . Чтобы агрегировать только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегации в IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. С помощью этого параметра необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы агрегировать по комбинации перенаправленного IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы агрегировать по комбинации IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы укажете перенаправленный IP-адрес в настройках ключа агрегации правила.

HeaderName -> (string)

Имя заголовка HTTP для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не содержит действительного IP-адреса в указанном положении.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отступлении:

  • MATCH - Рассматривайте веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий выражению правила.

CustomKeys -> (list)

Указывает агрегированные ключи, которые следует использовать в правиле на основе скорости.

(структура)

Указывает один настраиваемый агрегированный ключ для правила на основе скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, опускаются из оценки и обработки правила на основе скорости.

Header -> (структура)

Используйте значение заголовка в запросе в качестве агрегированного ключа. Каждое отдельное значение в заголовке способствует экземпляру агрегирования. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

The name of the header to use.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве агрегированного ключа. Каждое отдельное значение в cookie способствует экземпляру агрегирования. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

The name of the cookie to use.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве агрегированного ключа. Каждое отдельное значение для именованного аргумента запроса способствует экземпляру агрегирования. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

The name of the query argument to use.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

QueryString -> (structure)

Используйте строку запроса запроса в качестве агрегированного ключа. Каждая отдельная строка способствует экземпляру агрегирования. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

HTTPMethod -> (structure)

Используйте HTTP-метод запроса в качестве агрегированного ключа. Каждый отдельный HTTP-метод способствует экземпляру агрегирования. Если вы используете только HTTP-метод в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегирования.

ForwardedIP -> (structure)

Используйте первый IP-адрес в HTTP-заголовке в качестве агрегированного ключа. Каждый отдельный переадресованный IP-адрес способствует экземпляру агрегирования.

Когда вы указываете IP-адрес или переадресованный IP-адрес в настройках пользовательского ключа, вы также должны указать хотя бы один другой ключ для использования. Вы можете агрегировать только по переадресованному IP-адресу, указав FORWARDED_IP в операторе на основе скорости AggregateKeyType .

С помощью этой опции необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила на основе скорости.

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве агрегированного ключа. Каждый отдельный IP-адрес способствует экземпляру агрегирования.

Когда вы указываете IP-адрес или переадресованный IP-адрес в настройках пользовательского ключа, вы также должны указать хотя бы один другой ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в операторе на основе скорости AggregateKeyType .

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве агрегированного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, способствует экземпляру агрегирования. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегирования.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются перед этим правилом на основе скорости в веб-ACL.

For information about label namespaces and names, see Label syntax and naming requirements in the WAF Developer Guide .

Namespace -> (string)

The namespace to use for aggregation.

UriPath -> (structure)

Используйте путь URI запроса в качестве агрегированного ключа. Каждый отдельный путь URI способствует экземпляру агрегирования. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

For detailed descriptions of each of the transformation types, see Text transformations in the WAF Developer Guide .

JA3Fingerprint -> (structure)

Используйте отпечаток JA3 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если недостаточно информации TLS Client Hello для вычисления отпечатка JA3.

You can specify the following fallback behaviors:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток пальца JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток пальца JA4 в качестве пользовательского ключа, каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия для назначения веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка пальца JA4.

Вы можете указать следующие варианты поведения при отступлении:

  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логическое утверждение правила, используемое для объединения других утверждений правила с логикой AND. Вы предоставляете более одного Statement в рамках AndStatement .

Statements -> (list)

Утверждения для объединения с логикой AND. Вы можете использовать любые утверждения, которые могут быть вложены.

( … recursive … )

OrStatement -> (structure)

Логическое утверждение правила, используемое для объединения других утверждений правила с логикой OR. Вы предоставляете более одного Statement в рамках OrStatement .

Statements -> (list)

Утверждения для объединения с логикой OR. Вы можете использовать любые утверждения, которые могут быть вложены.

( … recursive … )

NotStatement -> (structure)

Логическое утверждение правила, используемое для отрицания результатов другого утверждения правила. Вы предоставляете одно Statement в рамках NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Утверждение правила, используемое для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом утверждении. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Вы не можете вкладывать ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на утверждение верхнего уровня в правиле, которое вы определяете в веб-ACL.

Примечание

С вас взимается дополнительная плата, когда вы используете управляемую группу правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемую группу правил WAF Fraud Control для предотвращения перехвата учетной записи (ATP) AWSManagedRulesATPRuleSet или управляемую группу правил WAF Fraud Control для предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. Цены WAF .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика, когда поставщик обновляет настройки управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылаемой группе правил, действия которых установлены на Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также места в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты пользователя и номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в ваше приложение и места в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения, а также места в полезной нагрузке запроса создания учетной записи данных, таких как поля электронной почты пользователя и номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает страницу входа в ваше приложение и места в полезной нагрузке запроса входа данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил Bot Control.

Например, см. раздел примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. Группа правил WAF Bot Control и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки для использования для группы правил Bot Control. Общий уровень — самый дешевый. Целевой уровень включает все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе Группа правил WAF Bot Control в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют аномальное поведение, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Список правил Bot Control в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это для предоставления информации о запросах на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это также для предоставления информации о том, как ваш дистрибутив отвечает на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Для получения информации об использовании управляемой группы правил ATP см. WAF Fraud Control account takeover prevention (ATP) rule group и WAF Fraud Control account takeover prevention (ATP) в WAF Developer Guide .

LoginPath -> (string)

Путь к конечной точке входа в ваше приложение. Например, для URL https://example.com/web/login , вы предоставите путь /web/login . Пути входа, начинающиеся с указанного вами пути, считаются соответствующими. Например /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной конечной точке входа.

RequestInspection -> (structure)

Критерии для проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа, либо JSON, либо форма с кодировкой.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

Identifier -> (string)

Название поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

Identifier -> (string)

Название поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Для получения информации о синтаксисе JSON Pointer см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно на попытки входа клиента, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа на индикаторы успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа или создания учетной записи. Чтобы быть засчитанным как успех, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа или создания учетной записи. Чтобы быть засчитанным как неудачу, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа на индикаторы успеха и неудачи.

Name -> (string)

Название заголовка, с которым нужно сопоставить. Название должно точно совпадать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешную попытку входа или создания учетной записи. Чтобы быть засчитанным как успех, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачную попытку входа или создания учетной записи. Чтобы быть засчитанным как неудачу, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа на индикаторы успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешную попытку входа или создания учетной записи. Чтобы быть засчитанным как успех, строка может быть в любом месте тела и должна точно совпадать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачную попытку входа или создания учетной записи. Чтобы быть засчитанной как неудачу, строка может быть в любом месте тела и должна точно совпадать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа на индикаторы успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения, с которым нужно сопоставить в JSON. Идентификатор должен точно совпадать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, указывающие на успешную попытку входа или создания учетной записи. Чтобы быть засчитанным как успех, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, указывающие на неудачную попытку входа или создания учетной записи. Чтобы быть засчитанным как неудачу, значение должно точно совпадать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet . Используйте это, чтобы предоставить информацию о запросе создания учетной записи в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы создания учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. группу правил предотвращения мошенничества при создании учетной записи WAF Fraud Control (ACFP) и предотвращение мошенничества при создании учетной записи WAF Fraud Control (ACFP) в Руководстве разработчика WAF.

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница вашего веб-сайта, которая принимает заполненную форму регистрации нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount, вы должны предоставить путь /web/newaccount . Пути к странице создания учетной записи, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница вашего веб-сайта, на которой отображается форма регистрации для новых пользователей.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL https://example.com/web/registration, вы должны предоставить путь /web/registration . Пути к странице регистрации, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или закодированный в форме.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

Identifier -> (string)

Название поля имени пользователя.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

Identifier -> (string)

Название поля пароля.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

EmailField -> (structure)

Название поля в полезной нагрузке запроса, содержащего электронную почту вашего клиента.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты — email1 .

Identifier -> (string)

Название поля электронной почты.

Способ указания зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты — email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного номера телефона.

Способ указания полей номера телефона зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 , идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного адреса.

Способ указания полей адреса зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 , идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответов доступна только в веб-ACL, которые защищают дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно в попытках создания учетной записи клиентом, ведя подсчет успешных и неудачных попыток с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно точно соответствовать, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] and "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] and "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] and "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно сопоставить в JSON. Идентификатор должен точно соответствовать, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] and "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не возвращает ошибку и не применяет параметр переопределения.

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

(структура)

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

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не возвращает ошибку и не применяет параметр переопределения.

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

Имя -> (string)

Имя правила для переопределения.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не возвращает ошибку и не применяет параметр переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ на веб-запрос.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF возвращал клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое настроено на блокировку. Для этого сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или действии по умолчанию веб-ACL настройке BlockAction вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, которые были добавлены в веб-запрос правилами, уже запущенными в веб-ACL.

Оператор соответствия меткам предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю полностью квалифицированную имя метки, которая была добавлена в веб-запрос. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, которое добавило метку. Если вы не предоставите полностью квалифицированное имя в строке соответствия метке, WAF выполнит поиск меток, добавленных в том же контексте, что и оператор соответствия метке.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора соответствия:

  • Если Scope указывает LABEL, то это указание должно включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс вплоть до предоставления полного имени метки.
  • Если Scope указывает NAMESPACE, то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, и компоненты метки должны быть разделены двоеточием, например NS1:NS2:name.

RegexMatchStatement -> (structure)

Заявление правила, используемое для поиска в компонентах веб-запроса соответствия одному регулярному выражению.

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может быть длиной до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с настройками действий вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо эту настройку, либо настройку IncludedPaths , но не обе.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо эту настройку, либо настройку All , но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All .

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF сопоставляет с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Для этого требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, а другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки анализа, с которой он сталкивается.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с настройками действий вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать только один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверить только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверить только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правила. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует обнаружения соответствия в ключах и обнаружения соответствия в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или и в ключах, и в значениях. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки как обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

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

Необходимо указать только один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверить только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверить только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правила. Если указать ALL, WAF проверит как ключи, так и значения.

All не требует обнаружения соответствия в ключах и обнаружения соответствия в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или и в ключах, и в значениях. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie как обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента поля для сопоставления при проверке. WAF разделяет имена заголовков в строке с использованием двоеточий и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовков.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки как обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено на EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement, где PositionalConstraint установлено на EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры scope и pattern matching в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если он не может полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста исключают некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах сопоставления правил, для преобразования компонента запроса FieldToMatch перед его проверкой, и они используются в операторах правил на основе скорости, для преобразования компонентов запроса, прежде чем использовать их в качестве пользовательских ключей агрегации. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования указанного содержимого, начиная с самой низкой настройки приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста исключают некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF.

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один Statement в NotStatement.

Statement -> (structure)

Оператор для отрицания. Вы можете использовать любой оператор, который можно вложить.

ByteMatchStatement -> (structure)

Оператор правила, который определяет поиск соответствия строк для применения WAF к веб-запросам. Оператор сопоставления байтов предоставляет байты для поиска, местоположение в запросах, которое вы хотите, чтобы WAF искал, и другие параметры. Байты для поиска обычно представляют собой строку, соответствующую символам ASCII. В консоли WAF и в руководстве разработчика это называется оператором сопоставления строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF выполняет поиск только в той части веб-запросов, которую вы указываете для проверки в FieldToMatch. Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch:

  • Method: Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath: Значение, которое вы хотите, чтобы WAF искал в пути URI, например, /images/daily-ad.jpg.
  • JA3Fingerprint: Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY. Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях ведения журнала см. в разделе Log fields в Руководстве разработчика WAF.
  • HeaderOrder: Список имен заголовков для сопоставления. WAF создает строку, которая содержит упорядоченный список имен заголовков, из заголовков в веб-запросе, а затем сопоставляет с этой строкой.

Если SearchString включает буквенные символы A-Z и a-z, обратите внимание, что значение учитывает регистр.

Если вы используете API WAF

Укажите версию значения, закодированную в base64. Максимальная длина значения перед кодированием base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER, а значение Data равно User-Agent. Если вы хотите найти в заголовке User-Agent значение BadBot, вы кодируете BadBot с помощью кодирования base64 MIME и включаете полученное значение QmFkQm90 в значение SearchString.

Если вы используете CLI или один из Amazon Web Services SDK

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше ограничения, базовая служба хоста пересылает только содержимое, которое находится в пределах ограничения, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большего размера, смотрите конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше ограничения, базовая служба хоста пересылает только содержимое, которое находится в пределах ограничения, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий условию правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий условию правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает для выполнения источником.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше ограничения, базовая служба хоста пересылает только содержимое, которое находится в пределах ограничения, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большего размера, смотрите конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих совпадений шаблонов с критериями проверки правила.

All -> (structure)

Соответствует всем элементам. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Соответствует только указанным путям включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Рабочей группы разработки Интернет (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL , WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий условию правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий условию правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение резервного копирования. Для получения дополнительной информации см. JSON body в WAF Developer Guide .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает ограничение для типа ресурса. Когда тело веб-запроса больше ограничения, базовая служба хоста пересылает только содержимое, которое находится в пределах ограничения, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий условию правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий условию правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка превышающего размер в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения ключей и значений. Это требует совпадения ключей или значений, или и того, и другого. Чтобы требовать совпадения и ключей, и значений, используйте логическое утверждение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует совпадения ключей и значений. Это требует совпадения ключей или значений, или и того, и другого. Чтобы требовать совпадения и ключей, и значений, используйте логическое утверждение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что должен делать WAF, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонентов при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и балансировщиками нагрузки приложений. Сопоставьте отпечаток JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и балансировщиками нагрузки приложений. Сопоставьте отпечаток JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с соответствием строки ByteMatchStatement с PositionalConstraint , установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если в запросе нет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI превышающего размер в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если он не может полностью обработать JSON body. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить body как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста body.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF обрабатывает и оценивает содержимое только до первой ошибки парсинга, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недействительного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с настройки самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Для подробных описаний каждого из типов преобразований см. Text transformations в Руководстве разработчика WAF .

PositionalConstraint -> (string)

Область внутри части веб-запроса, в которой вы хотите, чтобы WAF искал SearchString. Допустимые значения включают следующее:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString, но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString, и SearchString должен содержать только буквенно-цифровые символы или символ подчеркивания (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что верно следующее:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или символа подчеркивания (_). Примеры включают значение заголовка и ;BadBot.
  • SearchString находится в конце указанной части веб-запроса или после него следует символ, отличный от буквенно-цифрового символа или символа подчеркивания (_), например, BadBot; и -BadBot;.
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString.

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники вставляют вредоносный SQL-код в веб-запросы, чтобы, например, изменить вашу базу данных или извлечь данные из нее.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда размер тела веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда размер тела веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда размер тела веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths, но не обе.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо эту настройку, либо настройку All, но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Он требует, чтобы соответствие было найдено в ключах, значениях или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если не удается полностью проанализировать тело JSON. Доступны следующие параметры:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что должен делать WAF, если тело запроса больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда размер тела веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксируется на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE — обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки больших размеров с настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запросов. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка превышающего размер в объекте Headers. WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия, одного для проверки ключей, а другого для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области действия и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для использования для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия, одного для проверки ключей, а другого для проверки значений.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия, без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки негабаритного размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Сведения о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для недействительного JSON. Когда анализ успешен, WAF не применяет поведение отката. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного контента, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки атак с внедрением SQL-кода.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Для получения информации об идентификации и смягчении последствий ложных срабатываний см. раздел Testing and tuning в Руководстве разработчика WAF .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак с внедрением SQL-кода или имеют низкую толерантность к ложным срабатываниям.

Default: LOW

XssMatchStatement -> (structure)

Заявление правила, которое проверяет наличие атак межсайтового скриптинга (XSS). В атаках XSS злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских скриптов в другие законные веб-браузеры.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch .

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может иметь длину до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как простой текст. Тело запроса сразу следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов с большим размером, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить HTTP-метод. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса сразу следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов с большим размером, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All .

(string)

MatchScope -> (string)

Части JSON, которые необходимо сопоставить, используя MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы потребовать соответствия в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил соответствия: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access по умолчанию лимит составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Вы должны настроить фильтры области и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовков превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно одну настройку: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки большого размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie превышающего размер в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для использования для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно одну настройку: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверит как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или и в том, и в другом. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одного, которое проверяет ключи, и другого, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки большого размера следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных так, как они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки большого размера следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журнала см. в разделе Log fields в WAF Developer Guide.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления для назначения веб-запросу, если запрос не имеет отпечатка пальца JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Информацию о полях журнала см. в разделе Log fields в WAF Developer Guide.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления для назначения веб-запросу, если запрос не имеет отпечатка пальца JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI передаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки содержимого фрагмента URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для неверного JSON. При успешном анализе WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

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

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, вы можете использовать оператор ограничения размера для поиска строк запросов, которые длиннее 100 байт.

Если вы настроите WAF для проверки тела запроса, WAF проверяет только количество байтов в теле до предела для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать предел проверки, вы можете использовать оператор ограничения размера, чтобы блокировать запросы, размер тела которых больше. Для получения дополнительной информации об ограничениях проверки см. настройки Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI в качестве значения параметра Часть запроса для фильтрации, косая черта (/) в URI считается одним символом. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в виде тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос требует от источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в виде тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правила.

All -> (structure)

Соответствие всем элементам. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Соответствие только указанным путям включения. См. также MatchScope в JsonBody.

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Для этого требуется соответствие, найденное в ключах, или в значениях, или в обоих случаях. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, которую он обнаружит.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение отката. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers , чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers . WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies , чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

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

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с помощью критериев проверки правила. Если указать ALL , WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса больше или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY .

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях журналов см. раздел Поля журналов в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, назначаемое веб-запросу, если запрос не имеет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY .

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях журналов см. раздел Поля журналов в Руководстве разработчика WAF .

Предоставьте строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы соответствовать любым будущим запросам с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, назначаемое веб-запросу, если запрос не имеет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует заявлению правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры соответствия области действия и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить, как обрабатывать содержимое фрагмента URI, превышающее размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

ComparisonOperator -> (string)

Оператор для сравнения части запроса с настройкой размера.

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Text transformations в Руководстве разработчика WAF .

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и сопоставляет веб-запросы на основе кода страны. Правило геосоответствия помечает каждый запрос, который оно проверяет, независимо от того, нашло ли оно соответствие.

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор сам по себе и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes.
  • В противном случае настройте свое правило геосоответствия с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил сопоставления меток для запуска после правила геосоответствия и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя коды стран и регионов alpha-2 из международного стандарта International Organization for Standardization (ISO) 3166. WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы его укажете, адрес в геосоответствии ForwardedIPConfig.

Если вы используете источник веб-запроса, форматы меток: awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code>.

Если вы используете перенаправленный IP-адрес, форматы меток: awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code>.

Для получения дополнительной информации см. Geographic match rule statement в Руководстве разработчика WAF.

CountryCodes -> (list)

Массив двухбуквенных кодов стран, с которыми вы хотите сопоставить, например, [ "US", "CN" ], из кодов стран alpha-2 ISO международного стандарта ISO 3166.

Когда вы используете оператор геосоответствия только для меток региона и страны, которые он добавляет к запросам, вам все равно необходимо указать код страны, чтобы правило оценивалось. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно по-прежнему будет создавать журналы и метрики подсчета для любых совпадений. Вы можете уменьшить объем ведения журнала и метрик, которые создает правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами HTTP-заголовке, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя HTTP-заголовка для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать это, создайте группу правил с вашими правилами, а затем укажите ARN группы правил в этом операторе.

Вы не можете вложить RuleGroupReferenceStatement, например, для использования внутри NotStatement или OrStatement. Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в ссылающейся группе правил, для которых действия установлены в Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любые допустимые настройки действия, включая Count.

(structure)

Указывает отдельное правило в группе правил, действие которого вы хотите переопределить на Count.

Примечание

Вместо этого варианта используйте RuleActionOverrides. Он принимает любые допустимые настройки действия, включая Count.

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count.

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правила на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группы правил.

(structure)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правила на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группы правил.

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в ваших пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string)

Ссылка на текст ответа, который вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое настроено на блокировку. Для этого сначала определите ключ и значение текста ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL настройке BlockAction, вы ссылаетесь на текст ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling.

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Оператор правила, используемый для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Чтобы создать IP-набор, см. CreateIPSet.

Каждый оператор правила IP-набора ссылается на IP-набор. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Имя ресурса Amazon (ARN) IPSet, на который ссылается этот оператор.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, а не с использованием IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP, который следует использовать для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое следует присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Position -> (string)

Положение в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные — прокси-серверы, через которые прошел запрос.

Параметры этого параметра следующие:

  • FIRST - Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правил, используемый для поиска соответствий в компонентах веб-запросов с помощью регулярных выражений. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правил набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов регулярных выражений, см. CreateRegexPatternSet.

Каждый оператор правил набора шаблонов регулярных выражений ссылается на набор шаблонов регулярных выражений. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (строка)

Amazon Resource Name (ARN) набора RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (структура)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

В качестве альтернативы вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (строка)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (строка)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверить все аргументы запроса.

UriPath -> (структура)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (структура)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (строка)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверить доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правил.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действий правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (структура)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (структура)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, содержащая любые дополнительные данные, которые вы хотите отправить на ваш веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (структура)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (структура)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (список)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(строка)

MatchScope -> (строка)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или в обоих случаях. Чтобы требовать соответствия в ключах и в значениях, используйте логический оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (строка)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Параметры следующие:

  • EVALUATE_AS_STRING — проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правил.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Примечание

WAF-анализ не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недопустимого JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (строка)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE — проверить доступное содержимое тела как обычно, в соответствии с критериями проверки правил.
  • MATCH — рассматривать веб-запрос как соответствующий оператору правил. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правил.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действий правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (структура)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовков превышающего размер в объекте Headers. WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для определения подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedHeaders , либо ExcludedHeaders .

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Требуется найти соответствие в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE — Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH — Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считать, что веб-запрос не соответствует заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для определения подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All , IncludedCookies , либо ExcludedCookies .

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с помощью критериев проверки правил. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Требуется найти соответствие в ключах, или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE — Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH — Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считать, что веб-запрос не соответствует заявлению правила.

HeaderOrder -> (структура)

Проверить строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer .

OversizeHandling -> (строка)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки превышения размера следующие:

  • CONTINUE — Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH — Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считать, что веб-запрос не соответствует заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Это можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел «Поля журналов» в Руководстве разработчика WAF .

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные параметры:

  • MATCH — Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считать, что веб-запрос не соответствует заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Это можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел «Поля журналов» в Руководстве разработчика WAF .

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить любые будущие запросы с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные параметры:

  • MATCH — Считать веб-запрос соответствующим заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Считать, что веб-запрос не соответствует заявлению правила.

UriFragment -> (структура)

Проверяйте фрагменты URI запроса. Необходимо настроить scope и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI превышающего размер в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к cookies, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать JSON body. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверить body как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста body.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может пройти даже для неверного JSON. Когда анализ завершается успешно, WAF не применяет fallback behavior. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости, для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным содержимым, начиная с параметра наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют часть необычного форматирования, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого из типов преобразований см. в разделе Преобразования текста в Руководстве разработчика WAF .

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает скорость запросов, когда они поступают со слишком высокой скоростью. Правило категоризирует запросы в соответствии с вашими критериями агрегации, собирает их в экземпляры агрегации, а также подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в используемом в данный момент правиле, изменение сбросит счетчики ограничения скорости правила. Это может приостановить действия правила по ограничению скорости на срок до одной минуты.

Вы можете указать отдельные ключи агрегации, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегации, такие как IP-адрес и метод HTTP, или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для ключей агрегации, которые вы указываете, является отдельным экземпляром агрегации, причем значение каждого ключа способствует определению экземпляра агрегации.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило будет создавать разные экземпляры агрегации в соответствии с вашими критериями агрегации, например:

  • Если критерием агрегации является только IP-адрес, то каждый отдельный адрес является экземпляром агрегации, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: количество 3
    • IP-адрес 127.0.0.0: количество 1
  • Если критерием агрегации является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: количество 2
    • Метод HTTP GET: количество 2
  • Если критерием агрегации является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут способствовать совместному экземпляру агрегации. Экземпляры агрегации и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: количество 1
    • IP-адрес 10.1.1.1, метод HTTP GET: количество 2
    • IP-адрес 127.0.0.0, метод HTTP POST: количество 1

Для любого n-кортежа ключей агрегации каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегации, который WAF подсчитывает и ограничивает скорость индивидуально.

При желании можно вложить другой оператор внутри оператора на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только запросов, соответствующих вложенному оператору. Вы можете использовать этот вложенный оператор сужения области действия в сочетании со спецификациями ключей агрегации или просто подсчитывать и ограничивать скорость всех запросов, соответствующих оператору сужения области действия, без дополнительной агрегации. Когда вы решите просто управлять всеми запросами, которые соответствуют оператору сужения области действия, экземпляр агрегации является сингулярным для правила.

Нельзя вкладывать RateBasedStatement внутри другого оператора, например, внутри NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри веб-ACL и внутри группы правил.

Для получения дополнительной информации об опциях см. Ограничение скорости веб-запросов с помощью правил на основе скорости в Руководстве разработчика WAF .

Если вы агрегируете только по отдельному IP-адресу или перенаправленному IP-адресу, вы можете получить список IP-адресов, для которых WAF в данный момент ограничивает скорость для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегации.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставляете одни и те же настройки правила на основе скорости в двух веб-ACL, каждое из двух операторов правила представляет отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление WAF.

Limit -> (long)

Ограничение на запросы во время указанного окна оценки для одного экземпляра агрегации для правила на основе скорости. Если оператор на основе скорости включает ScopeDownStatement , это ограничение применяется только к запросам, которые соответствуют оператору.

Примеры:

  • Если вы агрегируете только по IP-адресу, это ограничение на запросы с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это ограничение на запросы для любой одной пары метод-город.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в свои подсчеты запросов, оглядываясь назад от текущего времени. Например, для настройки 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые настройки: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а то, как далеко назад он смотрит каждый раз, когда проверяет. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 минут)

AggregateKeyType -> (string)

Настройка, указывающая, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегации, исключаются из оценки и обработки правила на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте запросы, соответствующие оператору сужения области действия правила на основе скорости. С этой опцией подсчитанные запросы больше не агрегируются. Оператор сужения области действия является единственной используемой спецификацией. Когда количество всех запросов, удовлетворяющих оператору сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим оператору сужения области действия. С этой опцией необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегации. С этой опцией необходимо указать ключи агрегации в свойстве CustomKeys . Чтобы выполнить агрегацию только по IP-адресу или только по перенаправленному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегации в IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. С этой опцией необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы выполнить агрегацию по комбинации перенаправленного IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы выполнить агрегацию по комбинации IP-адреса с другими ключами агрегации, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете перенаправленный IP-адрес в настройках ключа агрегации правила.

HeaderName -> (string)

Имя заголовка HTTP для использования для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите для него значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет допустимого IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные поведения:

  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать веб-запрос не соответствующим оператору правила.

CustomKeys -> (list)

Указывает агрегированные ключи для использования в правиле на основе частоты запросов.

(структура)

Указывает один пользовательский агрегированный ключ для правила на основе частоты запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правила на основе частоты запросов.

Header -> (структура)

Используйте значение заголовка в запросе в качестве агрегированного ключа. Каждое отдельное значение в заголовке вносит вклад в экземпляр агрегации. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя используемого заголовка.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты запросов для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным контентом, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

Cookie -> (structure)

Используйте значение cookie в запросе в качестве агрегированного ключа. Каждое отдельное значение в cookie вносит вклад в экземпляр агрегации. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя используемого cookie.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты запросов для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным контентом, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве агрегированного ключа. Каждое отдельное значение для указанного аргумента запроса вносит вклад в экземпляр агрегации. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

Name -> (string)

Имя используемого аргумента запроса.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты запросов для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным контентом, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

QueryString -> (structure)

Используйте строку запроса запроса в качестве агрегированного ключа. Каждая отдельная строка вносит вклад в экземпляр агрегации. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты запросов для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным контентом, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

HTTPMethod -> (structure)

Используйте метод HTTP запроса в качестве агрегированного ключа. Каждый отдельный метод HTTP вносит вклад в экземпляр агрегации. Если вы используете только метод HTTP в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегации.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве агрегированного ключа. Каждый отдельный перенаправленный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или перенаправленного IP-адреса в параметрах пользовательского ключа необходимо также указать как минимум еще один ключ для использования. Вы можете агрегировать только по перенаправленному IP-адресу, указав FORWARDED_IP в заявлении на основе частоты AggregateKeyType .

С помощью этого параметра необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила на основе частоты запросов.

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве агрегированного ключа. Каждый отдельный IP-адрес вносит вклад в экземпляр агрегации.

При указании IP-адреса или перенаправленного IP-адреса в параметрах пользовательского ключа необходимо также указать как минимум еще один ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в заявлении на основе частоты AggregateKeyType .

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве агрегированного ключа. Каждое отдельное полное имя метки, имеющее указанное пространство имен метки, вносит вклад в экземпляр агрегации. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегации.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются до этого правила на основе частоты запросов в веб-ACL.

Информацию о пространствах имен и именах меток см. в разделе Синтаксис меток и требования к именованию в Руководстве разработчика WAF .

Namespace -> (string)

Пространство имен для использования для агрегации.

UriPath -> (structure)

Используйте путь URI запроса в качестве агрегированного ключа. Каждый отдельный путь URI вносит вклад в экземпляр агрегации. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегации.

TextTransformations -> (list)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе частоты запросов для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования над указанным контентом, начиная с настройки самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(структура)

Текстовые преобразования устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

JA3Fingerprint -> (structure)

Используйте отпечаток пальца JA3 запроса в качестве агрегированного ключа. Если вы используете один отпечаток пальца JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегации.

FallbackBehavior -> (string)

Статус соответствия, назначаемый веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка пальца JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH — рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве пользовательского ключа, каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия для присвоения веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Вы можете указать следующие резервные поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

AndStatement -> (structure)

Логическое утверждение правила, используемое для объединения других утверждений правила с логикой И. Вы предоставляете более одного Statement в рамках AndStatement .

Statements -> (list)

Утверждения для объединения с логикой И. Вы можете использовать любые утверждения, которые могут быть вложены.

( … recursive … )

OrStatement -> (structure)

Логическое утверждение правила, используемое для объединения других утверждений правила с логикой ИЛИ. Вы предоставляете более одного Statement в рамках OrStatement .

Statements -> (list)

Утверждения для объединения с логикой ИЛИ. Вы можете использовать любые утверждения, которые могут быть вложены.

( … recursive … )

NotStatement -> (structure)

Логическое утверждение правила, используемое для отрицания результатов другого утверждения правила. Вы предоставляете одно Statement в рамках NotStatement .

( … recursive … )

ManagedRuleGroupStatement -> (structure)

Утверждение правила, используемое для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом утверждении. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups .

Нельзя вкладывать ManagedRuleGroupStatement , например, для использования внутри NotStatement или OrStatement . Нельзя использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на утверждение верхнего уровня в правиле, которое вы определяете в веб-ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet , управляемой группы правил WAF Fraud Control для предотвращения перехвата учетной записи (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control для предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet . Для получения дополнительной информации см. Цены WAF .

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия используемой управляемой группы правил. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию от поставщика, а затем сохраняет версию по умолчанию от поставщика, когда поставщик обновляет настройки управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылочной группе правил, действия которых установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любую допустимую настройку действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

( … recursive … )ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил для предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения и местоположения в полезной нагрузке запроса на создание учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил для предотвращения перехвата учетной записи. Конфигурация включает страницу входа в ваше приложение и местоположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил для предотвращения мошенничества при создании учетной записи. Конфигурация включает страницы регистрации и регистрации вашего приложения и местоположения в полезной нагрузке запроса на создание учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил для предотвращения перехвата учетной записи. Конфигурация включает страницу входа в ваше приложение и местоположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать для группы правил Bot Control.

Например, см. раздел примеров в CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификацией поля имени пользователя является /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем username1 , спецификацией поля имени пользователя является username1

PasswordField -> (structure)

Примечание

Вместо этой настройки укажите свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификацией поля пароля является /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом ввода с именем password1 , спецификацией поля пароля является password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. Группа правил WAF Bot Control и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки, который будет использоваться для группы правил Bot Control. Общий уровень - самый дешевый. Целевой уровень включает все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе Группа правил WAF Bot Control в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, использовать ли машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе список правил Bot Control в Руководстве разработчика WAF .

По умолчанию: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это, чтобы предоставить информацию о запросе на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Информацию об использовании управляемой группы правил ATP см. в разделе «Группа правил предотвращения захвата учетной записи (ATP) WAF Fraud Control» и «Предотвращение захвата учетной записи (ATP) WAF Fraud Control» в Руководстве разработчика WAF.

LoginPath -> (string)

Путь конечной точки входа для вашего приложения. Например, для URL-адреса https://example.com/web/login вы предоставите путь /web/login . Пути входа, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP-запросы POST к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезных данных для вашей конечной точки входа: JSON или форма с кодировкой.

UsernameField -> (structure)

Имя поля в полезных данных запроса, содержащего имя пользователя вашего клиента.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезных данных с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя — /form/username .
  • Для типов полезных данных с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезных данных запроса, содержащего пароль вашего клиента.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезных данных с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1 .

Identifier -> (string)

Имя поля пароля.

Способ указания зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля — /form/password .
  • Для типов полезных данных с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификация поля пароля — password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиента, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы из сеансов клиента и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным совпадением, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачной, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и сбоя. WAF может проверять первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP), AWSManagedRulesACFPRuleSet . Используйте это для предоставления информации о запросах на создание учетной записи группе правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив отвечает на запросы на создание учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. WAF Fraud Control account creation fraud prevention (ACFP) rule group и WAF Fraud Control account creation fraud prevention (ACFP) в Руководстве разработчика WAF.

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница вашего веб-сайта, которая принимает заполненную форму регистрации нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount вы предоставите путь /web/newaccount . Пути к страницам создания учетной записи, начинающиеся с указанного вами пути, считаются совпадением. Например /web/newaccount соответствует путям создания учетной записи /web/newaccount , /web/newaccount/ , /web/newaccountPage и /web/newaccount/thisPage , но не соответствует пути /home/web/newaccount или /website/newaccount .

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница вашего веб-сайта, на которой форма регистрации представляется новым пользователям.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL https://example.com/web/registration вы предоставите путь /web/registration . Пути к страницам регистрации, начинающиеся с указанного вами пути, считаются совпадением. Например /web/registration соответствует путям регистрации /web/registration , /web/registration/ , /web/registrationPage и /web/registration/thisPage , но не соответствует пути /home/web/registration или /website/registration .

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или закодированная форма.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя выглядит как /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя выглядит как username1

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя выглядит как /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя выглядит как username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля выглядит как /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля выглядит как /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

EmailField -> (structure)

Название поля в полезной нагрузке запроса, содержащего электронную почту вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты выглядит как /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты выглядит как email1 .

Identifier -> (string)

Имя поля электронной почты.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты выглядит как /form/email .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты выглядит как email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве в точном порядке, в котором они упорядочены в полезной нагрузке запроса.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 , и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 , идентификаторы полей номера телефона: primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного номера телефона.

Как вы указываете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона: /form/primaryphoneline1 , /form/primaryphoneline2 , и /form/primaryphoneline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 , идентификаторы полей номера телефона: primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, содержащих основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве в точном порядке, в котором они упорядочены в полезной нагрузке запроса.

Как вы указываете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса: /form/primaryaddressline1 , /form/primaryaddressline2 , и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 , идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя отдельного поля основного адреса.

Как вы указываете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса: /form/primaryaddressline1 , /form/primaryaddressline2 , и /form/primaryaddressline3 .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 , идентификаторы полей адреса: primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответов доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиента, подсчитывая успешные и неудачные попытки с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (структура)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (список)

Коды состояния в ответе, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (список)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (структура)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно точно соответствовать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (список)

Значения в заголовке ответа с указанным именем, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (список)

Значения в заголовке ответа с указанным именем, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (структура)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (список)

Строки в теле ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (список)

Строки в теле ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (структура)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (список)

Значения для указанного идентификатора в JSON ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (список)

Значения для указанного идентификатора в JSON ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

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

Примечание

Убедитесь, что имена правил в ваших перезаписях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку перезаписи.

Вы можете использовать перезаписи для тестирования, например, вы можете перезаписать все действия правил на Count и затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно перезаписывать некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(structure)

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

Примечание

Убедитесь, что имена правил в ваших перезаписях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку перезаписи.

Вы можете использовать перезаписи для тестирования, например, вы можете перезаписать все действия правил на Count и затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно перезаписывать некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для перезаписи.

Примечание

Убедитесь, что имена правил в ваших перезаписях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку перезаписи.

ActionToUse -> (structure)

Действие перезаписи, которое следует использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ на веб-запрос.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на текст ответа, который вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в значение «блокировать». Для этого сначала определите ключ и значение текста ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL настройке BlockAction, вы ссылаетесь на текст ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос и затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. раздел Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

LabelMatchStatement -> (structure)

Инструкция правила для сопоставления с метками, которые были добавлены в веб-запрос правилами, которые уже были запущены в веб-ACL.

Инструкция сопоставления меток предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю полностью квалифицированную имя метки, которая была добавлена в веб-запрос. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, добавившего метку. Если вы не предоставите полностью квалифицированное имя в строке сопоставления меток, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и инструкция сопоставления меток.

Scope -> (string)

Укажите, хотите ли вы выполнять сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope инструкции сопоставления:

  • Если Scope указывает LABEL , то это указание должно включать имя и может включать любое количество предыдущих спецификаций пространства имен и префикс до предоставления полного квалифицированного имени метки.
  • Если Scope указывает NAMESPACE , то это указание может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, и компоненты метки должны быть разделены двоеточием, например NS1:NS2:name .

RegexMatchStatement -> (structure)

Заявление правила, используемое для поиска в компонентах веб-запроса соответствия одному регулярному выражению.

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью Headers FieldToMatch setting.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может быть длиной до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync предел фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в разделе Body object configuration.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync предел фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить HTTP-метод. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync предел фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Информацию о том, как обрабатывать тела запросов большого размера, см. в разделе JsonBody object configuration.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов по критериям проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо эту настройку, либо настройку IncludedPaths , но не обе.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо эту настройку, либо настройку All , но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All .

(string)

MatchScope -> (string)

Части JSON, которые нужно сопоставить с помощью MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы соответствие было найдено в ключах, а соответствие было найдено в значениях. Для этого требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недопустимого JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительную информацию см. в разделе тело JSON в Руководство разработчика WAF .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync предел фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступное содержимое тела обычно, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с параметрами действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Он требует совпадения в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно одну настройку: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует совпадения в ключах и совпадения в значениях. Он требует совпадения в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

OversizeHandling -> (string)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента для сопоставления полей при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с установленным параметром PositionalConstraint в значение EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствие отпечатку пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с установленным параметром PositionalConstraint в значение EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Сведения о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Предоставьте строку отпечатка пальца JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры соответствия области действия и шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить, как обрабатывать любое содержимое фрагмента URI, превышающее размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как простой текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF будет анализировать и оценивать контент только до первой ошибки анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. Когда анализ успешен, WAF не применяет поведение при отказе. Для получения дополнительной информации см. JSON-тело в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

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

ManagedRuleGroupStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в управляемой группе правил. Чтобы использовать это, укажите имя поставщика и имя группы правил в этом операторе. Вы можете получить необходимые имена, вызвав ListAvailableManagedRuleGroups.

Вы не можете вкладывать ManagedRuleGroupStatement, например, для использования внутри NotStatement или OrStatement. Вы не можете использовать управляемую группу правил внутри другой группы правил. Вы можете ссылаться на управляемую группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

Примечание

С вас взимается дополнительная плата при использовании управляемой группы правил WAF Bot Control AWSManagedRulesBotControlRuleSet, управляемой группы правил WAF Fraud Control для предотвращения захвата учетной записи (ATP) AWSManagedRulesATPRuleSet или управляемой группы правил WAF Fraud Control для предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet. Для получения дополнительной информации см. WAF Pricing.

VendorName -> (string)

Имя поставщика управляемой группы правил. Вы используете это вместе с именем группы правил для идентификации группы правил.

Name -> (string)

Имя управляемой группы правил. Вы используете это вместе с именем поставщика для идентификации группы правил.

Version -> (string)

Версия управляемой группы правил для использования. Если вы укажете это, настройка версии будет фиксированной, пока вы ее не измените. Если вы не укажете это, WAF использует версию по умолчанию поставщика, а затем сохраняет версию по умолчанию поставщика при обновлении поставщиком настроек управляемой группы правил.

ExcludedRules -> (list)

Правила в ссылаемой группе правил, действия которых установлены на Count.

Примечание

Вместо этого параметра используйте RuleActionOverrides. Он принимает любые допустимые настройки действия, включая Count.

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count.

Примечание

Вместо этого параметра используйте RuleActionOverrides. Он принимает любые допустимые настройки действия, включая Count.

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count.

ScopeDownStatement -> (structure)

Необязательный вложенный оператор, который сужает область веб-запросов, которые оцениваются управляемой группой правил. Запросы оцениваются группой правил только в том случае, если они соответствуют оператору снижения области действия. Вы можете использовать любой вложенный оператор в операторе снижения области действия, и вы можете вкладывать операторы на любом уровне, так же, как и для оператора правила.

ByteMatchStatement -> (structure)

Оператор правила, определяющий поиск соответствия строк для WAF для применения к веб-запросам. Оператор байтового соответствия предоставляет байты для поиска, местоположение в запросах, в которых вы хотите, чтобы WAF искал, и другие настройки. Байты для поиска, как правило, представляют собой строку, которая соответствует символам ASCII. В консоли WAF и руководстве разработчика это называется оператором соответствия строк.

SearchString -> (blob)

Строковое значение, которое вы хотите, чтобы WAF искал. WAF выполняет поиск только в той части веб-запросов, которую вы указываете для проверки в FieldToMatch. Максимальная длина значения составляет 200 байт.

Допустимые значения зависят от компонента, который вы указываете для проверки в FieldToMatch:

  • Method: Метод HTTP, который вы хотите, чтобы WAF искал. Это указывает тип операции, указанной в запросе.
  • UriPath: Значение, которое вы хотите, чтобы WAF искал в пути URI, например /images/daily-ad.jpg.
  • JA3Fingerprint: Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставление с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. Вы можете использовать этот выбор только с соответствием строк ByteMatchStatement с установленным PositionalConstraint в EXACTLY. Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может рассчитать отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.
  • HeaderOrder: Список имен заголовков для сопоставления. WAF создает строку, которая содержит упорядоченный список имен заголовков из заголовков в веб-запросе, а затем выполняет сопоставление с этой строкой.

Если SearchString содержит буквенные символы A-Z и a-z, обратите внимание, что значение учитывает регистр.

Если вы используете API WAF

Укажите версию значения, закодированную в формате base64. Максимальная длина значения перед кодированием в формате base64 составляет 200 байт.

Например, предположим, что значение Type равно HEADER, а значение Data равно User-Agent. Если вы хотите выполнить поиск в заголовке User-Agent значения BadBot, вы кодируете BadBot с использованием MIME base64-кодирования и включаете полученное значение QmFkQm90 в значение SearchString.

Если вы используете CLI или один из пакетов SDK Amazon Web Services

Значение, которое вы хотите, чтобы WAF искал. SDK автоматически кодирует значение в формате base64.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (структура)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (структура)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (структура)

Проверьте все аргументы запроса.

UriPath -> (структура)

Проверьте путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (структура)

Проверьте строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (структура)

Проверьте тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверьте метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверьте тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов большого размера, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставьте все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Соответствует только указанным путям включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис указателя JSON. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления: одно для проверки ключей, а другое для проверки значений.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не укажете этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение отката. Для получения дополнительной информации см. Body JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса превышает лимит, базовый хост-сервис пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступное содержимое тела в обычном режиме, в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с настройками действия вашего правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Вы должны настроить фильтры сопоставления области и шаблона в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить, как обрабатывать любое содержимое заголовка большего размера в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверьте только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedHeaders -> (список)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков, которые необходимо сопоставить с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется совпадение в ключах или значениях или в обоих случаях. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND, чтобы объединить два правила сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Вы должны настроить фильтры сопоставления области и шаблона в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить, как обрабатывать любое содержимое файла cookie большего размера в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверьте только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(string)

ExcludedCookies -> (список)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie, которые необходимо проверить с критериями проверки правила. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется совпадение в ключах или значениях или в обоих случаях. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND, чтобы объединить два правила сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлов cookie запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента сопоставления полей в своей проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовков запроса больше или они больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, при котором PositionalConstraint установлено в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. Раздел Поля журналов в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement, при котором PositionalConstraint установлено в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. Раздел Поля журналов в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить с любыми будущими запросами, которые имеют ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус сопоставления, который необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого фрагмента URI сверхразмера в объекте UriFragment. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Доступны следующие варианты:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может завершиться успешно даже для недействительного JSON. Когда анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматирования, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве настраиваемых ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с настройки наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматирования, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Преобразования текста в Руководстве разработчика WAF .

PositionalConstraint -> (string)

Область внутри части веб-запроса, которую вы хотите, чтобы WAF искал SearchString . Допустимые значения включают следующее:

CONTAINS

Указанная часть веб-запроса должна включать значение SearchString , но местоположение не имеет значения.

CONTAINS_WORD

Указанная часть веб-запроса должна включать значение SearchString , а SearchString должен содержать только буквенно-цифровые символы или подчеркивание (A-Z, a-z, 0-9 или _). Кроме того, SearchString должно быть словом, что означает, что верно следующее:

  • SearchString находится в начале указанной части веб-запроса или ему предшествует символ, отличный от буквенно-цифрового символа или подчеркивания (_). Примеры включают значение заголовка и ;BadBot .
  • SearchString находится в конце указанной части веб-запроса или за ним следует символ, отличный от буквенно-цифрового символа или подчеркивания (_), например, BadBot; и -BadBot; .
EXACTLY

Значение указанной части веб-запроса должно точно соответствовать значению SearchString .

STARTS_WITH

Значение SearchString должно отображаться в начале указанной части веб-запроса.

ENDS_WITH

Значение SearchString должно отображаться в конце указанной части веб-запроса.

SqliMatchStatement -> (structure)

Оператор правила, который проверяет наличие вредоносного SQL-кода. Злоумышленники внедряют вредоносный SQL-код в веб-запросы, чтобы выполнять такие действия, как изменение вашей базы данных или извлечение данных из нее.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может быть длиной до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта Body.

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки превышения размера с вашими настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить исходный сервер.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения о том, как обрабатывать тела запросов большого размера, см. в конфигурации объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Необходимо указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Необходимо указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое AND оператор для объединения двух правил соответствия: одно для проверки ключей, а другое для проверки значений.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF выполняет синтаксический анализ и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе тело JSON в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовый хост-сервис пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки превышения размера с вашими настройками действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует обнаружения соответствия в ключах и обнаружения соответствия в значениях. Требуется обнаружение соответствия в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует обнаружения соответствия в ключах и обнаружения соответствия в значениях. Требуется обнаружение соответствия в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и значениях, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое - значения.

OversizeHandling -> (string)

Что WAF следует делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF создает строку, а затем использует ее в качестве компонента поля для сопоставления в своей проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF следует делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Параметры обработки больших размеров следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие резервные режимы:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток пальца служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток пальца для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток пальца, он включает его в журналы. Для получения информации о полях ведения журнала см. раздел «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами, имеющими ту же конфигурацию TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие резервные режимы:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверьте фрагменты URI запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Доступны следующие параметры:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF будет анализировать и оценивать содержимое только до первой встреченной им ошибки синтаксического анализа.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Анализ WAF не полностью проверяет входную строку JSON, поэтому анализ может быть успешным даже для недействительного JSON. При успешном анализе WAF не применяет резервное поведение. Дополнительную информацию см. в разделе «Тело JSON» в Руководстве разработчика WAF .

TextTransformations -> (list)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах сопоставления правил для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы указываете одно или несколько преобразований для применения, WAF выполняет все преобразования указанного контента, начиная с самой низкой настройки приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого типа преобразования см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

SensitivityLevel -> (string)

Уровень чувствительности, который вы хотите, чтобы WAF использовал для проверки атак с внедрением SQL.

HIGH обнаруживает больше атак, но может генерировать больше ложных срабатываний, особенно если ваши веб-запросы часто содержат необычные строки. Информацию о выявлении и смягчении последствий ложных срабатываний см. в разделе Тестирование и настройка в Руководстве разработчика WAF .

LOW обычно является лучшим выбором для ресурсов, которые уже имеют другие средства защиты от атак с внедрением SQL или имеют низкую толерантность к ложным срабатываниям.

По умолчанию: LOW

XssMatchStatement -> (structure)

Оператор правила, который проверяет наличие атак межсайтового скриптинга (XSS). При XSS-атаках злоумышленник использует уязвимости на безобидном веб-сайте в качестве средства для внедрения вредоносных клиентских скриптов в другие законные веб-браузеры.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не чувствительна к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете отфильтровать и проверить все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения об обработке тел запросов, превышающих размер, см. в конфигурации объекта Body .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки переразмеров с вашими параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка метода HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса непосредственно следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Сведения об обработке тел запросов, превышающих размер, см. в конфигурации объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо эту настройку, либо настройку IncludedPaths , но не обе.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо эту настройку, либо настройку All , но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern. Если вы укажете ALL, WAF выполнит сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое утверждение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Если вы не предоставите эту настройку, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF синтаксический анализ не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недопустимого JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Дополнительные сведения см. в разделе «Тело JSON» в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что WAF должен делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая хост-служба пересылает только содержимое, находящееся в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительную плату за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки переразмеров следующие:

  • CONTINUE - Обычно проверяйте доступное содержимое тела в соответствии с критериями проверки правил.
  • MATCH - Считать веб-запрос соответствующим оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Считать, что веб-запрос не соответствует оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки переразмеров с вашими параметрами действий правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Вы должны настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить способ обработки содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверьте все заголовки.

IncludedHeaders -> (список)

Проверяйте только заголовки, у которых ключ соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверяйте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Он требует, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Вы должны настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить способ обработки содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Вы должны указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверьте все файлы cookie.

IncludedCookies -> (список)

Проверяйте только файлы cookie, у которых ключ соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверяйте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если вы укажете ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Он требует, чтобы совпадение было найдено в ключах, в значениях или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки больших размеров следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который содержит достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот выбор только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если у запроса нет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Вы должны настроить фильтры сопоставления области и шаблона в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI передаются в WAF для проверки базовой службой хоста. Вы должны настроить обработку содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью разобрать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может быть успешным даже для недействительного JSON. Когда синтаксический анализ успешен, WAF не применяет резервное поведение. Для получения дополнительной информации см. Тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, и они используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования указанного содержимого, начиная с самой низкой приоритетности, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробное описание каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

SizeConstraintStatement -> (structure)

Оператор правила, который сравнивает количество байтов с размером компонента запроса, используя оператор сравнения, например, больше (>) или меньше (<). Например, можно использовать оператор ограничения размера для поиска строк запроса, длина которых превышает 100 байт.

Если настроить WAF для проверки тела запроса, WAF проверяет только количество байтов в теле до предела для типа веб-ACL и защищенного ресурса. Если вы знаете, что тело запроса для ваших веб-запросов никогда не должно превышать предел проверки, вы можете использовать оператор ограничения размера для блокировки запросов с большим размером тела запроса. Для получения дополнительной информации об ограничениях проверки см. параметры Body и JsonBody для типа данных FieldToMatch.

Если вы выберете URI для значения параметра Часть запроса для фильтрации, косая черта (/) в URI учитывается как один символ. Например, URI /logo.jpg имеет длину девять символов.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверка одного заголовка. Укажите имя заголовка для проверки, например, User-Agent или Referer. Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, можно фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверка одного аргумента запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion. Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверка всех аргументов запроса.

UriPath -> (structure)

Проверка пути URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg.

QueryString -> (structure)

Проверка строки запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверка тела запроса как обычного текста. Тело запроса сразу следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации об обработке больших тел запросов см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверка метода HTTP. Метод указывает тип операции, которую запрос просит выполнить origin.

JsonBody -> (structure)

Проверка тела запроса как JSON. Тело запроса сразу следует за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации об обработке больших тел запросов см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody.

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody.

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"]. Для получения информации об этом синтаксисе см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer.

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern. Если вы укажете ALL, WAF сопоставляет ключи и значения.

All не требует нахождения соответствия в ключах и нахождения соответствия в значениях. Требуется, чтобы соответствие было найдено в ключах или значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логическое выражение AND для объединения двух правил соответствия: одного, которое проверяет ключи, а другого, которое проверяет значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF.

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки больших размеров с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые проверяет WAF.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка превышающего размер в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверьте все заголовки.

IncludedHeaders -> (список)

Проверяйте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверяйте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если вы укажете ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или и том, и другом. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовка.

Параметры для обработки превышения размера следующие:

  • CONTINUE - Проверяйте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры области действия и сопоставления шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файла cookie превышающего размер в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверьте все файлы cookie.

IncludedCookies -> (список)

Проверяйте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверяйте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (строка)

Части файлов cookie для проверки с критериями проверки правила. Если вы укажете ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах, значениях или и том, и другом. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND для объединения двух правил сопоставления: одно проверяет ключи, а другое — значения.

OversizeHandling -> (строка)

Что должен делать WAF, если файлы cookie запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает в WAF максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie.

Параметры для обработки превышения размера следующие:

  • CONTINUE - Проверяйте доступные файлы cookie в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве компонента для сопоставления поля при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавления пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что должен делать WAF, если заголовки запроса более многочисленны или больше, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запросов, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает в WAF максимум 200 заголовков и не более 8 КБ содержимого заголовка.

Параметры для обработки превышения размера следующие:

  • CONTINUE - Проверяйте доступные заголовки в обычном режиме в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-символьный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, имеющего достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить область действия и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Возможны следующие варианты:

  • EVALUATE_AS_STRING — Проверьте тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к текстовой строке тела.
  • MATCH — Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, которую он обнаружит.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

ComparisonOperator -> (string)

Оператор, используемый для сравнения части запроса с настройкой размера.

Size -> (long)

Размер в байтах для сравнения с частью запроса после любых преобразований.

TextTransformations -> (list)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с самой низкой приоритетной настройки, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста устраняют некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, пытаясь обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе «Преобразования текста» в Руководстве разработчика WAF.

GeoMatchStatement -> (structure)

Оператор правила, который помечает веб-запросы по стране и региону и который сопоставляет веб-запросы на основе кода страны. Правило соответствия географическим данным помечает каждый проверяемый запрос независимо от того, находит ли оно соответствие.

  • Чтобы управлять запросами только по стране, вы можете использовать этот оператор сам по себе и указать страны, с которыми вы хотите сопоставить, в массиве CountryCodes.
  • В противном случае настройте правило соответствия географическим данным с действием Count, чтобы оно только помечало запросы. Затем добавьте одно или несколько правил соответствия меткам, чтобы они запускались после правила соответствия географическим данным, и настройте их для сопоставления с географическими метками и обработки запросов по мере необходимости.

WAF помечает запросы, используя двухбуквенные коды стран и регионов из международного стандарта организации по стандартизации (ISO) 3166. WAF определяет коды, используя либо IP-адрес в источнике веб-запроса, либо, если вы укажете его, адрес в соответствии с географическими данными ForwardedIPConfig.

Если вы используете источник веб-запроса, форматы меток — awswaf:clientip:geo:region:<ISO country code>-<ISO region code> и awswaf:clientip:geo:country:<ISO country code>.

Если вы используете переадресованный IP-адрес, форматы меток — awswaf:forwardedip:geo:region:<ISO country code>-<ISO region code> и awswaf:forwardedip:geo:country:<ISO country code>.

Дополнительные сведения см. в разделе «Оператор правила соответствия географическим данным» в Руководстве разработчика WAF.

CountryCodes -> (list)

Массив двухбуквенных кодов стран, с которыми вы хотите сопоставить, например [ "US", "CN" ], из двухбуквенных кодов стран международного стандарта ISO 3166.

Когда вы используете оператор соответствия географическим данным только для меток региона и страны, которые он добавляет к запросам, вам все равно необходимо предоставить код страны для оценки правила. В этом случае вы настраиваете правило только для подсчета соответствующих запросов, но оно все равно будет создавать журналы и показатели подсчета для любых совпадений. Вы можете уменьшить количество журналов и показателей, которые создает правило, указав страну, которая вряд ли будет источником трафика на ваш сайт.

(string)

ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите это значение в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные варианты поведения:

  • MATCH — Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH — Рассматривать веб-запрос как не соответствующий оператору правила.

RuleGroupReferenceStatement -> (structure)

Оператор правила, используемый для запуска правил, определенных в RuleGroup. Чтобы использовать его, создайте группу правил с вашими правилами, а затем предоставьте ARN группы правил в этом операторе.

Вы не можете вкладывать RuleGroupReferenceStatement , например, для использования внутри NotStatement или OrStatement . Вы не можете использовать оператор ссылки на группу правил внутри другой группы правил. Вы можете ссылаться на группу правил только как на оператор верхнего уровня в правиле, которое вы определяете в веб-ACL.

ARN -> (string)

Имя ресурса Amazon (ARN) сущности.

ExcludedRules -> (list)

Правила в указанной группе правил, для которых действия установлены в Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любые допустимые параметры действий, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого варианта используйте RuleActionOverrides . Он принимает любые допустимые параметры действий, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Не забудьте проверить имена правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правила на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(structure)

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

Примечание

Не забудьте проверить имена правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правила на Count , а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

Не забудьте проверить имена правил в ваших переопределениях. Если вы предоставите имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит параметр переопределения.

ActionToUse -> (structure)

Действие переопределения, которое следует использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ на веб-запрос.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP, который необходимо вернуть клиенту.

Список кодов состояния, которые можно использовать в пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Указывает ссылку на тело ответа, которое WAF должен вернуть клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено на блокировку. Для этого сначала определите ключ и значение тела ответа в параметре CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем в действии правила или действии по умолчанию веб-ACL BlockAction вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP, которые необходимо использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру пользовательских параметров запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру пользовательских параметров запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру пользовательских параметров запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру пользовательских параметров запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка Challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP, которые необходимо вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру пользовательских параметров запросов и ответов см. Квоты WAF в Руководстве разработчика WAF .

(structure)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Он используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение пользовательского заголовка.

IPSetReferenceStatement -> (structure)

Инструкция правила, используемая для обнаружения веб-запросов, поступающих с определенных IP-адресов или диапазонов адресов. Чтобы использовать это, создайте IPSet, который указывает адреса, которые вы хотите обнаружить, затем используйте ARN этого набора в этом выражении. Чтобы создать набор IP, см. CreateIPSet.

Каждое выражение правила IP-набора ссылается на IP-набор. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые на него ссылаются.

ARN -> (string)

Amazon Resource Name (ARN) IPSet, на который ссылается это выражение.

IPSetForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в указанном вами заголовке HTTP вместо использования IP-адреса, сообщаемого источником веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

HeaderName -> (string)

Имя заголовка HTTP для использования IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите его в X-Forwarded-For.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если запрос не содержит действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие резервные варианты:

  • MATCH - Рассматривать веб-запрос как соответствующий выражению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий выражению правила.

Position -> (string)

Позиция в заголовке для поиска IP-адреса. Заголовок может содержать IP-адреса исходного клиента, а также прокси-серверов. Например, значение заголовка может быть 10.1.1.1, 127.0.0.0, 10.10.10.10, где первый IP-адрес идентифицирует исходного клиента, а остальные идентифицируют прокси-серверы, через которые прошел запрос.

Варианты этой настройки следующие:

  • FIRST - Проверить первый IP-адрес в списке IP-адресов в заголовке. Обычно это исходный IP-адрес клиента.
  • LAST - Проверить последний IP-адрес в списке IP-адресов в заголовке.
  • ANY - Проверить все IP-адреса в заголовке на соответствие. Если заголовок содержит более 10 IP-адресов, WAF проверяет последние 10.

RegexPatternSetReferenceStatement -> (structure)

Оператор правила, используемый для поиска соответствий веб-компонентов запроса с регулярными выражениями. Чтобы использовать это, создайте RegexPatternSet, который указывает выражения, которые вы хотите обнаружить, затем используйте ARN этого набора в этом операторе. Веб-запрос соответствует оператору правила набора шаблонов, если компонент запроса соответствует любому из шаблонов в наборе. Чтобы создать набор шаблонов регулярных выражений, см. CreateRegexPatternSet .

Каждый оператор правила набора шаблонов регулярных выражений ссылается на набор шаблонов регулярных выражений. Вы создаете и поддерживаете набор независимо от ваших правил. Это позволяет вам использовать один набор в нескольких правилах. При обновлении ссылочного набора WAF автоматически обновляет все правила, которые ссылаются на него.

ARN -> (string)

Имя ресурса Amazon (ARN) набора RegexPatternSet, на который ссылается этот оператор.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не чувствителен к регистру.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не чувствительно к регистру.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это та часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать чрезмерно большие тела запросов, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступного содержимого тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с вашими настройками правил и действий веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника для выполнения.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать чрезмерно большие тела запросов, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths , но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Информацию об этом синтаксисе см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All , но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и в значениях, используйте логическое оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое - значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing doesn’t fully validate the input JSON string, so parsing can succeed even for invalid JSON. When parsing succeeds, WAF doesn’t apply the fallback behavior. For more information, see JSON body in the WAF Developer Guide .

OversizeHandling -> (string)

Что WAF следует делать, если тело больше, чем WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки больших размеров следующие:

  • CONTINUE - Обычная проверка доступного содержимого тела в соответствии с критериями проверки правил.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете комбинировать параметры MATCH или NO_MATCH для обработки больших размеров с вашими настройками правил и действий веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (structure)

Проверить все заголовки.

IncludedHeaders -> (list)

Проверьте только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (list)

Проверьте только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки негабаритного содержимого следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Cookies -> (structure)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого файла cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (structure)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (structure)

Проверить все файлы cookie.

IncludedCookies -> (list)

Проверьте только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (list)

Проверьте только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правила. Если указать ALL, WAF проверяет и ключи, и значения.

All не требует, чтобы совпадение было найдено в ключах, а совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или в значениях, или в обоих. Чтобы требовать соответствия ключам и значениям, используйте логическое выражение AND для объединения двух правил соответствия, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файла cookie в WAF.

Варианты обработки негабаритного содержимого следующие:

  • CONTINUE - Проверьте доступные файлы cookie в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

HeaderOrder -> (structure)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том виде, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонентов при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовка в WAF.

Варианты обработки негабаритного содержимого следующие:

  • CONTINUE - Проверьте доступные заголовки в обычном режиме, в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA3Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот выбор можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если у запроса нет отпечатка JA3.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Соответствует отпечатку JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором конфигурации TLS клиента. WAF вычисляет и регистрирует этот отпечаток для каждого запроса, у которого достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Этот выбор можно использовать только с сопоставлением строк ByteMatchStatement с PositionalConstraint, установленным в EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который необходимо назначить веб-запросу, если у запроса нет отпечатка JA4.

Вы можете указать следующие резервные варианты поведения:

  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

UriFragment -> (structure)

Проверяет фрагменты URI запроса. Вы должны настроить область действия и фильтры сопоставления шаблонов в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Вы должны настроить, как обрабатывать содержимое фрагментов URI большого размера в объекте UriFragment. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если ему не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF выполнит синтаксический анализ и оценит содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для неверного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение отката. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

TextTransformations -> (list)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегации. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с самого низкого приоритета, а затем использует преобразованное содержимое компонента.

(structure)

Преобразования текста исключают некоторое необычное форматирование, которое злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Text transformations в Руководстве разработчика WAF .

RateBasedStatement -> (structure)

Правило на основе скорости подсчитывает входящие запросы и ограничивает запросы, когда они поступают со слишком высокой скоростью. Правило классифицирует запросы в соответствии с вашими критериями агрегирования, собирает их в экземпляры агрегирования, а также подсчитывает и ограничивает скорость запросов для каждого экземпляра.

Примечание

Если вы измените какие-либо из этих настроек в используемом в данный момент правиле, изменение сбросит счетчики ограничения скорости правила. Это может приостановить действия по ограничению скорости правила на срок до одной минуты.

Вы можете указать отдельные ключи агрегирования, такие как IP-адрес или метод HTTP. Вы также можете указать комбинации ключей агрегирования, такие как IP-адрес и метод HTTP, или метод HTTP, аргумент запроса и cookie.

Каждый уникальный набор значений для указанных вами ключей агрегирования является отдельным экземпляром агрегирования, при этом значение каждого ключа вносит вклад в определение экземпляра агрегирования.

Например, предположим, что правило оценивает веб-запросы со следующими значениями IP-адреса и метода HTTP:

  • IP-адрес 10.1.1.1, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET
  • IP-адрес 127.0.0.0, метод HTTP POST
  • IP-адрес 10.1.1.1, метод HTTP GET

Правило создаст разные экземпляры агрегирования в соответствии с вашими критериями агрегирования, например:

  • Если критерием агрегирования является только IP-адрес, то каждый отдельный адрес является экземпляром агрегирования, и WAF подсчитывает запросы отдельно для каждого. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1: счет 3
    • IP-адрес 127.0.0.0: счет 1
  • Если критерием агрегирования является метод HTTP, то каждый отдельный метод HTTP является экземпляром агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • Метод HTTP POST: счет 2
    • Метод HTTP GET: счет 2
  • Если критерием агрегирования является IP-адрес и метод HTTP, то каждый IP-адрес и каждый метод HTTP будут вносить вклад в объединенный экземпляр агрегирования. Экземпляры агрегирования и количество запросов для нашего примера будут следующими:
    • IP-адрес 10.1.1.1, метод HTTP POST: счет 1
    • IP-адрес 10.1.1.1, метод HTTP GET: счет 2
    • IP-адрес 127.0.0.0, метод HTTP POST: счет 1

Для любого n-кортежа ключей агрегирования каждая уникальная комбинация значений для ключей определяет отдельный экземпляр агрегирования, который WAF подсчитывает и ограничивает по скорости индивидуально.

При желании вы можете вложить другое утверждение в утверждение на основе скорости, чтобы сузить область действия правила, чтобы оно подсчитывало и ограничивало скорость только запросов, соответствующих вложенному утверждению. Вы можете использовать это вложенное утверждение для сужения области действия в сочетании со спецификациями вашего ключа агрегирования или просто подсчитывать и ограничивать скорость всех запросов, соответствующих утверждению для сужения области действия, без дополнительного агрегирования. Когда вы решите просто управлять всеми запросами, соответствующими утверждению для сужения области действия, экземпляр агрегирования является единственным для правила.

Вы не можете вложить RateBasedStatement в другое утверждение, например, в NotStatement или OrStatement . Вы можете определить RateBasedStatement внутри списка управления веб-доступом и внутри группы правил.

Для получения дополнительной информации о параметрах см. раздел «Ограничение скорости веб-запросов с помощью правил на основе скорости» в Руководстве разработчика WAF .

Если вы агрегируете только по отдельному IP-адресу или пересланному IP-адресу, вы можете получить список IP-адресов, которые WAF в настоящее время ограничивает по скорости для правила, с помощью вызова API GetRateBasedStatementManagedKeys . Эта опция недоступна для других конфигураций агрегирования.

WAF отслеживает и управляет веб-запросами отдельно для каждого экземпляра правила на основе скорости, которое вы используете. Например, если вы предоставите одни и те же настройки правила на основе скорости в двух списках управления веб-доступом, каждое из двух утверждений правила представляет собой отдельный экземпляр правила на основе скорости и получает собственное отслеживание и управление со стороны WAF. Если вы определяете правило на основе скорости внутри группы правил, а затем используете эту группу правил в нескольких местах, каждое использование создает отдельный экземпляр правила на основе скорости, который получает собственное отслеживание и управление со стороны WAF.

Limit -> (long)

Лимит на запросы во время указанного окна оценки для одного экземпляра агрегирования для правила на основе скорости. Если утверждение на основе скорости включает ScopeDownStatement , это ограничение применяется только к запросам, соответствующим утверждению.

Примеры:

  • Если вы агрегируете только по IP-адресу, это ограничение на запросы с любого одного IP-адреса.
  • Если вы агрегируете по методу HTTP и имени аргумента запроса «city», то это ограничение на запросы для любой одной пары method, city.

EvaluationWindowSec -> (long)

Количество времени в секундах, которое WAF должен включать в свои подсчеты запросов, оглядываясь назад от текущего времени. Например, для настройки 120, когда WAF проверяет скорость, он подсчитывает запросы за 2 минуты, непосредственно предшествующие текущему времени. Допустимые настройки: 60, 120, 300 и 600.

Эта настройка не определяет, как часто WAF проверяет скорость, а показывает, как далеко назад он смотрит при каждой проверке. WAF проверяет скорость примерно каждые 10 секунд.

По умолчанию: 300 (5 минут)

AggregateKeyType -> (string)

Настройка, которая указывает, как агрегировать количество запросов.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правил на основе скорости.
  • CONSTANT - Подсчитывайте и ограничивайте запросы, соответствующие утверждению сужения области действия правила на основе скорости. При использовании этого параметра подсчитанные запросы не агрегируются дополнительно. Утверждение сужения области действия — единственная используемая спецификация. Когда количество всех запросов, удовлетворяющих утверждению сужения области действия, превышает лимит, WAF применяет действие правила ко всем запросам, удовлетворяющим утверждению сужения области действия. При использовании этого параметра необходимо настроить свойство ScopeDownStatement .
  • CUSTOM_KEYS - Агрегируйте количество запросов, используя один или несколько компонентов веб-запроса в качестве ключей агрегирования. При использовании этого параметра необходимо указать ключи агрегирования в свойстве CustomKeys . Чтобы выполнить агрегирование только по IP-адресу или только по пересланному IP-адресу, не используйте пользовательские ключи. Вместо этого установите тип ключа агрегирования в значение IP или FORWARDED_IP .
  • FORWARDED_IP - Агрегируйте количество запросов по первому IP-адресу в заголовке HTTP. При использовании этого параметра необходимо указать заголовок для использования в свойстве ForwardedIPConfig . Чтобы выполнить агрегирование по комбинации пересланного IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .
  • IP - Агрегируйте количество запросов по IP-адресу из источника веб-запроса. Чтобы выполнить агрегирование по комбинации IP-адреса с другими ключами агрегирования, используйте CUSTOM_KEYS .

( … recursive … )ForwardedIPConfig -> (structure)

Конфигурация для проверки IP-адресов в заголовке HTTP, который вы указываете, вместо использования IP-адреса, о котором сообщает источник веб-запроса. Обычно это заголовок X-Forwarded-For (XFF), но вы можете указать любое имя заголовка.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Это необходимо, если вы указываете пересланный IP-адрес в настройках ключа агрегирования правила.

HeaderName -> (string)

Имя заголовка HTTP, который следует использовать для IP-адреса. Например, чтобы использовать заголовок X-Forwarded-For (XFF), установите его в значение X-Forwarded-For .

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

FallbackBehavior -> (string)

Состояние соответствия, которое необходимо присвоить веб-запросу, если запрос не имеет действительного IP-адреса в указанной позиции.

Примечание

Если указанный заголовок отсутствует в запросе, WAF вообще не применяет правило к веб-запросу.

Вы можете указать следующие варианты поведения при отступлении:

  • MATCH - Рассматривайте веб-запрос как соответствующий утверждению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий утверждению правила.

CustomKeys -> (list)

Указывает совокупные ключи, используемые в правиле с ограничением скорости.

(структура)

Указывает один пользовательский совокупный ключ для правила с ограничением скорости.

Примечание

Веб-запросы, в которых отсутствуют какие-либо компоненты, указанные в ключах агрегирования, исключаются из оценки и обработки правил с ограничением скорости.

Header -> (структура)

Используйте значение заголовка в запросе в качестве совокупного ключа. Каждое отдельное значение в заголовке способствует созданию экземпляра агрегирования. Если вы используете один заголовок в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя используемого заголовка.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил с ограничением скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations в WAF Developer Guide .

Cookie -> (структура)

Используйте значение cookie в запросе в качестве совокупного ключа. Каждое отдельное значение в cookie способствует созданию экземпляра агрегирования. Если вы используете один cookie в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя используемого cookie.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил с ограничением скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations в WAF Developer Guide .

QueryArgument -> (structure)

Используйте указанный аргумент запроса в качестве совокупного ключа. Каждое отдельное значение для именованного аргумента запроса способствует созданию экземпляра агрегирования. Если вы используете один аргумент запроса в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

Name -> (string)

Имя используемого аргумента запроса.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил с ограничением скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations в WAF Developer Guide .

QueryString -> (structure)

Используйте строку запроса запроса в качестве совокупного ключа. Каждая отдельная строка способствует созданию экземпляра агрегирования. Если вы используете только строку запроса в качестве пользовательского ключа, то каждая строка полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил с ограничением скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations в WAF Developer Guide .

HTTPMethod -> (structure)

Используйте метод HTTP запроса в качестве совокупного ключа. Каждый отдельный метод HTTP способствует созданию экземпляра агрегирования. Если вы используете только метод HTTP в качестве пользовательского ключа, то каждый метод полностью определяет экземпляр агрегирования.

ForwardedIP -> (structure)

Используйте первый IP-адрес в заголовке HTTP в качестве совокупного ключа. Каждый отдельный перенаправленный IP-адрес способствует созданию экземпляра агрегирования.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в параметрах пользовательского ключа, вы также должны указать по крайней мере еще один ключ для использования. Вы можете агрегировать только по перенаправленному IP-адресу, указав FORWARDED_IP в AggregateKeyType вашего правила с ограничением скорости.

С этим параметром необходимо указать заголовок для использования в свойстве ForwardedIPConfig правила с ограничением скорости.

IP -> (structure)

Используйте исходный IP-адрес запроса в качестве совокупного ключа. Каждый отдельный IP-адрес способствует созданию экземпляра агрегирования.

Когда вы указываете IP-адрес или перенаправленный IP-адрес в параметрах пользовательского ключа, вы также должны указать по крайней мере еще один ключ для использования. Вы можете агрегировать только по IP-адресу, указав IP в AggregateKeyType вашего правила с ограничением скорости.

LabelNamespace -> (structure)

Используйте указанное пространство имен метки в качестве совокупного ключа. Каждое отдельное полное имя метки, которое имеет указанное пространство имен метки, способствует созданию экземпляра агрегирования. Если вы используете только одно пространство имен метки в качестве пользовательского ключа, то каждое имя метки полностью определяет экземпляр агрегирования.

Это использует только метки, которые были добавлены в запрос правилами, которые оцениваются до этого правила с ограничением скорости в веб-ACL.

Для получения информации о пространствах имен и именах меток см. Label syntax and naming requirements в WAF Developer Guide .

Namespace -> (string)

Используемое пространство имен для агрегирования.

UriPath -> (structure)

Используйте путь URI запроса в качестве совокупного ключа. Каждый отдельный путь URI способствует созданию экземпляра агрегирования. Если вы используете только путь URI в качестве пользовательского ключа, то каждый путь URI полностью определяет экземпляр агрегирования.

TextTransformations -> (list)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил с ограничением скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования над указанным содержимым, начиная с наименьшего приоритета, а затем использует содержимое преобразованного компонента.

(структура)

Преобразования текста устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразования см. в разделе Text transformations в WAF Developer Guide .

JA3Fingerprint -> (structure)

Используйте отпечаток JA3 запроса в качестве совокупного ключа. Если вы используете один отпечаток JA3 в качестве пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия, который необходимо присвоить веб-запросу, если недостаточно информации TLS Client Hello для вычисления отпечатка JA3.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

JA4Fingerprint -> (structure)

Используйте отпечаток JA4 запроса в качестве агрегированного ключа. Если вы используете один отпечаток JA4 в качестве своего пользовательского ключа, то каждое значение полностью определяет экземпляр агрегирования.

FallbackBehavior -> (string)

Статус соответствия, который нужно присвоить веб-запросу, если недостаточно информации TSL Client Hello для вычисления отпечатка JA4.

Вы можете указать следующие варианты поведения при отказе:

  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

AndStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правила с логикой И. Вы предоставляете более одного оператора в пределах AndStatement .

Statements -> (list)

Операторы для объединения с логикой И. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

OrStatement -> (structure)

Логический оператор правила, используемый для объединения других операторов правила с логикой ИЛИ. Вы предоставляете более одного оператора в пределах OrStatement .

Statements -> (list)

Операторы для объединения с логикой ИЛИ. Вы можете использовать любые операторы, которые могут быть вложены.

( … recursive … )

NotStatement -> (structure)

Логический оператор правила, используемый для отрицания результатов другого оператора правила. Вы предоставляете один оператор в пределах NotStatement .

( … recursive … )

( … recursive … )LabelMatchStatement -> (structure)

Оператор правила для сопоставления с метками, которые были добавлены в веб-запрос правилами, которые уже были запущены в веб-ACL.

Оператор соответствия метки предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю полностью квалифицированную имя метки, которое было добавлено в веб-запрос. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс идентифицирует группу правил или контекст веб-ACL правила, которое добавило метку. Если вы не предоставите полностью квалифицированное имя в строке соответствия метки, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и оператор соответствия метки.

Scope -> (string)

Укажите, хотите ли вы выполнить сопоставление, используя имя метки или только пространство имен.

Key -> (string)

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope оператора сопоставления:

  • Если Scope указывает LABEL , то эта спецификация должна включать имя и может включать любое количество предшествующих спецификаций пространства имен и префикс до предоставления полностью квалифицированного имени метки.
  • Если Scope указывает NAMESPACE , то эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен метки из группы правил или веб-ACL, откуда берется метка.

Метки чувствительны к регистру, и компоненты метки должны быть разделены двоеточием, например NS1:NS2:name .

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверил.

SingleHeader -> (structure)

Проверьте один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Этот параметр не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Альтернативно, вы можете фильтровать и проверять все заголовки с помощью параметра Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверьте один аргумент запроса. Укажите имя аргумента запроса для проверки, например, UserName или SalesRegion . Имя может быть длиной до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ?, если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта Body.

OversizeHandling -> (string)

Что должен делать WAF, если размер тела превышает возможности WAF для проверки.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос просит выполнить источник.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например, данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Для получения информации о том, как обрабатывать тела запросов, превышающие размер, см. конфигурацию объекта JsonBody.

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов в соответствии с критериями проверки правил.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо этот параметр, либо параметр IncludedPaths, но не оба.

IncludedPaths -> (list)

Сопоставить только указанные пути включения. См. также MatchScope в JsonBody .

Предоставьте пути включения, используя синтаксис JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Для получения информации об этом синтаксисе см. документацию Рабочей группы Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо этот параметр, либо параметр All, но не оба.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте параметр All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с помощью MatchPattern . Если вы укажете ALL, WAF выполняет сопоставление с ключами и значениями.

All не требует, чтобы совпадение было найдено в ключах, а совпадение — в значениях. Требуется, чтобы совпадение было найдено в ключах, или в значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое оператор AND для объединения двух правил сопоставления: одного, который проверяет ключи, и другого, который проверяет значения.

InvalidFallbackBehavior -> (string)

Что должен делать WAF, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing не полностью проверяет входную строку JSON, поэтому синтаксический анализ может пройти даже для недействительного JSON. Когда синтаксический анализ выполнен успешно, WAF не применяет резервное поведение. Для получения дополнительной информации см. JSON body в Руководстве разработчика WAF .

OversizeHandling -> (string)

Что должен делать WAF, если размер тела превышает возможности WAF для проверки.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если тело превышает лимит для типа ресурса. Когда тело веб-запроса больше лимита, базовая служба хоста пересылает только содержимое, которое находится в пределах лимита, в WAF для проверки.

  • Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access, лимит по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить лимит для каждого типа ресурса в веб-ACL AssociationConfig , за дополнительные сборы за обработку.
  • Для Amplify используйте лимит CloudFront.

Варианты обработки превышения размера следующие:

  • CONTINUE - Обычно проверять доступное содержимое тела в соответствии с критериями проверки правила.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Вы можете объединить параметры MATCH или NO_MATCH для обработки превышения размера с настройками действия вашего правила и веб-ACL, чтобы блокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры сопоставления области и шаблонов в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовка, превышающего размер, в объекте Headers. WAF применяет фильтры сопоставления шаблонов к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders или ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части заголовков для сопоставления с критериями проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса больше по количеству или размеру, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры сопоставления области и шаблонов в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые проверяет WAF.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies или ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из строк, указанных здесь.

(строка)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из строк, указанных здесь.

(строка)

MatchScope -> (строка)

Части файлов cookie для проверки с помощью критериев проверки правила. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Требуется, чтобы совпадение было найдено в ключах или значениях, или в обоих. Чтобы требовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления: одно, которое проверяет ключи, и другое, которое проверяет значения.

OversizeHandling -> (строка)

Что WAF следует делать, если файлы cookie запроса больше по количеству или размеру, чем может проверить WAF. WAF не поддерживает проверку всего содержимого файлов cookie запроса, когда они превышают 8 КБ (8192 байта) или 200 общих файлов cookie. Базовая служба хоста пересылает максимум 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE — обычно проверять доступные файлы cookie в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке с помощью двоеточий и без добавленных пробелов, например, host:user-agent:accept:authorization:referer.

OversizeHandling -> (строка)

Что WAF следует делать, если заголовки запроса больше по количеству или размеру, чем может проверить WAF. WAF не поддерживает проверку всего содержимого заголовков запроса, когда они превышают 8 КБ (8192 байта) или 200 общих заголовков. Базовая служба хоста пересылает максимум 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки чрезмерного размера следующие:

  • CONTINUE — обычно проверять доступные заголовки в соответствии с критериями проверки правила.
  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком пальца JA3 запроса. Отпечаток пальца JA3 представляет собой 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток пальца JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. разделы «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA3 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка пальца JA3.

Можно указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставить с отпечатком пальца JA4 запроса. Отпечаток пальца JA4 представляет собой 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, который имеет достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Эту опцию можно использовать только с сопоставлением строк ByteMatchStatement с параметром PositionalConstraint, установленным в значение EXACTLY.

Вы можете получить отпечаток пальца JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Для получения информации о полях ведения журнала см. разделы «Поля журналов» в Руководстве разработчика WAF.

Укажите строку отпечатка пальца JA4 из журналов в спецификации оператора сопоставления строк, чтобы сопоставить с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (строка)

Статус сопоставления, который необходимо назначить веб-запросу, если запрос не имеет отпечатка пальца JA4.

Можно указать следующие резервные варианты поведения:

  • MATCH — рассматривать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH — рассматривать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить область и фильтры сопоставления шаблонов в объекте UriFragment , чтобы определить фрагмент URI, который WAF проверяет.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить способ обработки любого контента фрагмента URI сверх размера в объекте UriFragment . WAF применяет фильтры сопоставления шаблонов к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверьте тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает контент только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Синтаксический анализ WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться успешно даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение отката. Для получения дополнительной информации см. тело JSON в Руководстве разработчика WAF .

TextTransformations -> (list)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение. Текстовые преобразования используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также используются в операторах правил на основе скорости для преобразования компонентов запроса перед их использованием в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного контента, начиная с самого низкого приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Текстовые преобразования устраняют некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

Подробные описания каждого из типов преобразований см. в разделе Текстовые преобразования в Руководстве разработчика WAF .

ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также расположение в полезных данных запроса на создание учетной записи данных, таких как электронная почта пользователя и поля номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и расположение в полезных данных запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил управления ботами.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также расположение в полезных данных запроса на создание учетной записи данных, таких как электронная почта пользователя и поля номера телефона.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение и расположение в полезных данных запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите, чтобы использовала группа правил управления ботами.

Примеры спецификаций см. в разделе примеров CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя - /form/username .
  • Для типов полезных данных с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем username1 , спецификация поля имени пользователя - username1

PasswordField -> (structure)

Примечание

Вместо этого параметра предоставьте свою конфигурацию в разделе конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля - /form/password .
  • Для типов полезных данных с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом input с именем password1 , спецификация поля пароля - password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Для получения информации об использовании управляемой группы правил Bot Control см. WAF Bot Control rule group и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки, который будет использоваться для группы правил Bot Control. Общий уровень является наименее затратным. Целевой уровень включает все общие правила уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе WAF Bot Control rule group в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, следует ли использовать машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют аномальное поведение, которое может указывать на распределенную, скоординированную активность ботов.

Для получения дополнительной информации об этом выборе см. список этих правил в таблице в разделе Список правил Bot Control в Руководстве разработчика WAF .

Default: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил защиты от перехвата учетных записей (ATP), AWSManagedRulesATPRuleSet . Используйте это, чтобы предоставить информацию о запросе на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функции.

Для получения информации об использовании управляемой группы правил ATP см. группу правил защиты от перехвата учетных записей (ATP) WAF Fraud Control и защиту от перехвата учетных записей (ATP) WAF Fraud Control в Руководстве разработчика WAF .

LoginPath -> (string)

Путь к конечной точке входа в ваше приложение. Например, для URL-адреса https://example.com/web/login , вы должны предоставить путь /web/login . Пути входа, начинающиеся с указанного вами пути, считаются соответствующими. Например, /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной вами конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа: JSON или форма с кодировкой.

UsernameField -> (structure)

Название поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

Способ его указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 , спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Способ его указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Название поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

Способ его указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 , спецификация поля пароля — password1 .

Identifier -> (string)

Имя поля пароля.

Способ его указания зависит от типа полезной нагрузки для проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Для получения информации о синтаксисе указателя JSON см. документацию Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 , спецификация поля пароля — password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиентов, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, которые имели слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON пример: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON пример: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Название заголовка, с которым следует сопоставить. Имя должно точно соответствовать, включая регистр.

JSON пример: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON примеры: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON примеры: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON примеры: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачей, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON пример: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для значения, с которым нужно сопоставить JSON. Идентификатор должен точно соответствовать, включая регистр.

JSON примеры: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON пример: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON пример: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетной записи (ACFP) AWSManagedRulesACFPRuleSet. Используйте это, чтобы предоставить информацию о запросе на создание учетной записи группе правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на создание учетной записи.

Для получения информации об использовании управляемой группы правил ACFP см. группу правил WAF Fraud Control для предотвращения мошенничества при создании учетной записи (ACFP) и WAF Fraud Control для предотвращения мошенничества при создании учетной записи (ACFP) в Руководстве разработчика WAF.

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount вы предоставите путь /web/newaccount. Пути к страницам создания учетной записи, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетной записи /web/newaccount, /web/newaccount/, /web/newaccountPage и /web/newaccount/thisPage, но не соответствует пути /home/web/newaccount или /website/newaccount.

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, на которой новым пользователям отображается форма регистрации.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL https://example.com/web/registration вы предоставите путь /web/registration. Пути к страницам регистрации, которые начинаются с указанного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration, /web/registration/, /web/registrationPage и /web/registration/thisPage, но не соответствует пути /home/web/registration или /website/registration.

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезных данных для вашей конечной точки создания учетной записи: JSON или закодированные формы.

UsernameField -> (structure)

Имя поля в полезных данных запроса, содержащего имя пользователя вашего клиента.

Способ указания этого зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя имеет вид /form/username .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя имеет вид username1

Identifier -> (string)

Имя поля имени пользователя.

Способ указания этого зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "username": "THE_USERNAME" } } спецификация поля имени пользователя имеет вид /form/username .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем username1 спецификация поля имени пользователя имеет вид username1

PasswordField -> (structure)

Имя поля в полезных данных запроса, содержащего пароль вашего клиента.

Способ указания этого зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля имеет вид /form/password .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля имеет вид password1 .

Identifier -> (string)

Имя поля пароля.

Способ указания этого зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "password": "THE_PASSWORD" } } спецификация поля пароля имеет вид /form/password .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем password1 спецификация поля пароля имеет вид password1 .

EmailField -> (structure)

Имя поля в полезных данных запроса, содержащего электронную почту вашего клиента.

Способ указания этого зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты имеет вид /form/email .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем email1 спецификация поля электронной почты имеет вид email1 .

Identifier -> (string)

Имя поля электронной почты.

Способ указания этого зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "email": "THE_EMAIL" } } спецификация поля электронной почты имеет вид /form/email .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементом input с именем email1 спецификация поля электронной почты имеет вид email1 .

PhoneNumberFields -> (list)

Имена полей в полезных данных запроса, содержащих основной номер телефона вашего клиента.

Укажите поля номера телефона в массиве точно в том порядке, в котором они указаны в полезных данных запроса.

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

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона имеют вид /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами input с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона имеют вид primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

(structure)

Имя поля в полезных данных запроса, содержащего часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного основного поля номера телефона.

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

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } идентификаторы полей номера телефона имеют вид /form/primaryphoneline1 , /form/primaryphoneline2 и /form/primaryphoneline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами input с именами primaryphoneline1 , primaryphoneline2 и primaryphoneline3 идентификаторы полей номера телефона имеют вид primaryphoneline1 , primaryphoneline2 и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезных данных запроса, содержащих основной физический адрес вашего клиента.

Укажите поля адреса в массиве точно в том порядке, в котором они указаны в полезных данных запроса.

Способ указания полей адреса зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса имеют вид /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами input с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса имеют вид primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

(structure)

Имя поля в полезных данных запроса, содержащего часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного основного поля адреса.

Способ указания полей адреса зависит от типа полезных данных проверки запроса.

  • Для полезных данных JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезных данных JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } идентификаторы полей адреса имеют вид /form/primaryaddressline1 , /form/primaryaddressline2 и /form/primaryaddressline3 .
  • Для типов полезных данных, закодированных в форме, используйте имена форм HTML. Например, для HTML-формы с элементами input с именами primaryaddressline1 , primaryaddressline2 и primaryaddressline3 идентификаторы полей адреса имеют вид primaryaddressline1 , primaryaddressline2 и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентом, ведя учет успешных и неудачных попыток с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (структура)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (список)

Коды состояния в ответе, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "SuccessCodes": [ 200, 201 ]

(целое число)

FailureCodes -> (список)

Коды состояния в ответе, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

Пример JSON: "FailureCodes": [ 400, 404 ]

(целое число)

Header -> (структура)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно точно соответствовать, включая регистр.

Пример JSON: "Name": [ "RequestResult" ]

SuccessValues -> (список)

Значения в заголовке ответа с указанным именем, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (список)

Значения в заголовке ответа с указанным именем, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Примеры JSON: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (структура)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (список)

Строки в теле ответа, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Примеры JSON: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (список)

Строки в теле ответа, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, строка может находиться в любом месте тела и должна точно соответствовать, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

Пример JSON: "FailureStrings": [ "Request failed" ]

(string)

Json -> (структура)

Настраивает проверку JSON-ответа для индикаторов успеха и неудачи. WAF может проверять первые 65 536 байт (64 КБ) JSON-ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен точно соответствовать, включая регистр.

Примеры JSON: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (список)

Значения для указанного идентификатора в JSON-ответе, указывающие на успешный вход в систему или попытку создания учетной записи. Чтобы считаться успешным, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (список)

Значения для указанного идентификатора в JSON-ответе, указывающие на неудачный вход в систему или попытку создания учетной записи. Чтобы считаться неудачей, значение должно точно соответствовать, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

Пример JSON: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

Настройки действия для использования вместо действий правил, настроенных внутри группы правил. Вы указываете одну переоценку для каждого правила, для которого вы хотите изменить действие.

Примечание

Будьте внимательны при проверке имен правил в ваших переоценках. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не вернет ошибку и не применит параметр переоценки.

Вы можете использовать переоценки для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно переопределять некоторые или все действия, чтобы изменить способ управления группой правил вашим веб-трафиком.

(структура)

Настройка действия для использования вместо действия правила, настроенного внутри группы правил. Вы указываете одну переоценку для каждого правила, для которого вы хотите изменить действие.

Примечание

Будьте внимательны при проверке имен правил в ваших переоценках. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не вернет ошибку и не применит параметр переоценки.

Вы можете использовать переоценки для тестирования, например, вы можете переопределить все действия правил на Count, а затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете постоянно переопределять некоторые или все действия, чтобы изменить способ управления группой правил вашим веб-трафиком.

Name -> (string) Имя правила, которое нужно переопределить.

Имя правила, которое нужно переопределить.

Примечание

Будьте внимательны при проверке имен правил в ваших переоценках. Если вы укажете имя правила, которое не соответствует имени ни одного правила в группе правил, WAF не вернет ошибку и не применит параметр переоценки.

ActionToUse -> (structure) Действие переоценки для использования вместо настроенного действия правила в группе правил.

Действие переоценки для использования вместо настроенного действия правила в группе правил.

Block -> (structure) Инструктирует WAF заблокировать веб-запрос.

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure) Определяет настраиваемый ответ для веб-запроса.

Определяет настраиваемый ответ для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

ResponseCode -> (integer) Код состояния HTTP для возврата клиенту.

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в ваших пользовательских ответах, см. в разделе Поддерживаемые коды состояния для пользовательского ответа в Руководстве разработчика WAF.

CustomResponseBodyKey -> (string) Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блокировку. Для этого сначала определите ключ и значение тела ответа в параметре CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL, параметре BlockAction, вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list) Заголовки HTTP для использования в ответе.

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string) Имя пользовательского заголовка.

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string) Значение пользовательского заголовка.

Значение пользовательского заголовка.

Allow -> (structure) Инструктирует WAF разрешить веб-запрос.

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure) Определяет пользовательскую обработку для веб-запроса.

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list) Заголовки HTTP для вставки в запрос.

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string) Имя пользовательского заголовка.

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string) Значение пользовательского заголовка.

Значение пользовательского заголовка.

Count -> (structure) Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure) Определяет пользовательскую обработку для веб-запроса.

Определяет пользовательскую обработку для веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list) Заголовки HTTP для вставки в запрос.

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string) Имя пользовательского заголовка.

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string) Значение пользовательского заголовка.

Значение пользовательского заголовка.

Captcha -> (structure) Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure) Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list) Заголовки HTTP для вставки в запрос.

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string) Имя пользовательского заголовка.

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string) Значение пользовательского заголовка.

Значение пользовательского заголовка.

Challenge -> (structure) Инструктирует WAF запустить проверку Challenge для веб-запроса.

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure) Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Для получения информации о настройке веб-запросов и ответов см. раздел Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF.

InsertHeaders -> (list) Заголовки HTTP для вставки в запрос.

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

Для получения информации об ограничениях на количество и размер пользовательских настроек запросов и ответов см. квоты WAF в Руководстве разработчика WAF.

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling.

Name -> (string) Имя пользовательского заголовка.

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf-, чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample, WAF вставляет заголовок x-amzn-waf-sample.

Value -> (string) Значение пользовательского заголовка.

Значение пользовательского заголовка.

LabelMatchStatement -> (structure) Инструкция правила для сопоставления с метками, которые были добавлены к веб-запросу правилами, которые уже были запущены в веб-ACL.

Инструкция правила для сопоставления с метками, которые были добавлены к веб-запросу правилами, которые уже были запущены в веб-ACL.

Инструкция соответствия меткам предоставляет строку метки или пространства имен для поиска. Строка метки может представлять часть или всю полностью квалифицированное имя метки, которое было добавлено к веб-запросу. Полностью квалифицированные метки имеют префикс, необязательные пространства имен и имя метки. Префикс определяет контекст группы правил или веб-ACL правила, которое добавило метку. Если вы не предоставите полностью квалифицированное имя в строке соответствия меткам, WAF выполнит поиск меток, которые были добавлены в том же контексте, что и инструкция соответствия меткам.

Scope -> (string) Укажите, хотите ли вы сопоставить, используя имя метки, или только пространство имен.

Key -> (string) Строка для сопоставления.

Строка для сопоставления. Настройка, которую вы предоставляете для этого, зависит от настройки Scope инструкции соответствия:

  • Если Scope указывает LABEL, тогда эта спецификация должна включать имя и может включать любое количество предшествующих спецификаций пространства имен и префикс до предоставления полностью квалифицированного имени метки.
  • Если Scope указывает NAMESPACE, тогда эта спецификация может включать любое количество смежных строк пространства имен и может включать весь префикс пространства имен меток из группы правил или веб-ACL, где метка возникла.

Метки чувствительны к регистру, и компоненты метки должны разделяться двоеточием, например NS1:NS2:name.

RegexMatchStatement -> (structure)

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

RegexString -> (string)

Строка, представляющая регулярное выражение.

FieldToMatch -> (structure)

Часть веб-запроса, которую вы хотите, чтобы WAF проверял.

SingleHeader -> (structure)

Проверить один заголовок. Укажите имя заголовка для проверки, например, User-Agent или Referer . Эта настройка не учитывает регистр.

Пример JSON: "SingleHeader": { "Name": "haystack" }

Кроме того, вы можете фильтровать и проверять все заголовки с помощью настройки Headers FieldToMatch.

Name -> (string)

Имя заголовка запроса для проверки.

SingleQueryArgument -> (structure)

Проверить один аргумент запроса. Укажите имя аргумента запроса для проверки, например UserName или SalesRegion . Имя может содержать до 30 символов и не учитывает регистр.

Пример JSON: "SingleQueryArgument": { "Name": "myArgument" }

Name -> (string)

Имя аргумента запроса для проверки.

AllQueryArguments -> (structure)

Проверить все аргументы запроса.

UriPath -> (structure)

Проверить путь URI запроса. Это часть веб-запроса, которая идентифицирует ресурс, например, /images/daily-ad.jpg .

QueryString -> (structure)

Проверить строку запроса. Это часть URL-адреса, которая отображается после символа ? , если таковой имеется.

Body -> (structure)

Проверить тело запроса как обычный текст. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает ограничение для типа ресурса. Когда тело веб-запроса больше ограничения, базовая служба хоста пересылает только содержимое, которое находится в пределах ограничения, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные комиссии за обработку.
  • Для Amplify используйте ограничение CloudFront.

Чтобы узнать, как обрабатывать тела запросов с превышением размера, см. конфигурацию объекта Body .

OversizeHandling -> (string)

Что WAF следует делать, если размер тела превышает размер, который WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает ограничение для типа ресурса. Когда тело веб-запроса больше ограничения, базовая служба хоста пересылает только содержимое, которое находится в пределах ограничения, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные комиссии за обработку.
  • Для Amplify используйте ограничение CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычно в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Method -> (structure)

Проверить метод HTTP. Метод указывает тип операции, которую запрос запрашивает у источника.

JsonBody -> (structure)

Проверить тело запроса как JSON. Тело запроса следует сразу за заголовками запроса. Это часть запроса, которая содержит любые дополнительные данные, которые вы хотите отправить на свой веб-сервер в качестве тела HTTP-запроса, например данные из формы.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает ограничение для типа ресурса. Когда тело веб-запроса больше ограничения, базовая служба хоста пересылает только содержимое, которое находится в пределах ограничения, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные комиссии за обработку.
  • Для Amplify используйте ограничение CloudFront.

Чтобы узнать, как обрабатывать тела запросов с превышением размера, см. конфигурацию объекта JsonBody .

MatchPattern -> (structure)

Шаблоны для поиска в теле JSON. WAF проверяет результаты этих сопоставлений шаблонов с критериями проверки правила.

All -> (structure)

Сопоставить все элементы. См. также MatchScope в JsonBody .

Вы должны указать либо эту настройку, либо настройку IncludedPaths , но не обе.

IncludedPaths -> (list)

Сопоставлять только указанные пути включения. См. также MatchScope в JsonBody .

Укажите пути включения с помощью синтаксиса JSON Pointer. Например, "IncludedPaths": ["/dogs/0/name", "/dogs/1/name"] . Сведения об этом синтаксисе см. в документации Рабочей группы разработки Internet (IETF) JavaScript Object Notation (JSON) Pointer .

Вы должны указать либо эту настройку, либо настройку All , но не обе.

Примечание

Не используйте этот параметр для включения всех путей. Вместо этого используйте настройку All.

(string)

MatchScope -> (string)

Части JSON для сопоставления с использованием MatchPattern . Если вы укажете ALL , WAF будет сопоставлять ключи и значения.

All не требует, чтобы соответствие было найдено в ключах и соответствие было найдено в значениях. Требуется, чтобы соответствие было найдено в ключах или в значениях, или в обоих. Чтобы требовать соответствия в ключах и в значениях, используйте логический оператор AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

InvalidFallbackBehavior -> (string)

Что WAF следует делать, если не удается полностью проанализировать тело JSON. Возможные варианты:

  • EVALUATE_AS_STRING - Проверить тело как обычный текст. WAF применяет текстовые преобразования и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Рассматривать веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривать веб-запрос как не соответствующий оператору правила.

Если вы не предоставите эту настройку, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он столкнется.

Примечание

WAF parsing doesn’t fully validate the input JSON string, so parsing can succeed even for invalid JSON. When parsing succeeds, WAF doesn’t apply the fallback behavior. For more information, see JSON body in the WAF Developer Guide .

OversizeHandling -> (string)

Что WAF следует делать, если размер тела превышает размер, который WAF может проверить.

WAF не поддерживает проверку всего содержимого тела веб-запроса, если размер тела превышает ограничение для типа ресурса. Когда тело веб-запроса больше ограничения, базовая служба хоста пересылает только содержимое, которое находится в пределах ограничения, в WAF для проверки.

  • Для Application Load Balancer и AppSync ограничение фиксировано на уровне 8 КБ (8192 байта).
  • Для CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access ограничение по умолчанию составляет 16 КБ (16 384 байта), и вы можете увеличить ограничение для каждого типа ресурса в веб-ACL AssociationConfig за дополнительные комиссии за обработку.
  • Для Amplify используйте ограничение CloudFront.

Параметры обработки превышения размера следующие:

  • CONTINUE - Проверьте доступное содержимое тела обычно в соответствии с критериями проверки правила.
  • MATCH - Рассматривайте веб-запрос как соответствующий оператору правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Рассматривайте веб-запрос как не соответствующий оператору правила.

Вы можете объединить настройки MATCH или NO_MATCH для обработки превышения размера с настройками действия правила и веб-ACL, чтобы заблокировать любой запрос, тело которого превышает лимит.

По умолчанию: CONTINUE

Headers -> (structure)

Проверьте заголовки запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Headers, чтобы определить набор заголовков и части заголовков, которые WAF проверяет.

Только первые 8 КБ (8192 байта) заголовков запроса и только первые 200 заголовков пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого заголовков, превышающего размер, в объекте Headers. WAF применяет фильтры соответствия шаблону к заголовкам, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества заголовков для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedHeaders, либо ExcludedHeaders.

Пример JSON: "MatchPattern": { "ExcludedHeaders": [ "KeyToExclude1", "KeyToExclude2" ] }

All -> (структура)

Проверить все заголовки.

IncludedHeaders -> (список)

Проверять только заголовки, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedHeaders -> (список)

Проверять только заголовки, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части заголовков для сопоставления с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или в значениях, или и в том, и в другом. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

Cookies -> (структура)

Проверьте файлы cookie запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте Cookies, чтобы определить набор файлов cookie и части файлов cookie, которые WAF проверяет.

Только первые 8 КБ (8192 байта) файлов cookie запроса и только первые 200 файлов cookie пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку содержимого файлов cookie, превышающего размер, в объекте Cookies. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

MatchPattern -> (структура)

Фильтр, используемый для идентификации подмножества файлов cookie для проверки в веб-запросе.

Необходимо указать ровно один параметр: либо All, IncludedCookies, либо ExcludedCookies.

Пример JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }

All -> (структура)

Проверить все файлы cookie.

IncludedCookies -> (список)

Проверять только файлы cookie, ключ которых соответствует одной из указанных здесь строк.

(string)

ExcludedCookies -> (список)

Проверять только файлы cookie, ключи которых не соответствуют ни одной из указанных здесь строк.

(string)

MatchScope -> (string)

Части файлов cookie для проверки с критериями проверки правил. Если указать ALL, WAF проверяет как ключи, так и значения.

All не требует, чтобы совпадение было найдено в ключах и совпадение было найдено в значениях. Он требует, чтобы совпадение было найдено в ключах или в значениях, или и в том, и в другом. Чтобы потребовать совпадения в ключах и значениях, используйте логическое выражение AND для объединения двух правил сопоставления, одно из которых проверяет ключи, а другое — значения.

OversizeHandling -> (string)

Что WAF должен делать, если файлы cookie запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого файлов cookie запроса, если они превышают 8 КБ (8192 байта) или всего 200 файлов cookie. Базовая служба хоста пересылает не более 200 файлов cookie и не более 8 КБ содержимого файлов cookie в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные файлы cookie в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

HeaderOrder -> (структура)

Проверьте строку, содержащую список имен заголовков запроса, упорядоченных в том порядке, в котором они отображаются в веб-запросе, который WAF получает для проверки. WAF генерирует строку, а затем использует ее в качестве поля для сопоставления компонента при проверке. WAF разделяет имена заголовков в строке, используя двоеточия и без добавленных пробелов, например host:user-agent:accept:authorization:referer.

OversizeHandling -> (string)

Что WAF должен делать, если заголовки запроса более многочисленны или больше, чем WAF может проверить. WAF не поддерживает проверку всего содержимого заголовков запроса, если они превышают 8 КБ (8192 байта) или всего 200 заголовков. Базовая служба хоста пересылает не более 200 заголовков и не более 8 КБ содержимого заголовков в WAF.

Варианты обработки превышения размера следующие:

  • CONTINUE - Проверять доступные заголовки в обычном режиме в соответствии с критериями проверки правил.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

JA3Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA3 запроса. Отпечаток JA3 — это 32-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с настройкой PositionalConstraint на EXACTLY.

Вы можете получить отпечаток JA3 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA3 из журналов в спецификации сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка JA3.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

JA4Fingerprint -> (структура)

Доступно для использования с дистрибутивами Amazon CloudFront и Application Load Balancers. Сопоставьте с отпечатком JA4 запроса. Отпечаток JA4 — это 36-значный хэш, полученный из TLS Client Hello входящего запроса. Этот отпечаток служит уникальным идентификатором для конфигурации TLS клиента. WAF вычисляет и записывает этот отпечаток для каждого запроса, в котором достаточно информации TLS Client Hello для вычисления. Почти все веб-запросы включают эту информацию.

Примечание

Вы можете использовать этот вариант только с сопоставлением строк ByteMatchStatement с настройкой PositionalConstraint на EXACTLY.

Вы можете получить отпечаток JA4 для клиентских запросов из журналов веб-ACL. Если WAF может вычислить отпечаток, он включает его в журналы. Информацию о полях ведения журнала см. в разделе «Поля журнала» в Руководстве разработчика WAF.

Укажите строку отпечатка JA4 из журналов в спецификации сопоставления строк, чтобы сопоставить ее с любыми будущими запросами с той же конфигурацией TLS.

FallbackBehavior -> (string)

Статус соответствия, который следует присвоить веб-запросу, если запрос не имеет отпечатка JA4.

Можно указать следующие варианты поведения при отказе:

  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

UriFragment -> (структура)

Проверьте фрагменты URI запроса. Необходимо настроить фильтры соответствия области и шаблону в объекте UriFragment, чтобы определить фрагмент URI, который проверяет WAF.

Только первые 8 КБ (8192 байта) фрагментов URI запроса и только первые 200 фрагментов URI пересылаются в WAF для проверки базовой службой хоста. Необходимо настроить обработку любого содержимого фрагмента URI, превышающего размер, в объекте UriFragment. WAF применяет фильтры соответствия шаблону к файлам cookie, которые он получает от базовой службы хоста.

FallbackBehavior -> (string)

Что WAF должен делать, если не удается полностью проанализировать тело JSON. Варианты следующие:

  • EVALUATE_AS_STRING - Проверять тело как обычный текст. WAF применяет преобразования текста и критерии проверки, которые вы определили для проверки JSON, к строке текста тела.
  • MATCH - Обрабатывать веб-запрос как соответствующий заявлению правила. WAF применяет действие правила к запросу.
  • NO_MATCH - Обрабатывать веб-запрос как не соответствующий заявлению правила.

Если вы не предоставите этот параметр, WAF анализирует и оценивает содержимое только до первой ошибки синтаксического анализа, с которой он сталкивается.

Пример JSON: { "UriFragment": { "FallbackBehavior": "MATCH"} }

Примечание

Разбор WAF не полностью проверяет входную строку JSON, поэтому синтаксический анализ может завершиться даже для недействительного JSON. Когда синтаксический анализ завершается успешно, WAF не применяет поведение при отказе. Для получения дополнительной информации см. раздел «Тело JSON» в Руководстве разработчика WAF.

TextTransformations -> (list)

Преобразования текста исключают некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение. Преобразования текста используются в операторах соответствия правилам для преобразования компонента запроса FieldToMatch перед его проверкой, а также в операторах правил на основе скорости для преобразования компонентов запроса перед использованием их в качестве пользовательских ключей агрегирования. Если вы укажете одно или несколько преобразований для применения, WAF выполнит все преобразования для указанного содержимого, начиная с наименьшего значения приоритета, а затем использует содержимое преобразованного компонента.

(structure)

Преобразования текста исключают некоторые необычные форматы, которые злоумышленники используют в веб-запросах, чтобы попытаться обойти обнаружение.

Priority -> (integer)

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

Type -> (string)

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

ManagedRuleGroupConfigs -> (list)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса на создание учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение, а также местоположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать группой правил Bot Control.

(structure)

Дополнительная информация, используемая управляемой группой правил. Многие управляемые группы правил не требуют этого.

Группы правил, используемые для интеллектуального смягчения угроз, требуют дополнительной настройки:

  • Используйте объект конфигурации AWSManagedRulesACFPRuleSet для настройки управляемой группы правил предотвращения мошенничества при создании учетной записи. Конфигурация включает в себя страницы регистрации и регистрации вашего приложения, а также местоположения в полезной нагрузке запроса на создание учетной записи данных, таких как поля электронной почты и номера телефона пользователя.
  • Используйте объект конфигурации AWSManagedRulesATPRuleSet для настройки управляемой группы правил предотвращения захвата учетной записи. Конфигурация включает в себя страницу входа в ваше приложение, а также местоположения в полезной нагрузке запроса на вход данных, таких как имя пользователя и пароль.
  • Используйте объект конфигурации AWSManagedRulesBotControlRuleSet для настройки уровня защиты, который вы хотите использовать группой правил Bot Control.

Примеры спецификаций см. в разделе примеров раздела CreateWebACL .

LoginPath -> (string)

Примечание

Вместо этого параметра укажите свою конфигурацию в разделе AWSManagedRulesATPRuleSet .

PayloadType -> (string)

Примечание

Вместо этого параметра укажите свою конфигурацию в конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

UsernameField -> (structure)

Примечание

Вместо этого параметра укажите свою конфигурацию в конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля имени пользователя.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } спецификацией поля имени пользователя является /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 спецификацией поля имени пользователя является username1

PasswordField -> (structure)

Примечание

Вместо этого параметра укажите свою конфигурацию в конфигурации проверки запроса для AWSManagedRulesATPRuleSet или AWSManagedRulesACFPRuleSet .

Identifier -> (string)

Имя поля пароля.

То, как вы это указываете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Сведения о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } спецификацией поля пароля является /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 спецификацией поля пароля является password1 .

AWSManagedRulesBotControlRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил Bot Control. Используйте это, чтобы указать уровень проверки, который вы хотите использовать. Сведения об использовании управляемой группы правил Bot Control см. в разделах WAF Bot Control rule group и WAF Bot Control в Руководстве разработчика WAF .

InspectionLevel -> (string)

Уровень проверки, который будет использоваться для группы правил Bot Control. Общий уровень — самый недорогой. Целевой уровень включает в себя все правила общего уровня и добавляет правила с более продвинутыми критериями проверки. Подробности см. в разделе WAF Bot Control rule group в Руководстве разработчика WAF .

EnableMachineLearning -> (boolean)

Применяется только к целевому уровню проверки.

Определяет, использовать ли машинное обучение (ML) для анализа вашего веб-трафика на предмет активности, связанной с ботами. Машинное обучение требуется для правил Bot Control TGT_ML_CoordinatedActivityLow и TGT_ML_CoordinatedActivityMedium , которые проверяют наличие аномального поведения, которое может указывать на распределенную, скоординированную активность ботов.

Дополнительные сведения об этом выборе см. в списке этих правил в таблице в разделе Список правил Bot Control в Руководстве разработчика WAF .

Default: TRUE

AWSManagedRulesATPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения захвата учетной записи (ATP), AWSManagedRulesATPRuleSet . Используйте это для предоставления информации о запросах на вход в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на вход.

Эта конфигурация заменяет отдельные поля конфигурации в ManagedRuleGroupConfig и предоставляет дополнительную конфигурацию функций.

Информацию об использовании управляемой группы правил ATP см. в разделе Группа правил предотвращения захвата учетной записи (ATP) WAF Fraud Control и Предотвращение захвата учетной записи (ATP) WAF Fraud Control в Руководстве разработчика WAF .

LoginPath -> (string)

Путь к конечной точке входа для вашего приложения. Например, для URL-адреса https://example.com/web/login , вы предоставите путь /web/login . Пути входа, которые начинаются с указанного вами пути, считаются совпадением. Например /web/login соответствует путям входа /web/login , /web/login/ , /web/loginPage и /web/login/thisPage , но не соответствует пути входа /home/web/login или /website/login .

Группа правил проверяет только HTTP POST запросы к указанной конечной точке входа.

RequestInspection -> (structure)

Критерии проверки запросов на вход, используемые группой правил ATP для проверки использования учетных данных.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки входа, либо JSON, либо закодированный в форме.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего имя пользователя вашего клиента.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя выглядит как /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя выглядит как username1

Identifier -> (string)

Имя поля имени пользователя.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) documentation JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "username": "THE_USERNAME" } } , the username field specification is /form/username .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя выглядит как username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, содержащего пароль вашего клиента.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "password": "THE_PASSWORD" } } , the password field specification is /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

Identifier -> (string)

Имя поля пароля.

То, как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе указателя JSON. Информацию о синтаксисе указателя JSON см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . For example, for the JSON payload { "form": { "password": "THE_PASSWORD" } } , the password field specification is /form/password .
  • Для типов полезной нагрузки, закодированных в форме, используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля выглядит как password1 .

ResponseInspection -> (structure)

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

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ATP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках входа клиента, подсчитывая успешные и неудачные попытки для каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от сеансов клиентов и IP-адресов, у которых было слишком много неудачных попыток входа за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и сбоя.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешный вход или попытку создания учетной записи. Чтобы быть засчитанным как успешный, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачный вход или попытку создания учетной записи. Чтобы быть засчитанным как сбой, код состояния ответа должен соответствовать одному из них. Каждый код должен быть уникальным среди кодов состояния успеха и сбоя.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и сбоя.

Name -> (string)

Имя заголовка, с которым нужно сопоставить. Имя должно быть точным совпадением, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на успешный вход или попытку создания учетной записи. Чтобы быть засчитанным как успех, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] и "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы быть засчитанным как сбой, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] и "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы быть засчитанной как успех, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

JSON examples: "SuccessStrings": [ "Login successful" ] и "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачный вход или попытку создания учетной записи. Чтобы быть засчитанной как сбой, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и сбоя.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и сбоя. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор значения для сопоставления в JSON. Идентификатор должен быть точным совпадением, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] и "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на успешный вход или попытку создания учетной записи. Чтобы быть засчитанным как успех, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, которые указывают на неудачный вход или попытку создания учетной записи. Чтобы быть засчитанным как сбой, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и сбоя.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы входа.

AWSManagedRulesACFPRuleSet -> (structure)

Дополнительная конфигурация для использования управляемой группы правил предотвращения мошенничества при создании учетных записей (ACFP), AWSManagedRulesACFPRuleSet . Используйте это, чтобы предоставить информацию о запросе на создание учетной записи в группу правил. Для веб-ACL, защищающих дистрибутивы CloudFront, используйте это, чтобы также предоставить информацию о том, как ваш дистрибутив реагирует на запросы на создание учетных записей.

Для получения информации об использовании управляемой группы правил ACFP см. WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) и WAF Fraud Control предотвращение мошенничества при создании учетной записи (ACFP) в Руководстве разработчика WAF .

CreationPath -> (string)

Путь к конечной точке создания учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая принимает заполненную форму регистрации для нового пользователя. Эта страница должна принимать POST запросы.

Например, для URL https://example.com/web/newaccount , вы предоставите путь /web/newaccount . Пути к страницам создания учетных записей, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/newaccount соответствует путям создания учетных записей /web/newaccount , /web/newaccount/ , /web/newaccountPage , и /web/newaccount/thisPage , но не соответствует пути /home/web/newaccount или /website/newaccount .

RegistrationPagePath -> (string)

Путь к конечной точке регистрации учетной записи для вашего приложения. Это страница на вашем веб-сайте, которая представляет форму регистрации новым пользователям.

Примечание

Эта страница должна принимать GET text/html запросы.

Например, для URL https://example.com/web/registration , вы предоставите путь /web/registration . Пути к страницам регистрации, начинающиеся с указанного вами пути, считаются совпадением. Например, /web/registration соответствует путям регистрации /web/registration , /web/registration/ , /web/registrationPage , и /web/registration/thisPage , но не соответствует пути /home/web/registration или /website/registration .

RequestInspection -> (structure)

Критерии для проверки запросов на создание учетной записи, используемые группой правил ACFP для проверки и отслеживания попыток создания учетной записи.

PayloadType -> (string)

Тип полезной нагрузки для вашей конечной точки создания учетной записи: JSON или с кодировкой формы.

UsernameField -> (structure)

Имя поля в полезной нагрузке запроса, которое содержит имя пользователя вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

Identifier -> (string)

Имя поля имени пользователя.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "username": "THE_USERNAME" } } , спецификация поля имени пользователя — /form/username .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем username1 , спецификация поля имени пользователя — username1

PasswordField -> (structure)

Имя поля в полезной нагрузке запроса, которое содержит пароль вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

Identifier -> (string)

Имя поля пароля.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "password": "THE_PASSWORD" } } , спецификация поля пароля — /form/password .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем password1 , спецификация поля пароля — password1 .

EmailField -> (structure)

Имя поля в полезной нагрузке запроса, которое содержит адрес электронной почты вашего клиента.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты — email1 .

Identifier -> (string)

Имя поля электронной почты.

Как вы это укажете, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите имя поля в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "email": "THE_EMAIL" } } , спецификация поля электронной почты — /form/email .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементом ввода с именем email1 , спецификация поля электронной почты — email1 .

PhoneNumberFields -> (list)

Имена полей в полезной нагрузке запроса, которые содержат основной номер телефона вашего клиента.

Упорядочите поля номера телефона в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 , и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 , идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 .

(structure)

Имя поля в полезной нагрузке запроса, которое содержит часть или весь основной номер телефона вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного номера телефона.

Как вы укажете поля номера телефона, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryphoneline1": "THE_PHONE1", "primaryphoneline2": "THE_PHONE2", "primaryphoneline3": "THE_PHONE3" } } , идентификаторы полей номера телефона — /form/primaryphoneline1 , /form/primaryphoneline2 , и /form/primaryphoneline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 , идентификаторы полей номера телефона — primaryphoneline1 , primaryphoneline2 , и primaryphoneline3 .

AddressFields -> (list)

Имена полей в полезной нагрузке запроса, которые содержат основной физический адрес вашего клиента.

Упорядочите поля адреса в массиве точно так же, как они упорядочены в полезной нагрузке запроса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 , и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 , идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 .

(structure)

Имя поля в полезной нагрузке запроса, которое содержит часть или весь основной физический адрес вашего клиента.

Этот тип данных используется в типе данных RequestInspectionACFP .

Identifier -> (string)

Имя одного поля основного адреса.

Как вы укажете поля адреса, зависит от типа полезной нагрузки проверки запроса.

  • Для полезных нагрузок JSON укажите идентификаторы полей в синтаксисе JSON pointer. Информацию о синтаксисе JSON Pointer см. в документации Internet Engineering Task Force (IETF) JavaScript Object Notation (JSON) Pointer . Например, для полезной нагрузки JSON { "form": { "primaryaddressline1": "THE_ADDRESS1", "primaryaddressline2": "THE_ADDRESS2", "primaryaddressline3": "THE_ADDRESS3" } } , идентификаторы полей адреса — /form/primaryaddressline1 , /form/primaryaddressline2 , и /form/primaryaddressline3 .
  • Для типов полезной нагрузки с кодировкой формы используйте имена HTML-форм. Например, для HTML-формы с элементами ввода с именами primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 , идентификаторы полей адреса — primaryaddressline1 , primaryaddressline2 , и primaryaddressline3 .

ResponseInspection -> (structure)

Критерии для проверки ответов на запросы создания учетной записи, используемые группой правил ACFP для отслеживания показателей успешности создания учетной записи.

Примечание

Проверка ответа доступна только в веб-ACL, защищающих дистрибутивы Amazon CloudFront.

Группа правил ACFP оценивает ответы, которые ваши защищенные ресурсы отправляют обратно при попытках создания учетной записи клиентами, подсчитывая успешные и неудачные попытки с каждого IP-адреса и сеанса клиента. Используя эту информацию, группа правил помечает и смягчает запросы от клиентских сеансов и IP-адресов, у которых было слишком много успешных попыток создания учетной записи за короткий промежуток времени.

StatusCode -> (structure)

Настраивает проверку кода состояния ответа для индикаторов успеха и неудачи.

SuccessCodes -> (list)

Коды состояния в ответе, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "SuccessCodes": [ 200, 201 ]

(integer)

FailureCodes -> (list)

Коды состояния в ответе, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, код состояния ответа должен соответствовать одному из этих кодов. Каждый код должен быть уникальным среди кодов состояния успеха и неудачи.

JSON example: "FailureCodes": [ 400, 404 ]

(integer)

Header -> (structure)

Настраивает проверку заголовка ответа для индикаторов успеха и неудачи.

Name -> (string)

Имя заголовка для сопоставления. Имя должно быть точным совпадением, включая регистр.

JSON example: "Name": [ "RequestResult" ]

SuccessValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "SuccessValues": [ "LoginPassed", "Successful login" ] and "SuccessValues": [ "AccountCreated", "Successful account creation" ]

(string)

FailureValues -> (list)

Значения в заголовке ответа с указанным именем, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON examples: "FailureValues": [ "LoginFailed", "Failed login" ] and "FailureValues": [ "AccountCreationFailed" ]

(string)

BodyContains -> (structure)

Настраивает проверку тела ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) тела ответа.

SuccessStrings -> (list)

Строки в теле ответа, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON examples: "SuccessStrings": [ "Login successful" ] and "SuccessStrings": [ "Account creation successful", "Welcome to our site!" ]

(string)

FailureStrings -> (list)

Строки в теле ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, строка может находиться в любом месте тела и должна быть точным совпадением, включая регистр. Каждая строка должна быть уникальной среди строк успеха и неудачи.

JSON example: "FailureStrings": [ "Request failed" ]

(string)

Json -> (structure)

Настраивает проверку JSON ответа для индикаторов успеха и неудачи. WAF может проверить первые 65 536 байт (64 КБ) JSON ответа.

Identifier -> (string)

Идентификатор для сопоставления значения в JSON. Идентификатор должен быть точным совпадением, включая регистр.

JSON examples: "Identifier": [ "/login/success" ] and "Identifier": [ "/sign-up/success" ]

SuccessValues -> (list)

Значения для указанного идентификатора в JSON ответа, указывающие на успешную попытку входа в систему или создания учетной записи. Чтобы считаться успешным, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "SuccessValues": [ "True", "Succeeded" ]

(string)

FailureValues -> (list)

Значения для указанного идентификатора в JSON ответа, указывающие на неудачную попытку входа в систему или создания учетной записи. Чтобы считаться неудачей, значение должно быть точным совпадением, включая регистр. Каждое значение должно быть уникальным среди значений успеха и неудачи.

JSON example: "FailureValues": [ "False", "Failed" ]

(string)

EnableRegexInPath -> (boolean)

Разрешить использование регулярных выражений в пути страницы регистрации и пути создания учетной записи.

RuleActionOverrides -> (list)

Настройки действия для использования вместо действий правила, настроенных внутри группы правил. Вы указываете одну переопределяющую настройку для каждого правила, действие которого вы хотите изменить.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count и затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

(structure)

Настройка действия для использования вместо действия правила, настроенного внутри группы правил. Вы указываете одну переопределяющую настройку для каждого правила, действие которого вы хотите изменить.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

Вы можете использовать переопределения для тестирования, например, вы можете переопределить все действия правил на Count и затем отслеживать результирующие метрики подсчета, чтобы понять, как группа правил будет обрабатывать ваш веб-трафик. Вы также можете навсегда переопределить некоторые или все действия, чтобы изменить способ управления веб-трафиком группой правил.

Name -> (string)

Имя правила для переопределения.

Примечание

Убедитесь, что имена правил в ваших переопределениях верны. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения для использования вместо настроенного действия правила в группе правил.

Block -> (structure)

Инструктирует WAF заблокировать веб-запрос.

CustomResponse -> (structure)

Определяет пользовательский ответ для веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

For a list of status codes that you can use in your custom responses, see Supported status codes for custom response in the WAF Developer Guide .

CustomResponseBodyKey -> (string)

Ссылки на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить пользовательский ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блокировку. Чтобы сделать это, сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или настройке по умолчанию веб-ACL BlockAction , вы ссылаетесь на тело ответа, используя этот ключ.

ResponseHeaders -> (list)

Заголовки HTTP для использования в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

The value of the custom header.

Allow -> (structure)

Инструктирует WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

The value of the custom header.

Count -> (structure)

Инструктирует WAF подсчитать веб-запрос, а затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

The value of the custom header.

Captcha -> (structure)

Инструктирует WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

The value of the custom header.

Challenge -> (structure)

Инструктирует WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет пользовательскую обработку для веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

For information about customizing web requests and responses, see Customizing web requests and responses in WAF in the WAF Developer Guide .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дубликаты имен заголовков не допускаются.

For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer Guide .

(structure)

Пользовательский заголовок для обработки пользовательских запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя пользовательского заголовка.

For custom request header insertion, when WAF inserts the header into the request, it prefixes this name x-amzn-waf- , to avoid confusion with the headers that are already in the request. For example, for the header name sample , WAF inserts the header x-amzn-waf-sample .

Value -> (string)

The value of the custom header.

RuleGroupReferenceStatement -> (structure)

Оператор, используемый Firewall Manager для запуска правил, определенных в группе правил. Управляется Firewall Manager для политики Firewall Manager WAF.

ARN -> (string)

Имя ресурса Amazon (ARN) объекта.

ExcludedRules -> (list)

Правила в указанной группе правил, для которых действия установлены в Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

(structure)

Указывает одно правило в группе правил, действие которого вы хотите переопределить на Count .

Примечание

Вместо этого параметра используйте RuleActionOverrides . Он принимает любое допустимое значение действия, включая Count .

Name -> (string)

Имя правила, действие которого вы хотите переопределить на Count .

RuleActionOverrides -> (list)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

(structure)

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

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

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

Name -> (string)

Имя правила для переопределения.

Примечание

Будьте внимательны при проверке имен правил в ваших переопределениях. Если вы укажете имя правила, которое не соответствует имени какого-либо правила в группе правил, WAF не вернет ошибку и не применит настройку переопределения.

ActionToUse -> (structure)

Действие переопределения, которое нужно использовать вместо настроенного действия правила в группе правил.

Block -> (structure)

Предписывает WAF блокировать веб-запрос.

CustomResponse -> (structure)

Определяет настраиваемый ответ для веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

ResponseCode -> (integer)

Код состояния HTTP для возврата клиенту.

Список кодов состояния, которые можно использовать в настраиваемых ответах, см. в разделе Поддерживаемые коды состояния для настраиваемого ответа в Руководстве разработчика WAF .

CustomResponseBodyKey -> (string)

Ссылается на тело ответа, которое вы хотите, чтобы WAF вернул клиенту веб-запроса. Вы можете определить настраиваемый ответ для действия правила или действия веб-ACL по умолчанию, которое установлено в блок. Чтобы сделать это, сначала определите ключ и значение тела ответа в настройке CustomResponseBodies для WebACL или RuleGroup, где вы хотите его использовать. Затем, в действии правила или действии по умолчанию веб-ACL BlockAction , вы ссылаетесь на тело ответа с помощью этого ключа.

ResponseHeaders -> (list)

Заголовки HTTP, которые нужно использовать в ответе. Вы можете указать любое имя заголовка, кроме content-type . Дублирование имен заголовков не допускается.

Сведения об ограничениях на количество и размер настроек настраиваемых запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение настраиваемого заголовка.

Allow -> (structure)

Предписывает WAF разрешить веб-запрос.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Сведения об ограничениях на количество и размер настроек настраиваемых запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение настраиваемого заголовка.

Count -> (structure)

Предписывает WAF подсчитать веб-запрос и затем продолжить оценку запроса, используя оставшиеся правила в веб-ACL.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку веб-запроса.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Сведения об ограничениях на количество и размер настроек настраиваемых запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение настраиваемого заголовка.

Captcha -> (structure)

Предписывает WAF запустить проверку CAPTCHA для веб-запроса.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку веб-запроса, используемую, когда проверка CAPTCHA определяет, что токен запроса действителен и не истек.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Сведения об ограничениях на количество и размер настроек настраиваемых запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение настраиваемого заголовка.

Challenge -> (structure)

Предписывает WAF запустить проверку Challenge для веб-запроса.

CustomRequestHandling -> (structure)

Определяет настраиваемую обработку веб-запроса, используемую, когда проверка challenge определяет, что токен запроса действителен и не истек.

Сведения о настройке веб-запросов и ответов см. в разделе Настройка веб-запросов и ответов в WAF в Руководстве разработчика WAF .

InsertHeaders -> (list)

Заголовки HTTP для вставки в запрос. Дублирование имен заголовков не допускается.

Сведения об ограничениях на количество и размер настроек настраиваемых запросов и ответов см. в разделе Квоты WAF в Руководстве разработчика WAF .

(structure)

Настраиваемый заголовок для настраиваемой обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (string)

Имя настраиваемого заголовка.

Для вставки настраиваемого заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample , WAF вставляет заголовок x-amzn-waf-sample .

Value -> (string)

Значение настраиваемого заголовка.

OverrideAction -> (structure)

Действие, которое следует использовать вместо действия, являющегося результатом оценки группы правил. Установите действие переопределения в значение none, чтобы оставить результат группы правил неизменным. Установите его в значение count, чтобы переопределить результат только на подсчет.

Вы можете использовать это только для инструкций правил, которые ссылаются на группу правил, например RuleGroupReferenceStatement и ManagedRuleGroupStatement .

Примечание

Этот параметр обычно имеет значение none. Он не влияет на то, как оцениваются правила в группе правил. Если вы хотите, чтобы правила в группе правил только подсчитывали совпадения, не используйте этот параметр, а вместо этого используйте параметр переопределения действия правила с действием Count в настройках ссылки на группу правил.

Count -> (структура)

Переопределите результат оценки группы правил только для подсчета.

Примечание

Этот параметр обычно имеет значение none. Он не влияет на то, как оцениваются правила в группе правил. Если вы хотите, чтобы правила в группе правил только подсчитывали совпадения, не используйте этот параметр, а вместо этого используйте параметр переопределения действия правила с действием Count в настройках ссылки на группу правил.

CustomRequestHandling -> (структура)

Определяет пользовательскую обработку веб-запроса.

Для получения информации о настройке веб-запросов и ответов см. раздел Customizing web requests and responses in WAF в Руководстве разработчика WAF .

InsertHeaders -> (список)

Заголовки HTTP, которые необходимо вставить в запрос. Дублирование имен заголовков не допускается.

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел WAF quotas в Руководстве разработчика WAF .

(структура)

Пользовательский заголовок для пользовательской обработки запросов и ответов. Это используется в CustomResponse и CustomRequestHandling .

Name -> (строка)

Имя пользовательского заголовка.

Для вставки пользовательского заголовка запроса, когда WAF вставляет заголовок в запрос, он добавляет к этому имени префикс x-amzn-waf- , чтобы избежать путаницы с заголовками, которые уже есть в запросе. Например, для имени заголовка sample WAF вставляет заголовок x-amzn-waf-sample .

Value -> (строка)

Значение пользовательского заголовка.

None -> (структура)

Не переопределять результат оценки группы правил. Это наиболее распространенная настройка.

VisibilityConfig -> (структура)

Определяет и включает метрики Amazon CloudWatch и сбор образцов веб-запросов.

SampledRequestsEnabled -> (логическое значение)

Указывает, должен ли WAF хранить выборку веб-запросов, которые соответствуют правилам. Вы можете просмотреть запросы выборки через консоль WAF.

Если вы настраиваете защиту данных для веб-ACL, защита применяется к данным выборки веб-запросов веб-ACL.

Примечание

Выборка запросов не предоставляет параметр редактирования полей, и любое редактирование полей, которое вы указываете в конфигурации ведения журнала, не влияет на выборку. Вы можете исключить поля из выборки запросов, отключив выборку в конфигурации видимости веб-ACL или настроив защиту данных для веб-ACL.

CloudWatchMetricsEnabled -> (логическое значение)

Указывает, отправляет ли связанный ресурс метрики в Amazon CloudWatch. Список доступных метрик см. в разделе WAF Metrics в Руководстве разработчика WAF .

Для веб-ACL метрики предназначены для веб-запросов, к которым применяется действие по умолчанию веб-ACL. WAF применяет действие по умолчанию к веб-запросам, которые проходят проверку всех правил в веб-ACL, не будучи разрешенными или заблокированными. Дополнительную информацию см. в разделе The web ACL default action в Руководстве разработчика WAF .

MetricName -> (строка)

Имя измерения метрики Amazon CloudWatch. Имя может содержать только символы: A-Z, a-z, 0-9, - (дефис) и _ (подчеркивание). Длина имени может составлять от одного до 128 символов. Оно не может содержать пробелы или имена метрик, зарезервированные для WAF, например All и Default_Action .

ManagedByFirewallManager -> (логическое значение)

Указывает, была ли эта веб-ACL создана с помощью Firewall Manager и управляется ли она Firewall Manager. Если true, только Firewall Manager может удалить веб-ACL или любые группы правил Firewall Manager в веб-ACL. См. также свойства RetrofittedByFirewallManager , PreProcessFirewallManagerRuleGroups и PostProcessFirewallManagerRuleGroups .

LabelNamespace -> (строка)

Префикс пространства имен меток для этой веб-ACL. Все метки, добавленные правилами в этой веб-ACL, имеют этот префикс.

  • Синтаксис префикса пространства имен меток для веб-ACL следующий: awswaf:<account ID>:webacl:<web ACL name>:
  • Когда правило с меткой соответствует веб-запросу, WAF добавляет полное имя метки в запрос. Полное имя метки состоит из пространства имен меток из группы правил или веб-ACL, где определено правило, и метки из правила, разделенных двоеточием: <label namespace>:<label from rule>

CustomResponseBodies -> (карта)

Карта пользовательских ключей ответов и тел содержимого. Когда вы создаете правило с действием блокировки, вы можете отправить пользовательский ответ на веб-запрос. Вы определяете их для веб-ACL, а затем используете их в правилах и действиях по умолчанию, которые вы определяете в веб-ACL.

Для получения информации о настройке веб-запросов и ответов см. раздел Customizing web requests and responses in WAF в Руководстве разработчика WAF .

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел WAF quotas в Руководстве разработчика WAF .

key -> (строка)

value -> (структура)

Тело ответа для использования в пользовательском ответе на веб-запрос. На это ссылается ключ из CustomResponse CustomResponseBodyKey .

ContentType -> (строка)

Тип контента в полезных данных, который вы определяете в строке Content .

Content -> (строка)

Полезные данные пользовательского ответа.

Вы можете использовать строки экранирования JSON в контенте JSON. Для этого необходимо указать контент JSON в настройке ContentType .

Для получения информации об ограничениях по количеству и размеру для пользовательских настроек запросов и ответов см. раздел WAF quotas в Руководстве разработчика WAF .

CaptchaConfig -> (структура)

Указывает, как WAF должен обрабатывать оценки CAPTCHA для правил, у которых нет собственных настроек CaptchaConfig . Если вы не укажете это, WAF использует свои настройки по умолчанию для CaptchaConfig .

ImmunityTimeProperty -> (структура)

Определяет, как долго метка времени CAPTCHA в токене остается действительной после того, как клиент успешно решит головоломку CAPTCHA .

ImmunityTime -> (long)

Количество времени в секундах, в течение которого метка времени CAPTCHA или challenge считается действительной WAF. Настройка по умолчанию — 300.

Для действия Challenge минимальная настройка — 300.

ChallengeConfig -> (структура)

Указывает, как WAF должен обрабатывать оценки challenge для правил, у которых нет собственных настроек ChallengeConfig . Если вы не укажете это, WAF использует свои настройки по умолчанию для ChallengeConfig .

ImmunityTimeProperty -> (структура)

Определяет, как долго метка времени challenge в токене остается действительной после того, как клиент успешно отвечает на challenge.

ImmunityTime -> (long)

Количество времени в секундах, в течение которого метка времени CAPTCHA или challenge считается действительной WAF. Настройка по умолчанию — 300.

Для действия Challenge минимальная настройка — 300.

TokenDomains -> (список)

Указывает домены, которые WAF должен принимать в токене веб-запроса. Это позволяет использовать токены на нескольких защищенных веб-сайтах. Когда WAF предоставляет токен, он использует домен ресурса Amazon Web Services, который защищает веб-ACL. Если вы не укажете список доменов токенов, WAF принимает токены только для домена защищенного ресурса. Со списком доменов токенов WAF принимает домен хоста ресурса плюс все домены в списке доменов токенов, включая их префиксные поддомены.

(строка)

AssociationConfig -> (структура)

Указывает пользовательские настройки для связей между веб-ACL и защищенными ресурсами.

Используйте это, чтобы настроить максимальный размер тела запроса, который ваши защищенные ресурсы пересылают в WAF для проверки. Вы можете настроить этот параметр для ресурсов CloudFront, API Gateway, Amazon Cognito, App Runner или Verified Access. Настройка по умолчанию — 16 КБ (16 384 байта).

Примечание

С вас взимается дополнительная плата, когда ваши защищенные ресурсы пересылают размеры тела, превышающие размер по умолчанию. Дополнительную информацию см. в разделе WAF Pricing .

Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).

RequestBody -> (карта)

Настраивает максимальный размер тела запроса, который ваши защищенные ресурсы CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access пересылают в WAF для проверки. Размер по умолчанию — 16 КБ (16 384 байта). Вы можете изменить настройку для любого из доступных типов ресурсов.

Примечание

С вас взимается дополнительная плата, когда ваши защищенные ресурсы пересылают размеры тела, превышающие размер по умолчанию. Дополнительную информацию см. в разделе WAF Pricing .

Пример JSON: { "API_GATEWAY": "KB_48", "APP_RUNNER_SERVICE": "KB_32" }

Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).

key -> (строка)

value -> (структура)

Настраивает максимальный размер тела запроса, который ваши защищенные ресурсы CloudFront, API Gateway, Amazon Cognito, App Runner и Verified Access пересылают в WAF для проверки. Размер по умолчанию — 16 КБ (16 384 байта). Вы можете изменить настройку для любого из доступных типов ресурсов.

Примечание

С вас взимается дополнительная плата, когда ваши защищенные ресурсы пересылают размеры тела, превышающие размер по умолчанию. Дополнительную информацию см. в разделе WAF Pricing .

Пример JSON: { "API_GATEWAY": "KB_48", "APP_RUNNER_SERVICE": "KB_32" }

Для Application Load Balancer и AppSync лимит фиксирован на уровне 8 КБ (8 192 байта).

Это используется в AssociationConfig веб-ACL.

DefaultSizeInspectionLimit -> (строка)

Указывает максимальный размер компонента тела веб-запроса, который связанный ресурс CloudFront, API Gateway, Amazon Cognito, App Runner или Verified Access должен отправлять в WAF для проверки. Это относится к операторам в веб-ACL, которые проверяют тело или тело JSON.

По умолчанию: 16 KB (16,384 bytes)

RetrofittedByFirewallManager -> (логическое значение)

Указывает, был ли этот веб-ACL создан учетной записью клиента, а затем доработан Firewall Manager. Если true, то веб-ACL в настоящее время управляется политикой WAF Firewall Manager, и только Firewall Manager может управлять любыми группами правил Firewall Manager в веб-ACL. См. также свойства ManagedByFirewallManager , PreProcessFirewallManagerRuleGroups и PostProcessFirewallManagerRuleGroups .

LockToken -> (string)

Токен, используемый для оптимистичной блокировки. WAF возвращает токен вашим get и list запросам, чтобы отметить состояние сущности на момент запроса. Чтобы внести изменения в сущность, связанную с токеном, вы предоставляете токен таким операциям, как update и delete . WAF использует токен, чтобы гарантировать, что в сущность не было внесено никаких изменений с момента ее последнего извлечения. Если изменение было внесено, обновление завершится неудачей с WAFOptimisticLockException . Если это произойдет, выполните еще один get и используйте новый токен, возвращенный этой операцией.

ApplicationIntegrationURL -> (string)

URL-адрес для использования в интеграциях SDK с управляемыми группами правил Amazon Web Services. Например, вы можете использовать интеграционные SDK с управляемой группой правил предотвращения захвата учетной записи AWSManagedRulesATPRuleSet и управляемой группой правил предотвращения мошенничества при создании учетной записи AWSManagedRulesACFPRuleSet . Это заполняется только в том случае, если вы используете группу правил в своем веб-ACL, которая интегрируется с вашими приложениями таким образом. Для получения дополнительной информации см. раздел Интеграция клиентских приложений WAF в Руководстве разработчика WAF .

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API