From ed87420e1847a59c4517a09da0513adca90409e0 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Sun, 15 Nov 2026 01:47:03 +0100 Subject: [PATCH] Fence restored Windows clock contexts with real Linux evidence --- crates/agent-windows/src/signed_clock.rs | 162 +++++++-- .../windows_context_fence_linux_acceptance.py | 311 ++++++++++++++++++ docs/handover.md | 7 + docs/windows-signed-clock-evidence.md | 190 +++++++++++ 4 files changed, 647 insertions(+), 23 deletions(-) create mode 100644 deploy/windows_context_fence_linux_acceptance.py create mode 100644 docs/windows-signed-clock-evidence.md diff --git a/crates/agent-windows/src/signed_clock.rs b/crates/agent-windows/src/signed_clock.rs index 8e29495..27d76cd 100644 --- a/crates/agent-windows/src/signed_clock.rs +++ b/crates/agent-windows/src/signed_clock.rs @@ -80,10 +80,13 @@ impl Continuity { "TIME_NATIVE_CONFIGURATION_GENERATION" ); if let Some((current, hash)) = &self.configuration { - ensure!( - generation >= *current && (generation != *current || hash == sha256), - "TIME_NATIVE_CONFIGURATION_ROLLBACK_OR_FORK" - ); + if generation < *current || (generation == *current && hash != sha256) { + // A constructor has positively observed a protected rollback + // or fork. Reject it without adopting its head, and retain the + // process-wide failure even if the original bytes are restored. + self.invalidate(); + anyhow::bail!("TIME_NATIVE_CONFIGURATION_ROLLBACK_OR_FORK"); + } if generation > *current { self.invalidate(); } @@ -131,6 +134,13 @@ impl Continuity { ); Ok(()) } + fn require_epoch(&self, epoch: u64) -> Result<()> { + ensure!( + !self.exhausted && self.epoch == epoch, + "TIME_NATIVE_EVIDENCE_INVALIDATED" + ); + Ok(()) + } } /// All three native clocks are read in one bracket. The qualified base error @@ -396,7 +406,8 @@ mod installed { use rmm_agent_core::auth::Binding; use rmm_domain::jobs::hash; use rmm_time_attestation::{ - Challenge, Context, Interval, Pins, Request, Role, SignedAttestation, Verifier, + Challenge, Context, Interval, Pins, Request, Role, SignedAttestation, VerifiedEvidence, + Verifier, }; use serde::{Deserialize, Serialize}; use std::{ @@ -467,6 +478,10 @@ mod installed { epoch: u64, challenge: Challenge, } + struct HeldEvidence { + evidence: VerifiedEvidence, + epoch: u64, + } /// Own-process role proof, protected held configuration, private challenge /// and native timers. No constructor accepts agent-reported helper times. pub struct SignedClock { @@ -478,6 +493,7 @@ mod installed { connection_generation: u64, base_error_ns: u64, pending: Option, + latest: Option, } impl SignedClock { /// Connection generation is later confirmed by the independently @@ -602,6 +618,7 @@ mod installed { connection_generation, base_error_ns, pending: None, + latest: None, }; value.recheck()?; process() @@ -612,16 +629,34 @@ mod installed { Ok(value) } fn recheck(&mut self) -> Result<()> { - self.own_process.check()?; - for file in &mut self.files { - file.check()?; + let result = (|| { + self.own_process.check()?; + for file in &mut self.files { + file.check()?; + } + let config = self.files.last_mut().context("TIME_NATIVE_CONFIG_HELD")?; + ensure!( + config.sha256()? == self.config_sha256, + "TIME_NATIVE_CONFIG_CHANGED" + ); + Ok(()) + })(); + if result.is_err() { + self.invalidate_observed_context(); + } + result + } + fn invalidate_observed_context(&mut self) { + self.latest = None; + self.pending = None; + self.verifier.invalidate(); + // A positively observed protected-context failure is shared by + // every object in this process, even if this object owns no nonce. + // Restoring old bytes must not revive any older same-generation + // evidence. Poisoned state already refuses all future access. + if let Ok(mut state) = process().lock() { + state.invalidate(); } - let config = self.files.last_mut().context("TIME_NATIVE_CONFIG_HELD")?; - ensure!( - config.sha256()? == self.config_sha256, - "TIME_NATIVE_CONFIG_CHANGED" - ); - Ok(()) } pub fn begin(&mut self, connection_generation: u64) -> Result { if connection_generation != self.connection_generation { @@ -675,9 +710,9 @@ mod installed { let signed: SignedAttestation = serde_json::from_slice(bytes)?; self.recheck()?; let mut checked = None; - let interval = + let (evidence, interval) = self.verifier - .finish(pending.challenge, &signed, received, || { + .finish_evidence(pending.challenge, &signed, received, || { let (sample, epoch) = observed(self.boot_id, self.base_error_ns)?; ensure!(epoch == pending.epoch, "TIME_NATIVE_CHALLENGE_INVALIDATED"); checked = Some(sample); @@ -688,6 +723,10 @@ mod installed { .map_err(|_| anyhow::anyhow!("TIME_NATIVE_STATE_POISONED"))?; state.require_owner(pending.owner, pending.epoch)?; state.active = None; + self.latest = Some(HeldEvidence { + evidence, + epoch: pending.epoch, + }); let comparison = Comparison { interval, wall_utc_ns: checked.context("TIME_NATIVE_FINAL_SAMPLE")?.wall_utc_ns, @@ -696,6 +735,7 @@ mod installed { consume(&comparison) })(); if result.is_err() { + self.latest = None; self.verifier.invalidate(); if let Ok(mut state) = process().lock() && state.active == Some(pending.owner) @@ -705,13 +745,64 @@ mod installed { } result } + /// No IO/IPC callback, reply, caller timestamp or ready flag is needed + /// for reads. Only a freshly recaptured own wall observation, bounded + /// by the original finite evidence, is exposed inside this callback. + pub fn with_current_comparison( + &mut self, + consume: impl FnOnce(&Comparison) -> Result, + ) -> Result { + // A first/next refresh may be pending. Absence/ordinary expiry of + // the old evidence must not consume that independent new nonce. + let epoch = self + .latest + .as_ref() + .context("TIME_NATIVE_NO_EVIDENCE")? + .epoch; + let checked = (|| { + self.recheck()?; + let (sample, current_epoch) = observed(self.boot_id, self.base_error_ns)?; + ensure!(epoch == current_epoch, "TIME_NATIVE_EVIDENCE_INVALIDATED"); + let state = process() + .lock() + .map_err(|_| anyhow::anyhow!("TIME_NATIVE_STATE_POISONED"))?; + state.require_epoch(epoch)?; + state.require_connection(self.connection_generation)?; + Ok(sample) + })(); + let checked = match checked { + Ok(value) => value, + Err(error) => { + self.close(); + return Err(error); + } + }; + let evidence = &self + .latest + .as_ref() + .context("TIME_NATIVE_NO_EVIDENCE")? + .evidence; + let interval = match self.verifier.check_evidence(evidence, checked) { + Ok(value) => value, + Err(error) => { + self.latest = None; + return Err(error); + } + }; + consume(&Comparison { + interval, + wall_utc_ns: checked.wall_utc_ns, + }) + } pub fn close(&mut self) { self.verifier.invalidate(); - if let Some(pending) = self.pending.take() - && let Ok(mut state) = process().lock() - && state.active == Some(pending.owner) - { - state.invalidate(); + let evidence_epoch = self.latest.take().map(|value| value.epoch); + let pending = self.pending.take(); + if let Ok(mut state) = process().lock() { + let owns_pending = pending.is_some_and(|value| state.active == Some(value.owner)); + if owns_pending || evidence_epoch == Some(state.epoch) { + state.invalidate(); + } } } } @@ -721,7 +812,7 @@ mod installed { } } - /// Borrowed only inside the completion callback, never returned as a + /// Borrowed only inside a completion/current-comparison callback, never returned as a /// storable clock/lease/permit. Runtime callers must retain all job gates. pub struct Comparison { interval: Interval, @@ -836,25 +927,49 @@ mod tests { let mut state = Continuity::default(); state.accept_configuration(4, "one-config").unwrap(); state.accept_connection(3).unwrap(); + let before_rollback = state.epoch; assert!(state.accept_configuration(3, "old-config").is_err()); - assert!(state.accept_configuration(4, "different-config").is_err()); + assert!(state.require_epoch(before_rollback).is_err()); + assert_eq!(state.configuration, Some((4, "one-config".into()))); state.accept_configuration(4, "one-config").unwrap(); + let before_fork = state.epoch; + assert!(state.accept_configuration(4, "different-config").is_err()); + assert!(state.require_epoch(before_fork).is_err()); + assert_eq!(state.configuration, Some((4, "one-config".into()))); + state.accept_configuration(4, "one-config").unwrap(); + assert!(state.require_epoch(before_rollback).is_err()); + assert!(state.require_epoch(before_fork).is_err()); state.observe(boot, sample(0)).unwrap(); + let first_clock_evidence = state.epoch; + let other_clock_evidence = state.epoch; + // recheck's observed-context failure fences the entire process even + // when no object currently owns a pending nonce. Same-generation + // restoration does not erase the observed failure or heal old proof. + state.invalidate(); + state.accept_configuration(4, "one-config").unwrap(); + assert!(state.require_epoch(first_clock_evidence).is_err()); + assert!(state.require_epoch(other_clock_evidence).is_err()); let original_epoch = state.reserve(owner).unwrap(); + assert!(original_epoch > first_clock_evidence); + // An outstanding refresh owns a nonce, not the older finite evidence. + state.require_epoch(original_epoch).unwrap(); assert!(state.reserve(Uuid::new_v4()).is_err()); let mut resumed = sample(2_000_000_000); resumed.unbiased_ns = 9_000_000_000; assert!(state.observe(boot, resumed).is_err()); assert!(state.require_owner(owner, original_epoch).is_err()); + assert!(state.require_epoch(original_epoch).is_err()); // A caller reconstructing its verifier still sees this retained state. state.observe(boot, resumed).unwrap(); let next = Uuid::new_v4(); let epoch = state.reserve(next).unwrap(); assert!(epoch > original_epoch); state.require_owner(next, epoch).unwrap(); + state.require_epoch(epoch).unwrap(); state.accept_connection(4).unwrap(); assert!(state.require_owner(next, epoch).is_err()); + assert!(state.require_epoch(epoch).is_err()); assert!(state.require_connection(3).is_err()); assert!(state.accept_connection(3).is_err()); state.require_connection(4).unwrap(); @@ -863,6 +978,7 @@ mod tests { state.epoch = u64::MAX; state.invalidate(); assert!(state.exhausted); + assert!(state.require_epoch(state.epoch).is_err()); state.invalidate(); assert!(state.exhausted); assert!(state.reserve(Uuid::new_v4()).is_err()); diff --git a/deploy/windows_context_fence_linux_acceptance.py b/deploy/windows_context_fence_linux_acceptance.py new file mode 100644 index 0000000..1d1c2f4 --- /dev/null +++ b/deploy/windows_context_fence_linux_acceptance.py @@ -0,0 +1,311 @@ +#!/usr/bin/env python3 +"""Frozen one changed Windows context fence on Linux only; fourteen other cases filtered; no updater service or Apply. + +Prepare copies the independently reviewed snapshot locally. Execute is one +root-only Cloud-VM fixture run. After any lost reply read the original case; +never execute it again or substitute another binary/source generation. +""" +import argparse +import base64 +import hashlib +import inspect +import json +import os +from pathlib import Path +import stat +import uuid + +import windows_msi_runtime_acceptance as support + +ROOT = Path(__file__).resolve().parents[1] +ACCESS_ROOT = ROOT.parent / 'rust-discovery' +QUALIFICATION = ROOT / 'devstate/windows-signed-clock/config-fence-qualification-304d0520-9882-4ed4-b9e0-634996c07dc6' +STATE = ROOT / 'devstate/windows-context-fence-native-linux' +PROFILE = 'rmm.windows-clock.context-fence-linux-guard.v1' +RECEIPT_SHA = 'f25dae5d8f9fea185a298014a087424c8b2207dfe15cfe86de38d0773fae9ef4' +INPUTS_SHA = 'b0f317cb59aed20e2faa9cfeef38cc55fceb4bc00faac723bc9ab5bd8d60b87f' +BINARY_SHA = 'b390ee90332671a68ab401e713691e3b4072db1ec83b2cff9a6e4dbbe524ec42' +BINARY_BYTES = 4046032 +TESTS = sorted(['signed_clock::tests::retained_process_fence_rejects_old_challenge_and_boot_substitution']) +ALL_TESTS = sorted(['event_log::tests::job_mapping_is_only_fixed_unprivileged_live_logs_with_exact_limits', 'event_log::tests::only_fixed_source_window_and_finite_limits_are_queryable', 'event_log::tests::serialized_byte_budget_includes_xml_escaping_and_metadata', 'journal::tests::bounded_existing_journal_preserves_identity_sequence_and_unacked_bytes', 'journal::tests::durable_reopen_ack_identity_and_single_process', 'journal::tests::migrates_original_passive_schema_without_rewriting_pending_envelopes', 'journal::tests::unsupported_page_size_is_refused_without_mutating_existing_data', 'package::tests::exit_code_never_substitutes_for_independent_postconditions_or_reboot_authority', 'package::tests::late_exit_or_postcondition_cannot_retroactively_succeed_or_retry', 'package::tests::upgrade_and_noop_need_independent_exact_products_family_and_payload', 'signed_clock::tests::bracket_uses_actual_capture_width_and_refuses_unqualified_or_backward_counters', 'signed_clock::tests::complete_raw_report_is_bounded_non_authoritative_and_keeps_actual_brackets', 'signed_clock::tests::job_key_cannot_be_reintroduced_as_a_time_key_with_different_hex_case', 'signed_clock::tests::raw_capture_denies_backward_wall_counters_and_incomplete_or_expired_series', 'signed_clock::tests::retained_process_fence_rejects_old_challenge_and_boot_substitution']) +AGENT_SHA = '0a7ad6eefaefda79ee80b6a41b2df904e9e7f50ae6ebeed01b98c25b6ce5c06f' +HELPER_SHA = '79442727c3ba31cda02a8bc0e67481f14db9f39fc07520a880a90b64f10f1eaf' + + +def sha(raw): + return hashlib.sha256(raw).hexdigest() + + +def save_local(path, value): + support.save(path, value) + fd = os.open(path.parent, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW) + try: + os.fsync(fd) + finally: + os.close(fd) + + +def copy_exact(source, destination, digest, size): + metadata = source.lstat() + support.require(stat.S_ISREG(metadata.st_mode) and metadata.st_nlink == 1 + and metadata.st_uid in (0, os.getuid()) and not metadata.st_mode & 0o002 + and metadata.st_size == size and size <= 4 * 1024 * 1024, 'bounded regular frozen input') + raw = source.read_bytes() + support.require(sha(raw) == digest, 'frozen snapshot input hash') + destination.parent.mkdir(mode=0o700, parents=True, exist_ok=True) + support.private(destination.parent, True) + fd = os.open(destination, os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW | os.O_WRONLY, 0o600) + with os.fdopen(fd, 'wb') as stream: + stream.write(raw); stream.flush(); os.fsync(stream.fileno()) + fd = os.open(destination.parent, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW) + try: + os.fsync(fd) + finally: + os.close(fd) + + +def verify_case(folder): + value = support.load(folder / 'manifest.json') + support.require(value['profile'] == PROFILE and value['tests'] == TESTS and value['all_listed_tests'] == ALL_TESTS + and value['runner_sha256'] == sha(Path(__file__).read_bytes()) + and value['receipt_sha256'] == RECEIPT_SHA and value['binary_sha256'] == BINARY_SHA + and value['binary_bytes'] == BINARY_BYTES, 'same original reviewed manifest') + support.require(sha((folder / 'receipt.json').read_bytes()) == RECEIPT_SHA + and sha((folder / 'inputs.json').read_bytes()) == INPUTS_SHA, 'original qualification provenance') + source = support.load(folder / 'inputs.json') + support.require(len(source) == 190 and source == value['source_files'], 'exact frozen 190 compiler inputs') + for item in source: + path = Path(item['path']) + support.require(not path.is_absolute() and '..' not in path.parts, 'fixed snapshot relative path') + file = folder / 'source' / path + support.private(file) + support.require(file.stat().st_size == item['bytes'] and sha(file.read_bytes()) == item['sha256'], 'retained source freeze') + binary = folder / 'windows-clock-guard-tests'; support.private(binary) + support.require(binary.stat().st_size == BINARY_BYTES and sha(binary.read_bytes()) == BINARY_SHA, 'original qualified test bytes') + for path, digest in value['transport_sources'].items(): + support.require(sha((ROOT / path).read_bytes()) == digest, 'original strict transport source') + return value + + +def remote(p): + import base64 + import hashlib + import json + import os + from pathlib import Path + import selectors + import signal + import stat + import subprocess + import time + import uuid + + def require(ok, message): + if not ok: + raise RuntimeError(message) + + def enc(value): + return json.dumps(value, sort_keys=True, separators=(',', ':')).encode() + + def create(path, raw, mode=0o600): + fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, mode) + with os.fdopen(fd, 'wb') as stream: + stream.write(raw); stream.flush(); os.fsync(stream.fileno()) + fd = os.open(path.parent, os.O_DIRECTORY | os.O_RDONLY | os.O_NOFOLLOW) + try: + os.fsync(fd) + finally: + os.close(fd) + + def run(args, timeout=20): + # Keep the owned group leader unreaped until its entire group has been + # cleaned up. Its PID therefore cannot be recycled before killpg. + child = subprocess.Popen(args, stdin=subprocess.DEVNULL, stdout=subprocess.PIPE, + stderr=subprocess.PIPE, start_new_session=True, + env={'PATH': '/usr/bin:/bin', 'LC_ALL': 'C', 'HOME': '/nonexistent'}) + selector = selectors.DefaultSelector() + buffers = {'stdout': bytearray(), 'stderr': bytearray()} + deadline = time.monotonic() + timeout + try: + for stream, name in ((child.stdout, 'stdout'), (child.stderr, 'stderr')): + os.set_blocking(stream.fileno(), False); selector.register(stream, selectors.EVENT_READ, name) + while True: + require(time.monotonic() < deadline, 'owned native command timeout; read original case only') + for key, _ in selector.select(0.02): + raw = os.read(key.fileobj.fileno(), 4096) + if raw: + buffers[key.data].extend(raw) + require(len(buffers[key.data]) <= 65536, 'bounded native output') + else: + selector.unregister(key.fileobj) + ended = os.waitid(os.P_PID, child.pid, os.WEXITED | os.WNOHANG | os.WNOWAIT) + if ended is not None: + # Child remains a zombie until finally: no PID/group reuse. + os.killpg(child.pid, signal.SIGKILL) + for key in list(selector.get_map().values()): + while True: + try: + raw = os.read(key.fileobj.fileno(), 4096) + except BlockingIOError: + break + if not raw: + break + buffers[key.data].extend(raw) + require(len(buffers[key.data]) <= 65536, 'bounded native output') + code = ended.si_status if ended.si_code == os.CLD_EXITED else -ended.si_status + return code, bytes(buffers['stdout']), bytes(buffers['stderr']) + finally: + os.killpg(child.pid, signal.SIGKILL) + child.wait() + selector.close(); child.stdout.close(); child.stderr.close() + + def metadata_identity(value): + return (value.st_dev, value.st_ino, value.st_uid, value.st_gid, value.st_mode, + value.st_nlink, value.st_size, value.st_mtime_ns, value.st_ctime_ns) + + def hashed(path, maximum, process_image=False): + fd = os.open(path, os.O_RDONLY | os.O_CLOEXEC | (0 if process_image else os.O_NOFOLLOW)) + with os.fdopen(fd, 'rb') as stream: + before = os.fstat(stream.fileno()); require(stat.S_ISREG(before.st_mode) and before.st_size <= maximum, 'bounded witness file') + digest = hashlib.sha256(); total = 0 + while True: + raw = stream.read(32768) + if not raw: + break + total += len(raw); require(total <= maximum, 'bounded witness hash'); digest.update(raw) + after = os.fstat(stream.fileno()) + require(metadata_identity(before) == metadata_identity(after) and total == before.st_size, 'stable witness hash') + return before, digest.hexdigest() + + def witness(): + out = {'boot_id': Path('/proc/sys/kernel/random/boot_id').read_text().strip(), 'services': {}, 'files': {}} + release = dict(line.split('=', 1) for line in Path('/etc/os-release').read_text().splitlines() if '=' in line) + require(release.get('ID', '').strip('"') == 'ubuntu' and release.get('VERSION_ID', '').strip('"') == '24.04', 'fixed native Ubuntu24.04') + out['os'] = {'id': 'ubuntu', 'version': '24.04', 'machine': os.uname().machine, 'kernel': os.uname().release} + for name, uid, binary in ( + ('rmm-agent-remote.service', 993, p['agent_sha256']), + ('rmm-helper-cloud.service', 0, p['helper_sha256']), + ('rmm-full-maintenance-helper.service', 0, p['helper_sha256'])): + code, stdout, _ = run(['/usr/bin/systemctl', 'show', name, '-p', 'ActiveState', '-p', 'MainPID', '-p', 'UnitFileState', '-p', 'InvocationID']) + require(code == 0, 'existing service read') + service = dict(line.split('=', 1) for line in stdout.decode().splitlines()) + pid = int(service['MainPID']); require(service['ActiveState'] == 'active' and pid > 1, 'three existing services active') + proc = Path('/proc', str(pid)); birth = (proc / 'stat').read_text().rsplit(') ', 1)[1].split()[19] + ids = {line.split(':')[0]: line.split()[1:] for line in (proc / 'status').read_text().splitlines() if line.startswith(('Uid:', 'Gid:'))} + metadata, image = hashed(proc / 'exe', 256 * 1024 * 1024, process_image=True) + current = (proc / 'exe').stat() + require(ids['Uid'] == [str(uid)] * 4 and ids['Gid'] == ['984'] * 4 and image == binary + and (metadata.st_dev, metadata.st_ino) == (current.st_dev, current.st_ino) + and (proc / 'stat').read_text().rsplit(') ', 1)[1].split()[19] == birth, 'current generation/account/image') + out['services'][name] = dict(service, birth=birth, image=image, ids=ids) + code, stdout, _ = run(['/usr/bin/systemctl', 'show', 'rmm-apt-helper.service', '-p', 'ActiveState', '-p', 'UnitFileState']) + apt = dict(line.split('=', 1) for line in stdout.decode().splitlines()) + require(code == 0 and apt == {'ActiveState': 'inactive', 'UnitFileState': 'disabled'}, 'APT remains closed') + out['apt'] = apt + for name in ('/etc/rmm-remote/helper-general.json', '/etc/rmm-remote/helper-full-maintenance.json', + '/etc/rmm-remote/full-maintenance-helper-proof.json', '/etc/systemd/system/rmm-full-maintenance-helper.service'): + path = Path(name); metadata = path.lstat() + require(not path.is_symlink() and stat.S_ISREG(metadata.st_mode) and metadata.st_uid == 0 + and not metadata.st_mode & 0o022 and metadata.st_nlink == 1, 'protected known control') + current, digest = hashed(path, 65536) + require(metadata_identity(current) == metadata_identity(metadata), 'same known control file') + out['files'][name] = [metadata.st_dev, metadata.st_ino, metadata.st_uid, metadata.st_gid, metadata.st_mode, + metadata.st_size, metadata.st_mtime_ns, metadata.st_ctime_ns, digest] + for name in ('/var/lib/rmm-helper/consumption.sqlite', '/var/lib/rmm-helper/executor.lock', + '/var/lib/rmm-agent-remote/journal.sqlite', '/var/lib/rmm-agent-remote/consumption.sqlite'): + path = Path(name); metadata = path.lstat() + require(not path.is_symlink() and stat.S_ISREG(metadata.st_mode) and metadata.st_nlink == 1, 'existing state identity') + out['files'][name] = [metadata.st_dev, metadata.st_ino, metadata.st_uid, metadata.st_gid, metadata.st_mode] + return out + + require(os.geteuid() == 0 and os.uname().machine == 'x86_64', 'fixed Cloud Linux root contract fixtures') + ident = str(uuid.UUID(p['id'])); require(ident == p['id'], 'canonical original case') + folder = Path('/var/tmp') / ('rmm-windows-raw-clock-guards-linux-' + ident) + if p['action'] == 'read': + metadata = folder.lstat() + require(stat.S_ISDIR(metadata.st_mode) and not folder.is_symlink() and metadata.st_uid == 0 + and stat.S_IMODE(metadata.st_mode) == 0o700, 'own original case only') + result = folder / 'result.json' + return {'read_only': True, 'id': ident, 'entered': (folder / 'entered.json').exists(), + 'result': json.loads(result.read_bytes()) if result.exists() else None, 'current_witness': witness()} + require(p['action'] == 'execute', 'one fixed time contract action') + os.umask(0o077); folder.mkdir(mode=0o700) + create(folder / 'intent.json', enc({key: value for key, value in p.items() if key != 'binary_b64'})) + require(len(p['binary_b64']) == 5394712, 'bounded binary transfer') + raw = base64.b64decode(p['binary_b64'], validate=True) + require(len(raw) == 4046032 and hashlib.sha256(raw).hexdigest() == p['binary_sha256'], 'fixed three-guard library binary') + binary = folder / 'windows-clock-guard-tests'; create(binary, raw, 0o700) + before = witness(); create(folder / 'before.json', enc(before)) + command = ['/usr/bin/setpriv', '--reuid=0', '--regid=0', '--clear-groups', '--no-new-privs', str(binary)] + code, stdout, stderr = run(command + ['--list', '--format', 'terse']) + create(folder / 'list.stdout', stdout); create(folder / 'list.stderr', stderr) + require(code == 0 and stderr == b'', 'native list succeeded') + lines = stdout.decode().splitlines() + require(len(lines) == 15 and sorted(line[:-6] for line in lines if line.endswith(': test')) == p['all_listed_tests'], 'exact full fifteen-test list before one targeted fence') + create(folder / 'entered.json', enc({'id': ident, 'run_once': True, 'time_ns': time.time_ns()})) + code, stdout, stderr = run(command + ['signed_clock::tests::retained_process_fence_rejects_old_challenge_and_boot_substitution', '--exact', '--test-threads=1', '--nocapture']) + create(folder / 'run.stdout', stdout); create(folder / 'run.stderr', stderr) + after = witness(); create(folder / 'after.json', enc(after)) + require(before == after and code == 0 and stderr == b'' + and b'1 passed; 0 failed; 0 ignored; 0 measured; 14 filtered out' in stdout + and all((b'test ' + name.encode() + b' ... ok') in stdout for name in p['tests']), 'one native context fence with fourteen filtered and retained target state') + receipt = dict(id=ident, profile=p['profile'], passed=1, ignored=0, filtered=14, listed=15, execution_uid=0, tests=p['tests'], + before=before, after=after, binary_sha256=p['binary_sha256'], source_receipt_sha256=p['receipt_sha256'], + source_manifest_sha256=p['manifest_sha256'], stdout_sha256=hashlib.sha256(stdout).hexdigest(), + no_rmm_jobs=True, no_apply=True, no_service_control=True) + create(folder / 'result.json', enc(receipt)); return receipt + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('action', choices=('prepare', 'execute', 'read')); parser.add_argument('--case') + args = parser.parse_args(); os.umask(0o077) + STATE.mkdir(mode=0o700, parents=True, exist_ok=True); support.private(STATE, True) + if args.action == 'prepare': + support.require(args.case is None, 'prepare one new local case') + receipt_path = QUALIFICATION / 'receipt.json'; support.private(receipt_path) + support.require(sha(receipt_path.read_bytes()) == RECEIPT_SHA, 'independently reviewed source receipt') + receipt = support.load(receipt_path); original = support.load(QUALIFICATION / 'inputs.json') + support.require(sha((QUALIFICATION / 'inputs.json').read_bytes()) == INPUTS_SHA + and receipt['inputs_sha256'] == INPUTS_SHA and len(original) == 190 + and receipt['module_sha256'] == '9cc43960531a7fbd9899f88eeda4400c04a87a756a188c062bc1865fafd5bc50' + and receipt['tests'] == 'local1PASS/14filtered; full15list verified' + and receipt['runtime_gate_or_target_changes'] is False, 'reviewed changed context-fence qualification') + ident = str(uuid.uuid4()); folder = STATE / ident; folder.mkdir(mode=0o700) + copy_exact(receipt_path, folder / 'receipt.json', RECEIPT_SHA, receipt_path.stat().st_size) + copy_exact(QUALIFICATION / 'inputs.json', folder / 'inputs.json', INPUTS_SHA, (QUALIFICATION / 'inputs.json').stat().st_size) + paths = set() + for item in original: + path = Path(item['path']) + support.require(not path.is_absolute() and '..' not in path.parts and str(path) not in paths, 'unique fixed frozen input') + paths.add(str(path)); copy_exact(QUALIFICATION / 'source' / path, folder / 'source' / path, item['sha256'], item['bytes']) + binary = QUALIFICATION / 'windows-config-fence-tests' + support.require(receipt['binary'] == dict(path='windows-config-fence-tests', bytes=BINARY_BYTES, sha256=BINARY_SHA, complete_test_list=ALL_TESTS), 'fixed original linked artifact') + copy_exact(binary, folder / 'windows-clock-guard-tests', BINARY_SHA, BINARY_BYTES) + transports = {path: sha((ROOT / path).read_bytes()) for path in ('deploy/windows_msi_runtime_acceptance.py', 'deploy/vm_access_check.py')} + save_local(folder / 'manifest.json', dict(id=ident, profile=PROFILE, runner_sha256=sha(Path(__file__).read_bytes()), + receipt_sha256=RECEIPT_SHA, binary_sha256=BINARY_SHA, binary_bytes=BINARY_BYTES, + source_files=original, tests=TESTS, all_listed_tests=ALL_TESTS, transport_sources=transports)) + verify_case(folder) + print(json.dumps({'id': ident, 'prepared_locally': True})); return + support.require(args.case is not None, 'original --case required') + ident = str(uuid.UUID(args.case)); support.require(ident == args.case, 'same canonical original case') + folder = STATE / ident; support.private(folder, True); verify_case(folder) + payload = dict(id=ident, action=args.action, profile=PROFILE, tests=TESTS, all_listed_tests=ALL_TESTS, binary_sha256=BINARY_SHA, + receipt_sha256=RECEIPT_SHA, manifest_sha256=sha((folder / 'manifest.json').read_bytes()), + agent_sha256=AGENT_SHA, helper_sha256=HELPER_SHA) + if args.action == 'execute': + save_local(folder / 'execute-entered.json', {'once': True, 'no_retry': True}) + payload['binary_b64'] = base64.b64encode((folder / 'windows-clock-guard-tests').read_bytes()).decode() + code = 'import json\n' + inspect.getsource(remote) + '\nprint(json.dumps(remote(' + repr(payload) + ')))\n' + response = support.transport(support.access_settings(ACCESS_ROOT, 'linux'), 'python3 -', code.encode(), folder) + save_local(folder / (args.action + '-' + str(uuid.uuid4()) + '.json'), response) + if args.action == 'read' and response['result'] is not None: + support.require(response['result']['source_manifest_sha256'] == sha((folder / 'manifest.json').read_bytes()) + and response['current_witness'] == response['result']['after'], 'same-case retained native result') + print(json.dumps({'id': ident, 'action': args.action, 'passed': response.get('passed'), + 'complete': response.get('result') is not None if args.action == 'read' else True, 'read_only': args.action == 'read'})) + + +if __name__ == '__main__': + main() diff --git a/docs/handover.md b/docs/handover.md index a12e159..89ae86a 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -1,5 +1,12 @@ # Übergabe — Linux-MVP abgeschlossen, Windows wird fortgesetzt +**Finaler Windows-Kontextfence Linux-first bestanden:** Originalfall1e179c84, +volle15er-Liste, nur geänderten Fencetest1PASS/14filtered ausgeführt; separater +Readback vollständig, bekannte Runtimezeugen erhalten. Recheck und erkannter +Konstruktor-Fork/Rollback invalidieren prozessweit. [Belege](windows-signed-clock-evidence.md). +Keine Windows-Kernel-/Zeitbereitschaft oder Jobfreigabe. + + **Kurzlebige Zeitevidenz Linux-first bestanden:** Originalfall44514778, sechs native Cloud-Linux-Vertragsprüfungen ohne Skip/Filter, separater Readback vollständig und bekannte Runtimezeugen erhalten. [Ergebnis](signed-time-contract-results.md). diff --git a/docs/windows-signed-clock-evidence.md b/docs/windows-signed-clock-evidence.md new file mode 100644 index 0000000..418aac8 --- /dev/null +++ b/docs/windows-signed-clock-evidence.md @@ -0,0 +1,190 @@ +# Kurze prozessgebundene Evidenz für native Clockleser + +Dieser Schnitt erweitert ausschließlich den gemeinsamen Zeitcodec und den +noch nicht angebundenen Windowsadapter. Er aktiviert keinen Legacyclock, +Capability, Runtime-/Helper-IPC-Pfad oder Jobgate. Request, Payload, kanonische +Wirebytes und Signaturdomäne bleiben unverändert; das eingefrorene Serverpaket +des Quellencheckpoints `2dfd791` bleibt auf dem Draht kompatibel. + +`Verifier::finish_evidence` konsumiert genau die eigene Challenge und prüft +Nonce-/Kontext-/Keybindung und Signatur einmal. Erst danach erfolgt wie bisher +das eigene finale Capture. Zurück kommen ein opakes `VerifiedEvidence` und +das ursprüngliche sofortige `Interval`. Das bestehende `finish` delegiert +dorthin und liefert unverändert nur dieses Intervall. Evidence besitzt keine +öffentlichen Felder, keinen Konstruktor, Clone, Serialize/Deserialize oder +Timestampgetter. Sie hält private verifizierte Payloadfakten, ursprüngliche +Begin-/Receive-Samples sowie Verifier-ID, Epoche und Kontext; keine Signatur +oder Antwortbytes für spätere erneute Signaturprüfung. + +Jeder spätere `check_evidence` verlangt eine neue eigene native Beobachtung. +Ownership/Epoche/Kontext und Kontinuität werden erneut geprüft. Die gesamte +Zeit seit dem ursprünglichen Challengebeginn bleibt höchstens1s, seit dem +ursprünglichen eigenen Empfang höchstens100ms. Begin-/Receive-/aktuelles +Capturebudget zusammen höchstens50ms. Fehlerintervalle enthalten den gesamten +vergangenen Zeitraum und Capturebudgets, niemals RTT/2. Quellalter samt diesen +Zeiten bleibt höchstens1h; das gesamte neu errechnete UTC-Intervall muss +innerhalb2s der tatsächlich selbst beobachteten Wallclock liegen. Ein Read +erneuert keine Frist und ersetzt die Wallclock nicht durch einen Mittelpunkt. + +Eine neue offene Challenge verändert diese Evidenzepoche nicht. Deshalb kann +die vorherige Evidence während eines Refreshes bis zu ihren ursprünglichen +Fristen weiter verwendet werden. Ihr gewöhnlicher Ablauf darf die nächste +offene Nonce nicht konsumieren. Ein unabhängiger neuer erfolgreicher Vergleich +ersetzt sie; eine verspätete alte Antwort wird dadurch nicht erneut gültig. +Explizite Invalidierung, fremder Verifier, Diskontinuität oder wechselnder +geschützter Kontext sperren die alte Evidence. + +`SignedClock` hält die jüngste Evidence samt Prozess-Globalepoche ausschließlich +privat. `complete` bewahrt seinen ursprünglichen Callback und dessen eigenes +finales Sample/Initialintervall, versiegelt gleichzeitig die Evidence und +erteilt keine zweite Wirkung bei doppelter Antwort. Der neue +`with_current_comparison` liest nur den eigenen Prozess: Rolle/geschützte +gehaltene Dateien und Konfigurationshash, echte Clockgetter, Boot-/Globalepoche +und Connectionhead werden geprüft. Anschließend rechnet der eigene Verifier +das Intervall erneut aus. Nur im Callback sind tatsächlich selbst beobachtetes +UTC-W und frisches Intervall verfügbar. Kein Netzwerk-/Pipe-Rückruf aus diesem +Getter, kein Agentbericht als Helperzeit, kein exportierter Clockready-Boolean. +Fehlende Evidence oder normaler Ablauf sind kein Grund, einen laufenden neuen +Refresh abzubrechen; ein nativer Identitäts-/Kontextfehler schließt den Kontext. + +Die zwei neuen Codec-Guardsequenzen betreffen Originalfristen einschließlich +101ms nach Empfang und mehr als1s seit Beginn, alte Evidence bei gleichzeitig +offener nächster Challenge, erfolgreiche neue Evidence nach Ablauf der alten, +getrennte Evidence-/Antwortdaten sowie falschen Verifier, neue Epoche und +Diskontinuität. Der vorhandene Windows-Prozessfencetest prüft zusätzlich die +Evidenceepoche während einer offenen Challenge und nach Invalidierung. + +Lokale Build-/Testbelege dieses neuen Quellenstandes werden separat erfasst. +Die alten nativen Codec-/Windows-Guard-/Rohcapturebelege qualifizieren diesen +Deltaquellstand nicht nachträglich. Kein nativer Windowsvergleich, keine echte +Rollen-/Timerkalibrierung oder neue Serverqualität wird aus lokalen Tests +abgeleitet. Linux-first-Nachweis der neuen Guards, echte unabhängige Windows- +Rollenproofs und spätere Runtime-/Deadlineintegration bleiben eigene offene +MVP-Schritte. Geschützte Pins oder Baseerror werden hier nicht provisioniert. + +## Tatsächlicher lokaler Nachweis, 2026-11-15 + +Privater neuer Fall +`evidence-qualification-b245fc45-1f03-417d-9275-31f26a22451e`,190 eingefrorene +Inputs, Manifest-SHA256 +`60bab3aeaa3ff65f6046af73645c2bc6736ff946bb88d579622c24aa9ca4c6a5`. +Codecquelle SHA256 +`38009d0393c64d3c9b8db6154210e02cbf349d1a67b25ef2cc58c05f926b2346`, +Windowsmodul SHA256 +`3a0b5985884f74b9ef910af5586fc62ba4d4194ef82483e23d7c220501f478ee`. + +Tatsächlich ausschließlich lokal bestanden: + +- Linux-Release-Link beider Libtestexes; Codec vollständig6 Tests,6PASS, + einschließlich der4 bestehenden Completionregressionen und2 neuen Guards. +- Windows-Linuxlib vollständig15 Namen geprüft; ausschließlich geänderten + Prozessfencetest ausgeführt:1PASS,14 andere ausdrücklich gefiltert. +- Codec-Alltargets-Clippy und Windows-GNU-Alltargets-Clippy mit + `system-helper`, jeweils `-D warnings`, sowie Formatcheck beider Ownerdateien. + +Die Linuxcodec-Testexe hat1543576Bytes/SHA256 +`0eb40face421325822887b2104fe82bd4050621e9c792e1b1d5751547e77208b`; +die Windows-Linuxlib-Testexe4043056Bytes/SHA256 +`f5ee6564fff8abbc0e13eb043060e24bdaa474c6dbbddaffe5b2c3b911783cf4`. +Dies sind vorbereitete Linux-first-Artefakte. Keine native Cloud-Linux- +Ausführung, Windowsausführung oder Rollenqualifikation wurde durch diesen +Worker in diesem Schritt durchgeführt. Die zuvor eingefrorenen Runner und +der Serverquellenpack des Checkpoints2dfd791 bleiben bytegleich erhalten; +sie werden nicht nachträglich auf diesen neuen Quellenstand umgedeutet. + +## Nachtrag: beobachtete Kontextfehler fencen alle Objekte + +Der unabhängige Review fand einen konkreten Wiederherstellungsfall: Ein Fehler +von `begin` beim Nachprüfen geschützter Dateien gab zuvor lediglich `Err` +zurück. Nach kurzfristiger Wiederherstellung des alten Kontexts konnte alte +Evidence innerhalb ihrer Restfrist erneut verwendbar werden. Der zentrale +private `recheck` fencet jetzt bei jedem tatsächlich beobachteten Rollen-/Image-/ +Datei-/Konfigurationsfehler die eigene Evidence, Pendingnonce und den eigenen +Verifier sowie **unbedingt** die gemeinsame Prozess-Globalepoche. Dies gilt +auch ohne eigenen Pendingowner und somit für alte Evidence anderer Objekte. +`open`, `begin`, `complete` und `with_current_comparison` benutzen dieselbe +Prüfung. Gleichgenerationige Wiederherstellung löscht diesen Befund nicht; +erst ein frischer erfolgreicher Vergleich kann wieder neue Evidence liefern. + +Gewöhnlicher Evidenzablauf löscht weiterhin ausschließlich die alte Evidence +und bewahrt die nächste offene Refreshnonce. Normales `close`/Drop behält die +bisherige konditionale Besitzer-/Epochprüfung und fencet nicht blind eine +neuere andere Connection. Kein neuer Provisionszwang, kein Wire-/Codecwechsel. + +Neuer eigener190-Input-Fall +`context-fence-qualification-4d884851-d24b-42e6-82b2-956da3c6a980`, +Inputmanifest SHA256 +`4363d357c01803f381939de28d287eaf323f2701f5e7064bb479833ccc0c0475`, +Modul SHA256 +`7132b914de701a3ed5c35f265dbf7aa8bb4e0621dbc597eb3225165aa7231683`. +Der gemeinsame Codec bleibt bytegleich bei SHA38009d0393c64d3c9b8db6154210e02cbf349d1a67b25ef2cc58c05f926b2346; +die frühere6er-Codecprüfung wurde deshalb nicht unnötig wiederholt. + +Tatsächlich lokal: Release-Testbinary gelinkt, vollständige15er-Liste geprüft, +nur den geänderten Prozessfencetest ausgeführt:1PASS/14filtered. Die Statefolge +prüft jetzt ausdrücklich zwei alte Objekt-Epochen nach einem beobachteten +Kontextfehler ohne offene Nonce, deren Ablehnung nach SameGen-Restore sowie +eine neue zulässige Challenge. Windows-GNU-Alltargets-Clippy mit system-helper/ +`-D warnings` und Modulformatcheck PASS. Testexe4043200Bytes/SHA256 +`89f17cc6ae861f12adb251676b6b5deec664b41979e655dbab79ef1dac19e69d`. +Dies ist ein enger lokaler Delta-/Statemodellnachweis, kein nativer Windows- +Dateirestore- oder Rollenversuch. Alte Receipts/Artefakte bleiben unverändert; +ihre Dokumentfassung wurde als eigener historischer Beleg erhalten. Keine +Zielaktion, neue Clockbereitschaft oder Jobwirkung wurde aktiviert. + +## Nachtrag: Konstruktor erkennt Fork/Rollback ebenfalls prozessweit + +Der weitere unabhängige Review fand denselben Restorefall vor dem abschließenden +`recheck` eines neuen Objekts: `accept_configuration` verweigerte einen positiven +Rollback-/SameGenfork-Befund, ließ dabei aber alte Objekt-Epochen bestehen. +Jetzt invalidiert dieser konkrete Fehlerzweig die gemeinsame Epoche vor dem +Fehlerreturn und übernimmt ausdrücklich keinen neuen Konfigurationshead. +Wiederherstellung des bisherigen Heads heilt keine alte Evidence; eine frische +postErrorChallenge ist weiterhin möglich. Die vorherige zentrale Recheck- +Korrektur allein wurde deshalb nicht als vollständige Invariante übernommen. + +Neuer190-Input-Fall +`config-fence-qualification-304d0520-9882-4ed4-b9e0-634996c07dc6`, Manifest +`b0f317cb59aed20e2faa9cfeef38cc55fceb4bc00faac723bc9ab5bd8d60b87f`, +Modul SHA256 +`9cc43960531a7fbd9899f88eeda4400c04a87a756a188c062bc1865fafd5bc50`. +Einzige geänderte Compilerquelle gegenüber dem vorigen190er-Fall ist das +Windowsmodul; Codec/Wire bleiben bytegleich. Der bestehende Fencetest prüft +Rollback und Fork, Ablehnung alter Epochen auch nach Restore sowie den +unverändert gehaltenen echten Konfigurationshead. Lokal nach Release-Link und +vollständiger15er-Liste:1PASS/14filtered; GNU-Alltargets-Clippy mit system-helper/ +`-D warnings` und Formatcheck PASS. Testexe4046032Bytes/SHA256 +`b390ee90332671a68ab401e713691e3b4072db1ec83b2cff9a6e4dbbe524ec42`. +Der unabhängige enge Source-Re-review meldete für diesen Fehlerzweig PASS. +Keine native Windows-Restore-Abnahme, kein Gate-/Runtimeanschluss und keine +Zielaktion durch diesen Deltaquellstand. Alle bisherigen Fälle bleiben historisch. + +## Tatsächlicher Linux-first-Nachweis des finalen Kontextfences + +2026-11-15: Originalfall `1e179c84-041c-4c49-b730-3a688a495aec` auf +der Cloud-Linux-VM. Vollständige15er-Testliste geprüft; ausschließlich der +geänderte Prozessfencetest lief:1 bestanden,14 ausdrücklich gefiltert, +0 ignoriert. Separater Originalfall-Rückabruf vollständig; bekannte +RMM-Datei-/Prozess-/Dienstzeugen unverändert. Der Test prüft das native +Statemodell, keine Windows-Dateiwiederherstellung oder Windows-Kerneluhr. + +Operator `deploy/windows_context_fence_linux_acceptance.py`, SHA256 +`ec469733415f3cfe5804b507c4cb50911e6f2afdd93bc5bb19c6cbed1cedec4d`. +Originale lokale Qualificationreceipt +`f25dae5d8f9fea185a298014a087424c8b2207dfe15cfe86de38d0773fae9ef4`, +190-Inputmanifest +`b0f317cb59aed20e2faa9cfeef38cc55fceb4bc00faac723bc9ab5bd8d60b87f`. +Genau deren Testartefakt4046032Bytes wurde ausgeführt, SHA256 +`b390ee90332671a68ab401e713691e3b4072db1ec83b2cff9a6e4dbbe524ec42`. +Der Quellenreview bestätigte beide tatsächlichen Kontextfehlerpfade: zentralen +Recheck und Konstruktor-Fork/Rollback, jeweils prozessweite Invalidierung. +Die Codecquelle38009d bleibt bytegleich; ihre sechs Prüfungen liefen separat +im [nativen Codecfall44514778](signed-time-contract-results.md). + +Keine Windowszeitqualität, Calibration, Runtimeintegration oder Jobfreigabe +wird daraus abgeleitet. Eigene gestoppte Windows-Messfixture aus dem partiellen +Setup bleibt separat dokumentiert und wird nicht durch diesen Linuxlauf geheilt. + +Ausführungsreceipt-SHA256 `683935f353110da72178b0da703a33dcd87e48fa3f7a9bec2340a90ce9bcba3c`. + +Separater Rückabruf-SHA256 `0cb31b157ef4c0c55774280529bb27a634ffb945c875508d29896090ec144930`.