#[non_exhaustive]pub struct ByteMatchStatementBuilder { /* private fields */ }
Expand description
A builder for ByteMatchStatement
.
Implementations§
Source§impl ByteMatchStatementBuilder
impl ByteMatchStatementBuilder
Sourcepub fn search_string(self, input: Blob) -> Self
pub fn search_string(self, input: Blob) -> Self
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 matchByteMatchStatement
with thePositionalConstraint
set toEXACTLY
.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.
This field is required.Sourcepub fn set_search_string(self, input: Option<Blob>) -> Self
pub fn set_search_string(self, input: Option<Blob>) -> Self
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 matchByteMatchStatement
with thePositionalConstraint
set toEXACTLY
.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.
Sourcepub fn get_search_string(&self) -> &Option<Blob>
pub fn get_search_string(&self) -> &Option<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 matchByteMatchStatement
with thePositionalConstraint
set toEXACTLY
.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.
Sourcepub fn field_to_match(self, input: FieldToMatch) -> Self
pub fn field_to_match(self, input: FieldToMatch) -> Self
The part of the web request that you want WAF to inspect.
This field is required.Sourcepub fn set_field_to_match(self, input: Option<FieldToMatch>) -> Self
pub fn set_field_to_match(self, input: Option<FieldToMatch>) -> Self
The part of the web request that you want WAF to inspect.
Sourcepub fn get_field_to_match(&self) -> &Option<FieldToMatch>
pub fn get_field_to_match(&self) -> &Option<FieldToMatch>
The part of the web request that you want WAF to inspect.
Sourcepub fn text_transformations(self, input: TextTransformation) -> Self
pub fn text_transformations(self, input: TextTransformation) -> Self
Appends an item to text_transformations
.
To override the contents of this collection use set_text_transformations
.
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.
Sourcepub fn set_text_transformations(
self,
input: Option<Vec<TextTransformation>>,
) -> Self
pub fn set_text_transformations( self, input: Option<Vec<TextTransformation>>, ) -> Self
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.
Sourcepub fn get_text_transformations(&self) -> &Option<Vec<TextTransformation>>
pub fn get_text_transformations(&self) -> &Option<Vec<TextTransformation>>
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.
Sourcepub fn positional_constraint(self, input: PositionalConstraint) -> Self
pub fn positional_constraint(self, input: PositionalConstraint) -> Self
The area within the portion of the web request that you want 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.
Sourcepub fn set_positional_constraint(
self,
input: Option<PositionalConstraint>,
) -> Self
pub fn set_positional_constraint( self, input: Option<PositionalConstraint>, ) -> Self
The area within the portion of the web request that you want 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.
Sourcepub fn get_positional_constraint(&self) -> &Option<PositionalConstraint>
pub fn get_positional_constraint(&self) -> &Option<PositionalConstraint>
The area within the portion of the web request that you want 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.
Sourcepub fn build(self) -> Result<ByteMatchStatement, BuildError>
pub fn build(self) -> Result<ByteMatchStatement, BuildError>
Consumes the builder and constructs a ByteMatchStatement
.
This method will fail if any of the following fields are not set:
Trait Implementations§
Source§impl Clone for ByteMatchStatementBuilder
impl Clone for ByteMatchStatementBuilder
Source§fn clone(&self) -> ByteMatchStatementBuilder
fn clone(&self) -> ByteMatchStatementBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for ByteMatchStatementBuilder
impl Debug for ByteMatchStatementBuilder
Source§impl Default for ByteMatchStatementBuilder
impl Default for ByteMatchStatementBuilder
Source§fn default() -> ByteMatchStatementBuilder
fn default() -> ByteMatchStatementBuilder
impl StructuralPartialEq for ByteMatchStatementBuilder
Auto Trait Implementations§
impl Freeze for ByteMatchStatementBuilder
impl RefUnwindSafe for ByteMatchStatementBuilder
impl Send for ByteMatchStatementBuilder
impl Sync for ByteMatchStatementBuilder
impl Unpin for ByteMatchStatementBuilder
impl UnwindSafe for ByteMatchStatementBuilder
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Returns self
with the
fg()
set to
Color::BrightBlack
.
§Example
println!("{}", value.bright_black());
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Returns self
with the
fg()
set to
Color::BrightGreen
.
§Example
println!("{}", value.bright_green());
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Returns self
with the
fg()
set to
Color::BrightYellow
.
§Example
println!("{}", value.bright_yellow());
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Returns self
with the
fg()
set to
Color::BrightMagenta
.
§Example
println!("{}", value.bright_magenta());
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Returns self
with the
fg()
set to
Color::BrightWhite
.
§Example
println!("{}", value.bright_white());
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightBlack
.
§Example
println!("{}", value.on_bright_black());
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightGreen
.
§Example
println!("{}", value.on_bright_green());
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightYellow
.
§Example
println!("{}", value.on_bright_yellow());
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightBlue
.
§Example
println!("{}", value.on_bright_blue());
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightMagenta
.
§Example
println!("{}", value.on_bright_magenta());
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightCyan
.
§Example
println!("{}", value.on_bright_cyan());
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightWhite
.
§Example
println!("{}", value.on_bright_white());
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn underline(&self) -> Painted<&T>
fn underline(&self) -> Painted<&T>
Returns self
with the
attr()
set to
Attribute::Underline
.
§Example
println!("{}", value.underline());
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Returns self
with the
attr()
set to
Attribute::RapidBlink
.
§Example
println!("{}", value.rapid_blink());
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);