Skip to main content

qualia_vision/biosense/liveness/
camera_stream_integrity.rs

1//! OS-level camera stream integrity (virtual-camera injection defense).
2//!
3//! Pure-landmark PAD is defeated if an attacker injects a pre-rendered 3D
4//! avatar into a virtual camera. This module is the **pairing hook** for
5//! hardware attestation: the PAD evaluator fails closed when attestation is
6//! required and not confirmed.
7//!
8//! Platform-specific attestation (Windows Camera Frame Server / Media
9//! Foundation device ID, Android Camera2 hardware level, AVFoundation unique
10//! ID + entitlement) is implemented outside this crate; hosts set
11//! [`CameraStreamAttestation`] before calling PAD.
12
13#[derive(Debug, Clone, Copy, PartialEq, Eq)]
14pub enum CameraStreamSource {
15    /// Host has not classified the stream.
16    Unknown,
17    /// Claimed physical CMOS / built-in or USB UVC with attestation path.
18    PhysicalSensor,
19    /// Known virtual camera / loopback / inject path.
20    VirtualOrInjected,
21}
22
23#[derive(Debug, Clone, Copy, PartialEq, Eq)]
24pub struct CameraStreamAttestation {
25    pub source: CameraStreamSource,
26    /// Host verified device identity / kernel driver path this session.
27    pub hardware_attested: bool,
28    /// When true, PAD must refuse VirtualOrInjected and unattested streams.
29    pub require_physical: bool,
30}
31
32impl Default for CameraStreamAttestation {
33    fn default() -> Self {
34        Self {
35            source: CameraStreamSource::Unknown,
36            hardware_attested: false,
37            // Default open for unit tests / mesh-only benches; production hosts
38            // set require_physical = true for unlock paths.
39            require_physical: false,
40        }
41    }
42}
43
44impl CameraStreamAttestation {
45    /// Physical-attested stream integrity.
46    pub fn physical_attested() -> Self {
47        Self {
48            source: CameraStreamSource::PhysicalSensor,
49            hardware_attested: true,
50            require_physical: true,
51        }
52    }
53
54    /// Virtual-camera stream integrity (still requires physical).
55    pub fn virtual_camera() -> Self {
56        Self {
57            source: CameraStreamSource::VirtualOrInjected,
58            hardware_attested: false,
59            require_physical: true,
60        }
61    }
62}
63
64#[derive(Debug, Clone, Copy, PartialEq, Eq)]
65pub enum StreamIntegrityVerdict {
66    Ok,
67    VirtualCamera,
68    UnattestedPhysicalRequired,
69}
70
71/// Gate PAD on stream origin. Fail closed when physical attestation is required.
72pub fn check_camera_stream_integrity(att: CameraStreamAttestation) -> StreamIntegrityVerdict {
73    if !att.require_physical {
74        return StreamIntegrityVerdict::Ok;
75    }
76    match att.source {
77        CameraStreamSource::VirtualOrInjected => StreamIntegrityVerdict::VirtualCamera,
78        CameraStreamSource::Unknown => StreamIntegrityVerdict::UnattestedPhysicalRequired,
79        CameraStreamSource::PhysicalSensor if !att.hardware_attested => {
80            StreamIntegrityVerdict::UnattestedPhysicalRequired
81        }
82        CameraStreamSource::PhysicalSensor => StreamIntegrityVerdict::Ok,
83    }
84}
85
86#[cfg(test)]
87mod tests {
88    use super::*;
89
90    #[test]
91    fn virtual_rejected_when_required() {
92        assert_eq!(
93            check_camera_stream_integrity(CameraStreamAttestation::virtual_camera()),
94            StreamIntegrityVerdict::VirtualCamera
95        );
96    }
97
98    #[test]
99    fn physical_attested_ok() {
100        assert_eq!(
101            check_camera_stream_integrity(CameraStreamAttestation::physical_attested()),
102            StreamIntegrityVerdict::Ok
103        );
104    }
105
106    #[test]
107    fn default_open_for_tests() {
108        assert_eq!(
109            check_camera_stream_integrity(CameraStreamAttestation::default()),
110            StreamIntegrityVerdict::Ok
111        );
112    }
113}