Trapdoor - The serverless HTTP honeypot
Trapdoor, our AWS-based serverless honeypot.
The idea of a serverless honeytoken isn't new. Adel released his honeyLambda a few years ago and we've been working with it for quite some time. It was because of this experience and the goal of improving on what was already a great idea that we decided to go to the drawing board and see how we would change and tweak the concept.
What is it?
Trapdoor is a serverless application that can be deployed in any AWS environment. Its goal is to receive HTTP requests with the intent of identifying, and alerting, on its visitors. The URLs generated by Trapdoor can also be referred to as honeytokens.
While you can get creative on how to use it, one of the goals of a honeytoken is to be hidden or stored in a "safe" place and, if accessed, fire of an alarm, as access to the token would be considered a compromise or unauthorized access.
This example is the passive way of using deception tactics. Additionally users can also create Trapdoor tokens and save them inside of other honeypots. Much can be said about ideas to trick a botnet operator to move away from the zombies and make the operator himself access a URL, but we'll leave you to figure that part out.
Features of Trapdoor
Trapdoor has two deception mechanisms:
- HTTP session & User Agent
- Client Fingerprinting
In Client Fingerprinting mode Trapdoor will, aggressively, attempt to retrieve a wide range of information from the client, namely:
- Screen resolution
- Laptop battery level
- If browser is in Incognito mode
- If the visitor was utilizing Tor to access Trapdoor
- CPU type
- and more!
It is important to mention that since Trapdoor is very much in an alpha stage changes to the reported information will likely occur based on our experience as well as community feedback (which we'd like to receive).
Stateful client fingerprint and tracking
Another interesting feature is that Trapdoor will also attempt to create a unique identifier per client/visitor and save that information so that we can maintain a state of that visitor's actions (how many times a particular user accessed a honeytoken and other information). Trapdoor tracks and reports based on two identifiers:
- Visitor IP Address
- Unique Client Fingerprint
This allows us to report not only on individual, ad-hoc visits, but also provide a history-aware alert when notifying users of access to their honeytoken.
The main motivation for developing the stateful client fingerprinting was to create the ability to track visitors who might hop between exit nodes (from a VPN, Tor, etc). With this feature we will attempt to track the user and provide that information on the alert. Before moving on to the alerting section, here's a quick example of how this feature translates into actionable tracking:
We went back and forward on which methods we should support. Ultimately we decided to rely on Slack messages as those provided us with the highest level of control and interactions
A notification (and these will age poorly with time as we continuously change how it looks) will look something along the lines of:
Early release and community contributions
3CORESec is releasing this project as a proof-of-concept for the research community.
Please remember that it might not be legal to run Trapdoor in some countries and that the information you will be accessing could be considered personal data.
If you decide to deploy, install or run Trapdoor you will be agreeing to release and hold us harmless from any responsibility resulting or arising directly or indirectly from the use of Trapdoor.
You are solely and exclusively responsible for the use of Trapdoor.
Feel free to reach out to us on Twitter or joining our Community Slack. We'd love to hear what you think of Trapdoor and maybe add some features to it.