aws-solutions-constructs.aws-wafwebacl-cloudfront 2.85.2__py3-none-any.whl → 2.85.4__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,133 +1,5 @@
1
1
  r'''
2
- # aws-wafwebacl-cloudfront module
3
-
4
- <!--BEGIN STABILITY BANNER-->---
5
-
6
-
7
- ![Stability: Experimental](https://img.shields.io/badge/stability-Experimental-important.svg?style=for-the-badge)
8
-
9
- > All classes are under active development and subject to non-backward compatible changes or removal in any
10
- > future version. These are not subject to the [Semantic Versioning](https://semver.org/) model.
11
- > This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.
12
-
13
- ---
14
- <!--END STABILITY BANNER-->
15
-
16
- | **Reference Documentation**:| <span style="font-weight: normal">https://docs.aws.amazon.com/solutions/latest/constructs/</span>|
17
- |:-------------|:-------------|
18
-
19
- <div style="height:8px"></div>
20
-
21
- | **Language** | **Package** |
22
- |:-------------|-----------------|
23
- |![Python Logo](https://docs.aws.amazon.com/cdk/api/latest/img/python32.png) Python|`aws_solutions_constructs.aws_wafwebacl_cloudfront`|
24
- |![Typescript Logo](https://docs.aws.amazon.com/cdk/api/latest/img/typescript32.png) Typescript|`@aws-solutions-constructs/aws-wafwebacl-cloudfront`|
25
- |![Java Logo](https://docs.aws.amazon.com/cdk/api/latest/img/java32.png) Java|`software.amazon.awsconstructs.services.wafwebaclcloudfront`|
26
-
27
- ## Overview
28
-
29
- This AWS Solutions Construct implements an AWS WAF web ACL connected to Amazon CloudFront.
30
-
31
- Here is a minimal deployable pattern definition:
32
-
33
- Typescript
34
-
35
- ```python
36
- import { Construct } from 'constructs';
37
- import { Stack, StackProps } from 'aws-cdk-lib';
38
- import { CloudFrontToS3 } from '@aws-solutions-constructs/aws-cloudfront-s3';
39
- import { WafwebaclToCloudFront } from "@aws-solutions-constructs/aws-wafwebacl-cloudfront";
40
-
41
- const cloudfrontToS3 = new CloudFrontToS3(this, 'test-cloudfront-s3', {});
42
-
43
- // This construct can only be attached to a configured CloudFront.
44
- new WafwebaclToCloudFront(this, 'test-wafwebacl-cloudfront', {
45
- existingCloudFrontWebDistribution: cloudfrontToS3.cloudFrontWebDistribution
46
- });
47
- ```
48
-
49
- Python
50
-
51
- ```python
52
- from aws_solutions_constructs.aws_cloudfront_s3 import CloudFrontToS3
53
- from aws_solutions_constructs.aws_wafwebacl_cloudfront import WafwebaclToCloudFront
54
- from aws_cdk import Stack
55
- from constructs import Construct
56
-
57
- cloudfront_to_s3 = CloudFrontToS3(self, 'test_cloudfront_s3')
58
-
59
- # This construct can only be attached to a configured CloudFront.
60
- WafwebaclToCloudFront(self, 'test_wafwebacl_cloudfront',
61
- existing_cloud_front_web_distribution=cloudfront_to_s3.cloud_front_web_distribution
62
- )
63
- ```
64
-
65
- Java
66
-
67
- ```java
68
- import software.constructs.Construct;
69
-
70
- import software.amazon.awscdk.Stack;
71
- import software.amazon.awscdk.StackProps;
72
- import software.amazon.awsconstructs.services.cloudfronts3.*;
73
- import software.amazon.awsconstructs.services.wafwebaclcloudfront.*;
74
-
75
- final CloudFrontToS3 cloudfrontToS3 = new CloudFrontToS3(this, "test-cloudfront-s3",
76
- new CloudFrontToS3Props.Builder()
77
- .build());
78
-
79
- // This construct can only be attached to a configured CloudFront.
80
- new WafwebaclToCloudFront(this, "test-wafwebacl-cloudfront", new WafwebaclToCloudFrontProps.Builder()
81
- .existingCloudFrontWebDistribution(cloudfrontToS3.getCloudFrontWebDistribution())
82
- .build());
83
- ```
84
-
85
- ## Pattern Construct Props
86
-
87
- | **Name** | **Type** | **Description** |
88
- |:-------------|:----------------|-----------------|
89
- |existingCloudFrontWebDistribution|[`cloudfront.Distribution`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Distribution.html)|The existing CloudFront instance that will be protected with the WAF web ACL. *Note that a WAF web ACL can only be added to a configured CloudFront, so this construct only accepts an existing Distribution and does not accept cloudfrontProps.*|
90
- |existingWebaclObj?|[`waf.CfnWebACL`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_wafv2.CfnWebACL.html)|Existing instance of a WAF web ACL, an error will occur if this and props is set.|
91
- |webaclProps?|[`waf.CfnWebACLProps`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_wafv2.CfnWebACLProps.html)|Optional user-provided props to override the default props for the AWS WAF web ACL. To use a different collection of managed rule sets, specify a new rules property. Use our [`wrapManagedRuleSet(managedGroupName: string, vendorName: string, priority: number)`](../core/lib/waf-defaults.ts) function from core to create an array entry from each desired managed rule set.|
92
-
93
- ## Pattern Properties
94
-
95
- | **Name** | **Type** | **Description** |
96
- |:-------------|:----------------|-----------------|
97
- |webacl|[`waf.CfnWebACL`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_wafv2.CfnWebACL.html)|Returns an instance of the waf.CfnWebACL created by the construct.|
98
- |cloudFrontWebDistribution|[`cloudfront.Distribution`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Distribution.html)|Returns an instance of cloudfront.Distribution created by the construct.|
99
-
100
- ## Default settings
101
-
102
- Out of the box implementation of the Construct without any override will set the following defaults:
103
-
104
- ### AWS WAF
105
-
106
- * Deploy a WAF web ACL with 7 [AWS managed rule groups](https://docs.aws.amazon.com/waf/latest/developerguide/aws-managed-rule-groups-list.html).
107
-
108
- * AWSManagedRulesBotControlRuleSet
109
- * AWSManagedRulesKnownBadInputsRuleSet
110
- * AWSManagedRulesCommonRuleSet
111
- * AWSManagedRulesAnonymousIpList
112
- * AWSManagedRulesAmazonIpReputationList
113
- * AWSManagedRulesAdminProtectionRuleSet
114
- * AWSManagedRulesSQLiRuleSet
115
-
116
- *Note that the default rules can be replaced by specifying the rules property of CfnWebACLProps*
117
- * Send metrics to Amazon CloudWatch
118
-
119
- ### Amazon CloudFront
120
-
121
- * User provided CloudFront object is used as-is
122
-
123
- ## Architecture
124
-
125
- ![Architecture Diagram](architecture.png)
126
-
127
- ---
128
-
129
-
130
- © Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
2
+ Documentation for this pattern can be found [here](https://github.com/awslabs/aws-solutions-constructs/blob/main/source/patterns/%40aws-solutions-constructs/aws-wafwebacl-cloudfront/README.adoc)
131
3
  '''
132
4
  from pkgutil import extend_path
133
5
  __path__ = extend_path(__path__, __name__)
@@ -34,9 +34,9 @@ import constructs._jsii
34
34
 
35
35
  __jsii_assembly__ = jsii.JSIIAssembly.load(
36
36
  "@aws-solutions-constructs/aws-wafwebacl-cloudfront",
37
- "2.85.2",
37
+ "2.85.4",
38
38
  __name__[0:-6],
39
- "aws-wafwebacl-cloudfront@2.85.2.jsii.tgz",
39
+ "aws-wafwebacl-cloudfront@2.85.4.jsii.tgz",
40
40
  )
41
41
 
42
42
  __all__ = [
@@ -0,0 +1,28 @@
1
+ Metadata-Version: 2.1
2
+ Name: aws-solutions-constructs.aws-wafwebacl-cloudfront
3
+ Version: 2.85.4
4
+ Summary: CDK constructs for defining an AWS web WAF connected to Amazon CloudFront.
5
+ Home-page: https://github.com/awslabs/aws-solutions-constructs.git
6
+ Author: Amazon Web Services
7
+ License: Apache-2.0
8
+ Project-URL: Source, https://github.com/awslabs/aws-solutions-constructs.git
9
+ Classifier: Intended Audience :: Developers
10
+ Classifier: Operating System :: OS Independent
11
+ Classifier: Programming Language :: JavaScript
12
+ Classifier: Programming Language :: Python :: 3 :: Only
13
+ Classifier: Programming Language :: Python :: 3.9
14
+ Classifier: Programming Language :: Python :: 3.10
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Typing :: Typed
17
+ Classifier: License :: OSI Approved
18
+ Requires-Python: ~=3.9
19
+ Description-Content-Type: text/markdown
20
+ License-File: LICENSE
21
+ Requires-Dist: aws-cdk-lib<3.0.0,>=2.193.0
22
+ Requires-Dist: aws-solutions-constructs.core==2.85.4
23
+ Requires-Dist: constructs<11.0.0,>=10.0.0
24
+ Requires-Dist: jsii<2.0.0,>=1.111.0
25
+ Requires-Dist: publication>=0.0.3
26
+ Requires-Dist: typeguard<4.3.0,>=2.13.3
27
+
28
+ Documentation for this pattern can be found [here](https://github.com/awslabs/aws-solutions-constructs/blob/main/source/patterns/%40aws-solutions-constructs/aws-wafwebacl-cloudfront/README.adoc)
@@ -0,0 +1,9 @@
1
+ aws_solutions_constructs/aws_wafwebacl_cloudfront/__init__.py,sha256=RMRCPuT1DWMQCCri1kIXOmTY_hU7CBkdT4uvLWf34jg,9228
2
+ aws_solutions_constructs/aws_wafwebacl_cloudfront/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
3
+ aws_solutions_constructs/aws_wafwebacl_cloudfront/_jsii/__init__.py,sha256=3Z79eiC_CLWdG0mmC5KCSh3loolskoUYjFBFJyHBKMU,1543
4
+ aws_solutions_constructs/aws_wafwebacl_cloudfront/_jsii/aws-wafwebacl-cloudfront@2.85.4.jsii.tgz,sha256=p-GkVGkc3q_fZ1O5eVATbvN7dJNHBSdWQjd5URUE7jY,226022
5
+ aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.4.dist-info/LICENSE,sha256=wnT4A3LZDAEpNzcPDh8VCH0i4wjvmLJ86l3A0tCINmw,10279
6
+ aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.4.dist-info/METADATA,sha256=cwgzHzLwiEs-xWu8KIEjxdrAYeEFAjE49ko96vZ29Yk,1309
7
+ aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.4.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
8
+ aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.4.dist-info/top_level.txt,sha256=hi3us_KW7V1ocfOqVsNq1o3w552jCEgu_KsCckqYWsg,25
9
+ aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.4.dist-info/RECORD,,
@@ -1,156 +0,0 @@
1
- Metadata-Version: 2.1
2
- Name: aws-solutions-constructs.aws-wafwebacl-cloudfront
3
- Version: 2.85.2
4
- Summary: CDK constructs for defining an AWS web WAF connected to Amazon CloudFront.
5
- Home-page: https://github.com/awslabs/aws-solutions-constructs.git
6
- Author: Amazon Web Services
7
- License: Apache-2.0
8
- Project-URL: Source, https://github.com/awslabs/aws-solutions-constructs.git
9
- Classifier: Intended Audience :: Developers
10
- Classifier: Operating System :: OS Independent
11
- Classifier: Programming Language :: JavaScript
12
- Classifier: Programming Language :: Python :: 3 :: Only
13
- Classifier: Programming Language :: Python :: 3.9
14
- Classifier: Programming Language :: Python :: 3.10
15
- Classifier: Programming Language :: Python :: 3.11
16
- Classifier: Typing :: Typed
17
- Classifier: License :: OSI Approved
18
- Requires-Python: ~=3.9
19
- Description-Content-Type: text/markdown
20
- License-File: LICENSE
21
- Requires-Dist: aws-cdk-lib<3.0.0,>=2.193.0
22
- Requires-Dist: aws-solutions-constructs.core==2.85.2
23
- Requires-Dist: constructs<11.0.0,>=10.0.0
24
- Requires-Dist: jsii<2.0.0,>=1.111.0
25
- Requires-Dist: publication>=0.0.3
26
- Requires-Dist: typeguard<4.3.0,>=2.13.3
27
-
28
- # aws-wafwebacl-cloudfront module
29
-
30
- <!--BEGIN STABILITY BANNER-->---
31
-
32
-
33
- ![Stability: Experimental](https://img.shields.io/badge/stability-Experimental-important.svg?style=for-the-badge)
34
-
35
- > All classes are under active development and subject to non-backward compatible changes or removal in any
36
- > future version. These are not subject to the [Semantic Versioning](https://semver.org/) model.
37
- > This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.
38
-
39
- ---
40
- <!--END STABILITY BANNER-->
41
-
42
- | **Reference Documentation**:| <span style="font-weight: normal">https://docs.aws.amazon.com/solutions/latest/constructs/</span>|
43
- |:-------------|:-------------|
44
-
45
- <div style="height:8px"></div>
46
-
47
- | **Language** | **Package** |
48
- |:-------------|-----------------|
49
- |![Python Logo](https://docs.aws.amazon.com/cdk/api/latest/img/python32.png) Python|`aws_solutions_constructs.aws_wafwebacl_cloudfront`|
50
- |![Typescript Logo](https://docs.aws.amazon.com/cdk/api/latest/img/typescript32.png) Typescript|`@aws-solutions-constructs/aws-wafwebacl-cloudfront`|
51
- |![Java Logo](https://docs.aws.amazon.com/cdk/api/latest/img/java32.png) Java|`software.amazon.awsconstructs.services.wafwebaclcloudfront`|
52
-
53
- ## Overview
54
-
55
- This AWS Solutions Construct implements an AWS WAF web ACL connected to Amazon CloudFront.
56
-
57
- Here is a minimal deployable pattern definition:
58
-
59
- Typescript
60
-
61
- ```python
62
- import { Construct } from 'constructs';
63
- import { Stack, StackProps } from 'aws-cdk-lib';
64
- import { CloudFrontToS3 } from '@aws-solutions-constructs/aws-cloudfront-s3';
65
- import { WafwebaclToCloudFront } from "@aws-solutions-constructs/aws-wafwebacl-cloudfront";
66
-
67
- const cloudfrontToS3 = new CloudFrontToS3(this, 'test-cloudfront-s3', {});
68
-
69
- // This construct can only be attached to a configured CloudFront.
70
- new WafwebaclToCloudFront(this, 'test-wafwebacl-cloudfront', {
71
- existingCloudFrontWebDistribution: cloudfrontToS3.cloudFrontWebDistribution
72
- });
73
- ```
74
-
75
- Python
76
-
77
- ```python
78
- from aws_solutions_constructs.aws_cloudfront_s3 import CloudFrontToS3
79
- from aws_solutions_constructs.aws_wafwebacl_cloudfront import WafwebaclToCloudFront
80
- from aws_cdk import Stack
81
- from constructs import Construct
82
-
83
- cloudfront_to_s3 = CloudFrontToS3(self, 'test_cloudfront_s3')
84
-
85
- # This construct can only be attached to a configured CloudFront.
86
- WafwebaclToCloudFront(self, 'test_wafwebacl_cloudfront',
87
- existing_cloud_front_web_distribution=cloudfront_to_s3.cloud_front_web_distribution
88
- )
89
- ```
90
-
91
- Java
92
-
93
- ```java
94
- import software.constructs.Construct;
95
-
96
- import software.amazon.awscdk.Stack;
97
- import software.amazon.awscdk.StackProps;
98
- import software.amazon.awsconstructs.services.cloudfronts3.*;
99
- import software.amazon.awsconstructs.services.wafwebaclcloudfront.*;
100
-
101
- final CloudFrontToS3 cloudfrontToS3 = new CloudFrontToS3(this, "test-cloudfront-s3",
102
- new CloudFrontToS3Props.Builder()
103
- .build());
104
-
105
- // This construct can only be attached to a configured CloudFront.
106
- new WafwebaclToCloudFront(this, "test-wafwebacl-cloudfront", new WafwebaclToCloudFrontProps.Builder()
107
- .existingCloudFrontWebDistribution(cloudfrontToS3.getCloudFrontWebDistribution())
108
- .build());
109
- ```
110
-
111
- ## Pattern Construct Props
112
-
113
- | **Name** | **Type** | **Description** |
114
- |:-------------|:----------------|-----------------|
115
- |existingCloudFrontWebDistribution|[`cloudfront.Distribution`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Distribution.html)|The existing CloudFront instance that will be protected with the WAF web ACL. *Note that a WAF web ACL can only be added to a configured CloudFront, so this construct only accepts an existing Distribution and does not accept cloudfrontProps.*|
116
- |existingWebaclObj?|[`waf.CfnWebACL`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_wafv2.CfnWebACL.html)|Existing instance of a WAF web ACL, an error will occur if this and props is set.|
117
- |webaclProps?|[`waf.CfnWebACLProps`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_wafv2.CfnWebACLProps.html)|Optional user-provided props to override the default props for the AWS WAF web ACL. To use a different collection of managed rule sets, specify a new rules property. Use our [`wrapManagedRuleSet(managedGroupName: string, vendorName: string, priority: number)`](../core/lib/waf-defaults.ts) function from core to create an array entry from each desired managed rule set.|
118
-
119
- ## Pattern Properties
120
-
121
- | **Name** | **Type** | **Description** |
122
- |:-------------|:----------------|-----------------|
123
- |webacl|[`waf.CfnWebACL`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_wafv2.CfnWebACL.html)|Returns an instance of the waf.CfnWebACL created by the construct.|
124
- |cloudFrontWebDistribution|[`cloudfront.Distribution`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudfront.Distribution.html)|Returns an instance of cloudfront.Distribution created by the construct.|
125
-
126
- ## Default settings
127
-
128
- Out of the box implementation of the Construct without any override will set the following defaults:
129
-
130
- ### AWS WAF
131
-
132
- * Deploy a WAF web ACL with 7 [AWS managed rule groups](https://docs.aws.amazon.com/waf/latest/developerguide/aws-managed-rule-groups-list.html).
133
-
134
- * AWSManagedRulesBotControlRuleSet
135
- * AWSManagedRulesKnownBadInputsRuleSet
136
- * AWSManagedRulesCommonRuleSet
137
- * AWSManagedRulesAnonymousIpList
138
- * AWSManagedRulesAmazonIpReputationList
139
- * AWSManagedRulesAdminProtectionRuleSet
140
- * AWSManagedRulesSQLiRuleSet
141
-
142
- *Note that the default rules can be replaced by specifying the rules property of CfnWebACLProps*
143
- * Send metrics to Amazon CloudWatch
144
-
145
- ### Amazon CloudFront
146
-
147
- * User provided CloudFront object is used as-is
148
-
149
- ## Architecture
150
-
151
- ![Architecture Diagram](architecture.png)
152
-
153
- ---
154
-
155
-
156
- © Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
@@ -1,9 +0,0 @@
1
- aws_solutions_constructs/aws_wafwebacl_cloudfront/__init__.py,sha256=KLR2ufLhkkOgjLZIe2Im1dPjkBCDEcQf-ShHWqJMYmE,14922
2
- aws_solutions_constructs/aws_wafwebacl_cloudfront/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
3
- aws_solutions_constructs/aws_wafwebacl_cloudfront/_jsii/__init__.py,sha256=F5i1n7arRUq-WV67RBT2O5geJvDzmy2i5JAg5ykYdBc,1543
4
- aws_solutions_constructs/aws_wafwebacl_cloudfront/_jsii/aws-wafwebacl-cloudfront@2.85.2.jsii.tgz,sha256=aHf5wlz_lBQ1M6kNdctsIDPcez5lvl-v9W2-4DPdyZk,227682
5
- aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.2.dist-info/LICENSE,sha256=wnT4A3LZDAEpNzcPDh8VCH0i4wjvmLJ86l3A0tCINmw,10279
6
- aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.2.dist-info/METADATA,sha256=pX2-5AiQohCPhqZE5s1Ir4OZhStNZLy9j1Y7tKZGfiw,7003
7
- aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.2.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
8
- aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.2.dist-info/top_level.txt,sha256=hi3us_KW7V1ocfOqVsNq1o3w552jCEgu_KsCckqYWsg,25
9
- aws_solutions_constructs_aws_wafwebacl_cloudfront-2.85.2.dist-info/RECORD,,