/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.wafv2.model; import java.io.Serializable; import javax.annotation.Generated; import com.amazonaws.protocol.StructuredPojo; import com.amazonaws.protocol.ProtocolMarshaller; /** *
* Inspect the cookies in the web request. You can specify the parts of the cookies to inspect and you can narrow the * set of cookies to inspect by including or excluding specific keys. *
** This is used to indicate the web request component to inspect, in the FieldToMatch specification. *
*
* Example JSON:
* "Cookies": { "MatchPattern": { "All": {} }, "MatchScope": "KEY", "OversizeHandling": "MATCH" }
*
* The filter to use to identify the subset of cookies to inspect in a web request. *
*
* You must specify exactly one setting: either All
, IncludedCookies
, or
* ExcludedCookies
.
*
* Example JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
*
* The parts of the cookies to inspect with the rule inspection criteria. If you specify All
, WAF
* inspects both keys and values.
*
* What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect. WAF does not * support inspecting the entire contents of request cookies when they exceed 8 KB (8192 bytes) or 200 total * cookies. The underlying host service forwards a maximum of 200 cookies and at most 8 KB of cookie contents to * WAF. *
** The options for oversize handling are the following: *
*
* CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria.
*
* 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.
*
* The filter to use to identify the subset of cookies to inspect in a web request. *
*
* You must specify exactly one setting: either All
, IncludedCookies
, or
* ExcludedCookies
.
*
* Example JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
*
* You must specify exactly one setting: either All
, IncludedCookies
, or
* ExcludedCookies
.
*
* Example JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
*/
public void setMatchPattern(CookieMatchPattern matchPattern) {
this.matchPattern = matchPattern;
}
/**
*
* The filter to use to identify the subset of cookies to inspect in a web request. *
*
* You must specify exactly one setting: either All
, IncludedCookies
, or
* ExcludedCookies
.
*
* Example JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
*
* You must specify exactly one setting: either All
, IncludedCookies
, or
* ExcludedCookies
.
*
* Example JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
*/
public CookieMatchPattern getMatchPattern() {
return this.matchPattern;
}
/**
*
* The filter to use to identify the subset of cookies to inspect in a web request. *
*
* You must specify exactly one setting: either All
, IncludedCookies
, or
* ExcludedCookies
.
*
* Example JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
*
* You must specify exactly one setting: either All
, IncludedCookies
, or
* ExcludedCookies
.
*
* Example JSON: "MatchPattern": { "IncludedCookies": [ "session-id-time", "session-id" ] }
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Cookies withMatchPattern(CookieMatchPattern matchPattern) {
setMatchPattern(matchPattern);
return this;
}
/**
*
* The parts of the cookies to inspect with the rule inspection criteria. If you specify All
, WAF
* inspects both keys and values.
*
All
,
* WAF inspects both keys and values.
* @see MapMatchScope
*/
public void setMatchScope(String matchScope) {
this.matchScope = matchScope;
}
/**
*
* The parts of the cookies to inspect with the rule inspection criteria. If you specify All
, WAF
* inspects both keys and values.
*
All
,
* WAF inspects both keys and values.
* @see MapMatchScope
*/
public String getMatchScope() {
return this.matchScope;
}
/**
*
* The parts of the cookies to inspect with the rule inspection criteria. If you specify All
, WAF
* inspects both keys and values.
*
All
,
* WAF inspects both keys and values.
* @return Returns a reference to this object so that method calls can be chained together.
* @see MapMatchScope
*/
public Cookies withMatchScope(String matchScope) {
setMatchScope(matchScope);
return this;
}
/**
*
* The parts of the cookies to inspect with the rule inspection criteria. If you specify All
, WAF
* inspects both keys and values.
*
All
,
* WAF inspects both keys and values.
* @return Returns a reference to this object so that method calls can be chained together.
* @see MapMatchScope
*/
public Cookies withMatchScope(MapMatchScope matchScope) {
this.matchScope = matchScope.toString();
return this;
}
/**
* * What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect. WAF does not * support inspecting the entire contents of request cookies when they exceed 8 KB (8192 bytes) or 200 total * cookies. The underlying host service forwards a maximum of 200 cookies and at most 8 KB of cookie contents to * WAF. *
** The options for oversize handling are the following: *
*
* CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria.
*
* 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.
*
* The options for oversize handling are the following: *
*
* CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria.
*
* 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.
*
* What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect. WAF does not * support inspecting the entire contents of request cookies when they exceed 8 KB (8192 bytes) or 200 total * cookies. The underlying host service forwards a maximum of 200 cookies and at most 8 KB of cookie contents to * WAF. *
** The options for oversize handling are the following: *
*
* CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria.
*
* 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.
*
* The options for oversize handling are the following: *
*
* CONTINUE
- Inspect the available cookies normally, according to the rule inspection
* criteria.
*
* 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.
*
* What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect. WAF does not * support inspecting the entire contents of request cookies when they exceed 8 KB (8192 bytes) or 200 total * cookies. The underlying host service forwards a maximum of 200 cookies and at most 8 KB of cookie contents to * WAF. *
** The options for oversize handling are the following: *
*
* CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria.
*
* 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.
*
* The options for oversize handling are the following: *
*
* CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria.
*
* 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.
*
* What WAF should do if the cookies of the request are more numerous or larger than WAF can inspect. WAF does not * support inspecting the entire contents of request cookies when they exceed 8 KB (8192 bytes) or 200 total * cookies. The underlying host service forwards a maximum of 200 cookies and at most 8 KB of cookie contents to * WAF. *
** The options for oversize handling are the following: *
*
* CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria.
*
* 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.
*
* The options for oversize handling are the following: *
*
* CONTINUE
- Inspect the available cookies normally, according to the rule inspection criteria.
*
* 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.
*