Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Visualize your aws security groups.
branch: master

aws-security-viz -- A tool to visualize aws security groups

Build Status Code Climate Dependency Status


Need a quick way to visualize your current aws/amazon ec2 security group configuration? aws-security-viz does just that based on the EC2 security group ingress configuration.


  • Output to any of the formats that Graphviz supports.
  • EC2 classic and VPC security groups


  $ bundle install

(Bundler installation)


To generate the graph directly using AWS keys

  $ bundle exec ruby lib/visualize_aws.rb -a your_aws_key -s your_aws_secret_key -f viz.svg --color=true

To generate the graph using an existing security_groups.json (created using aws-cli)

  $ bundle exec ruby lib/visualize_aws.rb -o data/security_groups.json -f viz.svg --color
$ bundle exec ruby lib/visualize_aws.rb --help
  -a, --access-key=<s>     AWS access key
  -s, --secret-key=<s>     AWS secret key
  -r, --region=<s>         AWS region to query (default: us-east-1)
  -o, --source-file=<s>    JSON source file containing security groups
  -f, --filename=<s>       Output file name (default: aws-security-viz.png)
  -c, --color              Colored node edges
  -h, --help               Show this message


To generate the graph with debug statements, execute the following command

$ DEBUG=true bundle exec ruby lib/visualize_aws.rb -a your_aws_key -s your_aws_secret_key -f viz.svg

If it doesn't indicate the problem, please share the generated json file with me @

Execute the following command to generate the json. You will need aws-cli to execute the command

aws ec2 describe-security-groups


Something went wrong with that request. Please try again.