guac 0.3.1

A library that provides toolkit for working with [Guac](https://guac.sh) from Rust.
Documentation 
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
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use chrono::Utc;
use graphql_client::reqwest::post_graphql;

use crate::client::intrinsic::vuln_metadata::ingest::IngestVulnerabilityMetadata;
use crate::client::intrinsic::vuln_metadata::query::{query_vulnerability_metadata, QueryVulnerabilityMetadata};
use crate::client::intrinsic::vulnerability::{VulnerabilityInputSpec, VulnerabilitySpec};
use crate::client::intrinsic::IntrinsicGuacClient;
use crate::client::{Error, Id};

mod ingest;
mod query;

type Time = chrono::DateTime<Utc>;

impl IntrinsicGuacClient {
    pub async fn ingest_vuln_metadata(
        &self,
        vulnerability: &VulnerabilityInputSpec,
        vulnerability_metadata: &VulnerabilityMetadataInputSpec,
    ) -> Result<Id, Error> {
        use self::ingest::ingest_vulnerability_metadata;

        let variables = ingest_vulnerability_metadata::Variables {
            vulnerability: vulnerability.into(),
            vulnerability_metadata: vulnerability_metadata.into(),
        };

        let response_body =
            post_graphql::<IngestVulnerabilityMetadata, _>(self.client(), self.url(), variables).await?;

        if let Some(errors) = response_body.errors {
            return Err(Error::GraphQL(errors));
        }

        let data = response_body.data.ok_or(Error::GraphQL(vec![]))?;

        Ok(data.ingest_vulnerability_metadata)
    }

    pub async fn vuln_metadata(
        &self,
        vulnerability_metadata_spec: &VulnerabilityMetadataSpec,
    ) -> Result<Vec<VulnerabilityMetadata>, Error> {
        use self::query::query_vulnerability_metadata;

        let variables = query_vulnerability_metadata::Variables {
            vulnerability_metadata_spec: vulnerability_metadata_spec.into(),
        };

        let response_body = post_graphql::<QueryVulnerabilityMetadata, _>(self.client(), self.url(), variables).await?;

        if let Some(errors) = response_body.errors {
            return Err(Error::GraphQL(errors));
        }

        let data = response_body.data.ok_or(Error::GraphQL(vec![]))?;

        let mut meta = Vec::new();

        for entry in &data.vulnerability_metadata {
            meta.push(entry.into());
        }

        Ok(meta)
    }
}

#[derive(Debug, Clone)]
pub struct VulnerabilityMetadata {
    pub id: Id,
    pub score_type: VulnerabilityScoreType,
    pub score_value: f64,
    pub timestamp: Time,
    pub origin: String,
    pub collector: String,
}

#[derive(Debug, Clone)]
pub struct VulnerabilityMetadataInputSpec {
    pub score_type: VulnerabilityScoreType,
    pub score_value: f64,
    pub timestamp: Time,
    pub origin: String,
    pub collector: String,
}

#[derive(Default, Debug, Clone)]
pub struct VulnerabilityMetadataSpec {
    pub id: Option<Id>,
    pub vulnerability: Option<VulnerabilitySpec>,
    pub score_type: Option<VulnerabilityScoreType>,
    pub score_value: Option<f64>,
    pub comparator: Option<Comparator>,
    pub timestamp: Option<Time>,
    pub origin: Option<String>,
    pub collector: Option<String>,
}

#[derive(Debug, Clone)]
pub enum VulnerabilityScoreType {
    CVSSv2,
    CVSSv3,
    CVSSv31,
    CVSSv4,
    EPSSv1,
    EPSSv2,
    OWASP,
    SSVC,
    Other(String),
}

#[derive(Debug, Clone)]
pub enum Comparator {
    Greater,
    Equal,
    Less,
    GreaterEqual,
    LessEqual,
}