Merge commit 'cfbf1f7'
Rust development slice / linux (push) Failing after 6s

This commit is contained in:
2026-11-15 01:59:35 +01:00
13 changed files with 1409 additions and 49 deletions
@@ -204,6 +204,10 @@ impl<V: Ed25519Verifier> HelperSync<V> {
self.lease = None;
self.capture = None;
}
/// Read-only bound of the existing confirmed lease; creates no readiness.
pub fn validity_deadline(&self) -> Option<DateTime<Utc>> {
self.lease.as_ref().map(|lease| lease.until)
}
pub fn active_generation(&self) -> Option<u64> {
self.lease.as_ref().map(|lease| lease.generation)
}
+1
View File
@@ -10,3 +10,4 @@ pub mod ledger;
pub mod reconcile;
pub mod update_handoff;
pub mod update_health_inventory;
pub mod update_health_sync;
+323
View File
@@ -0,0 +1,323 @@
//! Read-only original HelperSync evidence. Exact UTC bodies, not quantized
//! receipt scalars, bound the real local application time. Creates no lease.
use crate::{
auth::Binding,
helper_reconcile::{ExecutorLedgerGuard, SignedResponse},
reconcile::{Channel, verify_response},
update_handoff::{self, AppliedUpdateSync},
};
use anyhow::{Context, Result, ensure};
use chrono::{DateTime, Utc};
use prost::Message;
use rmm_domain::{
agent_update::{UpdateInflightProof, inflight_decision, verify_inflight_proof},
jobs::hash,
reconciliation::ReconcileDecisionPayload,
};
use rmm_protocol::{SyncRequest, SyncResponse};
use rmm_updater_handoff::{Handoff, HealthReceipt, Phase};
use rusqlite::Connection;
use uuid::Uuid;
/// No deserializer or external construction. Raw request/response hashes and
/// actual local application come from the SAME guarded existing helper ledger.
pub struct Round {
applied: AppliedUpdateSync,
request: SyncRequest,
decision: ReconcileDecisionPayload,
}
impl Round {
pub fn applied(&self) -> &AppliedUpdateSync {
&self.applied
}
pub fn decision(&self) -> &ReconcileDecisionPayload {
&self.decision
}
}
pub fn read_round(
db: &Connection,
guard: &impl ExecutorLedgerGuard,
binding: &Binding,
grant: Uuid,
id: Uuid,
) -> Result<Round> {
guard.check(db)?;
let (request_len, response_len): (usize, usize) = db.query_row(
"SELECT length(request),length(response) FROM helper_sync_decisions WHERE decision_id=?1",
[id.to_string()],
|r| Ok((r.get(0)?, r.get(1)?)),
)?;
ensure!(
request_len > 0
&& request_len <= rmm_domain::MAX_MESSAGE
&& response_len > 0
&& response_len <= 4 * rmm_domain::MAX_MESSAGE + 1024,
"UPDATE_HEALTH_STORED_SYNC_SIZE"
);
let applied = update_handoff::read_applied_sync(db, guard, grant, id)?;
let (raw, signed): (Vec<u8>, Vec<u8>) = db.query_row(
"SELECT request,response FROM helper_sync_decisions WHERE decision_id=?1",
[id.to_string()],
|r| Ok((r.get(0)?, r.get(1)?)),
)?;
let request = SyncRequest::decode(raw.as_slice())?;
let signed: SignedResponse = serde_json::from_slice(&signed)?;
let response = SyncResponse {
decision_bytes: signed.decision_bytes,
signature: signed.signature,
};
ensure!(
request.encode_to_vec() == raw
&& hash(&raw) == applied.request_sha256
&& hash(&response.encode_to_vec()) == applied.response_protobuf_sha256,
"UPDATE_HEALTH_STORED_SYNC_BYTES"
);
let unverified: ReconcileDecisionPayload = serde_json::from_slice(&response.decision_bytes)?;
// Historical verification only. Current clock/owner/boot/policy remain the
// calling Fullguard's independent prerequisites, never renewed by this read.
let decision = verify_response(
binding,
&request,
&Channel {
boot_id: unverified.boot_id,
connection_generation: unverified.connection_generation,
},
&response,
unverified.issued_at,
)?;
ensure!(
decision.decision_id == id && serde_json::to_vec(&decision)? == response.decision_bytes,
"UPDATE_HEALTH_ORIGINAL_SYNC_CODEC"
);
guard.check(db)?;
Ok(Round {
applied,
request,
decision,
})
}
pub struct VerifiedSpan {
applied: AppliedUpdateSync,
lower: DateTime<Utc>,
upper: DateTime<Utc>,
}
impl VerifiedSpan {
pub fn applied(&self) -> &AppliedUpdateSync {
&self.applied
}
pub fn lower(&self) -> DateTime<Utc> {
self.lower
}
pub fn upper(&self) -> DateTime<Utc> {
self.upper
}
}
pub fn verified_span(
db: &Connection,
guard: &impl ExecutorLedgerGuard,
binding: &Binding,
header: &Handoff,
receipt: &HealthReceipt,
health_key: [u8; 32],
) -> Result<VerifiedSpan> {
guard.check(db)?;
let applied = read_round(
db,
guard,
binding,
header.attempt.grant_id,
receipt.signed_sync_decision_id,
)?;
ensure!(
applied.applied.request_sha256 == receipt.signed_sync_request_sha256
&& applied.applied.response_protobuf_sha256 == receipt.signed_sync_response_sha256
&& receipt.inventory_ack_sha256 == applied.applied.response_protobuf_sha256
&& applied
.decision
.acknowledged_message_ids
.contains(&receipt.inventory_message_id),
"UPDATE_HEALTH_ORIGINAL_APPLIED_OR_ACK"
);
let prefix = services_prefix(&applied, header, receipt, health_key)?;
let original_prefix = UpdateInflightProof::from_bytes(&prefix).map_err(anyhow::Error::msg)?;
let current = update_handoff::current_proof(db, guard, header.attempt.grant_id)?
.context("UPDATE_HEALTH_ORIGINAL_CURRENT_PREFIX_MISSING")?;
ensure!(
original_prefix.delegation == current.delegation
&& original_prefix.events.len() <= current.events.len()
&& current.events[..original_prefix.events.len()] == original_prefix.events,
"UPDATE_HEALTH_ORIGINAL_PREFIX_NOT_RETAINED"
);
let invalid:usize=db.query_row("SELECT count(*) FROM agent_update_sync_applied WHERE grant_id=?1 AND length(decision_id)<>36",[header.attempt.grant_id.to_string()],|r|r.get(0))?;
ensure!(invalid == 0, "UPDATE_HEALTH_ORIGINAL_SYNC_ID_SIZE");
let mut query=db.prepare("SELECT decision_id FROM agent_update_sync_applied WHERE grant_id=?1 ORDER BY decision_id LIMIT 1025")?;
let ids = query
.query_map([header.attempt.grant_id.to_string()], |r| {
r.get::<_, String>(0)
})?
.collect::<rusqlite::Result<Vec<_>>>()?;
ensure!(ids.len() <= 1024, "UPDATE_HEALTH_ORIGINAL_SYNC_LIMIT");
let mut confirming = None;
for id in ids {
let id: Uuid = id.parse()?;
if id == receipt.signed_sync_decision_id {
continue;
}
let (len,): (usize,) = db.query_row(
"SELECT length(request) FROM helper_sync_decisions WHERE decision_id=?1",
[id.to_string()],
|r| Ok((r.get(0)?,)),
)?;
ensure!(
len > 0 && len <= rmm_domain::MAX_MESSAGE,
"UPDATE_HEALTH_CONFIRMING_SIZE"
);
let raw: Vec<u8> = db.query_row(
"SELECT request FROM helper_sync_decisions WHERE decision_id=?1",
[id.to_string()],
|r| r.get(0),
)?;
let request = SyncRequest::decode(raw.as_slice())?;
if request.previous_decision_id != receipt.signed_sync_decision_id.to_string()
|| request.helper_previous_decision_id != receipt.signed_sync_decision_id.to_string()
{
continue;
}
// Hash/signature/application checks are mandatory AFTER this cheap
// candidate selection too. Caller request fields never prove an apply.
let round = read_round(db, guard, binding, header.attempt.grant_id, id)?;
ensure!(
services_prefix(&round, header, receipt, health_key)? == prefix && confirming.is_none(),
"UPDATE_HEALTH_CONFIRMING_PREFIX_OR_FORK"
);
confirming = Some(round);
}
let confirming = confirming.context("UPDATE_HEALTH_ACTUAL_CONFIRMING_ROUND_MISSING")?;
require_exact_span(
applied.decision.issued_at,
applied.applied.applied_at,
confirming.decision.issued_at,
receipt.signed_sync_applied_at,
)?;
ensure!(
applied.applied.applied_at < applied.decision.valid_until,
"UPDATE_HEALTH_ACTUAL_APPLY_EXPIRED"
);
guard.check(db)?;
Ok(VerifiedSpan {
applied: applied.applied,
lower: applied.decision.issued_at,
upper: confirming.decision.issued_at,
})
}
fn services_prefix(
round: &Round,
header: &Handoff,
receipt: &HealthReceipt,
key: [u8; 32],
) -> Result<Vec<u8>> {
let request = &round.request;
let decision = &round.decision;
ensure!(
!decision.ready
&& !decision.helper_ready
&& request.journal_complete
&& decision.connection_generation == receipt.connection_generation
&& decision.boot_id == header.boot_id
&& request.journal_id == header.agent_journal_id.to_string()
&& request.helper_journal_id == header.helper_journal_id.to_string(),
"UPDATE_HEALTH_CONFIRMING_CHANNEL"
);
let mut local = request.attempts.iter().filter(|a| {
a.job_id == header.attempt.job_id.to_string()
&& a.attempt_id == header.attempt.attempt_id.to_string()
});
let local = local
.next()
.context("UPDATE_HEALTH_ORIGINAL_ATTEMPT_MISSING")?
.clone();
ensure!(
request
.attempts
.iter()
.filter(|a| a.job_id == header.attempt.job_id.to_string()
&& a.attempt_id == header.attempt.attempt_id.to_string())
.count()
== 1,
"UPDATE_HEALTH_ORIGINAL_ATTEMPT_DUPLICATE"
);
let proof =
UpdateInflightProof::from_bytes(&local.update_handoff_bytes).map_err(anyhow::Error::msg)?;
let (observed, journal) = verify_inflight_proof(&proof, key).map_err(anyhow::Error::msg)?;
ensure!(
observed.bytes()? == header.bytes()?
&& journal.phase() == Phase::ServicesStarted
&& local.grant_id == header.attempt.grant_id.to_string()
&& local.consumption == "consumed"
&& local.state == "running"
&& local.job_payload_hash == header.attempt.job_payload_sha256
&& local.original_boot_id == header.boot_id.to_string()
&& local.outcome_bytes.is_empty()
&& local.outcome_sha256.is_empty()
&& local.result.is_none()
&& local.result_envelope.is_none(),
"UPDATE_HEALTH_ORIGINAL_INFLIGHT"
);
let signed = decision
.attempts
.iter()
.filter(|a| a.job_id == header.attempt.job_id && a.attempt_id == header.attempt.attempt_id)
.collect::<Vec<_>>();
ensure!(signed.len() == 1, "UPDATE_HEALTH_SIGNED_ATTEMPT");
let signed = signed[0];
ensure!(
signed.update_inflight.as_ref()
== Some(&inflight_decision(&proof, key).map_err(anyhow::Error::msg)?)
&& signed.grant_id == Some(header.attempt.grant_id)
&& signed.authorization_id == Some(header.attempt.authorization_id)
&& signed.plan_hash.as_deref() == Some(header.attempt.plan_sha256.as_str())
&& signed.job_payload_hash == header.attempt.job_payload_sha256
&& signed.action == "update_agent"
&& signed.execution_identity == "root"
&& signed.outcome_state == "running"
&& !signed.unlock
&& signed.outcome_bytes.is_empty()
&& signed.outcome_sha256.is_none(),
"UPDATE_HEALTH_SIGNED_ORIGINAL_INFLIGHT"
);
Ok(local.update_handoff_bytes)
}
fn require_exact_span(
lower: DateTime<Utc>,
actual: DateTime<Utc>,
upper: DateTime<Utc>,
wire_floor: u64,
) -> Result<()> {
ensure!(
lower <= actual && actual <= upper && wire_floor == u64::try_from(upper.timestamp())?,
"UPDATE_HEALTH_EXACT_ACTUAL_APPLY_SPAN"
);
Ok(())
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn same_floor_does_not_admit_a_one_nanosecond_early_or_late_apply() {
let base = DateTime::from_timestamp(1000, 0).unwrap();
let lower = base + chrono::Duration::nanoseconds(100_000_001);
let upper = base + chrono::Duration::nanoseconds(200_000_001);
assert_eq!(lower.timestamp(), upper.timestamp());
require_exact_span(lower, lower, upper, 1000).unwrap();
require_exact_span(lower, upper, upper, 1000).unwrap();
assert!(
require_exact_span(lower, lower - chrono::Duration::nanoseconds(1), upper, 1000)
.is_err()
);
assert!(
require_exact_span(lower, upper + chrono::Duration::nanoseconds(1), upper, 1000)
.is_err()
);
assert!(require_exact_span(lower, lower, upper, 1001).is_err());
}
}
@@ -984,11 +984,13 @@ fn clean_ready_shared_lock_and_reopen_start_closed() {
let mut f = Fixture::new();
let mut sync = f.sync();
assert!(!sync.can_start(&f.db, &f.guard, 1, &f.clock, &f.boot));
assert_eq!(sync.validity_deadline(), None);
let snapshot = f.snapshot(&mut sync, 1);
let raw = f.request(&snapshot);
let d = f.decision(&snapshot, &raw, 1, true);
let applied = f.apply(&mut sync, &d, &raw).unwrap();
assert!(applied.ready);
assert_eq!(sync.validity_deadline(), Some(d.valid_until));
assert_eq!(sync.active_generation(), Some(1));
assert_eq!(applied.snapshot.previous_decision_id, Some(d.decision_id));
assert!(applied.unlocked_grants.is_empty());
@@ -1004,6 +1006,7 @@ fn clean_ready_shared_lock_and_reopen_start_closed() {
.is_err()
);
sync.close();
assert_eq!(sync.validity_deadline(), None);
assert!(!sync.can_start(&f.db, &f.guard, 1, &f.clock, &f.boot));
}
#[test]
@@ -1784,6 +1787,17 @@ fn update_inflight_negative_control_keeps_every_start_closed_and_owner_loss_is_t
decision.decision_id,
)
.unwrap();
let retained_round = rmm_agent_core::update_health_sync::read_round(
&f.db,
&guard,
&f.binding,
handoff.attempt.grant_id,
decision.decision_id,
)
.unwrap();
assert_eq!(retained_round.applied(), &local_apply);
assert_eq!(retained_round.decision().issued_at, decision.issued_at);
assert_eq!(retained_round.decision().valid_until, decision.valid_until);
assert_eq!(local_apply.applied_at, f.clock.now);
assert_eq!(local_apply.request_sha256, hash(&raw));
let proto = rmm_protocol::SyncResponse {
+6 -29
View File
@@ -335,38 +335,15 @@ impl<'a> FullUpdateGuard<'a> {
"UPDATE_HEALTH_CURRENT_LOCAL_CHANNEL_REQUIRED"
);
self.verify_current_services(&receipt.service_processes)?;
let applied = update_handoff::read_applied_sync(
let span = rmm_agent_core::update_health_sync::verified_span(
db,
self.executor,
self.original.permit().grant_id,
receipt.signed_sync_decision_id,
self.binding,
self.original.handoff(),
&receipt,
self.trust.health_public_key(),
)?;
ensure!(
applied.request_sha256 == receipt.signed_sync_request_sha256
&& applied.response_protobuf_sha256 == receipt.signed_sync_response_sha256
&& receipt.inventory_ack_sha256 == applied.response_protobuf_sha256,
"UPDATE_LOCAL_APPLIED_RAW_BINDING"
);
let response_raw: Vec<u8> = db.query_row(
"SELECT response FROM helper_sync_decisions WHERE decision_id=?1",
[receipt.signed_sync_decision_id.to_string()],
|r| r.get(0),
)?;
let response: rmm_agent_core::helper_reconcile::SignedResponse =
serde_json::from_slice(&response_raw)?;
let decision: rmm_domain::reconciliation::ReconcileDecisionPayload =
serde_json::from_slice(&response.decision_bytes)?;
let applied_seconds = u64::try_from(applied.applied_at.timestamp())?;
ensure!(
applied_seconds >= u64::try_from(decision.issued_at.timestamp())?
&& applied_seconds <= receipt.signed_sync_applied_at
&& !decision.ready
&& !decision.helper_ready
&& decision
.acknowledged_message_ids
.contains(&receipt.inventory_message_id),
"UPDATE_ACTUAL_LOCAL_APPLY_OR_INVENTORY_ACK"
);
let applied = span.applied().clone();
verify_local_inventory(&self.witnesses, &self.original, &receipt)?;
Ok(VerifiedHealth {
signed_sha256: hash(&serde_json::to_vec(signed)?),
+210
View File
@@ -0,0 +1,210 @@
//! Existing Agent singleton fence. No create, ACL change or Root-ledger alias.
//! The agent holds this exact lock before opening BOTH of its SQLite files.
use crate::retained::{RetainedSet, Retention};
use anyhow::{Context, Result, ensure};
use rmm_updater_linux::{
Budget,
files::{Directory, Identity},
services::StoppedServices,
};
use std::{
fs::{File, OpenOptions},
os::{
fd::AsRawFd,
unix::fs::{MetadataExt, OpenOptionsExt},
},
path::Path,
};
const PARENT: &str = "/var/lib/rmm-agent-remote";
const PATH: &str = "/var/lib/rmm-agent-remote/agent.lock";
pub struct BoundAgentLock {
directory: Directory,
file: File,
expected: Identity,
}
impl BoundAgentLock {
/// Open/bind before any stop, so a missing preservation witness cannot be
/// discovered only after stopping the Agent. Reading never takes its lock.
pub fn bind(retained: &RetainedSet) -> Result<Self> {
retained.verify()?;
let specs = retained.specs();
let spec = specs
.iter()
.find(|s| s.path == Path::new(PATH))
.context("UPDATE_AGENT_LOCK_WITNESS_REQUIRED")?;
ensure!(
spec.retention == Retention::ImmutableMetadata
&& spec.parent_uid == 993
&& spec.identity.uid == 993
&& spec.identity.gid == 984
&& spec.identity.mode & 0o7777 == 0o600
&& spec.identity.links == 1,
"UPDATE_AGENT_LOCK_PROVISIONING"
);
let directory = Directory::open(Path::new(PARENT), 993, true)?;
let file = OpenOptions::new()
.read(true)
.write(true)
.custom_flags(libc::O_NOFOLLOW | libc::O_NONBLOCK | libc::O_CLOEXEC)
.open(PATH)?;
let result = Self {
directory,
file,
expected: spec.identity.clone(),
};
result.verify()?;
Ok(result)
}
fn verify(&self) -> Result<()> {
self.directory.verify()?;
let held = self.file.metadata()?;
let named = std::fs::symlink_metadata(PATH)?;
ensure!(
held.is_file()
&& held.len() == 0
&& named.is_file()
&& !named.file_type().is_symlink()
&& identity(&held) == self.expected
&& identity(&named) == self.expected,
"UPDATE_AGENT_LOCK_IDENTITY_CHANGED"
);
Ok(())
}
pub fn identity(&self) -> &Identity {
&self.expected
}
/// Real, fresh stopped-service proof precedes the existing nonblocking
/// singleton acquisition. A running/restarted Agent makes this fail closed.
pub fn acquire(self, stopped: &StoppedServices, budget: &Budget) -> Result<HeldAgentLock> {
stopped.verify_still_stopped(budget)?;
let result = self.acquire_existing()?;
stopped.verify_still_stopped(budget)?;
Ok(result)
}
fn acquire_existing(self) -> Result<HeldAgentLock> {
self.verify()?;
ensure!(
unsafe { libc::flock(self.file.as_raw_fd(), libc::LOCK_EX | libc::LOCK_NB) } == 0,
"UPDATE_AGENT_STARTUP_BUSY"
);
let result = HeldAgentLock { bound: self };
result.verify()?;
Ok(result)
}
}
pub struct HeldAgentLock {
bound: BoundAgentLock,
}
impl HeldAgentLock {
pub fn verify(&self) -> Result<()> {
self.bound.verify()
}
pub fn identity(&self) -> &Identity {
self.bound.identity()
}
/// Only the live Engine calls this after SQLite close and actual original
/// Root flock return, before the explicit once-only service start sequence.
pub(crate) fn return_after_root_release(self, budget: &Budget) -> Result<()> {
budget.check()?;
self.verify()?;
ensure!(
unsafe { libc::flock(self.bound.file.as_raw_fd(), libc::LOCK_UN) } == 0,
"UPDATE_AGENT_STARTUP_RETURN_FAILED"
);
Ok(())
}
}
impl Drop for HeldAgentLock {
fn drop(&mut self) {
unsafe {
libc::flock(self.bound.file.as_raw_fd(), libc::LOCK_UN);
}
}
}
fn identity(meta: &std::fs::Metadata) -> Identity {
Identity {
device: meta.dev(),
inode: meta.ino(),
uid: meta.uid(),
gid: meta.gid(),
mode: meta.mode(),
links: meta.nlink(),
}
}
#[cfg(test)]
mod tests {
use super::*;
use crate::retained::RetainedFileSpec;
use std::os::unix::fs::PermissionsExt;
struct Cleanup;
impl Drop for Cleanup {
fn drop(&mut self) {
std::fs::remove_dir_all(PARENT).unwrap();
}
}
#[test]
fn existing_agent_lock_blocks_aliases_and_rejects_samebyte_inode_substitution() {
// Private network-none/root container fixture ONLY; no host path/test.
assert_eq!(unsafe { libc::geteuid() }, 0);
assert!(!Path::new(PARENT).exists());
std::fs::create_dir_all(PARENT).unwrap();
let _cleanup = Cleanup;
std::fs::set_permissions(PARENT, std::fs::Permissions::from_mode(0o700)).unwrap();
let file = OpenOptions::new()
.create_new(true)
.read(true)
.write(true)
.mode(0o600)
.open(PATH)
.unwrap();
for path in [PARENT, PATH] {
let path = std::ffi::CString::new(path).unwrap();
assert_eq!(unsafe { libc::chown(path.as_ptr(), 993, 984) }, 0);
}
let retained = RetainedSet::capture(vec![RetainedFileSpec {
path: Path::new(PATH).to_owned(),
parent_uid: 993,
identity: identity(&file.metadata().unwrap()),
retention: Retention::ImmutableMetadata,
}])
.unwrap();
let bound = BoundAgentLock::bind(&retained).unwrap();
// The existing Agent's separately opened descriptor owns the lock.
assert_eq!(
unsafe { libc::flock(file.as_raw_fd(), libc::LOCK_EX | libc::LOCK_NB) },
0
);
assert!(bound.acquire_existing().is_err());
assert_eq!(unsafe { libc::flock(file.as_raw_fd(), libc::LOCK_UN) }, 0);
let held = BoundAgentLock::bind(&retained)
.unwrap()
.acquire_existing()
.unwrap();
assert_ne!(
unsafe { libc::flock(file.as_raw_fd(), libc::LOCK_EX | libc::LOCK_NB) },
0
);
held.verify().unwrap();
std::fs::rename(PATH, Path::new(PARENT).join("agent.lock.previous")).unwrap();
let replacement = OpenOptions::new()
.create_new(true)
.read(true)
.write(true)
.mode(0o600)
.open(PATH)
.unwrap();
let path = std::ffi::CString::new(PATH).unwrap();
assert_eq!(unsafe { libc::chown(path.as_ptr(), 993, 984) }, 0);
assert_eq!(replacement.metadata().unwrap().len(), 0);
assert!(held.verify().is_err());
assert!(BoundAgentLock::bind(&retained).is_err());
drop(held);
assert_eq!(
unsafe { libc::flock(file.as_raw_fd(), libc::LOCK_EX | libc::LOCK_NB) },
0
);
}
}
+71 -20
View File
@@ -53,7 +53,7 @@ pub struct BridgeContext<'a> {
}
pub struct FullBridge<'a> {
context: BridgeContext<'a>,
prefix: UpdateInflightProof,
prefix: Option<UpdateInflightProof>,
poisoned: bool,
finalized: bool,
}
@@ -76,7 +76,27 @@ impl<'a> FullBridge<'a> {
);
Ok(Self {
context,
prefix,
prefix: Some(prefix),
poisoned: false,
finalized: false,
})
}
/// First read obtains the actual original prefix from the authenticated
/// Full process/ledger. No event is synthesized from a caller's header.
pub fn original(context: BridgeContext<'a>) -> Result<Self> {
ensure!(
context.generation == Generation::Original,
"UPDATE_BRIDGE_ORIGINAL_ONLY"
);
context.handoff.validate()?;
ensure!(
context.delegation.handoff_sha256 == rmm_domain::jobs::hash(&context.handoff.bytes()?)
&& context.delegation.owner_nonce == context.handoff.owner_nonce,
"UPDATE_BRIDGE_ORIGINAL_HEADER"
);
Ok(Self {
context,
prefix: None,
poisoned: false,
finalized: false,
})
@@ -87,8 +107,21 @@ impl<'a> FullBridge<'a> {
.updater
.verify_delegation(context.delegation, context.budget)?;
context.budget.check()?;
let (_, journal) = verify_inflight_proof(&self.prefix, context.health_public_key)
.map_err(anyhow::Error::msg)?;
if self.prefix.is_none() {
ensure!(
matches!(method, NativeControlOperation::ReadOriginal),
"UPDATE_BRIDGE_ORIGINAL_READ_REQUIRED"
);
}
let journal = self
.prefix
.as_ref()
.map(|prefix| {
verify_inflight_proof(prefix, context.health_public_key)
.map(|(_, journal)| journal)
.map_err(anyhow::Error::msg)
})
.transpose()?;
match &method {
NativeControlOperation::ReadOriginal => {}
NativeControlOperation::ClaimStop {
@@ -96,31 +129,43 @@ impl<'a> FullBridge<'a> {
..
} => ensure!(
context.generation == Generation::Original
&& journal.phase() == Phase::StopIntent
&& *expected_head_sha256 == self.prefix.head_sha256,
&& journal
.as_ref()
.is_some_and(|j| j.phase() == Phase::StopIntent)
&& Some(expected_head_sha256.as_str())
== self.prefix.as_ref().map(|p| p.head_sha256.as_str()),
"UPDATE_BRIDGE_CLAIM_PHASE"
),
NativeControlOperation::ObserveStarts { .. } => ensure!(
context.generation == Generation::Replacement
&& journal.phase() == Phase::LedgerReturnIntent,
&& journal
.as_ref()
.is_some_and(|j| j.phase() == Phase::LedgerReturnIntent),
"UPDATE_BRIDGE_START_PHASE"
),
NativeControlOperation::Health { receipt } => {
ensure!(
context.generation == Generation::Replacement
&& journal.phase() == Phase::ServicesStarted,
&& journal
.as_ref()
.is_some_and(|j| j.phase() == Phase::ServicesStarted),
"UPDATE_BRIDGE_HEALTH_PHASE"
);
journal.prepare(
u64::try_from(context.clock.now()?.timestamp())?,
rmm_updater_handoff::Evidence::HealthVerified {
receipt: receipt.clone(),
},
)?;
journal
.as_ref()
.context("UPDATE_BRIDGE_ORIGINAL_READ_REQUIRED")?
.prepare(
u64::try_from(context.clock.now()?.timestamp())?,
rmm_updater_handoff::Evidence::HealthVerified {
receipt: receipt.clone(),
},
)?;
}
NativeControlOperation::Finalize => ensure!(
context.generation == Generation::Replacement
&& journal.phase() == Phase::HealthVerified,
&& journal
.as_ref()
.is_some_and(|j| j.phase() == Phase::HealthVerified),
"UPDATE_BRIDGE_FINAL_PHASE"
),
}
@@ -270,8 +315,11 @@ impl<'a> FullBridge<'a> {
ensure!(
handoff.bytes()? == context.handoff.bytes()?
&& proof.delegation == *context.delegation
&& proof.events.len() >= self.prefix.events.len()
&& proof.events[..self.prefix.events.len()] == self.prefix.events,
&& self
.prefix
.as_ref()
.is_none_or(|prior| proof.events.len() >= prior.events.len()
&& proof.events[..prior.events.len()] == prior.events),
"UPDATE_BRIDGE_PROOF_ROLLBACK_OR_CHANGED"
);
match request.method {
@@ -315,7 +363,7 @@ impl<'a> FullBridge<'a> {
),
NativeControlOperation::Finalize => unreachable!(),
}
self.prefix = proof.clone();
self.prefix = Some(proof.clone());
}
context.budget.check()?;
if matches!(request.method, NativeControlOperation::Finalize) {
@@ -331,8 +379,11 @@ impl<'a> FullBridge<'a> {
original_outcome,
})
}
pub fn head_sha256(&self) -> &str {
&self.prefix.head_sha256
pub fn head_sha256(&self) -> Result<&str> {
self.prefix
.as_ref()
.map(|p| p.head_sha256.as_str())
.context("UPDATE_BRIDGE_ORIGINAL_READ_REQUIRED")
}
pub fn observe_starts(
&mut self,
+605
View File
@@ -0,0 +1,605 @@
//! One live original-attempt pass. Activation queues only; the fixed listener
//! must finish its reply before this runtime can stop the calling Fullhelper.
//! No daemon entrypoint, admission/capability registration or restart recovery.
use crate::{
agent_startup::BoundAgentLock,
bridge::{BridgeContext, FullBridge, Generation},
bundle,
clock::NativeClock,
fence::LedgerFence,
ledger::{OwnedInputs, OwnedLedger},
original::Original,
participants::{StableParticipant, verify_original_helper},
retained::RetainedSet,
returned,
trust::TrustState,
};
use anyhow::{Context, Result, ensure};
use rmm_agent_core::{
auth::Binding,
reconcile::SyncClock,
update_handoff::{NativeControlOperation, NativeEffect, NativeEffectClaim, NativeService},
};
use rmm_domain::{
agent_update::{ParticipantIdentity, ParticipantRole, UpdateInflightProof},
agent_update_provisioning::{HealthKeyPin, InstalledReleaseRecord, LocalUpdatePolicy},
jobs::hash,
};
use rmm_updater_handoff::{Evidence, Phase, Process};
use rmm_updater_linux::{
Budget, DurableEffectFence, Effect,
files::{Directory, HeldFile, LedgerGuard, Role},
ipc::{self, Request, Response, State},
services::{Service, ServicePolicy, ServiceProof, Systemd},
};
use std::{ffi::OsStr, path::Path, time::Duration};
use uuid::Uuid;
struct Protected {
directory: Directory,
file: HeldFile,
name: String,
max: u64,
}
impl Protected {
fn read(path: &str, max: u64) -> Result<(Self, Vec<u8>)> {
let path = Path::new(path);
let directory = Directory::open(path.parent().context("UPDATE_ENGINE_PARENT")?, 0, false)?;
let name = path
.file_name()
.context("UPDATE_ENGINE_NAME")?
.to_str()
.context("UPDATE_ENGINE_NAME")?
.to_owned();
let mut file = directory.inspect(OsStr::new(&name), 0, max)?;
let raw = file.bytes(max)?;
Ok((
Self {
directory,
file,
name,
max,
},
raw,
))
}
fn verify(&self) -> Result<()> {
self.directory
.file(OsStr::new(&self.name), self.file.proof(), self.max)?;
Ok(())
}
}
/// Construct only in the separately provisioned stable service, with the
/// independently protected original job Binding. It offers no approval API.
pub struct Runtime {
binding: Binding,
policy: LocalUpdatePolicy,
policy_sha256: String,
installed: InstalledReleaseRecord,
installed_sha256: String,
health_key: [u8; 32],
health_pin_sha256: String,
protected: Vec<Protected>,
old_policies: Vec<ServicePolicy>,
updater: StableParticipant,
clock: NativeClock,
queued: Option<Queued>,
accepted: bool,
failed: bool,
terminal: bool,
head: Option<String>,
}
struct Queued {
agent_startup: BoundAgentLock,
original: Original,
witnesses: bundle::Loaded,
trust: TrustState,
budget: Budget,
proof: UpdateInflightProof,
}
impl Runtime {
pub fn new(binding: Binding) -> Result<Self> {
let clock = NativeClock::new()?;
let budget = observation_budget()?;
let (policy_file, raw) = Protected::read("/etc/rmm-agent-updater/policy.json", 65536)?;
let (policy, policy_sha256) =
LocalUpdatePolicy::from_bytes(&raw).map_err(anyhow::Error::msg)?;
ensure!(
policy.tenant_id == binding.tenant_id
&& policy.asset_id == binding.asset_id
&& policy.agent_id == binding.agent_id
&& policy.enrollment_generation == binding.enrollment_generation
&& policy.assignment_version == binding.assignment_version,
"UPDATE_ENGINE_LOCAL_IDENTITY"
);
let (record_file, raw) = Protected::read(&policy.installed_record_path, 32768)?;
let installed = InstalledReleaseRecord::from_bytes(&raw).map_err(anyhow::Error::msg)?;
let installed_sha256 = hash(&raw);
let old_policies = service_policies(&policy, &installed, None)?;
let (health_file, raw) = Protected::read(&policy.health_pin_path, 4096)?;
let health: HealthKeyPin = serde_json::from_slice(&raw)?;
let health_key = health.public_key().map_err(anyhow::Error::msg)?;
let updater = StableParticipant::observe(
ServicePolicy {
service: Service::Updater,
image_sha256: policy.updater_binary_sha256.clone(),
unit_sha256: policy.updater_service.unit_sha256.clone(),
},
&budget,
)?;
Ok(Self {
binding,
policy,
policy_sha256,
installed,
installed_sha256,
health_key,
health_pin_sha256: hash(&raw),
protected: vec![policy_file, record_file, health_file],
old_policies,
updater,
clock,
queued: None,
accepted: false,
failed: false,
terminal: false,
head: None,
})
}
/// A lost activation reply disables this live runtime before any stop.
/// Drive is deliberately private: it cannot run inside Engine::handle.
pub fn serve_one(&mut self, listener: &ipc::Listener) -> Result<()> {
self.require_reader_registry_and_census()?;
ensure!(!self.failed && !self.terminal, "UPDATE_ENGINE_CLOSED");
let services = Systemd::new(self.old_policies.clone())?;
let budget = observation_budget()?;
if let Err(error) = listener.serve_one(&services, &budget, self) {
if self.queued.take().is_some() {
self.failed = true;
}
return Err(error);
}
if let Some(queued) = self.queued.take() {
// serve_one has written/flushed the bounded reply and dropped its
// accepted stream. Only now may the original Full process stop.
match self.drive(queued) {
Ok(()) => self.terminal = true,
Err(error) => {
self.failed = true;
return Err(error);
}
}
}
Ok(())
}
fn require_reader_registry_and_census(&self) -> Result<()> {
// This is an explicit source-checkpoint barrier, not a caller boolean
// or a known-unit-list substitute. Replace only with the real protected
// bootstrap registry + complete live FD/maps census and both locks.
anyhow::bail!("UPDATE_READER_CENSUS_NOT_CONFIGURED")
}
fn enqueue(
&mut self,
peer: &ParticipantIdentity,
grant: Uuid,
nonce: Uuid,
handoff_sha: &str,
) -> Result<()> {
ensure!(
!self.accepted && self.queued.is_none() && !self.failed && !self.terminal,
"UPDATE_ENGINE_NO_RETRY_OR_RESUME"
);
// Fuse before any fallible original admission. Even an uncertain reply
// cannot dispatch this handoff for a second time in this process.
self.accepted = true;
for file in &self.protected {
file.verify()?;
}
let header = bundle::read_header(grant, nonce, handoff_sha)?;
ensure!(
peer.role == ParticipantRole::LinuxFullHelper
&& *peer == header.delegation.original_helper
&& header.handoff.updater_sha256 == self.policy.updater_binary_sha256
&& header.handoff.updater_policy_sha256 == self.policy_sha256
&& header.handoff.predecessor_record_sha256 == self.installed_sha256,
"UPDATE_ENGINE_ORIGINAL_PARTICIPANTS_OR_POLICY"
);
let finish =
chrono::DateTime::from_timestamp(i64::try_from(header.handoff.finish_before)?, 0)
.context("UPDATE_ENGINE_FINISH")?;
let budget = Budget::new(
header.handoff.boot_id,
(finish - self.clock.now()?).to_std()?,
)?;
let services = Systemd::new(self.old_policies.clone())?;
verify_original_helper(&services, &header.delegation, &budget)?;
self.updater
.verify_delegation(&header.delegation, &budget)?;
let mut bridge = FullBridge::original(BridgeContext {
handoff: &header.handoff,
delegation: &header.delegation,
services: &services,
updater: &self.updater,
clock: &self.clock,
budget: &budget,
health_public_key: self.health_key,
generation: Generation::Original,
})?;
let reply = bridge.call(NativeControlOperation::ReadOriginal)?;
let proof = reply.proof.context("UPDATE_ENGINE_ORIGINAL_PROOF")?;
let original = Original::verify(
&self.binding,
&reply
.original_start
.context("UPDATE_ENGINE_ORIGINAL_START")?,
&header.handoff.bytes()?,
header.delegation,
&self.clock,
&budget,
)?;
let (_, journal) = rmm_domain::agent_update::verify_inflight_proof(&proof, self.health_key)
.map_err(anyhow::Error::msg)?;
ensure!(
journal.phase() == Phase::StopIntent,
"UPDATE_ENGINE_NOT_A_FRESH_HANDOFF"
);
let trust = TrustState::load(&original, &self.binding, &self.clock)?;
ensure!(
trust.health_public_key() == self.health_key
&& original.update().updater.health_key_pin_sha256 == self.health_pin_sha256
&& serde_json::to_vec(trust.policy())? == serde_json::to_vec(&self.policy)?,
"UPDATE_ENGINE_TRUST_CHANGED"
);
let witnesses = bundle::read_for_handoff(original.handoff())?;
witnesses.files.reopen_stages(original.handoff(), &budget)?;
witnesses.retained.verify()?;
let agent_startup = BoundAgentLock::bind(&witnesses.retained)?;
self.head = Some(proof.head_sha256.clone());
self.queued = Some(Queued {
agent_startup,
original,
witnesses,
trust,
budget,
proof,
});
Ok(())
}
fn drive(&mut self, queued: Queued) -> Result<()> {
let Queued {
agent_startup,
original,
witnesses,
trust,
budget,
proof,
} = queued;
original.check_current(&self.binding, &self.clock, &budget)?;
trust.recheck(&original, &self.clock)?;
let services = Systemd::new(self.old_policies.clone())?;
let old = [Service::Agent, Service::General, Service::Full]
.into_iter()
.map(|s| services.observe(s, &budget).map(|h| h.proof().clone()))
.collect::<Result<Vec<_>>>()?;
let mut bridge = FullBridge::new(
BridgeContext {
handoff: original.handoff(),
delegation: original.delegation(),
services: &services,
updater: &self.updater,
clock: &self.clock,
budget: &budget,
health_public_key: self.health_key,
generation: Generation::Original,
},
proof,
)?;
let mut claims = Vec::new();
for service in [
NativeService::Agent,
NativeService::General,
NativeService::Full,
] {
let expected_head_sha256 = bridge.head_sha256()?.to_owned();
claims.push(
bridge
.call(NativeControlOperation::ClaimStop {
expected_head_sha256,
service,
})?
.claim
.context("UPDATE_ENGINE_STOP_CLAIM")?,
);
}
drop(bridge);
let mut stop_fence = StopFence {
original: &original,
binding: &self.binding,
clock: &self.clock,
budget: &budget,
updater: &self.updater,
trust: &trust,
retained: &witnesses.retained,
claims,
old,
next: 0,
pending: false,
poisoned: false,
};
let stopped = services.stop_all(&budget, &mut stop_fence)?;
let claims = stop_fence.finish()?;
let agent_startup = agent_startup.acquire(&stopped, &budget)?;
let os = LedgerGuard::acquire(&stopped, &witnesses.ledger, &budget)?;
let mut ledger = OwnedLedger::open(OwnedInputs {
os: &os,
original: &original,
binding: &self.binding,
clock: &self.clock,
budget: &budget,
updater: &self.updater,
retained: &witnesses.retained,
files: &witnesses.files,
stopped: &stopped,
trust: &trust,
})?;
for (claim, old) in claims.iter().zip(stopped.proofs()) {
ledger.observe_native(claim, &hash(&serde_json::to_vec(&old)?))?;
}
ledger.append_observed(Evidence::AllStopped {
observation_sha256: hash(&serde_json::to_vec(&stopped.proofs())?),
})?;
ledger.append_observed(Evidence::UpdaterOwnsLedger {
process: Process {
pid: self.updater.identity().pid,
birth: self.updater.identity().birth,
image_sha256: self.updater.identity().image_sha256.clone(),
},
ledger_identity_sha256: witnesses.ledger.sha256()?,
})?;
// Do not hold a second connection before all readers really stopped.
let swap = (|| -> Result<()> {
let stages = witnesses.files.reopen_stages(original.handoff(), &budget)?;
let mut fence = LedgerFence::new(&mut ledger)?;
for (stage, role) in
stages
.into_iter()
.zip([Role::Agent, Role::Helper, Role::FullConfig, Role::FullPin])
{
let directory = Directory::open(
Path::new(role.target())
.parent()
.context("UPDATE_ENGINE_TARGET_PARENT")?,
0,
false,
)?;
stage.install(&directory, &os, &budget, &mut fence)?;
}
fence.finish()?;
ledger.append_observed(Evidence::PairVerified {
pair: original.handoff().target.clone(),
retained_state_sha256: original.handoff().retained_state_sha256.clone(),
})
})();
if let Err(error) = swap {
// Exactly one best-effort ORIGINAL Unknown CAS while we still own
// the real guard. Failure is preserved; no restoration or retry.
let _ = ledger.mark_unknown(
u64::try_from(self.clock.now()?.timestamp())?,
rmm_updater_handoff::UnknownReason::ReplaceUncertain,
);
return Err(error);
}
let prepared = ledger.prepare_return_and_close()?;
let reservation = prepared.bind(returned::Inputs {
original: &original,
binding: &self.binding,
clock: &self.clock,
budget: &budget,
updater: &self.updater,
retained: &witnesses.retained,
files: &witnesses.files,
trust: &trust,
})?;
let target_policies = service_policies(&self.policy, &self.installed, Some(&original))?;
let target = Systemd::new(target_policies.clone())?;
let observer = Systemd::new(target_policies)?;
let mut bridge = FullBridge::new(
BridgeContext {
handoff: original.handoff(),
delegation: original.delegation(),
services: &observer,
updater: &self.updater,
clock: &self.clock,
budget: &budget,
health_public_key: self.health_key,
generation: Generation::Replacement,
},
reservation.proof().clone(),
)?;
let mut fence = reservation.start_fence(&observer, &mut bridge);
agent_startup.verify()?;
os.release(&budget, &mut fence)?;
agent_startup.return_after_root_release(&budget)?;
let started = stopped.start_once(target, &budget, &mut fence)?;
fence.finish()?;
bridge.observe_starts(&started)?;
loop {
original.check_current(&self.binding, &self.clock, &budget)?;
self.updater
.verify_delegation(original.delegation(), &budget)?;
witnesses.retained.verify()?;
for service in &started {
service.verify(&budget)?;
}
let reply = bridge.call(NativeControlOperation::ReadOriginal)?;
let proof = reply.proof.context("UPDATE_ENGINE_HEALTH_PROOF")?;
self.head = Some(proof.head_sha256.clone());
let (_, journal) =
rmm_domain::agent_update::verify_inflight_proof(&proof, self.health_key)
.map_err(anyhow::Error::msg)?;
match journal.phase() {
Phase::ServicesStarted => std::thread::sleep(Duration::from_millis(100)),
Phase::HealthVerified => {
bridge.call(NativeControlOperation::Finalize)?;
self.head = None;
return Ok(());
}
_ => anyhow::bail!("UPDATE_ENGINE_HEALTH_PREFIX_CHANGED"),
}
}
}
}
impl ipc::Engine for Runtime {
fn handle(&mut self, peer: &ParticipantIdentity, request: Request) -> Result<Response> {
ensure!(!self.failed && !self.terminal, "UPDATE_ENGINE_CLOSED");
self.updater
.identity()
.validate()
.then_some(())
.context("UPDATE_ENGINE_IDENTITY")?;
let state = match request {
Request::Describe {} => State::Described,
Request::Activate {
grant_id,
owner_nonce,
handoff_sha256,
} => {
self.enqueue(peer, grant_id, owner_nonce, &handoff_sha256)?;
State::Inflight
}
// Health travels through the existing independently validating
// new Fullhelper path. This daemon accepts no duplicate authority.
_ => anyhow::bail!("UPDATE_ENGINE_UNSUPPORTED_CONTROL"),
};
Ok(Response {
schema_version: 1,
state,
ready: false,
updater: self.updater.identity().clone(),
head_sha256: self.head.clone(),
})
}
}
struct StopFence<'a> {
original: &'a Original,
binding: &'a Binding,
clock: &'a NativeClock,
budget: &'a Budget,
updater: &'a StableParticipant,
trust: &'a TrustState,
retained: &'a RetainedSet,
claims: Vec<NativeEffectClaim>,
old: Vec<ServiceProof>,
next: usize,
pending: bool,
poisoned: bool,
}
impl StopFence<'_> {
fn current(&self) -> Result<()> {
self.original
.check_current(self.binding, self.clock, self.budget)?;
self.updater
.verify_delegation(self.original.delegation(), self.budget)?;
self.trust.recheck(self.original, self.clock)?;
self.retained.verify()
}
fn finish(self) -> Result<Vec<NativeEffectClaim>> {
ensure!(
!self.poisoned && !self.pending && self.next == 3,
"UPDATE_ENGINE_STOP_INCOMPLETE"
);
self.current()?;
Ok(self.claims)
}
}
impl DurableEffectFence for StopFence<'_> {
fn before_effect(&mut self, effect: &Effect) -> Result<()> {
ensure!(
!self.poisoned && !self.pending && self.next < 3,
"UPDATE_ENGINE_STOP_NO_RETRY"
);
self.poisoned = true;
self.current()?;
let service = [Service::Agent, Service::General, Service::Full][self.next];
let native = [
NativeService::Agent,
NativeService::General,
NativeService::Full,
][self.next];
let claim = &self.claims[self.next];
ensure!(
*effect == Effect::StopService { service }
&& claim.effect() == &NativeEffect::StopService { service: native }
&& claim.grant_id() == self.original.permit().grant_id
&& claim.owner_nonce() == self.original.handoff().owner_nonce,
"UPDATE_ENGINE_STOP_RESERVATION_CHANGED"
);
self.pending = true;
Ok(())
}
fn after_effect(&mut self, effect: &Effect, observation: &str) -> Result<()> {
ensure!(
self.poisoned
&& self.pending
&& self.next < 3
&& *effect
== Effect::StopService {
service: self.old[self.next].service
}
&& observation == hash(&serde_json::to_vec(&self.old[self.next])?),
"UPDATE_ENGINE_STOP_OBSERVATION_CHANGED"
);
self.current()?;
self.next += 1;
self.pending = false;
self.poisoned = false;
Ok(())
}
}
fn observation_budget() -> Result<Budget> {
Budget::new(
std::fs::read_to_string("/proc/sys/kernel/random/boot_id")?
.trim()
.parse()?,
Duration::from_secs(5),
)
}
fn service_policies(
policy: &LocalUpdatePolicy,
installed: &InstalledReleaseRecord,
original: Option<&Original>,
) -> Result<Vec<ServicePolicy>> {
let release = installed
.release_envelope
.decode()
.map_err(anyhow::Error::msg)?;
policy
.services
.iter()
.zip([
Service::Agent,
Service::General,
Service::Full,
Service::Apt,
])
.map(|(pin, service)| {
ensure!(pin.unit == service.unit(), "UPDATE_ENGINE_SERVICE_SET");
let image_sha256 = match (service, original) {
(Service::Agent, Some(o)) => o.handoff().target.agent_sha256.clone(),
(Service::General | Service::Full | Service::Apt, Some(o)) => {
o.handoff().target.helper_sha256.clone()
}
(Service::Agent, None) => release.manifest.artifacts[0].sha256.clone(),
(_, None) => release.manifest.artifacts[1].sha256.clone(),
_ => anyhow::bail!("UPDATE_ENGINE_SERVICE_ROLE"),
};
Ok(ServicePolicy {
service,
image_sha256,
unit_sha256: pin.unit_sha256.clone(),
})
})
.collect()
}
+88
View File
@@ -1316,6 +1316,94 @@ mod tests {
active,
}
}
#[test]
fn public_record_builder_binds_actual_original_key_and_exact_health_head() {
let f = fixture();
let (grant, record, start):(String,Vec<u8>,Vec<u8>)=f.db.query_row(
"SELECT h.grant_id,h.record,e.start FROM agent_update_handoffs h JOIN execution_evidence e USING(grant_id)",
[],|r|Ok((r.get(0)?,r.get(1)?,r.get(2)?))).unwrap();
let grant: Uuid = grant.parse().unwrap();
let delegation = update_handoff::read_delegation(&f.db, grant).unwrap();
let original =
crate::original::Original::verify_retained(&f.binding, &start, &record, delegation)
.unwrap();
let key: [u8; 32] = hex::decode(&original.update().updater.health_public_key_hex)
.unwrap()
.try_into()
.unwrap();
let mut journal = Journal::open(&record, key).unwrap();
let mut wrong_journal = Journal::open(
&record,
SigningKey::from_bytes(&[88; 32]).verifying_key().to_bytes(),
)
.unwrap();
let mut statement =
f.db.prepare("SELECT event FROM agent_update_handoff_events ORDER BY sequence")
.unwrap();
let events = statement
.query_map([], |r| r.get::<_, Vec<u8>>(0))
.unwrap()
.collect::<rusqlite::Result<Vec<_>>>()
.unwrap();
let mut health_raw = None;
let mut wrong_health_raw = None;
for raw in events {
let event: Event = serde_json::from_slice(&raw).unwrap();
if let Evidence::HealthVerified { receipt } = &event.evidence {
journal.replay(&raw).unwrap();
let mut wrong = receipt.clone();
let mut message = HEALTH_DOMAIN.to_vec();
message.extend_from_slice(&wrong.payload);
wrong.signature = SigningKey::from_bytes(&[88; 32])
.sign(&message)
.to_bytes()
.to_vec();
let forged = wrong_journal
.prepare(
event.observed_at,
Evidence::HealthVerified { receipt: wrong },
)
.unwrap();
wrong_journal.replay(&forged).unwrap();
wrong_health_raw = Some(forged);
health_raw = Some(raw);
break;
}
journal.replay(&raw).unwrap();
wrong_journal.replay(&raw).unwrap();
}
let health_raw = health_raw.unwrap();
let built = crate::record::BuiltRecord::build(&original, &f.initial, &journal, &health_raw)
.unwrap();
assert_eq!(built.raw(), f.active);
assert_eq!(built.sha256(), hash(&f.active));
// A complete kernel Journal can be constructed with the wrong external
// key. The public builder must independently enforce the ORIGINAL job.
assert!(
crate::record::BuiltRecord::build(
&original,
&f.initial,
&wrong_journal,
&wrong_health_raw.unwrap()
)
.is_err()
);
let mut changed: Event = serde_json::from_slice(&health_raw).unwrap();
changed.observed_at += 1;
assert!(
crate::record::BuiltRecord::build(
&original,
&f.initial,
&journal,
&serde_json::to_vec(&changed).unwrap()
)
.is_err()
);
assert!(
crate::record::BuiltRecord::build(&original, &f.active, &journal, &health_raw).is_err()
);
}
#[test]
fn completed_history_rejects_file_only_rollback_forks_and_tampered_activation_without_writes() {
let f = fixture();
+2
View File
@@ -1,9 +1,11 @@
//! Concrete, original-attempt-bound Linux worker. No approval or retry path.
#![cfg(target_os = "linux")]
pub mod agent_startup;
pub mod bridge;
pub mod bundle;
pub mod clock;
pub mod engine;
pub mod fence;
pub mod files;
pub mod full;