How freakingcoderr/honey-vault works
Honey-Vault is a deception-based access system: a user signs in, the frontend gathers a device fingerprint, and the backend evaluates trust signals to route the session to the real or decoy vault. The decoy vault records activity and offers honeytoken downloads; administrators monitor threat logs and manage IP blacklists. The graph captures documented and excerpted interactions. Other README-described capabilities, such as real-time alerts and geolocation, are shown where documented, but their unsampled implementation details are not inferred.
Main entry points: auth.py Login & Blacklist · App.jsx Route App · HoneyVault.jsx Honey Vault UI · AdminDashboard.jsx Admin Dashboard
Components 23
Frontend
- Route App
honey-vault-frontend/src/App.jsx - Login
honey-vault-frontend/src/pages/login.jsx - Canvas Fingerprint
honey-vault-frontend/src/utils/fingerprint.js - Real Vault UI
honey-vault-frontend/src/pages/RealVault.jsx - Firebase Client
honey-vault-frontend/src/firebase.js
Access Decision
- FastAPI App
honey-vault-backend/main.py - Login & Blacklist
honey-vault-backend/routers/auth.py - Trust Scoring
honey-vault-backend/services/trust_score.py - IP Geolocation
Decoy Vault
- Honey Vault UI
honey-vault-frontend/src/pages/HoneyVault.jsx - Honeytoken Downloads
honey-vault-backend/routers/honeytokens.py - Honeytoken Files
honey-vault-backend/honeytokens
Threat Monitoring
- Admin Dashboard
honey-vault-frontend/src/pages/AdminDashboard.jsx - Alert Functions
functions/index.js
Other components
- User
- Firebase Authentication
- Firestore
- Real Vault Data
- Honey Vault Data
- Threat Logs
- Failed Attempts
- IP Blacklist
- IP Geolocation API
Connections 30
- User → Route App: opens
README.md - Route App → Login: routes
honey-vault-frontend/src/App.jsx - Route App → Real Vault UI: routes
honey-vault-frontend/src/App.jsx - Route App → Honey Vault UI: routes
honey-vault-frontend/src/App.jsx - Route App → Admin Dashboard: routes
honey-vault-frontend/src/App.jsx - Login → Canvas Fingerprint: generates ID
honey-vault-frontend/src/pages/login.jsx - Login → Firebase Authentication: authenticates
honey-vault-frontend/src/pages/login.jsx - Login → FastAPI App: requests route
honey-vault-frontend/src/pages/login.jsx - FastAPI App → Login & Blacklist: routes login
honey-vault-backend/main.py - FastAPI App → Honeytoken Downloads: routes downloads
honey-vault-backend/main.py - Login & Blacklist → Trust Scoring: calculates score
honey-vault-backend/routers/auth.py - Login & Blacklist → Firestore: reads and writes
honey-vault-backend/routers/auth.py - Login & Blacklist → IP Blacklist: checks and updates
honey-vault-backend/routers/auth.py - Login & Blacklist → Failed Attempts: tracks failures
honey-vault-backend/routers/auth.py - Trust Scoring → IP Geolocation API: queries location
honey-vault-backend/services/trust_score.py - Trust Scoring → IP Geolocation: uses IP signals
README.md - Real Vault UI → Firebase Client: reads config
honey-vault-frontend/src/pages/RealVault.jsx - Honey Vault UI → Firebase Client: reads config
honey-vault-frontend/src/pages/HoneyVault.jsx - Admin Dashboard → Firebase Client: reads config
honey-vault-frontend/src/pages/AdminDashboard.jsx - Firebase Client → Firebase Authentication: initializes
honey-vault-frontend/src/firebase.js - Real Vault UI → Real Vault Data: reads records
honey-vault-frontend/src/pages/RealVault.jsx - Honey Vault UI → Honey Vault Data: reads decoys
honey-vault-frontend/src/pages/HoneyVault.jsx - Honey Vault UI → Threat Logs: logs activity
honey-vault-frontend/src/pages/HoneyVault.jsx - Honey Vault UI → Honeytoken Downloads: requests download
honey-vault-frontend/src/pages/HoneyVault.jsx - Honeytoken Downloads → Threat Logs: logs file access
honey-vault-backend/routers/honeytokens.py - Honeytoken Downloads → Honeytoken Files: serves files
honey-vault-backend/routers/honeytokens.py - Admin Dashboard → Threat Logs: streams feed
honey-vault-frontend/src/pages/AdminDashboard.jsx - Admin Dashboard → IP Blacklist: manages entries
honey-vault-frontend/src/pages/AdminDashboard.jsx - Alert Functions → Admin Dashboard: alerts admins
README.md - Login & Blacklist → IP Blacklist: middleware checks