keylight 0.1.2

Keylight licensing SDK — activate/validate licenses with offline Ed25519 lease verification.
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

//! The signed `v3` [`Lease`] — the offline artifact — and reconstruction of its
//! canonical signed payload.

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct Lease {
    pub kid: String,
    #[serde(rename = "licenseKeyHash")]
    pub license_key_hash: String,
    #[serde(rename = "instanceId")]
    pub instance_id: String,
    #[serde(rename = "issuedAt")]
    pub issued_at: i64,
    #[serde(rename = "expiresAt")]
    pub expires_at: i64,
    pub status: String,
    pub signature: String,
    pub entitlements: Vec<String>,
}

impl Lease {
    /// The exact UTF-8 payload that was signed (entitlements re-sorted ascending).
    pub fn payload(&self) -> String {
        let mut ents: Vec<&str> = self.entitlements.iter().map(String::as_str).collect();
        ents.sort_unstable();
        format!(
            "v3|{}|{}|{}|{}|{}|{}|{}",
            self.kid,
            self.license_key_hash,
            self.instance_id,
            self.issued_at,
            self.expires_at,
            self.status,
            ents.join(",")
        )
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    #[test]
    fn payload_sorts_entitlements_and_matches_v3_format() {
        let l = Lease {
            kid: "k1".into(),
            license_key_hash: "abc".into(),
            instance_id: "i1".into(),
            issued_at: 100,
            expires_at: 200,
            status: "active".into(),
            signature: "sig".into(),
            entitlements: vec!["pro".into(), "admin".into()],
        };
        assert_eq!(l.payload(), "v3|k1|abc|i1|100|200|active|admin,pro");
    }
    #[test]
    fn payload_empty_entitlements_is_trailing_empty() {
        let l = Lease {
            kid: "k1".into(),
            license_key_hash: "abc".into(),
            instance_id: "i1".into(),
            issued_at: 100,
            expires_at: 200,
            status: "active".into(),
            signature: "sig".into(),
            entitlements: vec![],
        };
        assert_eq!(l.payload(), "v3|k1|abc|i1|100|200|active|");
    }
}