ssvc 0.2.1

Implementation of the SSVC specification in Rust
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# SSVC Rust Implementation

A Rust implementation of the **SSVC (Stakeholder-Specific Vulnerability Categorization)** specification.
SSVC is a framework for prioritizing software vulnerability remediation efforts. It helps stakeholders make informed decisions about which vulnerabilities to address first by considering factors like vulnerability severity, the stakeholder's position in the ecosystem, and their specific constraints.
Learn more at the [official SSVC documentation](https://certcc.github.io/SSVC/).

## Features

This library provides validation and processing of SSVC decision points and selection lists, with support for SSVC namespaces and extensions.
It features full serde support. The library supports both native Rust usage and WebAssembly (WASM) bindings for JavaScript/web applications.

## Installation

Add to your project:

```bash
cargo add ssvc
```

## MSRV

1.85.0

## Examples

### Rust

```rust
use ssvc::selection_list::SelectionList;
use ssvc::validate_selection_list;

let json_data = "..."; // Your SSVC selection list

let selection_list: SelectionList =
    serde_json::from_str(json_data).expect("SSVC SelectionList was invalid JSON");

// Validate the selection list
let result = validate_selection_list(&selection_list, false);

if result.success {
    println!("Selection list is valid!");
} else {
    for error in result.errors {
        println!("Validation error: {}", error.message);
    }
}
```

### WebAssembly

#### Build

```bash
# Install wasm-pack if you haven't already
cargo install wasm-pack
# Build for web
wasm-pack build --target web --out-dir pkg -- --features wasm
```

#### Usage

```javascript
import * as wasm from './pkg/ssvc.js';

const jsonData = {...}; // Your SSVC selection list

try {
  const result = wasm.validateSelectionList(JSON.stringify(jsonData), false);
  if (result.success) {
    console.log("Valid SSVC data");
  } else {
    console.log("Validation errors:", result.errors);
  }
} catch (error) {
  console.error("Error:", error);
}
```

## License

Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) file for details.