How akshayareddy-1023/canary-token-honey-token-deception-system works
Canary Token is a Flask-based deception and incident-monitoring application. An administrator authenticates and creates URL or file honeytokens; a user encounters a decoy resource, triggering request capture, alerting, and event storage. The administrator dashboard presents incidents and supports application-level IP blocking. The graph preserves the distinct token-generation, detection, alert, persistence, and response stages. Some route and template details are documented in the README but were not fully sampled, so those links cite the README.
Main entry points: app.py Flask routes · file_honeytoken.py File token generator · dashboard.html Admin dashboard · user_dashboard.html User dashboard
Components 16
Web application
- Flask routes
app/app.py - Admin dashboard
templates/dashboard.html - User dashboard
templates/user_dashboard.html - Admin login
templates/admin_login.html
Honeytoken resources
- URL token generator
honeytokens/generator.py - File token generator
honeytokens/file_honeytoken.py - Token records
honeytokens - Decoy files
decoy_files
Detection and alerts
- Event capture
detection/detector.py - Alert generation
alerts/alert_manager.py - IP geolocation
app/app.py
Administration and storage
- Incident and block store
database/database.py - Admin authentication
database/admin_auth.py
Other components
- Administrator
- User
- IP lookup service
Connections 21
- Administrator → Admin login: signs in
README.md - Admin dashboard → Flask routes: requests actions
README.md - Flask routes → Admin authentication: verifies credentials
app/app.py - Flask routes → URL token generator: generates URL tokens
app/app.py - Flask routes → File token generator: generates file tokens
app/app.py - File token generator → Token records: writes records
honeytokens/file_honeytoken.py - URL token generator → Token records: writes records
honeytokens/generator.py - File token generator → Decoy files: creates decoy files
honeytokens/file_honeytoken.py - User → User dashboard: views resources
README.md - User dashboard → Flask routes: opens decoy
README.md - Flask routes → Event capture: captures request
app/app.py - Flask routes → Token records: updates token status
app/app.py - Flask routes → IP geolocation: looks up location
app/app.py - IP geolocation → IP lookup service: queries location
app/app.py - Flask routes → Alert generation: generates alert
app/app.py - Flask routes → Incident and block store: saves incident
app/app.py - Flask routes → Incident and block store: checks blocked IP
app/app.py - Flask routes → Incident and block store: blocks or unblocks IP
app/app.py - Administrator → Admin dashboard: reviews incidents
README.md - Flask routes → Admin dashboard: serves dashboard
README.md - Flask routes → User dashboard: serves dashboard
README.md