Skip to main content

qualia_core_db/net/
disclosure.rs

1//! Network disclosure discipline for outbound connections.
2//!
3//! Enforces that no adapter driver can reach out to the internet without
4//! explicit, pre-registered consent for its recipient and purpose.
5
6use std::collections::HashMap;
7
8/// An outbound network endpoint that an adapter requires access to.
9#[derive(Debug, Clone, PartialEq, Eq, Hash)]
10pub struct RegisteredEndpoint {
11    pub url: String,
12    pub purpose: String,
13    pub trigger: String,
14}
15
16/// The registry controlling egress to external layers.
17pub struct NetworkDisclosureRegistry {
18    /// Maps adapter ID (e.g. "dem_adapter") to its permitted endpoints
19    allowed_endpoints: HashMap<String, Vec<RegisteredEndpoint>>,
20}
21
22impl NetworkDisclosureRegistry {
23    /// Creates `NetworkDisclosureRegistry` with the given state.
24    pub fn new() -> Self {
25        Self {
26            allowed_endpoints: HashMap::new(),
27        }
28    }
29
30    /// Registers a permitted endpoint for an adapter.
31    pub fn register_egress(&mut self, adapter_id: &str, url: &str, purpose: &str, trigger: &str) {
32        let entry = self
33            .allowed_endpoints
34            .entry(adapter_id.to_string())
35            .or_insert_with(Vec::new);
36        entry.push(RegisteredEndpoint {
37            url: url.to_string(),
38            purpose: purpose.to_string(),
39            trigger: trigger.to_string(),
40        });
41    }
42
43    /// Fail-closed check before initiating `reqwest` or `/proxy/fetch`.
44    ///
45    /// Returns true if the endpoint is registered, false otherwise.
46    pub fn check_egress_consent(&self, adapter_id: &str, target_url: &str) -> bool {
47        if let Some(endpoints) = self.allowed_endpoints.get(adapter_id) {
48            for ep in endpoints {
49                if target_url.starts_with(&ep.url) {
50                    return true;
51                }
52            }
53        }
54        false
55    }
56}
57
58#[cfg(test)]
59mod tests {
60    use super::*;
61
62    #[test]
63    fn test_disclosure_registry() {
64        let mut registry = NetworkDisclosureRegistry::new();
65
66        registry.register_egress(
67            "dem_adapter",
68            "https://elevation.example.com",
69            "Fetch Cloud-Optimized GeoTIFF for terrain",
70            "User pans camera to quadrant",
71        );
72
73        // Exact match
74        assert!(registry.check_egress_consent("dem_adapter", "https://elevation.example.com"));
75        // Prefix match
76        assert!(registry.check_egress_consent(
77            "dem_adapter",
78            "https://elevation.example.com/tile/1/2/3.tif"
79        ));
80
81        // Unregistered endpoint for the adapter
82        assert!(!registry.check_egress_consent("dem_adapter", "https://tracker.example.com/log"));
83
84        // Unregistered adapter
85        assert!(!registry.check_egress_consent("unknown_adapter", "https://elevation.example.com"));
86    }
87}