gfa/puppet-aws_firewall

Granular IP filtering for Amazon Web Services

aws_firewall

Table of Contents

1. Description
2. Usage - Configuration options and additional functionality
3. Reference - An under-the-hood peek at what the module is doing and how
4. Limitations - OS compatibility, etc.
5. Development - Guide for contributing to the module
6. Changelog

Description

This module generates granular iptables rules to restrict access to Amazon Web Services.

Usage

Create an ipset that contains specific AWS IP prefixes

aws_firewall::ipset { 'ap-south-1-s3':
  regions  => ['ap-south-1'],
  services => ['S3'],
}

Create an ipset-based iptables rule

aws_firewall::rule::ipset { '200 Allow access to S3 in us-east-1':
  ipset => 'ap-south-1-s3',
}

Create an iptables rule to allow access to EC2 metadata

aws_firewall::rule::metadata { '200 Allow access to EC2 instance metadata':
  uid => 'someone',
}

Reference

See reference

Limitations

• Only tested on RedHat-like Linux distributions
• IPv6 prefixes are not yet supported

Development

See development

Changelog

See CHANGELOG