Releases: CERTCC/SSVC
v2024.3.9
This release converges feedback from the CSAF and CVE projects on the SSVC json schema. Also various dependency updates.
What's Changed
- Merge #627 into publish by @ahouseholder in #628
- Schema fix by @ahouseholder in #634
- Publish changes from #635 by @ahouseholder in #636
- Publish JSON schema base change to 2020-12 by @ahouseholder in #643
- Publish fix for decision point reference doc spacing by @ahouseholder in #646
- Bump mkdocs-material from 9.5.42 to 9.5.43 in the mkdocs group by @dependabot in #647
- Bump the mkdocs group with 2 updates by @dependabot in #648
- Bump mkdocs-include-markdown-plugin from 7.0.0 to 7.0.1 in the mkdocs group by @dependabot in #651
- Bump the mkdocs group with 2 updates by @dependabot in #653
- SSVC JSON Schema 2020-12 by @tschmidtb51 in #654
- Bump mkdocs-material from 9.5.46 to 9.5.48 in the mkdocs group by @dependabot in #656
- Bump the mkdocs group across 1 directory with 2 updates by @dependabot in #660
- Bump scikit-learn from 1.5.2 to 1.6.0 by @dependabot in #658
- Bump scikit-learn from 1.6.0 to 1.6.1 by @dependabot in #661
- Spelling error fix in Decision Point Value Selection cvvs to cvss by @sei-vsarvepalli in #664
New Contributors
- @tschmidtb51 made their first contribution in #654
Full Changelog: v2024.3.8...v2024.3.9
SSVC v2024.3.8
Fixes spacing issues affecting HTML layout in decision point reference documentation.
What's Changed
- Updates from mkdocs latest version for space issues by @sei-vsarvepalli in #645
Full Changelog: v2024.3.7...v2024.3.8
SSVC v2024.3.7
What's Changed
- Bump mkdocs-include-markdown-plugin from 6.2.2 to 7.0.0 by @dependabot in #638
- Bump networkx from 3.4.1 to 3.4.2 by @dependabot in #639
- Change json schema base to 2020-12 by @sei-vsarvepalli in #642
Full Changelog: v2024.3.6...v2024.3.7
SSVC v2024.3.6
This release is primarily to address schema changes for CVE data record compatibility.
What's Changed
- Schema/issue 631 by @sei-vsarvepalli in #633
- Wrong URL in the ID field for Decision_Point_Value_Selection-1-0-1.schema.json by @sei-vsarvepalli in #635
Dependency updates
- Bump the mkdocs group with 3 updates by @dependabot in #629
- Bump the mkdocs group with 2 updates by @dependabot in #632
- Bump networkx from 3.3 to 3.4.1 by @dependabot in #630
Full Changelog: v2024.3.5...v2024.3.6
SSVC v2024.3.5
Fixes a schema bug in v2024.3.4
What's Changed
- Bump mkdocs-material from 9.5.36 to 9.5.39 in the mkdocs group by @dependabot in #626
- schema URL's ID field is garbled by @sei-vsarvepalli in #627
Full Changelog: v2024.3.4...v2024.3.5
SSVC v2024.3.4
Significant updates in this version include:
- JSON schema updates
- Bug fixes & Dependency updates
What's Changed
- Add Decision Point Value Selection schema with an example by @sei-vsarvepalli in #599
- Fix bad import in PolicyGenerator by @ahouseholder in #605
- Add schemaVersion field by @sei-vsarvepalli in #606
- Update dependencies by @ahouseholder in #598
- Bump mkdocs-material from 9.5.28 to 9.5.29 in the mkdocs group by @dependabot in #607
- Bump jsonschema from 4.22.0 to 4.23.0 by @dependabot in #608
- Bump the mkdocs group with 3 updates by @dependabot in #609
- Bump mkdocs-material from 9.5.30 to 9.5.31 in the mkdocs group by @dependabot in #610
- Bump mkdocs-include-markdown-plugin from 6.2.1 to 6.2.2 in the mkdocs group by @dependabot in #611
- Bump the mkdocs group with 2 updates by @dependabot in #612
- Bump mkdocs-table-reader-plugin from 2.2.2 to 3.0.1 by @dependabot in #613
- Bump the mkdocs group across 1 directory with 6 updates by @dependabot in #618
- Bump mkdocs-print-site-plugin from 2.5.0 to 2.6.0 in the mkdocs group by @dependabot in #619
- Bump scikit-learn from 1.5.1 to 1.5.2 by @dependabot in #620
- Bump pandas from 2.2.2 to 2.2.3 by @dependabot in #622
- Bump mkdocs-material from 9.5.34 to 9.5.36 in the mkdocs group by @dependabot in #621
Full Changelog: v2024.3.3...v2024.3.4
SSVC v2024.3.3
What's Changed
- Remove polyfill.io dependency
- Update dependencies
Full Changelog: v2024.3.2...v2024.3.3
SSVC v2024.3.2
- Make json schemas available from
/data/schema/
folder on site - Update Mission Impact in
.json
and.csv
representations - Minor i18n improvements
- Update links to CERT Guide to CVD to new site
- Other link fixes
- Project infrastructure improvements
- Update Dependencies
What's Changed
- Publish certcc.github.io/SSVC by @ahouseholder in #534
- Updates dependencies & adds changelog by @ahouseholder in #554
- Bump pandas from 2.2.1 to 2.2.2 by @dependabot in #557
- Bump scikit-learn from 1.4.1.post1 to 1.4.2 by @dependabot in #556
- Bump mkdocs-print-site-plugin from 2.3.6 to 2.4.0 in the mkdocs group by @dependabot in #555
- Updated Mission-Impact in Deployer.json and in csvs/child_trees to ma… by @sei-vsarvepalli in #559
- i18n improvement to Deployer.json by @sei-vsarvepalli in #560
- Bump the mkdocs group with 3 updates by @dependabot in #563
- Replace vuls.cert.org CVD guide links with certcc.github.io links by @ahouseholder in #562
- Bump dataclasses-json from 0.6.4 to 0.6.5 by @dependabot in #566
- Bump the mkdocs group across 1 directory with 5 updates by @dependabot in #567
- Bump jsonschema from 4.21.1 to 4.22.0 by @dependabot in #568
- Bump dataclasses-json from 0.6.5 to 0.6.6 by @dependabot in #572
- Bump the mkdocs group with 3 updates by @dependabot in #571
- Add requirements.txt trigger to link_checker.yml by @ahouseholder in #569
- Bump the mkdocs group with 3 updates by @dependabot in #573
- Bump scikit-learn from 1.4.2 to 1.5.0 by @dependabot in #575
- Bump the mkdocs group with 2 updates by @dependabot in #574
- Bump the mkdocs group with 3 updates by @dependabot in #577
- Fixed URL in README.md by @patrickmgarrity in #578
- Bump dataclasses-json from 0.6.6 to 0.6.7 by @dependabot in #580
- Bump the mkdocs group with 2 updates by @dependabot in #579
- Bump mkdocs-material from 9.5.26 to 9.5.27 in the mkdocs group by @dependabot in #583
- Bump the mkdocs group with 2 updates by @dependabot in #585
- Make schema available via data/ folder for certcc.github.io by @sei-vsarvepalli in #586
- Dockerize unit tests by @ahouseholder in #581
New Contributors
- @patrickmgarrity made their first contribution in #578
Full Changelog: v2024.3.1...v2024.3.2
SSVC v2024.3.1
- Update dependencies
- Add 2024.3 release notes
- Integrate site navigation with
certcc.github.io
home page
What's Changed
- Bump the mkdocs group with 1 update by @dependabot in #541
- Configure sitemap.xml to be populated by @ahouseholder in #543
- Bump the mkdocs group with 2 updates by @dependabot in #544
- Bump the mkdocs group with 3 updates by @dependabot in #545
- Bump actions/configure-pages from 4 to 5 by @dependabot in #548
- Bump the mkdocs group with 2 updates by @dependabot in #547
- Bump the mkdocs group with 4 updates by @dependabot in #551
- Bump networkx from 3.2.1 to 3.3 by @dependabot in #552
- Add link to certcc.github.io home page by @ahouseholder in #553
- Update changelog by @ahouseholder in #549
Full Changelog: v2024.3...v2024.3.1
SSVC v2024.3
The Stakeholder-specific Vulnerability Categorization (SSVC) is a system for prioritizing actions during vulnerability management. SSVC aims to avoid one-size-fits-all solutions in favor of a modular decision-making system with clearly defined and tested parts that vulnerability managers can select and use as appropriate to their context.
In the 2024.3 release of the Stakeholder-Specific Vulnerability Classification (SSVC) system, we've made a number of significant changes:
New Web Site
This release debuts the certcc.github.io/SSVC web site to serve as the front-door for all things SSVC.
- Diátaxis Framework - We adopted the Diátaxis Framework as a document organization framework for SSVC documentation. High level content categories are: tutorials, how-to, topics, and reference. What used to be a linear paper format is now sectioned off into more digestible pieces.
- More call-outs and examples - With our adoption of Material for MkDocs as the underlying toolkit to construct our web site, we were able to better highlight examples, tips, and sidebar topics through the use of call-out boxes throughout the site.
New and Revised Content
- Expanded Content - We've included more examples of Decision Points and the like directly inline where they're mentioned so readers don't need to keep flipping back and forth to their definitions for reference.
- Bootstrapping advice - Added a Getting Started with SSVC process to help organizations go from being potential SSVC users to being actual SSVC users. This process is based on both our own experience helping organizations adopt SSVC as well as a few field reports of SSVC adoption from the community.
- Putting the Pieces Together - Added a Putting the Pieces Together page explaining some of our philosophy regarding how to use SSVC to model decisions. SSVC provides you with the pieces and some instructions on how to assemble them, but you can customize it however you like.
- Acuity Ramp - Added an Acuity Ramp explainer to show how an organization can grow into a decision model over time.
- Community Engagement - Included in the new web site are a number of suggested ways for the community to interact with and contribute to the SSVC project on Github.
Versioned Objects
- Semantic Versioning for Decision Points and Decision Point Groups - Introduced Semantic Versioning (SemVer) for Decision Points and Decision Point Groups to improve communication around decision points and decision models
- Calendar Versioning for SSVC as a whole - With the introduction of SemVer for Decision Points and Decision Point Groups, it started to make less sense for us to talk in terms of "SSVC v2.2", especially as we were simultaneously moving away from a PDF document-focused development model towards a more flexible web-based documentation model. Beginning with this version, we anticipate that future tagged releases will use Calendar Versioning (CalVer) instead of SemVer.
Experimental & Emerging Features
There are a few improvements we've begun but have not yet fully finished, and that are largely undocumented. Most of these in the current release are python-centric. Here's a brief overview for those who want to poke around at code.
- SSVC Python module - This release introduces the
ssvc
python module to allow us to more easily work with Decision Points, Decision Point Groups, Outcomes, and Policies that map from Decision Points to Outcomes. We expect to have more to say about this module in the future, but for now it's geared towards helping us produce the site documentation. - Policy Generator - We're prototyping a Python tool that can generate a starting policy given any combination of a Decision Point Group and Outcomes. It's not ready for prime-time yet, but folks with a bit of python skill might be in a position to try it out.
- More Decision Points and Outcomes - In the process of exercising our Semantic Versioning rules for decision points and groups, we needed some examples of versioning events for discussion purposes. As a result, the
ssvc.decision_points.cvss
andssvc.dp_groups.cvss
modules contain python implementations of CVSS vector elements from CVSS v1, v2, v3, v3.1, and v4. We anticipate some of these coming in handy in the future as we look toward modeling other decisions potentially based on CVSS vector elements as well as other decision points from SSVC and elsewhere. We also included decision points and groups from CISA's customized SSVC implementation.
Other project infrastructure improvements
- Shifted from PDF-oriented to web-oriented workflow
- Adopted MkDocs and Material for MkDocs for static site production
- Adopted Markdown Any Decision Records to preserve rationale and record decisions that are of significant impact to the project
- Added documentation to the SSVC project wiki with tips for current and future contributors.
- Began using Github's Dependabot to help maintain dependency versions.
What's Changed
- Convert docs to mkdocs, material, mermaid by @ahouseholder in #301
- Create CODEOWNERS by @ahouseholder in #305
- Fix video links by @ahouseholder in #312
- Fix links by @ahouseholder in #310
- Feature/bootstrapping docs by @ahouseholder in #308
- Move project meta-docs from main repo into Github wiki by @ahouseholder in #320
- add drop column importance by @ahouseholder in #327
- Add print-site plugin to restore all-in-one page feature by @ahouseholder in #338
- Add new json schemas for decision points and dp groups by @ahouseholder in #340
- Add SSVC python module by @ahouseholder in #342
- Begin recording architecture decisions by @ahouseholder in #341
- Add python decision points for critical software and high value assets by @ahouseholder in #346
- add ADR proposals for decision point versioning. by @ahouseholder in #350
- Add Decision Point Group Versioning ADRs by @ahouseholder in #368
- Add build steps to python-app.yml by @ahouseholder in #371
- Add CVSS-based (v1, v2, v3) decision points as python classes by @ahouseholder in #343
- Add CWE-PoC list file by @koscinv in #376
- Policy Generator tool, first pass by @ahouseholder in #365
- Reorganize HowTo section by @ahouseholder in #379
- Tool to auto populate documentation examples for decision point objects by @ahouseholder in #370
- Add sanity checks to policy generator by @ahouseholder in #387
- Add CVSSv4 Decision Points by @ahouseholder in #377
- Add ADR excluding examples from object descriptions by @ahouseholder in #391
- Fix policygenerator slowness by @ahouseholder in #397
- Two small typofixes by @ahouseholder in #396
- Add grid to homepage by @ahouseholder in #399
- Pin versions in requirements.txt by @ahouseholder in #400
- Create dependabot.yml by @ahouseholder in #402
- Bump mkdocs-material from 9.5.4 to 9.5.6 by @dependabot in #410
- Bump jsonschema from 4.19.2 to 4.21.1 by @dependabot in #408
- Bump pandas from 2.1.2 to 2.2.0 by @dependabot in #406
- Bump mkdocs-include-markdown-plugin from 6.0.3 to 6.0.4 by @dependabot in #407
- Bump networkx from 3.1 to 3.2.1 by @dependabot in #409
- Add GH actions to dependabot config by @ahouseholder in #411
- Bump mkdocs-table-reader-plugin from 2.0.3 to 2.1.0 by @dependabot in #413
- Bump thefuzz from 0.20.0 to 0.22.1 by @dependabot in #414
- Bump actions/upload-pages-artifact from 2 to 3 by @dependabot in #421
- Bump actions/deploy-pages from 2 to 4 by @dependabot in #422
- Bump dataclasses-json from 0.6.1 to 0.6.3 by @dependabot in #415
- Bump actions/configure-pages from 3 to 4 by @dependabot in #419
- Bump actions/checkout from 3 to 4 by @dependabot in #420
- Bump actions/setup-python from 3 to 5 by @dependabot in #418
- Bump scikit-learn from 1.3.2 to 1.4.0 by @dependabot in https://github.com/CERTCC/SSVC/...