How kesavanaswin/cspmr works
CSPMR is a container security posture monitoring tool. Its main runtime discovers Docker containers, scans their images, and combines policy findings with Falco runtime events to assess risk, write a report, and raise alerts. A separate Kubernetes admission webhook evaluates Pods before admission; a realtime dashboard is also present in the tree. The README provides no capability details, and the dashboard and several runtime modules were not excerpted, so their internal behavior and connections are not inferred.
Main entry points: realtime_cspm.py Realtime runner · models.py CSPM data models · trivy_adapter.py Trivy adapter · admission_webhook.py Admission webhook
Components 16
Runtime collection
- Realtime runner
realtime_cspm.py - Docker collector
integrations/docker_events.py - Falco stream
integrations/falco_stream.py - Trivy adapter
integrations/trivy_adapter.py - Image scanner
vuln_scan.py
Posture analysis
- Policy engine
engines/analysis_engine.py - Anomaly detector
engines/analysis_engine.py - Risk engine
engines/risk_engine.py
Reporting and response
- Mitigation engine
engines/mitigation_engine.py - Webhook notifier
integrations/notifications.py - Risk report
output/risk_report.json - Realtime dashboard
dashboard_realtime.py - Admission webhook
admission_webhook.py
Shared data
- Policy configuration
config/policies.yaml - CSPM data models
utils/models.py
Other components
- Operator
Connections 18
- Operator → Realtime runner: starts
- Realtime runner → Docker collector: collects state
realtime_cspm.py - Realtime runner → Falco stream: reads events
realtime_cspm.py - Realtime runner → Trivy adapter: scans containers
realtime_cspm.py - Trivy adapter → Image scanner: scans image
integrations/trivy_adapter.py - Realtime runner → Policy engine: evaluates posture
realtime_cspm.py - Realtime runner → Anomaly detector: scores events
realtime_cspm.py - Realtime runner → Risk engine: assesses risk
realtime_cspm.py - Realtime runner → Mitigation engine: creates alerts
realtime_cspm.py - Realtime runner → Webhook notifier: sends alerts
realtime_cspm.py - Realtime runner → Risk report: writes report
realtime_cspm.py - Realtime runner → Policy configuration: sets policy path
realtime_cspm.py - Admission webhook → Policy engine: evaluates Pod
admission_webhook.py - Admission webhook → Risk engine: assesses Pod
admission_webhook.py - Docker collector → CSPM data models: creates config
integrations/docker_events.py - Falco stream → CSPM data models: creates events
integrations/falco_stream.py - Trivy adapter → CSPM data models: creates findings
integrations/trivy_adapter.py - Mitigation engine → CSPM data models: creates alerts
engines/mitigation_engine.py