renovosolutions.aws-cdk-aspects-security-group 0.0.1

A library of CDK aspects applying to security groups.

cdk-aspects-library-security-group

A CDK library containing EC2 security group related CDK Aspects and the ability to define custom aspects.

Features

• Utilize built in aspects for common cases:

  • Disallow public access to any port
  • Disallow public access to AWS Restricted Common ports (per the AWS Config rule)
  • Disallow public access to SSH or RDP per CIS Benchmark guidelines and general good practice

• Create any other aspect using the base security group aspect class.

• By default aspects generate errors in the CDK metadata which the deployment or synth process will find, but this can be changed with the annotationType property

API Doc

See API

Examples

Typescript

// Add an existing aspect to your stack
Aspects.of(stack).add(new NoPublicIngressAspect());

// Add a custom aspect to your stack
Aspects.of(stack).add(new SecurityGroupAspectBase({
  annotationText: 'This is a custom message warning you how you should not do what you are doing.',
  annotationType: AnnotationType.WARNING,
  ports: [5985],
  restrictedCidrs: ['10.1.0.0/16'],
}));

// Change an existing aspects message and type
Aspects.of(stack).add(new NoPublicIngressAspect(
  annotationText: 'This is custom text.',
  annotationType: AnnotationType.WARNING
));