Skip to content

docs(ec2): document Network ACL usage and default NACL workaround#37374

Open
syukawa-gh wants to merge 1 commit intoaws:mainfrom
syukawa-gh:docs/ec2-nacl-rule-100-workaround
Open

docs(ec2): document Network ACL usage and default NACL workaround#37374
syukawa-gh wants to merge 1 commit intoaws:mainfrom
syukawa-gh:docs/ec2-nacl-rule-100-workaround

Conversation

@syukawa-gh
Copy link
Copy Markdown
Contributor

Issue

Closes #13220

Reason for this change

When a VPC is created, AWS automatically creates a default Network ACL with rule 100 that allows all inbound and outbound traffic. CDK does not manage the default Network ACL, so users cannot remove or modify these permissive rules through CDK. This was not documented, causing confusion.

Description of changes

Added a "Network ACLs" section to the aws-ec2 README documenting:

  • How to create a custom Network ACL and associate it with subnets
  • How the default Network ACL works and why its rules cannot be modified through CDK
  • How to work around the default NACL's permissive rules by replacing it with a custom NACL that only allows specific traffic

Description of how you validated changes

Documentation-only change. Code examples use existing public API symbols (NetworkAcl, AclCidr, AclTraffic, TrafficDirection, Action).

Checklist

The default Network ACL created with a VPC allows all inbound and
outbound traffic (rule 100), and CDK does not manage it. Users cannot
remove or modify these permissive rules through CDK.

Add a Network ACLs section to the README documenting:
- How to create a custom Network ACL and associate it with subnets
- How to work around the default NACL's permissive rules by replacing
  it with a custom NACL that only allows specific traffic

Closes aws#13220
@github-actions github-actions bot added beginning-contributor [Pilot] contributed between 0-2 PRs to the CDK bug This issue is a bug. effort/small Small work item – less than a day of effort p2 labels Mar 27, 2026
@aws-cdk-automation aws-cdk-automation requested a review from a team March 27, 2026 09:02
@aws-cdk-automation aws-cdk-automation added the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Mar 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

beginning-contributor [Pilot] contributed between 0-2 PRs to the CDK bug This issue is a bug. effort/small Small work item – less than a day of effort p2 pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

(EC2): document how to workaround Network ACL rule 100

3 participants