csaf-rs 0.5.1

A parser for the CSAF standard written 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

use crate::csaf::types::csaf_document_category::CsafDocumentCategory;
use crate::csaf_traits::{CsafTrait, DocumentTrait, ProductStatusTrait, VulnerabilityTrait};
use crate::validation::ValidationError;
use crate::validations::utils::document_category_test_config::DocumentCategoryTestConfig;

/// 6.1.27.7 VEX Product Status
///
/// This test only applies to documents with `/document/category` with value `csaf_vex`.
///
/// In documents with this category each `/vulnerabilities[]/product_status` must have at least one
/// of the elements: `fixed`, `known_affected`, `known_not_affected` or `under_investigation`
pub fn test_6_1_27_07_vex_product_status(doc: &impl CsafTrait) -> Result<(), Vec<ValidationError>> {
    let doc_category = doc.get_document().get_category();

    if !PROFILE_TEST_CONFIG.matches_category(&doc_category) {
        return Ok(()); // ToDo generate skipped https://github.com/csaf-rs/csaf/issues/409
    }

    let mut errors: Option<Vec<ValidationError>> = None;
    // return error if there are vulnerabilities without fixed, known_affected, known_not_affected or under_investigation in product_status
    for (v_i, vulnerability) in doc.get_vulnerabilities().iter().enumerate() {
        if let Some(product_status) = vulnerability.get_product_status()
            && !(product_status.get_fixed().is_some()
                || product_status.get_known_affected().is_some()
                || product_status.get_known_not_affected().is_some()
                || product_status.get_under_investigation().is_some())
        {
            errors
                .get_or_insert_default()
                .push(test_6_1_27_07_err_generator(&doc_category, &v_i));
        }
    }

    errors.map_or(Ok(()), Err)
}

const PROFILE_TEST_CONFIG: DocumentCategoryTestConfig =
    DocumentCategoryTestConfig::new().shared(&[CsafDocumentCategory::CsafVex]);

fn test_6_1_27_07_err_generator(document_category: &CsafDocumentCategory, vuln_path_index: &usize) -> ValidationError {
    ValidationError {
        message: format!(
            "Document with category '{document_category}' must provide at least one fixed, known_affected, known_unaffected or under_investigation product_status in each vulnerability"
        ),
        instance_path: format!("/vulnerabilities/{vuln_path_index}/product_status"),
    }
}

crate::test_validation::impl_validator!(ValidatorForTest6_1_27_7, test_6_1_27_07_vex_product_status);

#[cfg(test)]
mod tests {
    use super::*;
    use crate::csaf2_0::testcases::TESTS_2_0;
    use crate::csaf2_1::testcases::TESTS_2_1;

    #[test]
    fn test_test_6_1_27_07() {
        let case_01 = Err(vec![test_6_1_27_07_err_generator(&CsafDocumentCategory::CsafVex, &0)]);

        TESTS_2_0.test_6_1_27_7.expect(case_01.clone(), Ok(()));
        TESTS_2_1.test_6_1_27_7.expect(case_01, Ok(()));
    }
}