How tirrenotechnologies/tirreno works
Tirreno is a self-hosted, in-application security framework: products send contextual events to its sensor/API, which enriches and records them for the operator console to analyze. The console supports dashboards and entity activity views, automated risk rules, manual review, and field-audit trails. The diagram shows the sampled event-ingestion calls and the application’s aggregator structure; major README capabilities with unsampled implementations are retained as subsystem nodes. Some links to those unsampled features are dashed and unverified.
Main entry points: CreateEventController.php Event controller · Main.php Page services · UserScore.php Risk scoring · Controllers.php Controller registry
Components 19
Event ingestion
- Event controller
sensor/src/Controller/CreateEventController.php - Data enrichment
sensor/src/Service/Enrichment - URL query parsing
sensor/src/Service/QueryParser.php - User-agent records
sensor/src/Repository/UserAgentRepository.php - URL query records
sensor/src/Repository/UrlQueryRepository.php - Event persistence
sensor/src/Repository - Event database
sensor/src/Repository
Security analysis
- Risk rules
app/Models/Rules.php - Risk scoring
app/Models/UserScore.php - Review queue
app/Models/ReviewQueue.php - Field audit trail
app/Models/FieldAuditTrail.php
Operator console
- Security dashboard
app/Models/Dashboard.php - Single-user view
app/Controllers/Services/User.php - Console entry
app/Controllers/Pages/Main.php - Page services
app/Controllers/Services/Main.php
Application core
- Controller registry
app/Core/Services/Controllers.php - Entity registry
app/Core/Services/Entities.php - Model registry
app/Core/Services/Models.php
Other components
- Product SDK
Connections 16
- Product SDK → Event controller: sends events
README.md - Event controller → Data enrichment: requests enrichment
sensor/src/Controller/CreateEventController.php - Event controller → URL query parsing: parses URL
sensor/src/Controller/CreateEventController.php - Event controller → Event persistence: inserts event
sensor/src/Controller/CreateEventController.php - Event controller → User-agent records: detects device
- Event controller → URL query records: stores query
- Event controller → Event database: records event
sensor/src/Controller/CreateEventController.php - Console entry → Controller registry: uses registry
app/Controllers/Pages/Main.php - Page services → Controller registry: uses registry
app/Controllers/Services/Main.php - Page services → Entity registry: resolves entities
app/Controllers/Services/Main.php - Page services → Model registry: resolves models
app/Controllers/Services/Main.php - Security dashboard → Page services: powers dashboard
- Single-user view → Page services: serves entity view
- Risk rules → Risk scoring: calculates scores
- Risk scoring → Review queue: flags risky entities
- Field audit trail → Page services: supports audit view