View a markdown version of this page

XssMatchStatement - AWS WAFV2

XssMatchStatement

A rule statement that inspects for cross-site scripting (XSS) attacks. In XSS attacks, the attacker uses vulnerabilities in a benign website as a vehicle to inject malicious client-site scripts into other legitimate web browsers.

Contents

FieldToMatch

The part of the web request that you want AWS WAF to inspect.

Type: FieldToMatch object

Required: Yes

TextTransformations

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, AWS WAF performs all transformations on the specified content, starting from the lowest priority setting, and then uses the transformed component contents.

Type: Array of TextTransformation objects

Array Members: Minimum number of 1 item.

Required: Yes

PreParseTextTransformations

Pre-parse text transformations normalize the raw query string before AWS WAF parses it into individual query arguments. They are applied before the standard text transformations. Pre-parse text transformations are only supported when FieldToMatch is SingleQueryArgument or AllQueryArguments. You can specify up to 3 pre-parse text transformations per rule statement.

Type: Array of PreParseTextTransformation objects

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: