Skip to content

Th3R3p0/openAWS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Repository files navigation

openAWS

This script identifies any security groups that are open to the world (0.0.0.0/0).

By default it only checks security groups attached to running instances. The documentation on how to change this is in the comments in the script

Prerequisites

pip install -r requirements.txt
  • Ensure you have setup AWS config in ~/.aws/config and ~/.aws/credentials
    • See AWS Documentation
    • IAM Policy Requirements: This tool only needs to read your Security Groups and EC2 instances. You can create a new policy for this or use the already existing SecurityAudit policy. This will grant a little more than needed, but only read-only access to your AWS account. See the bottom of readme for an example policy that uses the least amount of privileges.

To run

python openAWS.py

Command Line Parameters

  • --region (optional)
    • You may specify one or multiple regions seperated by spaces
    • If not configured, this will default to pull from your AWS config file
  • --all-regions=True (optional)
    • You may set this to True, if you want to run this in all regions
    • By default, this is set to False
  • --out-file="open-ports.json" (optional)
    • You may set this to a file name to output the open ports for each instance to a file
    • By default, it does not output to a file.
  • --verbose=True (optional)

To do

  • implement in Lambda
    • Keep a dictionary of SGs and Instances attached to the SGs in S3 of known SGs open to the world
    • Do a deepdiff to the new dictionary on lambda execution.
    • If new SGs are found, send an alert to admin
    • If instances are assigned a new SG that is more open then previously, send an alert to admin
  • Add protocol for port

Least Privilege IAM Policy

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeSecurityGroups",
                "ec2:DescribeInstanceStatus",
                "ec2:DescribeInstances"
            ],
            "Resource": "*"
        }
    ]
}

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages