@aws-cdk/aws-route53resolver-alpha 2.4.0-alpha.0 → 2.8.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.4.0",
+    "aws-cdk-lib": "^2.8.0",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
@@ -2855,7 +2855,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/aws/aws-cdk",
-  "jsiiVersion": "1.50.0 (build d1830a4)",
+  "jsiiVersion": "1.52.1 (build 5ccc8f6)",
   "keywords": [
     "aws",
     "cdk",
@@ -2868,12 +2868,15 @@
       "compiledWithDeprecationWarnings": true,
       "pacmak": {
         "hasDefaultInterfaces": true
+      },
+      "rosetta": {
+        "strict": true
       }
     }
   },
   "name": "@aws-cdk/aws-route53resolver-alpha",
   "readme": {
-    "markdown": "# Amazon Route53 Resolver Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n## DNS Firewall\n\nWith Route 53 Resolver DNS Firewall, you can filter and regulate outbound DNS traffic for your\nvirtual private connections (VPCs). To do this, you create reusable collections of filtering rules\nin DNS Firewall rule groups and associate the rule groups to your VPC.\n\nDNS Firewall provides protection for outbound DNS requests from your VPCs. These requests route\nthrough Resolver for domain name resolution. A primary use of DNS Firewall protections is to help\nprevent DNS exfiltration of your data. DNS exfiltration can happen when a bad actor compromises\nan application instance in your VPC and then uses DNS lookup to send data out of the VPC to a domain\nthat they control. With DNS Firewall, you can monitor and control the domains that your applications\ncan query. You can deny access to the domains that you know to be bad and allow all other queries\nto pass through. Alternately, you can deny access to all domains except for the ones that you\nexplicitly trust.\n\n### Domain lists\n\nDomain lists can be created using a list of strings, a text file stored in Amazon S3 or a local\ntext file:\n\n```ts\nconst blockList = new route53resolver.FirewallDomainList(this, 'BlockList', {\n  domains: route53resolver.FirewallDomains.fromList(['bad-domain.com', 'bot-domain.net']),\n});\n\nconst s3List = new route53resolver.FirewallDomainList(this, 'S3List', {\n  domains: route53resolver.FirewallDomains.fromS3Url('s3://bucket/prefix/object'),\n});\n\nconst assetList = new route53resolver.FirewallDomainList(this, 'AssetList', {\n  domains: route53resolver.FirewallDomains.fromAsset('/path/to/domains.txt'),\n});\n```\n\nThe file must be a text file and must contain a single domain per line.\n\nUse `FirewallDomainList.fromFirewallDomainListId()` to import an existing or [AWS managed domain list](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-managed-domain-lists.html):\n\n```ts\n// AWSManagedDomainsMalwareDomainList in us-east-1\nconst malwareList = route53resolver.FirewallDomainList.fromFirewallDomainListId(this, 'Malware', 'rslvr-fdl-2c46f2ecbfec4dcc');\n```\n\n### Rule group\n\nCreate a rule group:\n\n```ts\nnew route53resolver.FirewallRuleGroup(this, 'RuleGroup', {\n  rules: [\n    {\n      priority: 10,\n      firewallDomainList: myBlockList,\n      // block and reply with NODATA\n      action: route53resolver.FirewallRuleAction.block(),\n    },\n  ],\n});\n```\n\nRules can be added at construction time or using `addRule()`:\n\n```ts\nruleGroup.addRule({\n  priority: 10,\n  firewallDomainList: blockList,\n  // block and reply with NXDOMAIN\n  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.nxDomain()),\n});\n\nruleGroup.addRule({\n  priority: 20,\n  firewallDomainList: blockList,\n  // block and override DNS response with a custom domain\n  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.override('amazon.com')),\n});\n```\n\nUse `associate()` to associate a rule group with a VPC:\n\n```ts\nruleGroup.associate({\n  priority: 101,\n  vpc: myVpc,\n})\n```\n"
+    "markdown": "# Amazon Route53 Resolver Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n## DNS Firewall\n\nWith Route 53 Resolver DNS Firewall, you can filter and regulate outbound DNS traffic for your\nvirtual private connections (VPCs). To do this, you create reusable collections of filtering rules\nin DNS Firewall rule groups and associate the rule groups to your VPC.\n\nDNS Firewall provides protection for outbound DNS requests from your VPCs. These requests route\nthrough Resolver for domain name resolution. A primary use of DNS Firewall protections is to help\nprevent DNS exfiltration of your data. DNS exfiltration can happen when a bad actor compromises\nan application instance in your VPC and then uses DNS lookup to send data out of the VPC to a domain\nthat they control. With DNS Firewall, you can monitor and control the domains that your applications\ncan query. You can deny access to the domains that you know to be bad and allow all other queries\nto pass through. Alternately, you can deny access to all domains except for the ones that you\nexplicitly trust.\n\n### Domain lists\n\nDomain lists can be created using a list of strings, a text file stored in Amazon S3 or a local\ntext file:\n\n```ts\nconst blockList = new route53resolver.FirewallDomainList(this, 'BlockList', {\n  domains: route53resolver.FirewallDomains.fromList(['bad-domain.com', 'bot-domain.net']),\n});\n\nconst s3List = new route53resolver.FirewallDomainList(this, 'S3List', {\n  domains: route53resolver.FirewallDomains.fromS3Url('s3://bucket/prefix/object'),\n});\n\nconst assetList = new route53resolver.FirewallDomainList(this, 'AssetList', {\n  domains: route53resolver.FirewallDomains.fromAsset('/path/to/domains.txt'),\n});\n```\n\nThe file must be a text file and must contain a single domain per line.\n\nUse `FirewallDomainList.fromFirewallDomainListId()` to import an existing or [AWS managed domain list](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resolver-dns-firewall-managed-domain-lists.html):\n\n```ts\n// AWSManagedDomainsMalwareDomainList in us-east-1\nconst malwareList = route53resolver.FirewallDomainList.fromFirewallDomainListId(\n  this,\n  'Malware',\n  'rslvr-fdl-2c46f2ecbfec4dcc',\n);\n```\n\n### Rule group\n\nCreate a rule group:\n\n```ts\ndeclare const myBlockList: route53resolver.FirewallDomainList;\nnew route53resolver.FirewallRuleGroup(this, 'RuleGroup', {\n  rules: [\n    {\n      priority: 10,\n      firewallDomainList: myBlockList,\n      // block and reply with NODATA\n      action: route53resolver.FirewallRuleAction.block(),\n    },\n  ],\n});\n```\n\nRules can be added at construction time or using `addRule()`:\n\n```ts\ndeclare const myBlockList: route53resolver.FirewallDomainList;\ndeclare const ruleGroup: route53resolver.FirewallRuleGroup;\n\nruleGroup.addRule({\n  priority: 10,\n  firewallDomainList: myBlockList,\n  // block and reply with NXDOMAIN\n  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.nxDomain()),\n});\n\nruleGroup.addRule({\n  priority: 20,\n  firewallDomainList: myBlockList,\n  // block and override DNS response with a custom domain\n  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.override('amazon.com')),\n});\n```\n\nUse `associate()` to associate a rule group with a VPC:\n\n```ts\nimport * as ec2 from 'aws-cdk-lib/aws-ec2';\n\ndeclare const ruleGroup: route53resolver.FirewallRuleGroup;\ndeclare const myVpc: ec2.Vpc;\n\nruleGroup.associate('Association', {\n  priority: 101,\n  vpc: myVpc,\n})\n```\n"
   },
   "repository": {
     "directory": "packages/individual-packages/aws-route53resolver",
@@ -2915,12 +2918,12 @@
       "abstract": true,
       "assembly": "@aws-cdk/aws-route53resolver-alpha",
       "docs": {
-        "stability": "experimental",
-        "summary": "The way that you want DNS Firewall to block the request.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as route53resolver_alpha from '@aws-cdk/aws-route53resolver-alpha';\nconst dnsBlockResponse = route53resolver_alpha.DnsBlockResponse.noData();",
         "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+          "exampleMetadata": "infused"
+        },
+        "example": "declare const myBlockList: route53resolver.FirewallDomainList;\ndeclare const ruleGroup: route53resolver.FirewallRuleGroup;\n\nruleGroup.addRule({\n  priority: 10,\n  firewallDomainList: myBlockList,\n  // block and reply with NXDOMAIN\n  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.nxDomain()),\n});\n\nruleGroup.addRule({\n  priority: 20,\n  firewallDomainList: myBlockList,\n  // block and override DNS response with a custom domain\n  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.override('amazon.com')),\n});",
+        "stability": "experimental",
+        "summary": "The way that you want DNS Firewall to block the request."
       },
       "fqn": "@aws-cdk/aws-route53resolver-alpha.DnsBlockResponse",
       "initializer": {
@@ -3148,12 +3151,12 @@
       "assembly": "@aws-cdk/aws-route53resolver-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
-        "stability": "experimental",
-        "summary": "A Firewall Domain List.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as route53resolver_alpha from '@aws-cdk/aws-route53resolver-alpha';\n\ndeclare const firewallDomains: route53resolver_alpha.FirewallDomains;\nconst firewallDomainList = new route53resolver_alpha.FirewallDomainList(this, 'MyFirewallDomainList', {\n  domains: firewallDomains,\n\n  // the properties below are optional\n  name: 'name',\n});",
         "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+          "exampleMetadata": "infused"
+        },
+        "example": "const blockList = new route53resolver.FirewallDomainList(this, 'BlockList', {\n  domains: route53resolver.FirewallDomains.fromList(['bad-domain.com', 'bot-domain.net']),\n});\n\nconst s3List = new route53resolver.FirewallDomainList(this, 'S3List', {\n  domains: route53resolver.FirewallDomains.fromS3Url('s3://bucket/prefix/object'),\n});\n\nconst assetList = new route53resolver.FirewallDomainList(this, 'AssetList', {\n  domains: route53resolver.FirewallDomains.fromAsset('/path/to/domains.txt'),\n});",
+        "stability": "experimental",
+        "summary": "A Firewall Domain List."
       },
       "fqn": "@aws-cdk/aws-route53resolver-alpha.FirewallDomainList",
       "initializer": {
@@ -3402,12 +3405,12 @@
       "assembly": "@aws-cdk/aws-route53resolver-alpha",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
-        "summary": "Properties for a Firewall Domain List.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as route53resolver_alpha from '@aws-cdk/aws-route53resolver-alpha';\n\ndeclare const firewallDomains: route53resolver_alpha.FirewallDomains;\nconst firewallDomainListProps: route53resolver_alpha.FirewallDomainListProps = {\n  domains: firewallDomains,\n\n  // the properties below are optional\n  name: 'name',\n};",
         "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+          "exampleMetadata": "infused"
+        },
+        "example": "const blockList = new route53resolver.FirewallDomainList(this, 'BlockList', {\n  domains: route53resolver.FirewallDomains.fromList(['bad-domain.com', 'bot-domain.net']),\n});\n\nconst s3List = new route53resolver.FirewallDomainList(this, 'S3List', {\n  domains: route53resolver.FirewallDomains.fromS3Url('s3://bucket/prefix/object'),\n});\n\nconst assetList = new route53resolver.FirewallDomainList(this, 'AssetList', {\n  domains: route53resolver.FirewallDomains.fromAsset('/path/to/domains.txt'),\n});",
+        "stability": "experimental",
+        "summary": "Properties for a Firewall Domain List."
       },
       "fqn": "@aws-cdk/aws-route53resolver-alpha.FirewallDomainListProps",
       "kind": "interface",
@@ -3458,12 +3461,12 @@
       "abstract": true,
       "assembly": "@aws-cdk/aws-route53resolver-alpha",
       "docs": {
-        "stability": "experimental",
-        "summary": "A list of domains.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as route53resolver_alpha from '@aws-cdk/aws-route53resolver-alpha';\nconst firewallDomains = route53resolver_alpha.FirewallDomains.fromAsset('assetPath');",
         "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+          "exampleMetadata": "infused"
+        },
+        "example": "const blockList = new route53resolver.FirewallDomainList(this, 'BlockList', {\n  domains: route53resolver.FirewallDomains.fromList(['bad-domain.com', 'bot-domain.net']),\n});\n\nconst s3List = new route53resolver.FirewallDomainList(this, 'S3List', {\n  domains: route53resolver.FirewallDomains.fromS3Url('s3://bucket/prefix/object'),\n});\n\nconst assetList = new route53resolver.FirewallDomainList(this, 'AssetList', {\n  domains: route53resolver.FirewallDomains.fromAsset('/path/to/domains.txt'),\n});",
+        "stability": "experimental",
+        "summary": "A list of domains."
       },
       "fqn": "@aws-cdk/aws-route53resolver-alpha.FirewallDomains",
       "initializer": {
@@ -3639,12 +3642,12 @@
       "assembly": "@aws-cdk/aws-route53resolver-alpha",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
-        "summary": "A Firewall Rule.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as route53resolver_alpha from '@aws-cdk/aws-route53resolver-alpha';\n\ndeclare const firewallDomainList: route53resolver_alpha.FirewallDomainList;\ndeclare const firewallRuleAction: route53resolver_alpha.FirewallRuleAction;\nconst firewallRule: route53resolver_alpha.FirewallRule = {\n  action: firewallRuleAction,\n  firewallDomainList: firewallDomainList,\n  priority: 123,\n};",
         "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+          "exampleMetadata": "infused"
+        },
+        "example": "declare const myBlockList: route53resolver.FirewallDomainList;\ndeclare const ruleGroup: route53resolver.FirewallRuleGroup;\n\nruleGroup.addRule({\n  priority: 10,\n  firewallDomainList: myBlockList,\n  // block and reply with NXDOMAIN\n  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.nxDomain()),\n});\n\nruleGroup.addRule({\n  priority: 20,\n  firewallDomainList: myBlockList,\n  // block and override DNS response with a custom domain\n  action: route53resolver.FirewallRuleAction.block(route53resolver.DnsBlockResponse.override('amazon.com')),\n});",
+        "stability": "experimental",
+        "summary": "A Firewall Rule."
       },
       "fqn": "@aws-cdk/aws-route53resolver-alpha.FirewallRule",
       "kind": "interface",
@@ -3710,12 +3713,12 @@
       "abstract": true,
       "assembly": "@aws-cdk/aws-route53resolver-alpha",
       "docs": {
-        "stability": "experimental",
-        "summary": "A Firewall Rule.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as route53resolver_alpha from '@aws-cdk/aws-route53resolver-alpha';\nconst firewallRuleAction = route53resolver_alpha.FirewallRuleAction.alert();",
         "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+          "exampleMetadata": "infused"
+        },
+        "example": "declare const myBlockList: route53resolver.FirewallDomainList;\nnew route53resolver.FirewallRuleGroup(this, 'RuleGroup', {\n  rules: [\n    {\n      priority: 10,\n      firewallDomainList: myBlockList,\n      // block and reply with NODATA\n      action: route53resolver.FirewallRuleAction.block(),\n    },\n  ],\n});",
+        "stability": "experimental",
+        "summary": "A Firewall Rule."
       },
       "fqn": "@aws-cdk/aws-route53resolver-alpha.FirewallRuleAction",
       "initializer": {
@@ -3835,12 +3838,12 @@
       "assembly": "@aws-cdk/aws-route53resolver-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
-        "stability": "experimental",
-        "summary": "A Firewall Rule Group.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as route53resolver_alpha from '@aws-cdk/aws-route53resolver-alpha';\n\ndeclare const firewallDomainList: route53resolver_alpha.FirewallDomainList;\ndeclare const firewallRuleAction: route53resolver_alpha.FirewallRuleAction;\nconst firewallRuleGroup = new route53resolver_alpha.FirewallRuleGroup(this, 'MyFirewallRuleGroup', /* all optional props */ {\n  name: 'name',\n  rules: [{\n    action: firewallRuleAction,\n    firewallDomainList: firewallDomainList,\n    priority: 123,\n  }],\n});",
         "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+          "exampleMetadata": "infused"
+        },
+        "example": "declare const myBlockList: route53resolver.FirewallDomainList;\nnew route53resolver.FirewallRuleGroup(this, 'RuleGroup', {\n  rules: [\n    {\n      priority: 10,\n      firewallDomainList: myBlockList,\n      // block and reply with NODATA\n      action: route53resolver.FirewallRuleAction.block(),\n    },\n  ],\n});",
+        "stability": "experimental",
+        "summary": "A Firewall Rule Group."
       },
       "fqn": "@aws-cdk/aws-route53resolver-alpha.FirewallRuleGroup",
       "initializer": {
@@ -4357,12 +4360,12 @@
       "assembly": "@aws-cdk/aws-route53resolver-alpha",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
-        "summary": "Options for a Firewall Rule Group Association.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as route53resolver_alpha from '@aws-cdk/aws-route53resolver-alpha';\nimport { aws_ec2 as ec2 } from 'aws-cdk-lib';\n\ndeclare const vpc: ec2.Vpc;\nconst firewallRuleGroupAssociationOptions: route53resolver_alpha.FirewallRuleGroupAssociationOptions = {\n  priority: 123,\n  vpc: vpc,\n\n  // the properties below are optional\n  mutationProtection: false,\n  name: 'name',\n};",
         "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+          "exampleMetadata": "infused"
+        },
+        "example": "import * as ec2 from 'aws-cdk-lib/aws-ec2';\n\ndeclare const ruleGroup: route53resolver.FirewallRuleGroup;\ndeclare const myVpc: ec2.Vpc;\n\nruleGroup.associate('Association', {\n  priority: 101,\n  vpc: myVpc,\n})",
+        "stability": "experimental",
+        "summary": "Options for a Firewall Rule Group Association."
       },
       "fqn": "@aws-cdk/aws-route53resolver-alpha.FirewallRuleGroupAssociationOptions",
       "kind": "interface",
@@ -4489,12 +4492,12 @@
       "assembly": "@aws-cdk/aws-route53resolver-alpha",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
-        "summary": "Properties for a Firewall Rule Group.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as route53resolver_alpha from '@aws-cdk/aws-route53resolver-alpha';\n\ndeclare const firewallDomainList: route53resolver_alpha.FirewallDomainList;\ndeclare const firewallRuleAction: route53resolver_alpha.FirewallRuleAction;\nconst firewallRuleGroupProps: route53resolver_alpha.FirewallRuleGroupProps = {\n  name: 'name',\n  rules: [{\n    action: firewallRuleAction,\n    firewallDomainList: firewallDomainList,\n    priority: 123,\n  }],\n};",
         "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
+          "exampleMetadata": "infused"
+        },
+        "example": "declare const myBlockList: route53resolver.FirewallDomainList;\nnew route53resolver.FirewallRuleGroup(this, 'RuleGroup', {\n  rules: [\n    {\n      priority: 10,\n      firewallDomainList: myBlockList,\n      // block and reply with NODATA\n      action: route53resolver.FirewallRuleAction.block(),\n    },\n  ],\n});",
+        "stability": "experimental",
+        "summary": "Properties for a Firewall Rule Group."
       },
       "fqn": "@aws-cdk/aws-route53resolver-alpha.FirewallRuleGroupProps",
       "kind": "interface",
@@ -4627,6 +4630,6 @@
       "symbolId": "lib/firewall-rule-group:IFirewallRuleGroup"
     }
   },
-  "version": "2.4.0-alpha.0",
+  "version": "2.8.0-alpha.0",
   "fingerprint": "**********"
 }