Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spacesiren/spacesiren
A honey token manager and alert system for AWS.
https://github.com/spacesiren/spacesiren
aws honeypot lambda security terraform
Last synced: 26 days ago
JSON representation
A honey token manager and alert system for AWS.
- Host: GitHub
- URL: https://github.com/spacesiren/spacesiren
- Owner: spacesiren
- License: gpl-3.0
- Created: 2020-08-06T06:14:02.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-12-19T18:23:15.000Z (almost 3 years ago)
- Last Synced: 2024-08-03T18:16:41.228Z (4 months ago)
- Topics: aws, honeypot, lambda, security, terraform
- Language: Python
- Homepage:
- Size: 3.56 MB
- Stars: 314
- Watchers: 9
- Forks: 28
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - spacesiren/spacesiren - A honey token manager and alert system for AWS. (Python)
- awesome-python-applications - Repo - started.md)) Honeypot management and alert system for AWS tokens, with a fully serverless architecture. `(ops, server)` (<a id="tag-dev" href="#tag-dev">Dev</a> / <a id="tag-dev.security" href="#tag-dev.security">Security</a>)
README
# SpaceSiren
SpaceSiren is a [honey token](https://en.wikipedia.org/wiki/Honeypot_(computing))
manager and alert system for AWS. With this fully serverless application,
you can create and manage honey tokens at scale -- up to 10,000 per SpaceSiren
instance -- at close to no cost.1
## How It Works
* SpaceSiren provides an API to create no-permission AWS IAM users and access keys for those users.
* You sprinkle the access keys wherever you like, for example in proprietary code or private data stores.
* If one of those sources gets breached, an attacker is likely to use the stolen key to see what they can do with it.
* You will receive an alert that someone attempted to use the key.
## Alert Outputs
* Email
* PagerDuty
* Slack
* Pushover
> 
## Documentation Pages
* [Getting Started](docs/getting-started.md)
* [Alerts](docs/alerts.md)
* [API Documentation](docs/api.md)
* [Terraform Variables](docs/tfvars.md)
## Requirements
As with any open source project, this one assumes you have the required
foundational tools and knowledge, mainly in AWS and Terraform.
### Resources
* Terraform >= 0.13
* AWS CLI
* A dedicated AWS account with admin access
* A registered domain
### Knowledge
* Basic Terraform
* Basic REST API
* Basic AWS CLI, S3, and Route 53
* Basic AWS Organizations and IAM Roles for cross-account access
* Intermediate DNS (delegating a (sub)domain with NS records)
## Contact
If you notice a critical security bug (e.g., one that would grant real access to
an AWS account), please responsibly disclose it via email at
[[email protected]](mailto:[email protected]).
For standard bugs or feature requests, please open a GitHub issue.
## Attributions
Special thanks to:
* Atlassian for [Project SpaceCrab](https://bitbucket.org/asecurityteam/spacecrab), the
inspiration for this project. If you want to read about why I started SpaceSiren,
please see my [SpaceCrab critique](docs/spacecrab.md) page.
* The wonderful and talented
[Alia Mancisidor](https://www.instagram.com/figmentpie/) for the artwork.
* Anyone who volunteered to test this application for me.
---
## Footnotes
1. While SpaceSiren was designed to run as cheaply as possible, even for
individuals, it will not be entirely free of operating costs. You will incur
nominal costs for DynamoDB, Lambda, API Gateway, Route 53, and perhaps
CloudTrail, depending on your configuration. You should expect to spend
between $1 and $5 per month to run SpaceSiren. Of course, the project's
maintainers are not responsible for any actual costs you incur. Please closely
monitor your AWS bill while it is in use.