//! ONVIF PullPoint event subscription for each ONVIF camera in the bundle.
//!
//! For every camera with cam_type=="onvif" and ONVIF credentials, we:
//! 1. CreatePullPointSubscription (SOAP to the camera's event service)
//! 2. PullMessages in a loop (every 3s)
//! 3. Parse each NotificationMessage → topic + source + data key/value
//! 4. POST to /api/kiosk/event with source_type="onvif"
//! 5. Renew subscription before it times out
//! 6. Unsubscribe on shutdown / bundle change
//!
//! Forwards ALL event topics the camera produces: motion, ANPR, line
//! crossing, intrusion, digital input, analytics, tamper — everything.
//! Node-RED sorts what's interesting.
//!
//! Gated by env BF_ENABLE_ONVIF_EVENTS=1 (default OFF for dev kiosks
//! without cameras on the network).
use std::collections::HashMap;
use std::sync::{Arc, Mutex};
use std::time::Duration;
use tracing::{info, warn};
use crate::bundle::BundleCamera;
/// Active subscriptions keyed by camera id. Worker threads check this
/// to know when to stop (camera removed from bundle / bundle changed).
static ACTIVE: Mutex>> = Mutex::new(None);
/// Holds the current generation Arc. When start() replaces it, the old
/// Arc drops → old threads' Weak::upgrade() returns None → they exit.
/// Previous code used std::mem::forget which leaked the Arc and kept
/// old threads alive forever.
static GENERATION: Mutex >> = Mutex::new(None);
/// Subscription status per camera — reported in heartbeat for admin visibility.
static STATUS: Mutex >> = Mutex::new(None);
#[derive(Clone, serde::Serialize)]
pub struct SubStatus {
pub state: &'static str, // "subscribing", "active", "failed", "stopped"
pub last_event_at: Option,
pub error: Option,
}
fn set_status(cam_id: &str, state: &'static str, error: Option) {
let mut map = STATUS.lock().unwrap();
let map = map.get_or_insert_with(HashMap::new);
let entry = map.entry(cam_id.to_string()).or_insert_with(|| SubStatus {
state: "subscribing",
last_event_at: None,
error: None,
});
entry.state = state;
entry.error = error;
}
fn mark_event_received(cam_id: &str) {
let mut map = STATUS.lock().unwrap();
if let Some(map) = map.as_mut() {
if let Some(entry) = map.get_mut(cam_id) {
entry.last_event_at = Some(crate::os_update::current_os_version_public()); // reuse timestamp helper... actually just use epoch
}
}
}
/// Get current subscription statuses for all cameras. Used by heartbeat.
pub fn get_statuses() -> HashMap {
STATUS.lock().unwrap().clone().unwrap_or_default()
}
/// Start event subscription workers for all ONVIF cameras in the bundle.
/// Idempotent — stops old workers (via ACTIVE flag) before starting new.
pub fn start(
cameras: &[BundleCamera],
cluster_key: Option<&str>,
server_url: &str,
kiosk_key: &str,
) {
// Only subscribe to cameras where event_source is "auto" or "kiosk:"
// (not "server" or another kiosk). For "auto", this kiosk subscribes because
// the server put the camera in this kiosk's bundle — meaning it's reachable.
let onvif_cams: Vec<_> = cameras
.iter()
.filter(|c| {
if c.cam_type != "onvif" || c.onvif_host.is_none() { return false; }
match c.event_source.as_deref() {
Some("server") => false, // server handles this one
Some(s) if s.starts_with("kiosk:") => true, // pinned to a kiosk (might be us)
_ => true, // "auto" or missing → this kiosk subscribes
}
})
.cloned()
.collect();
if onvif_cams.is_empty() {
return;
}
// Signal old workers to stop.
let mut active = ACTIVE.lock().unwrap();
let new_map: HashMap = onvif_cams.iter().map(|c| (c.id.clone(), ())).collect();
*active = Some(new_map);
drop(active);
let generation = Arc::new(());
// Store in static — replaces old generation → old Arc drops → old
// threads' Weak::upgrade() returns None → they exit cleanly.
*GENERATION.lock().unwrap() = Some(generation.clone());
for cam in onvif_cams {
let server = server_url.to_string();
let key = kiosk_key.to_string();
let weak_gen = Arc::downgrade(&generation);
let password = match (&cam.onvif_password_encrypted, cluster_key) {
(Some(enc), Some(ck)) => decrypt_cluster(enc, ck),
_ => None,
};
std::thread::spawn(move || {
run_subscription(cam, password.as_deref(), &server, &key, weak_gen);
});
}
}
fn run_subscription(
cam: BundleCamera,
password: Option<&str>,
server: &str,
kiosk_key: &str,
generation: std::sync::Weak<()>,
) {
let host = cam.onvif_host.as_deref().unwrap_or("");
let port = cam.onvif_port.unwrap_or(80);
let user = cam.onvif_username.as_deref().unwrap_or("");
let pass = password.unwrap_or("");
let event_url = format!("http://{host}:{port}/onvif/event_service");
let has_pass = !pass.is_empty();
info!("onvif-events: cam {} ({}) subscribing at {event_url} user={user} has_pass={has_pass}", cam.id, cam.name);
loop {
if generation.upgrade().is_none() {
info!("onvif-events: cam {} generation expired, exiting", cam.id);
return;
}
// 1. CreatePullPointSubscription
set_status(&cam.id, "subscribing", None);
let sub = match create_pullpoint(&event_url, user, pass) {
Ok(s) => s,
Err(e) => {
warn!("onvif-events: cam {} CreatePullPoint failed: {e}", cam.id);
set_status(&cam.id, "failed", Some(e));
std::thread::sleep(Duration::from_secs(30));
continue;
}
};
info!("onvif-events: cam {} subscribed, address={}", cam.id, sub.address);
set_status(&cam.id, "active", None);
// 2. Poll loop
let poll_interval = Duration::from_secs(3);
let renew_interval = Duration::from_secs(55); // renew before 60s timeout
let mut since_renew = std::time::Instant::now();
loop {
if generation.upgrade().is_none() {
let _ = unsubscribe(&sub.address, user, pass);
return;
}
// Renew before timeout
if since_renew.elapsed() > renew_interval {
match renew(&sub.address, user, pass) {
Ok(()) => since_renew = std::time::Instant::now(),
Err(e) => {
warn!("onvif-events: cam {} renew failed: {e}, resubscribing", cam.id);
break; // outer loop will re-create
}
}
}
match pull_messages(&sub.address, user, pass) {
Ok(events) => {
for evt in events {
forward_event(server, kiosk_key, &cam.id, &evt, user, pass);
}
}
Err(e) => {
warn!("onvif-events: cam {} pull failed: {e}", cam.id);
set_status(&cam.id, "failed", Some(e));
std::thread::sleep(Duration::from_secs(15));
break; // resubscribe after backoff
}
}
std::thread::sleep(poll_interval);
}
}
}
// ---- SOAP helpers ----------------------------------------------------------
struct Subscription {
address: String,
}
fn wsse_header(user: &str, pass: &str) -> String {
use sha1::{Digest, Sha1};
use base64::Engine;
use rand::RngCore;
let mut nonce = [0u8; 16];
rand::thread_rng().fill_bytes(&mut nonce);
let created = chrono_now();
let mut hasher = Sha1::new();
hasher.update(&nonce);
hasher.update(created.as_bytes());
hasher.update(pass.as_bytes());
let digest = hasher.finalize();
let nonce_b64 = base64::engine::general_purpose::STANDARD.encode(nonce);
let digest_b64 = base64::engine::general_purpose::STANDARD.encode(digest);
format!(
r#"
{user}
{digest_b64}
{nonce_b64}
{created}
"#
)
}
fn soap_envelope(header_inner: &str, body_inner: &str) -> String {
format!(
r#"
{header_inner}
{body_inner}
"#
)
}
fn soap_post(url: &str, action: &str, body: &str) -> Result {
let client = reqwest::blocking::Client::new();
let resp = client
.post(url)
.header("Content-Type", "application/soap+xml; charset=utf-8")
.header("SOAPAction", action)
.body(body.to_string())
.timeout(Duration::from_secs(10))
.send()
.map_err(|e| format!("soap: {e}"))?;
if !resp.status().is_success() {
let status = resp.status();
let body = resp.text().unwrap_or_default();
let fault = extract_soap_fault(&body);
return Err(format!("soap HTTP {status}: {fault}"));
}
resp.text().map_err(|e| format!("soap body: {e}"))
}
/// Extract a human-readable fault reason from SOAP XML, stripping envelope noise.
fn extract_soap_fault(xml: &str) -> String {
// Try common SOAP fault tags
for tag in &["Reason", "Text", "faultstring", "Detail", "Subcode"] {
if let Some(val) = extract_tag_ns(xml, tag) {
let trimmed = val.trim();
if !trimmed.is_empty() {
return trimmed.to_string();
}
}
}
// Try Code/Value
if let Some(val) = extract_tag_ns(xml, "Value") {
let trimmed = val.trim();
if !trimmed.is_empty() {
return format!("Code: {trimmed}");
}
}
// Fallback: first 300 chars stripped of XML tags
let stripped: String = xml.replace(|c: char| c == '<', "\n<")
.lines()
.filter(|l| !l.trim_start().starts_with('<'))
.map(|l| l.trim())
.filter(|l| !l.is_empty())
.collect::>()
.join(" ");
if stripped.is_empty() {
xml.chars().take(300).collect()
} else {
stripped.chars().take(300).collect()
}
}
fn create_pullpoint(url: &str, user: &str, pass: &str) -> Result {
let header = wsse_header(user, pass);
let body = soap_envelope(
&header,
r#"
PT60S
"#,
);
let xml = soap_post(url, "http://www.onvif.org/ver10/events/wsdl/EventPortType/CreatePullPointSubscriptionRequest", &body)?;
// Camera may use namespaced Address: , ,
// , or plain . Try all.
let address = extract_tag_ns(&xml, "Address")
.filter(|a| !a.is_empty() && a.starts_with("http"))
.ok_or_else(|| {
// Log first 300 chars of response for debugging.
let preview: String = xml.chars().take(300).collect();
format!("no Address in CreatePullPoint response: {preview}")
})?;
Ok(Subscription { address })
}
/// Extract tag content, trying with and without namespace prefixes.
fn extract_tag_ns(xml: &str, tag: &str) -> Option {
// Try common namespace prefixes for ONVIF/WS-Addressing.
for prefix in &["", "wsa5:", "wsa:", "a:", "wsnt:", "tev:", "tt:"] {
let full = format!("{prefix}{tag}");
if let Some(val) = extract_tag(xml, &full) {
if !val.is_empty() { return Some(val); }
}
}
// Fallback: regex-style scan for any :Address> content.
let pattern = format!(":{tag}>");
if let Some(pos) = xml.find(&pattern) {
let after = &xml[pos + pattern.len()..];
if let Some(end) = after.find('<') {
let val = after[..end].trim();
if !val.is_empty() { return Some(val.to_string()); }
}
}
None
}
fn pull_messages(sub_url: &str, user: &str, pass: &str) -> Result, String> {
let header = wsse_header(user, pass);
let body = soap_envelope(
&header,
r#"
PT5S
100
"#,
);
let xml = soap_post(sub_url, "http://www.onvif.org/ver10/events/wsdl/PullPointSubscription/PullMessagesRequest", &body)?;
Ok(parse_notification_messages(&xml))
}
fn renew(sub_url: &str, user: &str, pass: &str) -> Result<(), String> {
let header = wsse_header(user, pass);
let body = soap_envelope(
&header,
r#"PT60S "#,
);
soap_post(sub_url, "http://docs.oasis-open.org/wsn/bw-2/SubscriptionManager/RenewRequest", &body)?;
Ok(())
}
fn unsubscribe(sub_url: &str, user: &str, pass: &str) -> Result<(), String> {
let header = wsse_header(user, pass);
let body = soap_envelope(&header, " ");
let _ = soap_post(sub_url, "http://docs.oasis-open.org/wsn/bw-2/SubscriptionManager/UnsubscribeRequest", &body);
Ok(())
}
// ---- Event parsing ---------------------------------------------------------
#[derive(Debug)]
struct OnvifEvent {
topic: String,
source: HashMap,
data: HashMap,
timestamp: Option,
}
fn parse_notification_messages(xml: &str) -> Vec {
let mut events = Vec::new();
// Split on NotificationMessage blocks
for block in xml.split(" Vec<(String, String)> {
let mut items = Vec::new();
for part in xml.split("SimpleItem") {
let name = extract_attr_inline(part, "Name");
let value = extract_attr_inline(part, "Value");
if let (Some(n), Some(v)) = (name, value) {
items.push((n, v));
}
}
items
}
// ---- Minimal XML helpers (no full parser dep) ------------------------------
fn extract_tag(xml: &str, tag: &str) -> Option {
// Handles both value and value
let patterns = [
format!("<{tag}>"),
format!("<{tag} "),
];
for pat in &patterns {
if let Some(start) = xml.find(pat.as_str()) {
let after = &xml[start + pat.len()..];
// If pattern ended with space, skip to >
let content_start = if pat.ends_with(' ') {
after.find('>')?.checked_add(1)?
} else {
0
};
let content = &after[content_start..];
let end_patterns = [format!("{tag}>"), format!(":{tag}>")];
for end_pat in &end_patterns {
if let Some(end) = content.find(end_pat.as_str()) {
// Walk back to find the < of the closing tag
let slice = &content[..end];
let result = if let Some(lt) = slice.rfind('<') {
&slice[..lt]
} else {
slice
};
return Some(result.trim().to_string());
}
}
}
}
// Try with namespace prefix
for part in xml.split('<') {
if let Some(rest) = part.strip_suffix('>').or_else(|| {
let idx = part.find('>')?;
Some(&part[..idx])
}) {
if rest.contains(':') && rest.ends_with(tag) || rest.split_whitespace().next()?.ends_with(&format!(":{tag}")) {
// Found opening tag with namespace
let after_close = &xml[xml.find(part)? + part.len()..];
if let Some(_end_idx) = after_close.find(&format!(":{tag}>")) {
let content = &after_close[after_close.find('>')? + 1..];
if let Some(close) = content.find('<') {
return Some(content[..close].trim().to_string());
}
}
}
}
}
None
}
fn extract_inner_text(xml: &str, tag: &str) -> Option {
let start = xml.find(&format!(":{tag}"))?;
let after = &xml[start..];
let gt = after.find('>')?;
let content = &after[gt + 1..];
let lt = content.find('<')?;
Some(content[..lt].trim().to_string())
}
fn extract_section(xml: &str, section: &str) -> Option {
let patterns = [
format!(""),
format!("{section}>"),
];
for end_pat in &end_patterns {
if let Some(end) = rest.find(end_pat.as_str()) {
return Some(rest[..end + end_pat.len()].to_string());
}
}
}
}
None
}
fn extract_attr_value(xml: &str, tag: &str, attr: &str) -> Option {
let tag_start = xml.find(tag)?;
let after = &xml[tag_start..];
let attr_pat = format!("{attr}=\"");
let attr_start = after.find(&attr_pat)?;
let val_start = attr_start + attr_pat.len();
let val_end = after[val_start..].find('"')?;
Some(after[val_start..val_start + val_end].to_string())
}
fn extract_attr_inline(xml: &str, attr: &str) -> Option {
let pat = format!("{attr}=\"");
let start = xml.find(&pat)?;
let val_start = start + pat.len();
let val_end = xml[val_start..].find('"')?;
Some(xml[val_start..val_start + val_end].to_string())
}
// ---- Forward to BF server --------------------------------------------------
fn forward_event(
server: &str,
kiosk_key: &str,
camera_id: &str,
evt: &OnvifEvent,
cam_user: &str,
cam_pass: &str,
) {
let attachments = fetch_image_attachments(&evt.data, cam_user, cam_pass);
let mut payload = serde_json::json!({
"source": evt.source,
"data": evt.data,
"timestamp": evt.timestamp,
});
if !attachments.is_empty() {
payload["attachments"] = serde_json::json!(attachments);
}
let body = serde_json::json!({
"topic": evt.topic,
"source_type": "onvif",
"camera_id": camera_id,
"property_op": "changed",
"payload": payload,
});
let _ = reqwest::blocking::Client::new()
.post(format!("{server}/api/kiosk/event"))
.header("Authorization", format!("Bearer {kiosk_key}"))
.json(&body)
.timeout(Duration::from_secs(10))
.send();
}
fn fetch_image_attachments(
data: &HashMap,
user: &str,
pass: &str,
) -> HashMap {
let mut attachments = HashMap::new();
let image_exts = [".jpg", ".jpeg", ".png", ".bmp"];
for (key, value) in data {
if !value.starts_with("http://") && !value.starts_with("https://") {
continue;
}
let lower = value.to_lowercase();
if !image_exts.iter().any(|ext| lower.contains(ext)) {
continue;
}
match fetch_image_b64(value, user, pass) {
Some(b64) => {
let mime = if lower.contains(".png") {
"image/png"
} else {
"image/jpeg"
};
attachments.insert(key.clone(), format!("data:{mime};base64,{b64}"));
}
None => {
warn!("onvif-events: failed to fetch image for {key}: {value}");
}
}
}
attachments
}
fn fetch_image_b64(url: &str, user: &str, pass: &str) -> Option {
use base64::Engine;
let client = reqwest::blocking::Client::new();
let resp = client
.get(url)
.basic_auth(user, Some(pass))
.timeout(Duration::from_secs(5))
.send()
.ok()?;
if !resp.status().is_success() {
let status = resp.status();
// Retry with digest auth if basic auth returned 401.
if status.as_u16() == 401 {
return fetch_image_b64_digest(url, user, pass);
}
warn!("onvif-events: image fetch HTTP {status} for {url}");
return None;
}
let bytes = resp.bytes().ok()?;
if bytes.is_empty() || bytes.len() > 10 * 1024 * 1024 {
return None;
}
Some(base64::engine::general_purpose::STANDARD.encode(&bytes))
}
fn fetch_image_b64_digest(url: &str, user: &str, pass: &str) -> Option {
use base64::Engine;
let client = reqwest::blocking::Client::builder()
.timeout(Duration::from_secs(5))
.build()
.ok()?;
let resp = client
.get(url)
.header("Authorization", digest_auth_header(url, user, pass)?)
.send()
.ok()?;
if !resp.status().is_success() {
return None;
}
let bytes = resp.bytes().ok()?;
if bytes.is_empty() || bytes.len() > 10 * 1024 * 1024 {
return None;
}
Some(base64::engine::general_purpose::STANDARD.encode(&bytes))
}
fn digest_auth_header(url: &str, user: &str, pass: &str) -> Option {
let client = reqwest::blocking::Client::new();
let resp = client.get(url).timeout(Duration::from_secs(3)).send().ok()?;
if resp.status().as_u16() != 401 {
return None;
}
let www_auth = resp.headers().get("www-authenticate")?.to_str().ok()?;
if !www_auth.to_lowercase().starts_with("digest ") {
return None;
}
let realm = extract_digest_field(www_auth, "realm")?;
let nonce = extract_digest_field(www_auth, "nonce")?;
let qop = extract_digest_field(www_auth, "qop").unwrap_or_default();
let uri = url::Url::parse(url).ok().map(|u| u.path().to_string()).unwrap_or_else(|| "/".to_string());
let ha1 = md5_hex(&format!("{user}:{realm}:{pass}"));
let ha2 = md5_hex(&format!("GET:{uri}"));
let cnonce = format!("{:08x}", rand::random::());
let nc = "00000001";
let response = if qop.contains("auth") {
md5_hex(&format!("{ha1}:{nonce}:{nc}:{cnonce}:auth:{ha2}"))
} else {
md5_hex(&format!("{ha1}:{nonce}:{ha2}"))
};
if qop.contains("auth") {
Some(format!(
r#"Digest username="{user}", realm="{realm}", nonce="{nonce}", uri="{uri}", response="{response}", qop=auth, nc={nc}, cnonce="{cnonce}""#
))
} else {
Some(format!(
r#"Digest username="{user}", realm="{realm}", nonce="{nonce}", uri="{uri}", response="{response}""#
))
}
}
fn extract_digest_field(header: &str, field: &str) -> Option {
let pat = format!("{field}=\"");
let start = header.find(&pat)? + pat.len();
let end = header[start..].find('"')?;
Some(header[start..start + end].to_string())
}
fn md5_hex(input: &str) -> String {
use md5::{Digest, Md5};
let mut hasher = Md5::new();
hasher.update(input.as_bytes());
let result = hasher.finalize();
hex_lower_bytes(&result)
}
fn hex_lower_bytes(bytes: &[u8]) -> String {
const HEX: &[u8; 16] = b"0123456789abcdef";
let mut s = String::with_capacity(bytes.len() * 2);
for b in bytes {
s.push(HEX[(b >> 4) as usize] as char);
s.push(HEX[(b & 0x0f) as usize] as char);
}
s
}
// ---- Cluster key decryption ------------------------------------------------
/// Decrypt a value encrypted with secrets.encryptForCluster on the server.
/// Format: "v1...". AES-256-GCM.
/// cluster_key is base64url-encoded 32-byte key.
pub fn decrypt_cluster_public(ciphertext: &str, key: &str) -> Option {
decrypt_cluster(ciphertext, key)
}
fn decrypt_cluster(ciphertext: &str, cluster_key_b64u: &str) -> Option {
use aes_gcm::{Aes256Gcm, Key, Nonce, aead::{Aead, KeyInit}};
use base64::Engine;
let b64u = base64::engine::general_purpose::URL_SAFE_NO_PAD;
let parts: Vec<&str> = ciphertext.split('.').collect();
if parts.len() != 4 || parts[0] != "v1" {
warn!("decrypt_cluster: bad format: {}", ciphertext.chars().take(20).collect::());
return None;
}
let iv = b64u.decode(parts[1]).ok()?;
let tag = b64u.decode(parts[2]).ok()?;
let ct = b64u.decode(parts[3]).ok()?;
let key_bytes = b64u.decode(cluster_key_b64u).ok()?;
if key_bytes.len() != 32 || iv.len() != 12 || tag.len() != 16 {
warn!("decrypt_cluster: bad lengths key={} iv={} tag={}", key_bytes.len(), iv.len(), tag.len());
return None;
}
let cipher = Aes256Gcm::new(Key::::from_slice(&key_bytes));
let nonce = Nonce::from_slice(&iv);
// AES-GCM ciphertext+tag concatenated for decryption.
let mut combined = ct;
combined.extend_from_slice(&tag);
match cipher.decrypt(nonce, combined.as_ref()) {
Ok(plaintext) => String::from_utf8(plaintext).ok(),
Err(e) => {
warn!("decrypt_cluster: decrypt failed: {e}");
None
}
}
}
fn chrono_now() -> String {
let secs = std::time::SystemTime::now()
.duration_since(std::time::UNIX_EPOCH)
.map(|d| d.as_secs())
.unwrap_or(0);
// ISO-8601 approximation without chrono crate.
let days = secs / 86400;
let remaining = secs % 86400;
let hours = remaining / 3600;
let minutes = (remaining % 3600) / 60;
let seconds = remaining % 60;
// Rough year/month/day — good enough for WSSE nonce timestamp.
// This is NOT used for display, only SOAP auth.
let (year, month, day) = epoch_days_to_ymd(days);
format!(
"{year:04}-{month:02}-{day:02}T{hours:02}:{minutes:02}:{seconds:02}Z"
)
}
fn epoch_days_to_ymd(days: u64) -> (u64, u64, u64) {
// Algorithm from http://howardhinnant.github.io/date_algorithms.html
let z = days + 719468;
let era = z / 146097;
let doe = z - era * 146097;
let yoe = (doe - doe / 1460 + doe / 36524 - doe / 146096) / 365;
let y = yoe + era * 400;
let doy = doe - (365 * yoe + yoe / 4 - yoe / 100);
let mp = (5 * doy + 2) / 153;
let d = doy - (153 * mp + 2) / 5 + 1;
let m = if mp < 10 { mp + 3 } else { mp - 9 };
let y = if m <= 2 { y + 1 } else { y };
(y, m, d)
}