actr-protocol 0.4.3

Unified protocol, types, and URI parsing for Actor-RTC framework
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

//! Manufacturer registration proof payload helpers.
//!
//! These helpers define the stable bytes signed by a package launcher using the
//! package manufacturer's key. For unpublished package registration, AIS
//! verifies this signature with the same MFR key that signed the package
//! manifest.

use crate::ActrType;

pub const MANUFACTURER_REGISTER_DOMAIN: &str = "ACTR-MANUFACTURER-REGISTER-V1";

#[derive(Debug, Clone, Copy)]
pub struct ManufacturerRegisterPayload<'a> {
    pub realm_id: u32,
    pub actr_type: &'a ActrType,
    pub target: &'a str,
    pub manifest_sha256_hex: &'a str,
    pub manufacturer_auth_signed_at: u64,
    pub manufacturer_auth_nonce: &'a [u8],
}

pub fn build_manufacturer_register_payload(input: ManufacturerRegisterPayload<'_>) -> String {
    format!(
        "{domain}\n\
         auth_mode=package\n\
         realm={realm}\n\
         actr_type={actr_type}\n\
         target={target}\n\
         manifest_sha256={manifest_sha256}\n\
         manufacturer_auth_signed_at={manufacturer_auth_signed_at}\n\
         manufacturer_auth_nonce={manufacturer_auth_nonce}",
        domain = MANUFACTURER_REGISTER_DOMAIN,
        realm = input.realm_id,
        actr_type = input.actr_type.to_string_repr(),
        target = input.target,
        manifest_sha256 = input.manifest_sha256_hex,
        manufacturer_auth_signed_at = input.manufacturer_auth_signed_at,
        manufacturer_auth_nonce = hex::encode(input.manufacturer_auth_nonce),
    )
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn manufacturer_register_payload_is_stable() {
        let actr_type = ActrType {
            manufacturer: "acme".to_string(),
            name: "echo".to_string(),
            version: "1.2.3".to_string(),
        };

        let payload = build_manufacturer_register_payload(ManufacturerRegisterPayload {
            realm_id: 7,
            actr_type: &actr_type,
            target: "x86_64-unknown-linux-gnu",
            manifest_sha256_hex: "abc123",
            manufacturer_auth_signed_at: 1_782_200_000,
            manufacturer_auth_nonce: &[0xab, 0xcd],
        });

        assert_eq!(
            payload,
            "ACTR-MANUFACTURER-REGISTER-V1\n\
             auth_mode=package\n\
             realm=7\n\
             actr_type=acme:echo:1.2.3\n\
             target=x86_64-unknown-linux-gnu\n\
             manifest_sha256=abc123\n\
             manufacturer_auth_signed_at=1782200000\n\
             manufacturer_auth_nonce=abcd"
        );
    }
}