Need help with smogcloud?
Click the β€œchat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

BishopFox
159 Stars 25 Forks 11 Commits 2 Opened issues

Description

Find cloud assets that no one wants exposed πŸ”Ž ☁️

Services available

!
?

Need anything else?

Contributors list

No Data

☁️ Smogcloud

Find exposed AWS cloud assets that you did not know you had. A comprehensive asset inventory is step one to any capable security program. We made smogcloud to enable security engineers, penetration testers, and AWS administrators to monitor the collective changes that create dynamic and ephemeral internet-facing assets on a more frequent basis. May be useful to identify:

  • Internet-facing FQDNs and IPs across one or hundreds of AWS accounts
  • Misconfigurations or vulnerabilities
  • Assets that are no longer in use
  • Services not currently monitored
  • Shadow IT

πŸ›  Getting Started

  1. Install and setup golang
  2. Install smogcloud using the following command

        go get -u github.com/BishopFox/smogcloud
    
  3. Set up aws environment variable for the account you wish to query. We suggest utilizing a read-only Security Auditor role. The following commands can be used to set environment variables:

    export AWS_ACCOUNT_ID=''            # Describe account
    export AWS_ACCESS_KEY_ID=''         # Access key for aws account
    export AWS_SECRET_ACCESS_KEY=''     # Secret key for aws account
    
  4. Run the application

    smogcloud
    

    or

    go run main.go
    

πŸ•΅οΈ Current Services

Supported services for extracting internet exposures:

* API Gateway
* CloudFront
* EC2
* Elastic Kubernetes Service
* Elastic Beanstalk
* Elastic Search
* Elastic Load Balancing 
* IoT
* Lightsail
* MediaStore
* Relational Database Service
* Redshift
* Route53
* S3

πŸ”Ž AWS Patterns

From studying Open API documentation on RESTful AWS endpoints we determined these are the patterns of exposure URIs that you may find in AWS accounts. It is important to understand how to interact with these native services to test them for vulnerabilities and other misconfigurations. Security engineers may want to monitor Cloudtrail logs or build DNS monitoring for requests to these services.

  • s3
    • https://{user_provided}.s3.amazonaws.com
  • cloudfront
    • https://{random_id}.cloudfront.net
  • ec2
    • ec2-{ip-seperated}.compute-1.amazonaws.com
  • es
    • https://{userprovided}-{randomid}.{region}.es.amazonaws.com
  • elb
    • http://{userprovided}-{randomid}.{region}.elb.amazonaws.com:80
    • https://{userprovided}-{randomid}.{region}.elb.amazonaws.com:443
  • elbv2
    • https://{userprovided}-{randomid}.{region}.elb.amazonaws.com
  • rds
    • mysql://{userprovided}.{randomid}.{region}.rds.amazonaws.com:3306
    • postgres://{userprovided}.{randomid}.{region}.rds.amazonaws.com:5432
  • route53
    • {user_provided}
  • execute-api
    • https://{randomid}.execute-api.{region}.amazonaws.com/{userprovided}
  • cloudsearch
    • https://doc-{userprovided}-{randomid}.{region}.cloudsearch.amazonaws.com
  • transfer
    • sftp://s-{random_id}.server.transfer.{region}.amazonaws.com
  • iot
    • mqtt://{random_id}.iot.{region}.amazonaws.com:8883
    • https://{random_id}.iot.{region}.amazonaws.com:8443
    • https://{random_id}.iot.{region}.amazonaws.com:443
  • mq
    • https://b-{random_id}-{1,2}.mq.{region}.amazonaws.com:8162
    • ssl://b-{random_id}-{1,2}.mq.{region}.amazonaws.com:61617
  • kafka
    • b-{1,2,3,4}.{userprovided}.{randomid}.c{1,2}.kafka.{region}.amazonaws.com
    • {userprovided}.{randomid}.c{1,2}.kafka.{region}.amazonaws.com
  • cloud9
    • https://{random_id}.vfs.cloud9.{region}.amazonaws.com
  • mediastore
    • https://{random_id}.data.mediastore.{region}.amazonaws.com.
  • kinesisvideo
    • https://{random_id}.kinesisvideo.{region}.amazonaws.com
  • mediaconvert
    • https://{random_id}.mediaconvert.{region}.amazonaws.com
  • mediapackage
    • https://{randomid}.mediapackage.{region}.amazonaws.com/in/v1/{randomid}/channel
  • elasticbeanstalk
    • https://{randomid}.{userprovided}.elasticbeanstalk.com
  • cognito
    • https://{user_provided}.auth.{region}.amazoncognito.com

πŸ“Œ References

πŸ‘¨β€πŸ’» Authors

✨ Contributions

We do our best to maintain our tools, but can't always keep them as up to date as we'd like. So, we always appreciate code contributions, feature requests, and bug reports.

πŸ“£ Acknowledgments

Thank you for inspiration * Cloudmapper * AWS Public IPs * John Backes & Tiros * IAM Access Analyzer * Cartography

πŸ“„ License

Smogcloud is licensed under GPLv3, some subcomponents have seperate licenses.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.