/** * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * SPDX-License-Identifier: Apache-2.0. */ #pragma once #include #include #include #include #include #include #include namespace Aws { namespace Utils { namespace Json { class JsonValue; class JsonView; } // namespace Json } // namespace Utils namespace WAFV2 { namespace Model { /** *

This is the latest version of AWS WAF, named AWS WAFV2, * released in November, 2019. For information, including how to migrate your AWS * WAF resources from the prior release, see the AWS * WAF Developer Guide.

A rule statement that defines a string * match search for AWS WAF to apply to web requests. The byte match statement * provides the bytes to search for, the location in requests that you want AWS WAF * to search, and other settings. The bytes to search for are typically a string * that corresponds with ASCII characters. In the AWS WAF console and the developer * guide, this is refered to as a string match statement.

See Also:

* AWS * API Reference

*/ class AWS_WAFV2_API ByteMatchStatement { public: ByteMatchStatement(); ByteMatchStatement(Aws::Utils::Json::JsonView jsonValue); ByteMatchStatement& operator=(Aws::Utils::Json::JsonView jsonValue); Aws::Utils::Json::JsonValue Jsonize() const; /** *

A string value that you want AWS WAF to search for. AWS WAF searches only in * the part of web requests that you designate for inspection in * FieldToMatch. The maximum length of the value is 50 bytes.

Valid * values depend on the component that you specify for inspection in * FieldToMatch:

  • Method: The HTTP * method that you want AWS WAF to search for. This indicates the type of operation * specified in the request.

  • UriPath: The value * that you want AWS WAF to search for in the URI path, for example, * /images/daily-ad.jpg.

If * SearchString includes alphabetic characters A-Z and a-z, note that * the value is case sensitive.

If you're using the AWS WAF API

*

Specify a base64-encoded version of the value. The maximum length of the * value before you base64-encode it is 50 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 AWS CLI or one of the * AWS SDKs

The value that you want AWS WAF to search for. The SDK * automatically base64 encodes the value.

*/ inline const Aws::Utils::ByteBuffer& GetSearchString() const{ return m_searchString; } /** *

A string value that you want AWS WAF to search for. AWS WAF searches only in * the part of web requests that you designate for inspection in * FieldToMatch. The maximum length of the value is 50 bytes.

Valid * values depend on the component that you specify for inspection in * FieldToMatch:

  • Method: The HTTP * method that you want AWS WAF to search for. This indicates the type of operation * specified in the request.

  • UriPath: The value * that you want AWS WAF to search for in the URI path, for example, * /images/daily-ad.jpg.

If * SearchString includes alphabetic characters A-Z and a-z, note that * the value is case sensitive.

If you're using the AWS WAF API

*

Specify a base64-encoded version of the value. The maximum length of the * value before you base64-encode it is 50 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 AWS CLI or one of the * AWS SDKs

The value that you want AWS WAF to search for. The SDK * automatically base64 encodes the value.

*/ inline bool SearchStringHasBeenSet() const { return m_searchStringHasBeenSet; } /** *

A string value that you want AWS WAF to search for. AWS WAF searches only in * the part of web requests that you designate for inspection in * FieldToMatch. The maximum length of the value is 50 bytes.

Valid * values depend on the component that you specify for inspection in * FieldToMatch:

  • Method: The HTTP * method that you want AWS WAF to search for. This indicates the type of operation * specified in the request.

  • UriPath: The value * that you want AWS WAF to search for in the URI path, for example, * /images/daily-ad.jpg.

If * SearchString includes alphabetic characters A-Z and a-z, note that * the value is case sensitive.

If you're using the AWS WAF API

*

Specify a base64-encoded version of the value. The maximum length of the * value before you base64-encode it is 50 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 AWS CLI or one of the * AWS SDKs

The value that you want AWS WAF to search for. The SDK * automatically base64 encodes the value.

*/ inline void SetSearchString(const Aws::Utils::ByteBuffer& value) { m_searchStringHasBeenSet = true; m_searchString = value; } /** *

A string value that you want AWS WAF to search for. AWS WAF searches only in * the part of web requests that you designate for inspection in * FieldToMatch. The maximum length of the value is 50 bytes.

Valid * values depend on the component that you specify for inspection in * FieldToMatch:

  • Method: The HTTP * method that you want AWS WAF to search for. This indicates the type of operation * specified in the request.

  • UriPath: The value * that you want AWS WAF to search for in the URI path, for example, * /images/daily-ad.jpg.

If * SearchString includes alphabetic characters A-Z and a-z, note that * the value is case sensitive.

If you're using the AWS WAF API

*

Specify a base64-encoded version of the value. The maximum length of the * value before you base64-encode it is 50 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 AWS CLI or one of the * AWS SDKs

The value that you want AWS WAF to search for. The SDK * automatically base64 encodes the value.

*/ inline void SetSearchString(Aws::Utils::ByteBuffer&& value) { m_searchStringHasBeenSet = true; m_searchString = std::move(value); } /** *

A string value that you want AWS WAF to search for. AWS WAF searches only in * the part of web requests that you designate for inspection in * FieldToMatch. The maximum length of the value is 50 bytes.

Valid * values depend on the component that you specify for inspection in * FieldToMatch:

  • Method: The HTTP * method that you want AWS WAF to search for. This indicates the type of operation * specified in the request.

  • UriPath: The value * that you want AWS WAF to search for in the URI path, for example, * /images/daily-ad.jpg.

If * SearchString includes alphabetic characters A-Z and a-z, note that * the value is case sensitive.

If you're using the AWS WAF API

*

Specify a base64-encoded version of the value. The maximum length of the * value before you base64-encode it is 50 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 AWS CLI or one of the * AWS SDKs

The value that you want AWS WAF to search for. The SDK * automatically base64 encodes the value.

*/ inline ByteMatchStatement& WithSearchString(const Aws::Utils::ByteBuffer& value) { SetSearchString(value); return *this;} /** *

A string value that you want AWS WAF to search for. AWS WAF searches only in * the part of web requests that you designate for inspection in * FieldToMatch. The maximum length of the value is 50 bytes.

Valid * values depend on the component that you specify for inspection in * FieldToMatch:

  • Method: The HTTP * method that you want AWS WAF to search for. This indicates the type of operation * specified in the request.

  • UriPath: The value * that you want AWS WAF to search for in the URI path, for example, * /images/daily-ad.jpg.

If * SearchString includes alphabetic characters A-Z and a-z, note that * the value is case sensitive.

If you're using the AWS WAF API

*

Specify a base64-encoded version of the value. The maximum length of the * value before you base64-encode it is 50 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 AWS CLI or one of the * AWS SDKs

The value that you want AWS WAF to search for. The SDK * automatically base64 encodes the value.

*/ inline ByteMatchStatement& WithSearchString(Aws::Utils::ByteBuffer&& value) { SetSearchString(std::move(value)); return *this;} /** *

The part of a web request that you want AWS WAF to inspect. For more * information, see FieldToMatch.

*/ inline const FieldToMatch& GetFieldToMatch() const{ return m_fieldToMatch; } /** *

The part of a web request that you want AWS WAF to inspect. For more * information, see FieldToMatch.

*/ inline bool FieldToMatchHasBeenSet() const { return m_fieldToMatchHasBeenSet; } /** *

The part of a web request that you want AWS WAF to inspect. For more * information, see FieldToMatch.

*/ inline void SetFieldToMatch(const FieldToMatch& value) { m_fieldToMatchHasBeenSet = true; m_fieldToMatch = value; } /** *

The part of a web request that you want AWS WAF to inspect. For more * information, see FieldToMatch.

*/ inline void SetFieldToMatch(FieldToMatch&& value) { m_fieldToMatchHasBeenSet = true; m_fieldToMatch = std::move(value); } /** *

The part of a web request that you want AWS WAF to inspect. For more * information, see FieldToMatch.

*/ inline ByteMatchStatement& WithFieldToMatch(const FieldToMatch& value) { SetFieldToMatch(value); return *this;} /** *

The part of a web request that you want AWS WAF to inspect. For more * information, see FieldToMatch.

*/ inline ByteMatchStatement& WithFieldToMatch(FieldToMatch&& value) { SetFieldToMatch(std::move(value)); return *this;} /** *

Text transformations eliminate some of the unusual formatting that attackers * use in web requests in an effort to bypass detection. If you specify one or more * transformations in a rule statement, AWS WAF performs all transformations on the * content of the request component identified by FieldToMatch, * starting from the lowest priority setting, before inspecting the content for a * match.

*/ inline const Aws::Vector& GetTextTransformations() const{ return m_textTransformations; } /** *

Text transformations eliminate some of the unusual formatting that attackers * use in web requests in an effort to bypass detection. If you specify one or more * transformations in a rule statement, AWS WAF performs all transformations on the * content of the request component identified by FieldToMatch, * starting from the lowest priority setting, before inspecting the content for a * match.

*/ inline bool TextTransformationsHasBeenSet() const { return m_textTransformationsHasBeenSet; } /** *

Text transformations eliminate some of the unusual formatting that attackers * use in web requests in an effort to bypass detection. If you specify one or more * transformations in a rule statement, AWS WAF performs all transformations on the * content of the request component identified by FieldToMatch, * starting from the lowest priority setting, before inspecting the content for a * match.

*/ inline void SetTextTransformations(const Aws::Vector& value) { m_textTransformationsHasBeenSet = true; m_textTransformations = value; } /** *

Text transformations eliminate some of the unusual formatting that attackers * use in web requests in an effort to bypass detection. If you specify one or more * transformations in a rule statement, AWS WAF performs all transformations on the * content of the request component identified by FieldToMatch, * starting from the lowest priority setting, before inspecting the content for a * match.

*/ inline void SetTextTransformations(Aws::Vector&& value) { m_textTransformationsHasBeenSet = true; m_textTransformations = std::move(value); } /** *

Text transformations eliminate some of the unusual formatting that attackers * use in web requests in an effort to bypass detection. If you specify one or more * transformations in a rule statement, AWS WAF performs all transformations on the * content of the request component identified by FieldToMatch, * starting from the lowest priority setting, before inspecting the content for a * match.

*/ inline ByteMatchStatement& WithTextTransformations(const Aws::Vector& value) { SetTextTransformations(value); return *this;} /** *

Text transformations eliminate some of the unusual formatting that attackers * use in web requests in an effort to bypass detection. If you specify one or more * transformations in a rule statement, AWS WAF performs all transformations on the * content of the request component identified by FieldToMatch, * starting from the lowest priority setting, before inspecting the content for a * match.

*/ inline ByteMatchStatement& WithTextTransformations(Aws::Vector&& value) { SetTextTransformations(std::move(value)); return *this;} /** *

Text transformations eliminate some of the unusual formatting that attackers * use in web requests in an effort to bypass detection. If you specify one or more * transformations in a rule statement, AWS WAF performs all transformations on the * content of the request component identified by FieldToMatch, * starting from the lowest priority setting, before inspecting the content for a * match.

*/ inline ByteMatchStatement& AddTextTransformations(const TextTransformation& value) { m_textTransformationsHasBeenSet = true; m_textTransformations.push_back(value); return *this; } /** *

Text transformations eliminate some of the unusual formatting that attackers * use in web requests in an effort to bypass detection. If you specify one or more * transformations in a rule statement, AWS WAF performs all transformations on the * content of the request component identified by FieldToMatch, * starting from the lowest priority setting, before inspecting the content for a * match.

*/ inline ByteMatchStatement& AddTextTransformations(TextTransformation&& value) { m_textTransformationsHasBeenSet = true; m_textTransformations.push_back(std::move(value)); return *this; } /** *

The area within the portion of a web request that you want AWS WAF to search * for SearchString. Valid values include the following:

* CONTAINS

The specified part of the web request must include the * value of SearchString, but the location doesn't matter.

* CONTAINS_WORD

The specified part of the web request must include * the value of SearchString, and SearchString must * contain only alphanumeric characters or underscore (A-Z, a-z, 0-9, or _). In * addition, SearchString must be a word, which means that both of the * following are true:

  • SearchString is at the * beginning of the specified part of the web request or is preceded by a character * other than an alphanumeric character or underscore (_). Examples include the * value of a header and ;BadBot.

  • * SearchString is at the end of the specified part of the web request * or is followed by a character other than an alphanumeric character or underscore * (_), for example, BadBot; and -BadBot;.

  • *

EXACTLY

The value of the specified part of the web * request must exactly match the value of SearchString.

* STARTS_WITH

The value of SearchString must appear at * the beginning of the specified part of the web request.

ENDS_WITH *

The value of SearchString must appear at the end of the * specified part of the web request.

*/ inline const PositionalConstraint& GetPositionalConstraint() const{ return m_positionalConstraint; } /** *

The area within the portion of a web request that you want AWS WAF to search * for SearchString. Valid values include the following:

* CONTAINS

The specified part of the web request must include the * value of SearchString, but the location doesn't matter.

* CONTAINS_WORD

The specified part of the web request must include * the value of SearchString, and SearchString must * contain only alphanumeric characters or underscore (A-Z, a-z, 0-9, or _). In * addition, SearchString must be a word, which means that both of the * following are true:

  • SearchString is at the * beginning of the specified part of the web request or is preceded by a character * other than an alphanumeric character or underscore (_). Examples include the * value of a header and ;BadBot.

  • * SearchString is at the end of the specified part of the web request * or is followed by a character other than an alphanumeric character or underscore * (_), for example, BadBot; and -BadBot;.

  • *

EXACTLY

The value of the specified part of the web * request must exactly match the value of SearchString.

* STARTS_WITH

The value of SearchString must appear at * the beginning of the specified part of the web request.

ENDS_WITH *

The value of SearchString must appear at the end of the * specified part of the web request.

*/ inline bool PositionalConstraintHasBeenSet() const { return m_positionalConstraintHasBeenSet; } /** *

The area within the portion of a web request that you want AWS WAF to search * for SearchString. Valid values include the following:

* CONTAINS

The specified part of the web request must include the * value of SearchString, but the location doesn't matter.

* CONTAINS_WORD

The specified part of the web request must include * the value of SearchString, and SearchString must * contain only alphanumeric characters or underscore (A-Z, a-z, 0-9, or _). In * addition, SearchString must be a word, which means that both of the * following are true:

  • SearchString is at the * beginning of the specified part of the web request or is preceded by a character * other than an alphanumeric character or underscore (_). Examples include the * value of a header and ;BadBot.

  • * SearchString is at the end of the specified part of the web request * or is followed by a character other than an alphanumeric character or underscore * (_), for example, BadBot; and -BadBot;.

  • *

EXACTLY

The value of the specified part of the web * request must exactly match the value of SearchString.

* STARTS_WITH

The value of SearchString must appear at * the beginning of the specified part of the web request.

ENDS_WITH *

The value of SearchString must appear at the end of the * specified part of the web request.

*/ inline void SetPositionalConstraint(const PositionalConstraint& value) { m_positionalConstraintHasBeenSet = true; m_positionalConstraint = value; } /** *

The area within the portion of a web request that you want AWS WAF to search * for SearchString. Valid values include the following:

* CONTAINS

The specified part of the web request must include the * value of SearchString, but the location doesn't matter.

* CONTAINS_WORD

The specified part of the web request must include * the value of SearchString, and SearchString must * contain only alphanumeric characters or underscore (A-Z, a-z, 0-9, or _). In * addition, SearchString must be a word, which means that both of the * following are true:

  • SearchString is at the * beginning of the specified part of the web request or is preceded by a character * other than an alphanumeric character or underscore (_). Examples include the * value of a header and ;BadBot.

  • * SearchString is at the end of the specified part of the web request * or is followed by a character other than an alphanumeric character or underscore * (_), for example, BadBot; and -BadBot;.

  • *

EXACTLY

The value of the specified part of the web * request must exactly match the value of SearchString.

* STARTS_WITH

The value of SearchString must appear at * the beginning of the specified part of the web request.

ENDS_WITH *

The value of SearchString must appear at the end of the * specified part of the web request.

*/ inline void SetPositionalConstraint(PositionalConstraint&& value) { m_positionalConstraintHasBeenSet = true; m_positionalConstraint = std::move(value); } /** *

The area within the portion of a web request that you want AWS WAF to search * for SearchString. Valid values include the following:

* CONTAINS

The specified part of the web request must include the * value of SearchString, but the location doesn't matter.

* CONTAINS_WORD

The specified part of the web request must include * the value of SearchString, and SearchString must * contain only alphanumeric characters or underscore (A-Z, a-z, 0-9, or _). In * addition, SearchString must be a word, which means that both of the * following are true:

  • SearchString is at the * beginning of the specified part of the web request or is preceded by a character * other than an alphanumeric character or underscore (_). Examples include the * value of a header and ;BadBot.

  • * SearchString is at the end of the specified part of the web request * or is followed by a character other than an alphanumeric character or underscore * (_), for example, BadBot; and -BadBot;.

  • *

EXACTLY

The value of the specified part of the web * request must exactly match the value of SearchString.

* STARTS_WITH

The value of SearchString must appear at * the beginning of the specified part of the web request.

ENDS_WITH *

The value of SearchString must appear at the end of the * specified part of the web request.

*/ inline ByteMatchStatement& WithPositionalConstraint(const PositionalConstraint& value) { SetPositionalConstraint(value); return *this;} /** *

The area within the portion of a web request that you want AWS WAF to search * for SearchString. Valid values include the following:

* CONTAINS

The specified part of the web request must include the * value of SearchString, but the location doesn't matter.

* CONTAINS_WORD

The specified part of the web request must include * the value of SearchString, and SearchString must * contain only alphanumeric characters or underscore (A-Z, a-z, 0-9, or _). In * addition, SearchString must be a word, which means that both of the * following are true:

  • SearchString is at the * beginning of the specified part of the web request or is preceded by a character * other than an alphanumeric character or underscore (_). Examples include the * value of a header and ;BadBot.

  • * SearchString is at the end of the specified part of the web request * or is followed by a character other than an alphanumeric character or underscore * (_), for example, BadBot; and -BadBot;.

  • *

EXACTLY

The value of the specified part of the web * request must exactly match the value of SearchString.

* STARTS_WITH

The value of SearchString must appear at * the beginning of the specified part of the web request.

ENDS_WITH *

The value of SearchString must appear at the end of the * specified part of the web request.

*/ inline ByteMatchStatement& WithPositionalConstraint(PositionalConstraint&& value) { SetPositionalConstraint(std::move(value)); return *this;} private: Aws::Utils::ByteBuffer m_searchString; bool m_searchStringHasBeenSet; FieldToMatch m_fieldToMatch; bool m_fieldToMatchHasBeenSet; Aws::Vector m_textTransformations; bool m_textTransformationsHasBeenSet; PositionalConstraint m_positionalConstraint; bool m_positionalConstraintHasBeenSet; }; } // namespace Model } // namespace WAFV2 } // namespace Aws