How certcc/ssvc works
SSVC is a Python toolkit for stakeholder-specific vulnerability prioritization, with a FastAPI interface alongside its decision-modeling library. The principal workflow is to define or select vulnerability decision points, combine them in decision tables, and interpret the resulting outcome; tables can also be analyzed to enumerate paths and produce CSV. CVSS, CISA, NIST, and SSVC-specific decision-point collections and tables are distinct domain branches. The README documents generated JSON/schema examples and documentation support, but their runtime wiring is not established by the sampled source. API route details are likewise unsampled.
Main entry points: decision_points/base.py Decision point model · decision_tables/base.py Decision table model · policy_generator.py Policy generation · main.py API application
Components 24
HTTP API
- API application
src/ssvc/api/main.py - API v1 routes
src/ssvc/api/v1/routers/v1_router.py - Response models
src/ssvc/api/v1/response_models
Decision models
- Decision point model
src/ssvc/decision_points/base.py - CVSS decision points
src/ssvc/decision_points/cvss/attack_vector.py - SSVC decision points
src/ssvc/decision_points/ssvc/base.py - CISA and NIST points
src/ssvc/decision_points/cisa - Point helpers
src/ssvc/decision_points/helpers.py - Decision table model
src/ssvc/decision_tables/base.py - Legacy point groups
src/ssvc/dp_groups/base.py
Decision catalog
- SSVC tables
src/ssvc/decision_tables/ssvc/coord_triage.py - CISA tables
src/ssvc/decision_tables/cisa/cisa_coordinate_dt.py - CVSS tables
src/ssvc/decision_tables/cvss/equivalence_set_six.py - Point collections
src/ssvc/dp_groups/cvss/collections.py
Analysis outputs
- Outcome definitions
src/ssvc/outcomes/ssvc/coordinate.py - CSV path analysis
src/ssvc/csv_analyzer.py - Decision ordering
src/ssvc/utils/toposort.py - Policy generation
src/ssvc/policy_generator.py
Shared foundation
- Object registry
src/ssvc/registry/base.py - Namespace rules
src/ssvc/namespaces.py - Model mixins
src/ssvc/_mixins.py - Field defaults
src/ssvc/utils/defaults.py - Field specifications
src/ssvc/utils/field_specs.py
Other components
- Vulnerability manager
Connections 27
- Vulnerability manager → API application: submits requests
- API application → API v1 routes: mounts v1
src/ssvc/api/main.py - API v1 routes → Response models: serves responses
- API application → Object registry: uses registry
src/ssvc/api/main.py - Decision point model → Model mixins: inherits traits
src/ssvc/decision_points/base.py - Decision point model → Field defaults: uses defaults
src/ssvc/decision_points/base.py - CVSS decision points → Decision point model: extends model
src/ssvc/decision_points/cvss/attack_vector.py - SSVC decision points → Decision point model: extends model
- CISA and NIST points → Decision point model: extends model
src/ssvc/decision_points/cisa/mission_prevalence.py - CVSS decision points → Point helpers: uses helpers
src/ssvc/decision_points/cvss/attack_vector.py - Decision table model → Decision point model: validates points
src/ssvc/decision_tables/base.py - Decision table model → Object registry: looks up points
src/ssvc/decision_tables/base.py - Decision table model → Field specifications: uses fields
src/ssvc/decision_tables/base.py - Legacy point groups → Decision point model: groups points
src/ssvc/dp_groups/base.py - SSVC tables → Decision table model: defines mappings
src/ssvc/decision_tables/ssvc/coord_triage.py - SSVC tables → Outcome definitions: uses outcomes
src/ssvc/decision_tables/ssvc/coord_triage.py - CISA tables → Decision table model: defines mappings
src/ssvc/decision_tables/cisa/cisa_coordinate_dt.py - CISA tables → Outcome definitions: uses scoring
src/ssvc/decision_tables/cisa/cisa_coordinate_dt.py - CVSS tables → Decision table model: defines mappings
src/ssvc/decision_tables/cvss/equivalence_set_six.py - Point collections → CVSS decision points: collects points
src/ssvc/dp_groups/cvss/collections.py - Model mixins → Namespace rules: validates names
src/ssvc/_mixins.py - Model mixins → Field specifications: uses fields
src/ssvc/_mixins.py - CSV path analysis → Decision ordering: orders paths
src/ssvc/csv_analyzer.py - Policy generation → CSV path analysis: analyzes paths
src/ssvc/policy_generator.py - Policy generation → Decision point model: uses points
src/ssvc/policy_generator.py - Policy generation → Legacy point groups: uses groups
src/ssvc/policy_generator.py - Policy generation → Outcome definitions: uses outcomes
src/ssvc/policy_generator.py