https://github.com/mvanholsteijn/aws-visualizer

A visualizer of the network of security group dependencies in an AWS VPC.
https://github.com/mvanholsteijn/aws-visualizer

Last synced: about 2 months ago
JSON representation

A visualizer of the network of security group dependencies in an AWS VPC.

• Host: GitHub
• URL: https://github.com/mvanholsteijn/aws-visualizer
• Owner: mvanholsteijn
• License: apache-2.0
• Created: 2014-11-18T15:21:08.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2021-01-27T22:42:07.000Z (over 3 years ago)
• Last Synced: 2024-04-24T16:36:17.754Z (5 months ago)
• Language: Python
• Homepage:
• Size: 4.43 MB
• Stars: 82
• Watchers: 10
• Forks: 25
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
aws-dot

==============

A visualizer of the network of security group dependencies in an AWS VPC.

It can generate the following:

- An HTML table with all security group dependencies between network components.

- A graph of all security group dependencies between network components.

- A graph of all security group dependencies between network components grouped by security groups.

- A graph of all security group dependencies between network components grouped by subnet.

html table

----------

An HTML table with all security group dependencies between network components.

![A HTML table with all security groups](sample/default/vpc-security-groups-html.jpg).

overall graph

--------------

A graph of all security group dependencies between network components.

![A graph of all security group dependencies](sample/default/vpc-security-groups.png) 

Grouped by security group

--------------------------

A graph of all security group dependencies between network components grouped by security groups.

![A graph of all dependencies grouped by security group](sample/securitygroups/vpc-security-groups.png) 

Grouped by subnets

------------------

A graph of all security group dependencies between network components grouped by subnet.

![A graph of all dependencies grouped by subnet](sample/subnets/vpc-security-groups.png) 

usage

=====

```

aws-dot [-h] [--directory DIRECTORY] [--use-subnets]

                       [--use-security-group-subgraphs]

                       [--exclude-security-group SECURITY-GROUP]

                       [--profile PROFILE] [--region REGION]

                       [--assume-role ROLE]

```

optional arguments:

```

  -h, --help            show this help message and exit

  --directory DIRECTORY, -d DIRECTORY

                        output directory defaults to .

  --use-subnets, -n     use subnet subgraphs

  --use-security-group-subgraphs, -s

                        use security group subgraphs

  --exclude-security-group SECURITY-GROUP, -x SECURITY-GROUP

                        exclude security group

  --profile PROFILE, -p PROFILE

                        select the AWS profile to use

  --region REGION, -r REGION

                        select region to graph

  --assume-role ROLE, -a ROLE

                        ARN of the role to assume

```

Install

-------

- brew install graphviz

- pip install aws-visualizer

Example

-------

```

$ aws-dot --directory .

$ for F in *.dot; do dot -Tpng -o $(basename $F .dot).png $F; done

$ open *.html *.png

```

Quickstart

-----------

./run.sh will generate three different views for each subnet in target: default, securitygroups and subnet.