How gnanadhivya/behaviorlock works
BehaviorLock provides continuous, privacy-preserving web authentication: the browser summarizes behavior into short feature windows, the backend evaluates risk, and the user receives security-state updates and account/device dashboards. Authentication and device recognition establish the session; monitoring feeds the risk-scoring and state-transition stages, with re-authentication for high risk. README documentation describes the backend-to-ML-service and database architecture; sampled source confirms several service/repository calls. Other routes and some wiring are represented only at subsystem level because their source was not sampled.
Main entry points: SecurityStateMachineService.java Security state machine · SecurityController.java Security endpoints · AuthService.java Authentication · AuthContext.jsx Auth context
Components 22
Web client
- App routes
frontend/src/App.jsx - Auth context
frontend/src/context/AuthContext.jsx - Behavior collector
frontend/src/hooks/useBehaviorCollector.js - Behavior API client
frontend/src/services/behaviorService.js - REST client
frontend/src/services/api.js
Identity and devices
- Authentication
backend/src/main/java/com/behaviorlock/backend/service/AuthService.java - Device and session service
backend/src/main/java/com/behaviorlock/backend/service/DeviceService.java - Auth endpoints
backend/src/main/java/com/behaviorlock/backend/controller - Re-authentication
frontend/src/pages/ReauthenticatePage.jsx
Behavior and security
- Security endpoints
backend/src/main/java/com/behaviorlock/backend/controller/SecurityController.java - Behavior processing
backend/src/main/java/com/behaviorlock/backend/service/BehaviorService.java - Security state machine
backend/src/main/java/com/behaviorlock/backend/service/SecurityStateMachineService.java
User insights
- Dashboard aggregation
backend/src/main/java/com/behaviorlock/backend/service/DashboardService.java - Alert endpoints
backend/src/main/java/com/behaviorlock/backend/controller/AlertController.java
Persistence and scoring
- ML scoring API
ml-service/main.py - Anomaly ensemble
ml-service/ensemble_model.py - MySQL
- User records
backend/src/main/java/com/behaviorlock/backend/entity/User.java - Session records
backend/src/main/java/com/behaviorlock/backend/entity/UserSession.java - Session repository
backend/src/main/java/com/behaviorlock/backend/repository/UserSessionRepository.java - Alert repository
backend/src/main/java/com/behaviorlock/backend/repository/SecurityAlertRepository.java
Other components
- User
Connections 25
- User → App routes: uses
frontend/src/App.jsx - App routes → Auth context: provides auth
frontend/src/App.jsx - Auth context → REST client: calls auth API
frontend/src/context/AuthContext.jsx - Auth context → Auth endpoints: authenticates via
- Authentication → Device and session service: registers device
backend/src/main/java/com/behaviorlock/backend/service/AuthService.java - Authentication → User records: creates or reads
backend/src/main/java/com/behaviorlock/backend/service/AuthService.java - Authentication → MySQL: persists users
- Behavior collector → Behavior API client: submits windows
frontend/src/hooks/useBehaviorCollector.js - Behavior API client → REST client: uses REST client
frontend/src/services/behaviorService.js - Behavior collector → Security endpoints: posts feature windows
- Security endpoints → Behavior processing: delegates processing
- Behavior processing → ML scoring API: requests risk score
- ML scoring API → Anomaly ensemble: scores anomalies
ml-service/main.py - ML scoring API → Security endpoints: returns risk score
- Security endpoints → Security state machine: applies risk state
backend/src/main/java/com/behaviorlock/backend/controller/SecurityController.java - Security state machine → Session repository: updates sessions
backend/src/main/java/com/behaviorlock/backend/service/SecurityStateMachineService.java - Security state machine → Alert repository: records alerts
backend/src/main/java/com/behaviorlock/backend/service/SecurityStateMachineService.java - Session repository → MySQL: reads and writes
- Alert repository → MySQL: reads and writes
- Security state machine → Re-authentication: requires re-auth
- User → Re-authentication: re-authenticates
- User → Dashboard aggregation: views summary
- Dashboard aggregation → Alert repository: loads alerts
backend/src/main/java/com/behaviorlock/backend/service/DashboardService.java - Dashboard aggregation → Session repository: loads sessions
backend/src/main/java/com/behaviorlock/backend/service/DashboardService.java - User → Alert endpoints: views alerts