aws-ip-ranges

Retrieve AWS IP ranges with ease.

Installation

Run:

gem install aws-ip-ranges

Usage

Code

AwsIpRanges.fetch(service: ['cloudfront', 's3']) # => [#<IPAddr: IPv4:3.2.34.0/255.255.255.192>,  #<IPAddr: IPv4:3.5.140.0/255.255.252.0>]
AwsIpRanges.fetch(region: 'eu-west-3')
AwsIpRanges.fetch(only_ipv4: true)
AwsIpRanges.fetch(only_ipv6: true)

CLI

Execute:

$ aws-ip-ranges list
35.172.155.192/27
35.172.155.96/27
44.192.134.240/28
...
2600:1f70:c000:400::/56

See the help for more usage:

Command:
  aws-ip-ranges list

Usage:
  aws-ip-ranges list

Description:
  List all AWS IP ranges

Options:
  --[no-]only-ipv6                  # Whether to include only IPv6 ranges., default: false
  --[no-]only-ipv4                  # Whether to include only IPv4 ranges., default: false
  --service=VALUE1,VALUE2,..        # Which services to include. By default, includes all.
  --region=VALUE1,VALUE2,..         # Which regions to include. By default, includes all.
  --help, -h                        # Print this help

Examples:
  aws-ip-ranges list                                             # Prints all AWS IP ranges
  aws-ip-ranges list --only-ipv4                                 # Prints all AWS IPv4 ranges
  aws-ip-ranges list --only-ipv6 --service=cloudfront,global     # Prints AWS Cloudfront and Global IPv6 ranges
  aws-ip-ranges list --only-ipv6 --service=s3 --region=eu-west-1 # Prints AWS S3 IPv6 ranges in the eu-west-1 region

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Contributing

We are not accepting outside contribution on this library at the moment.

License

The gem is available as open source under the terms of the MIT License.