☁️ 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

• AWS SDK Go
• API-guru Open API for AWS
• aws-cli

👨‍💻 Authors

• Oscar Salazar - Initial work - Bishop Fox
• Rob Ragan - Initial work - Bishop Fox 🐦 @sweepthatleg
• Brandon Gaudet - Initial work - Bishop Fox

✨ 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.