/* * Copyright 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. */ /* * Do not modify this file. This file is generated from the wafv2-2019-07-29.normal.json service model. */ using System; using System.Collections.Generic; using System.Xml.Serialization; using System.Text; using System.IO; using System.Net; using Amazon.Runtime; using Amazon.Runtime.Internal; namespace Amazon.WAFV2.Model { /// /// A web ACL defines a collection of rules to use to inspect and control web requests. /// Each rule has an action defined (allow, block, or count) for requests that match the /// statement of the rule. In the web ACL, you assign a default action to take (allow, /// block) for any request that does not match any of the rules. The rules in a web ACL /// can be a combination of the types Rule, RuleGroup, and managed rule /// group. You can associate a web ACL with one or more Amazon Web Services resources /// to protect. The resources can be an Amazon CloudFront distribution, an Amazon API /// Gateway REST API, an Application Load Balancer, an AppSync GraphQL API, an Amazon /// Cognito user pool, an App Runner service, or an Amazon Web Services Verified Access /// instance. /// public partial class WebACL { private string _arn; private AssociationConfig _associationConfig; private long? _capacity; private CaptchaConfig _captchaConfig; private ChallengeConfig _challengeConfig; private Dictionary _customResponseBodies = new Dictionary(); private DefaultAction _defaultAction; private string _description; private string _id; private string _labelNamespace; private bool? _managedByFirewallManager; private string _name; private List _postProcessFirewallManagerRuleGroups = new List(); private List _preProcessFirewallManagerRuleGroups = new List(); private List _rules = new List(); private List _tokenDomains = new List(); private VisibilityConfig _visibilityConfig; /// /// Gets and sets the property ARN. /// /// The Amazon Resource Name (ARN) of the web ACL that you want to associate with the /// resource. /// /// [AWSProperty(Required=true, Min=20, Max=2048)] public string ARN { get { return this._arn; } set { this._arn = value; } } // Check to see if ARN property is set internal bool IsSetARN() { return this._arn != null; } /// /// Gets and sets the property AssociationConfig. /// /// Specifies custom configurations for the associations between the web ACL and protected /// resources. /// /// /// /// Use this to customize the maximum size of the request body that your protected CloudFront /// distributions forward to WAF for inspection. The default is 16 KB (16,384 kilobytes). /// /// /// /// /// You are charged additional fees when your protected resources forward body sizes that /// are larger than the default. For more information, see WAF /// Pricing. /// /// /// public AssociationConfig AssociationConfig { get { return this._associationConfig; } set { this._associationConfig = value; } } // Check to see if AssociationConfig property is set internal bool IsSetAssociationConfig() { return this._associationConfig != null; } /// /// Gets and sets the property Capacity. /// /// The web ACL capacity units (WCUs) currently being used by this web ACL. /// /// /// /// WAF uses WCUs to calculate and control the operating resources that are used to run /// your rules, rule groups, and web ACLs. WAF calculates capacity differently for each /// rule type, to reflect the relative cost of each rule. Simple rules that cost little /// to run use fewer WCUs than more complex rules that use more processing power. Rule /// group capacity is fixed at creation, which helps users plan their web ACL WCU usage /// when they use a rule group. For more information, see WAF /// web ACL capacity units (WCU) in the WAF Developer Guide. /// /// [AWSProperty(Min=0)] public long Capacity { get { return this._capacity.GetValueOrDefault(); } set { this._capacity = value; } } // Check to see if Capacity property is set internal bool IsSetCapacity() { return this._capacity.HasValue; } /// /// Gets and sets the property CaptchaConfig. /// /// Specifies how WAF should handle CAPTCHA evaluations for rules that don't /// have their own CaptchaConfig settings. If you don't specify this, WAF /// uses its default settings for CaptchaConfig. /// /// public CaptchaConfig CaptchaConfig { get { return this._captchaConfig; } set { this._captchaConfig = value; } } // Check to see if CaptchaConfig property is set internal bool IsSetCaptchaConfig() { return this._captchaConfig != null; } /// /// Gets and sets the property ChallengeConfig. /// /// Specifies how WAF should handle challenge evaluations for rules that don't have their /// own ChallengeConfig settings. If you don't specify this, WAF uses its /// default settings for ChallengeConfig. /// /// public ChallengeConfig ChallengeConfig { get { return this._challengeConfig; } set { this._challengeConfig = value; } } // Check to see if ChallengeConfig property is set internal bool IsSetChallengeConfig() { return this._challengeConfig != null; } /// /// Gets and sets the property CustomResponseBodies. /// /// A map of custom response keys and content bodies. When you create a rule with a block /// action, you can send a custom response to the web request. You define these for the /// web ACL, and then use them in the rules and default actions that you define in the /// web ACL. /// /// /// /// For information about customizing web requests and responses, see Customizing /// web requests and responses in WAF in the WAF Developer Guide. /// /// /// /// For information about the limits on count and size for custom request and response /// settings, see WAF /// quotas in the WAF Developer Guide. /// /// [AWSProperty(Min=1)] public Dictionary CustomResponseBodies { get { return this._customResponseBodies; } set { this._customResponseBodies = value; } } // Check to see if CustomResponseBodies property is set internal bool IsSetCustomResponseBodies() { return this._customResponseBodies != null && this._customResponseBodies.Count > 0; } /// /// Gets and sets the property DefaultAction. /// /// The action to perform if none of the Rules contained in the WebACL /// match. /// /// [AWSProperty(Required=true)] public DefaultAction DefaultAction { get { return this._defaultAction; } set { this._defaultAction = value; } } // Check to see if DefaultAction property is set internal bool IsSetDefaultAction() { return this._defaultAction != null; } /// /// Gets and sets the property Description. /// /// A description of the web ACL that helps with identification. /// /// [AWSProperty(Min=1, Max=256)] public string Description { get { return this._description; } set { this._description = value; } } // Check to see if Description property is set internal bool IsSetDescription() { return this._description != null; } /// /// Gets and sets the property Id. /// /// A unique identifier for the WebACL. This ID is returned in the responses /// to create and list commands. You use this ID to do things like get, update, and delete /// a WebACL. /// /// [AWSProperty(Required=true, Min=1, Max=36)] public string Id { get { return this._id; } set { this._id = value; } } // Check to see if Id property is set internal bool IsSetId() { return this._id != null; } /// /// Gets and sets the property LabelNamespace. /// /// The label namespace prefix for this web ACL. All labels added by rules in this web /// ACL have this prefix. /// ///
  • /// /// The syntax for the label namespace prefix for a web ACL is the following: /// /// /// /// awswaf:<account ID>:webacl:<web ACL name>: /// ///
  • /// /// When a rule with a label matches a web request, WAF adds the fully qualified label /// to the request. A fully qualified label is made up of the label namespace from the /// rule group or web ACL where the rule is defined and the label from the rule, separated /// by a colon: /// /// /// /// <label namespace>:<label from rule> /// ///
///
[AWSProperty(Min=1, Max=1024)] public string LabelNamespace { get { return this._labelNamespace; } set { this._labelNamespace = value; } } // Check to see if LabelNamespace property is set internal bool IsSetLabelNamespace() { return this._labelNamespace != null; } /// /// Gets and sets the property ManagedByFirewallManager. /// /// Indicates whether this web ACL is managed by Firewall Manager. If true, then only /// Firewall Manager can delete the web ACL or any Firewall Manager rule groups in the /// web ACL. /// /// public bool ManagedByFirewallManager { get { return this._managedByFirewallManager.GetValueOrDefault(); } set { this._managedByFirewallManager = value; } } // Check to see if ManagedByFirewallManager property is set internal bool IsSetManagedByFirewallManager() { return this._managedByFirewallManager.HasValue; } /// /// Gets and sets the property Name. /// /// The name of the web ACL. You cannot change the name of a web ACL after you create /// it. /// /// [AWSProperty(Required=true, Min=1, Max=128)] public string Name { get { return this._name; } set { this._name = value; } } // Check to see if Name property is set internal bool IsSetName() { return this._name != null; } /// /// Gets and sets the property PostProcessFirewallManagerRuleGroups. /// /// The last set of rules for WAF to process in the web ACL. This is defined in an Firewall /// Manager WAF policy and contains only rule group references. You can't alter these. /// Any rules and rule groups that you define for the web ACL are prioritized before these. /// /// /// /// /// In the Firewall Manager WAF policy, the Firewall Manager administrator can define /// a set of rule groups to run first in the web ACL and a set of rule groups to run last. /// Within each set, the administrator prioritizes the rule groups, to determine their /// relative processing order. /// /// public List PostProcessFirewallManagerRuleGroups { get { return this._postProcessFirewallManagerRuleGroups; } set { this._postProcessFirewallManagerRuleGroups = value; } } // Check to see if PostProcessFirewallManagerRuleGroups property is set internal bool IsSetPostProcessFirewallManagerRuleGroups() { return this._postProcessFirewallManagerRuleGroups != null && this._postProcessFirewallManagerRuleGroups.Count > 0; } /// /// Gets and sets the property PreProcessFirewallManagerRuleGroups. /// /// The first set of rules for WAF to process in the web ACL. This is defined in an Firewall /// Manager WAF policy and contains only rule group references. You can't alter these. /// Any rules and rule groups that you define for the web ACL are prioritized after these. /// /// /// /// /// In the Firewall Manager WAF policy, the Firewall Manager administrator can define /// a set of rule groups to run first in the web ACL and a set of rule groups to run last. /// Within each set, the administrator prioritizes the rule groups, to determine their /// relative processing order. /// /// public List PreProcessFirewallManagerRuleGroups { get { return this._preProcessFirewallManagerRuleGroups; } set { this._preProcessFirewallManagerRuleGroups = value; } } // Check to see if PreProcessFirewallManagerRuleGroups property is set internal bool IsSetPreProcessFirewallManagerRuleGroups() { return this._preProcessFirewallManagerRuleGroups != null && this._preProcessFirewallManagerRuleGroups.Count > 0; } /// /// Gets and sets the property Rules. /// /// The Rule statements used to identify the web requests that you want to allow, /// block, or count. Each rule includes one top-level statement that WAF uses to identify /// matching web requests, and parameters that govern how WAF handles them. /// /// public List Rules { get { return this._rules; } set { this._rules = value; } } // Check to see if Rules property is set internal bool IsSetRules() { return this._rules != null && this._rules.Count > 0; } /// /// Gets and sets the property TokenDomains. /// /// Specifies the domains that WAF should accept in a web request token. This enables /// the use of tokens across multiple protected websites. When WAF provides a token, it /// uses the domain of the Amazon Web Services resource that the web ACL is protecting. /// If you don't specify a list of token domains, WAF accepts tokens only for the domain /// of the protected resource. With a token domain list, WAF accepts the resource's host /// domain plus all domains in the token domain list, including their prefixed subdomains. /// /// public List TokenDomains { get { return this._tokenDomains; } set { this._tokenDomains = value; } } // Check to see if TokenDomains property is set internal bool IsSetTokenDomains() { return this._tokenDomains != null && this._tokenDomains.Count > 0; } /// /// Gets and sets the property VisibilityConfig. /// /// Defines and enables Amazon CloudWatch metrics and web request sample collection. /// /// [AWSProperty(Required=true)] public VisibilityConfig VisibilityConfig { get { return this._visibilityConfig; } set { this._visibilityConfig = value; } } // Check to see if VisibilityConfig property is set internal bool IsSetVisibilityConfig() { return this._visibilityConfig != null; } } }