spacesiren/spacesiren

A honey token manager and alert system for AWS.

SpaceSiren

SpaceSiren is a honey token 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.¹

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
• Alerts
• API Documentation
• Terraform Variables

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

For standard bugs or feature requests, please open a GitHub issue.

Attributions

Special thanks to:

• Atlassian for Project SpaceCrab, the inspiration for this project. If you want to read about why I started SpaceSiren, please see my SpaceCrab critique page.
• The wonderful and talented Alia Mancisidor 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.

spacesiren's Issues

Pushover support

Support Pushover for alert output.

Input requirements:

• user_key
• app_key

Cannot create pull requests for this repo.

Was hoping to contribute and cannot create a branch/pull request. Can you add me?

Support multiple instances in one account

Possible issues:

• SES TO address validation. May require using separate addresses per instance.

Web UI

Add a web UI that will facilitate use of the API. Log in with normal API keys.

SQS Alert Output

Multiple alert email addresses

Allow for more than one destination email address for alerts. Terraform should take a list of email addresses. They will all need to be verified in SES.