Compare commits
114
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
78e503eaf1 | ||
|
|
326f6483fe | ||
|
|
45ab784c1b | ||
|
|
7a64002f74 | ||
|
|
bddfb26e67 | ||
|
|
00ecbb58ac | ||
|
|
ba43aee4a9 | ||
|
|
92b50f25e3 | ||
|
|
cd0257fbe9 | ||
|
|
bd0a426019 | ||
|
|
eb3fa560d6 | ||
|
|
cf2c1a632b | ||
|
|
45ce622370 | ||
|
|
fcec400ec6 | ||
|
|
dffdd401c5 | ||
|
|
97d4f86940 | ||
|
|
6fb973a247 | ||
|
|
e32f6330a0 | ||
|
|
c41c8c7286 | ||
|
|
0902a44671 | ||
|
|
e7cf1aed73 | ||
|
|
b614b6f5be | ||
|
|
242641de72 | ||
|
|
454e08f942 | ||
|
|
38e6df51ea | ||
|
|
5adf209f1e | ||
|
|
48662f97e3 | ||
|
|
16c9c3cefe | ||
|
|
07c5b0e12d | ||
|
|
c46873ff95 | ||
|
|
1a502a1c46 | ||
|
|
715287a559 | ||
|
|
a5ec061a92 | ||
|
|
9a6599fddd | ||
|
|
f023d790a4 | ||
|
|
5f21b753ed | ||
|
|
0b32859d74 | ||
|
|
331cdddac5 | ||
|
|
e952698f5e | ||
|
|
00717e4283 | ||
|
|
aa36b178aa | ||
|
|
d37160ba41 | ||
|
|
577132fb42 | ||
|
|
ca588abce4 | ||
|
|
53d17757ab | ||
|
|
27bb6a1257 | ||
|
|
cd80745d44 | ||
|
|
81d78aaf8f | ||
|
|
0ecfb98204 | ||
|
|
cd44bdb735 | ||
|
|
b0076d14be | ||
|
|
e46f11d3f9 | ||
|
|
895d107918 | ||
|
|
b5c7292f45 | ||
|
|
abdf392f31 | ||
|
|
1c1685bb40 | ||
|
|
2812bdaf27 | ||
|
|
54db5b72a3 | ||
|
|
03e5964474 | ||
|
|
5d3141f1df | ||
|
|
4ba243998c | ||
|
|
7c643b0eeb | ||
|
|
d3cd373d5e | ||
|
|
b47677b3a5 | ||
|
|
0c970dc6c0 | ||
|
|
99aedc14b1 | ||
|
|
4c6874a92b | ||
|
|
f6ebd02308 | ||
|
|
b5425fc152 | ||
|
|
8d1e6c99d7 | ||
|
|
cdcdb36c13 | ||
|
|
2f9e45302a | ||
|
|
3ec30d373d | ||
|
|
43e696ff3f | ||
|
|
16eb5f86cf | ||
|
|
4e55e04b97 | ||
|
|
8bee0ad5e6 | ||
|
|
7f4066b337 | ||
|
|
725cddd5b2 | ||
|
|
44f65c205b | ||
|
|
ef509b3eb2 | ||
|
|
0ef1959c07 | ||
|
|
d9c1311332 | ||
|
|
64214fc41a | ||
|
|
95bcd201fc | ||
|
|
786efe65be | ||
|
|
be2b0e36d7 | ||
|
|
cc821246cc | ||
|
|
e6debe5ba6 | ||
|
|
456734000b | ||
|
|
6e30a2a1fa | ||
|
|
656102bd25 | ||
|
|
94b912df8d | ||
|
|
480e261c0c | ||
|
|
330e3413fb | ||
|
|
332c12d70e | ||
|
|
1934e88896 | ||
|
|
1d2b33791c | ||
|
|
738470b33f | ||
|
|
098f32e24f | ||
|
|
2d16d329a0 | ||
|
|
495b6984e8 | ||
|
|
f8deca4f2c | ||
|
|
8d7915df59 | ||
|
|
d8b376f34b | ||
|
|
8212a85a9c | ||
|
|
27074e26fb | ||
|
|
497659f369 | ||
|
|
a713ea902a | ||
|
|
71b67c80a1 | ||
|
|
6ab067b156 | ||
|
|
688a3cf81a | ||
|
|
c1d8eea6b8 | ||
|
|
2e77f296cb |
Generated
+1
@@ -2191,6 +2191,7 @@ dependencies = [
|
||||
"rmm-domain",
|
||||
"rmm-privileged-helper",
|
||||
"rmm-protocol",
|
||||
"rmm-updater",
|
||||
"rmm-updater-handoff",
|
||||
"rusqlite",
|
||||
"rustls",
|
||||
|
||||
@@ -1,10 +1,11 @@
|
||||
# Rust Discovery / RMM
|
||||
|
||||
Aktueller Entwicklungsstand: **Linux-MVP M0–M5 im begrenzten dev/test-Umfang abgeschlossen**,
|
||||
Spezifikation 1.15, 2026-11-13. Der endgültige Server ist
|
||||
`discovery.ease-technologies.de`. Der Linux-Client läuft ausschließlich auf der
|
||||
Ubuntu-Cloud-VM; das Notebook dient ausschließlich der Entwicklung. Die
|
||||
Windows-11-Test-VM ist ein eigener Gast und darf parallel entwickelt werden.
|
||||
**Stand 15. November 2026, Spezifikation 1.23.** Linux M0–M5 ist auf der
|
||||
Ubuntu-Cloud-VM im dev/test-Betrieb abgenommen. Der zusätzliche Auftrag umfasst
|
||||
die Windows-11-VM, die genehmigte Skriptkonsole und den Agent-Selbstupdater.
|
||||
Beide aktiven Geräte melden sich an `discovery.ease-technologies.de` und sind
|
||||
über MCP mit gespeicherten Inventardaten abrufbar. Das Notebook dient der
|
||||
Entwicklung. [Abgleich der Geräte nach dem Gatewaywechsel](docs/server-time-gateway-deploy.md)
|
||||
|
||||
## Tatsächlich nachgewiesen
|
||||
|
||||
@@ -86,14 +87,17 @@ Kontrolle vor und nach den Ablehnungen. Das sind keine LocalService-
|
||||
TLS-Negativnachweise. Der permanente Dienst und seine Geräteidentität blieben
|
||||
erhalten; private Schlüssel verließen die VM nicht.
|
||||
|
||||
Windows meldet weiterhin keine Jobcapability und hat keinen Jobexecutor.
|
||||
Vertrauenswürdige Uhr, gemeinsamer signierter Sync-/Journal-/Einmalverbrauchskern
|
||||
sowie plattformgebundene Interpreterpläne in Domain, Server und WebUI sind vor
|
||||
dem ersten Windowsjob offen. Entwicklungsbuilds sind unsigniert;
|
||||
Rotation, Widerruf, privilegierter Helper, Paketaktionen und Windows-Reboot
|
||||
sind noch nicht abgenommen. Die [Windows-Gates](docs/windows-gates.md) und
|
||||
[Grenze vor dem ersten Job](docs/windows-job-boundary.md) führen den nächsten
|
||||
Umfang. Weitere Agentplattformen, PVE/PBS/Cluster/Backups und Betriebsreife
|
||||
Auf Windows laufen der passive Agent und der getrennte SYSTEM-Helper. Die
|
||||
beiderseitige Identitätsprüfung zwischen den Diensten ist nativ belegt. Der
|
||||
PowerShell-Executor und die Bindung an den genehmigten Plan sind implementiert.
|
||||
Für die erste durchgängige Abnahme fehlen der unabhängige signierte Zeitabgleich
|
||||
der beiden laufenden Rollen sowie ein WebUI-genehmigter Auftrag mit überprüfter
|
||||
Ausgabe. Selbstupdates benötigen noch eine native Aktualisierung des installierten
|
||||
Agent-/Helper-Paars unter Erhalt der Geräteidentität. APT- und MSI-Paketfälle
|
||||
prüfen die Verwaltung anderer Software. [Windows-Abnahmen](docs/windows-gates.md)
|
||||
und [Agent-Selbstupdate](docs/agent-updater-runtime-source.md).
|
||||
|
||||
Weitere Agentplattformen, PVE/PBS/Cluster/Backups und Betriebsreife
|
||||
folgen außerhalb des Linux-MVP. RustDesk ist ausdrücklich ausgelassen.
|
||||
|
||||
## Projektunterlagen
|
||||
|
||||
@@ -53,7 +53,7 @@ impl Client {
|
||||
ipc::service_sid(crate::SERVICE_NAME)?,
|
||||
ipc::service_sid(ipc::HELPER_SERVICE)?,
|
||||
];
|
||||
let _root = ipc::PinnedFile::open(Path::new(PUBLIC_ROOT), true, &readers, &[], false)?;
|
||||
let _root = ipc::PinnedFile::open_read_shared(Path::new(PUBLIC_ROOT), true, &readers, &[])?;
|
||||
let mut file = ipc::PinnedFile::open(Path::new(PIN_PATH), false, &readers, &[], false)?;
|
||||
ensure!(file.file.metadata()?.len() <= 16384, "HELPER_PIN_SIZE");
|
||||
let mut bytes = Vec::new();
|
||||
@@ -785,8 +785,38 @@ pub(crate) fn msi_test_job() -> JobPayload {
|
||||
}
|
||||
}
|
||||
fn write_current_probe(state: &Path, value: &serde_json::Value) -> Result<()> {
|
||||
write_report(state, PROBE_FILE, ".helper-probe.pending", value)
|
||||
}
|
||||
|
||||
/// A historical observation by the agent. The helper lane calls this only after
|
||||
/// the authenticated peer has acknowledged its own signature verification.
|
||||
pub fn record_verified_time(
|
||||
state: &Path,
|
||||
request: &rmm_time_attestation::Request,
|
||||
response_sha256: &str,
|
||||
observed_at: chrono::DateTime<chrono::Utc>,
|
||||
) -> Result<()> {
|
||||
use sha2::{Digest, Sha256};
|
||||
let (filename, pending) = match request.context.role {
|
||||
rmm_time_attestation::Role::Agent => ("agent-time-sample.json", ".agent-time.pending"),
|
||||
rmm_time_attestation::Role::SystemHelper => {
|
||||
("helper-time-sample.json", ".helper-time.pending")
|
||||
}
|
||||
};
|
||||
let value = json!({
|
||||
"schema_version": 1, "agent_pid": std::process::id(), "observed_at": observed_at,
|
||||
"role": request.context.role, "windows_boot_id": request.context.windows_boot_id,
|
||||
"connection_generation": request.context.connection_generation,
|
||||
"verifier_incarnation": request.context.verifier_incarnation,
|
||||
"request_sha256": format!("{:x}", Sha256::digest(serde_json::to_vec(request)?)),
|
||||
"response_sha256": response_sha256
|
||||
});
|
||||
write_report(state, filename, pending, &value)
|
||||
}
|
||||
|
||||
fn write_report(state: &Path, name: &str, pending: &str, value: &serde_json::Value) -> Result<()> {
|
||||
native::private_path(state, true)?;
|
||||
let path = state.join(PROBE_FILE);
|
||||
let path = state.join(name);
|
||||
if path.try_exists()? {
|
||||
native::private_path(&path, false)?;
|
||||
}
|
||||
@@ -794,7 +824,7 @@ fn write_current_probe(state: &Path, value: &serde_json::Value) -> Result<()> {
|
||||
ensure!(bytes.len() <= 8192, "HELPER_PROBE_REPORT_LIMIT");
|
||||
// One fixed create-only staging file bounds even interrupted-report state.
|
||||
// A leftover from a killed process is refused; it is never overwritten.
|
||||
let temporary = state.join(".helper-probe.pending");
|
||||
let temporary = state.join(pending);
|
||||
let mut file = std::fs::OpenOptions::new()
|
||||
.write(true)
|
||||
.create_new(true)
|
||||
|
||||
@@ -216,7 +216,9 @@ pub fn read_settings() -> Result<(Settings, Vec<PinnedFile>)> {
|
||||
let agent = ipc::service_sid(crate::SERVICE_NAME)?;
|
||||
let helper = ipc::service_sid(ipc::HELPER_SERVICE)?;
|
||||
let readers = vec![agent, helper];
|
||||
let root = PinnedFile::open(Path::new(PUBLIC_ROOT), true, &readers, &[], false)?;
|
||||
// A rename into PUBLIC_ROOT opens the directory with FILE_ADD_FILE.
|
||||
// The handle stays read-only and denies deletion of the pinned directory.
|
||||
let root = PinnedFile::open_read_shared(Path::new(PUBLIC_ROOT), true, &readers, &[])?;
|
||||
let mut file = PinnedFile::open(Path::new(CONFIG_PATH), false, &readers, &[], false)?;
|
||||
ensure!(file.file.metadata()?.len() <= 32768, "SYSTEM_CONFIG_SIZE");
|
||||
use std::io::Read;
|
||||
|
||||
@@ -39,6 +39,51 @@ struct Config {
|
||||
// Explicit protected opt-in only; this flag never qualifies a clock or pins.
|
||||
#[serde(default)]
|
||||
enable_jobs: bool,
|
||||
#[serde(
|
||||
default,
|
||||
deserialize_with = "rmm_domain::jobs::deserialize_windows_execution_profile"
|
||||
)]
|
||||
windows_execution_profile: Option<rmm_domain::jobs::WindowsExecutionProfile>,
|
||||
}
|
||||
impl Config {
|
||||
fn profile_enabled(&self, profile: rmm_domain::jobs::WindowsExecutionProfile) -> bool {
|
||||
self.enable_jobs
|
||||
&& self.job_binding_file.is_some()
|
||||
&& cfg!(feature = "system-helper")
|
||||
&& self.windows_execution_profile == Some(profile)
|
||||
}
|
||||
fn read(path: &Path) -> Result<Self> {
|
||||
let raw = protected_read(path, 32768)?;
|
||||
let config: Self = serde_json::from_slice(&raw)?;
|
||||
if let Some(profile) = config.windows_execution_profile {
|
||||
ensure!(
|
||||
config.profile_enabled(profile),
|
||||
"WINDOWS_PROFILE_REQUIRES_JOB_CONFIGURATION"
|
||||
);
|
||||
#[cfg(feature = "system-helper")]
|
||||
{
|
||||
use rmm_agent_windows::helper_ipc::PinnedFile;
|
||||
use std::io::Read;
|
||||
// Verify the exact bytes used for the opt-in under the existing
|
||||
// administrator-owned, service-read-only file and directory ACLs.
|
||||
let readers = [native::service_sid()?];
|
||||
let mut parent = PinnedFile::open(
|
||||
path.parent().context("CONFIG_PARENT")?,
|
||||
true,
|
||||
&readers,
|
||||
&[],
|
||||
false,
|
||||
)?;
|
||||
let mut pin = PinnedFile::open(path, false, &readers, &[], false)?;
|
||||
let mut verified = Vec::new();
|
||||
(&mut pin.file).take(32769).read_to_end(&mut verified)?;
|
||||
ensure!(verified == raw, "WINDOWS_PROFILE_CONFIGURATION_CHANGED");
|
||||
pin.check()?;
|
||||
parent.check()?;
|
||||
}
|
||||
}
|
||||
Ok(config)
|
||||
}
|
||||
}
|
||||
fn create_private(path: &Path, bytes: &[u8]) -> Result<()> {
|
||||
use std::io::Write;
|
||||
@@ -177,6 +222,7 @@ struct TimeRefresh {
|
||||
clock: rmm_agent_windows::signed_clock::RuntimeClock,
|
||||
helper: Option<rmm_agent_windows::helper_runtime::Client>,
|
||||
tasks: Vec<tokio::task::JoinHandle<()>>,
|
||||
samples: Vec<Arc<std::sync::OnceLock<VerifiedTimeSample>>>,
|
||||
}
|
||||
#[cfg(feature = "system-helper")]
|
||||
impl Drop for TimeRefresh {
|
||||
@@ -189,6 +235,30 @@ impl Drop for TimeRefresh {
|
||||
}
|
||||
}
|
||||
#[cfg(feature = "system-helper")]
|
||||
struct VerifiedTimeSample {
|
||||
request: rmm_time_attestation::Request,
|
||||
response_hash: String,
|
||||
observed_at: chrono::DateTime<Utc>,
|
||||
}
|
||||
#[cfg(feature = "system-helper")]
|
||||
impl VerifiedTimeSample {
|
||||
fn new(request: rmm_time_attestation::Request, response_hash: String) -> Self {
|
||||
Self {
|
||||
request,
|
||||
response_hash,
|
||||
observed_at: Utc::now(),
|
||||
}
|
||||
}
|
||||
fn persist(&self, state: &Path) -> Result<()> {
|
||||
rmm_agent_windows::helper_runtime::record_verified_time(
|
||||
state,
|
||||
&self.request,
|
||||
&self.response_hash,
|
||||
self.observed_at,
|
||||
)
|
||||
}
|
||||
}
|
||||
#[cfg(feature = "system-helper")]
|
||||
async fn time_response(
|
||||
client: &reqwest::Client,
|
||||
address: std::net::SocketAddr,
|
||||
@@ -458,9 +528,13 @@ impl Agent {
|
||||
identity: &crate::certificate_rotation::DeviceIdentity,
|
||||
) -> Result<()> {
|
||||
ensure!(self.time_refresh.is_none(), "TIME_REFRESH_ALREADY_RUNNING");
|
||||
if !self.config.enable_jobs {
|
||||
use rmm_agent_windows::signed_clock::{CONFIG_PATH, SamplingMode};
|
||||
// Presence opts into sampling only. Each role opens and verifies the
|
||||
// protected profile and signed response itself before accepting time.
|
||||
let Some(mode) = SamplingMode::configured(self.config.enable_jobs, Path::new(CONFIG_PATH))?
|
||||
else {
|
||||
return Ok(());
|
||||
}
|
||||
};
|
||||
let client = crate::https_channel::mtls_client(
|
||||
self.config.connect_address,
|
||||
&self.ca,
|
||||
@@ -480,6 +554,17 @@ impl Agent {
|
||||
let own_stop = stop.clone();
|
||||
let own_http = client.clone();
|
||||
let address = self.config.connect_address;
|
||||
// Only the connection owner publishes observations. Dropping it also
|
||||
// discards unfinished samples, so an old worker cannot overwrite a newer report.
|
||||
let sample_slot =
|
||||
|| (mode == SamplingMode::Passive).then(|| Arc::new(std::sync::OnceLock::new()));
|
||||
let own_receipt = sample_slot();
|
||||
let helper_receipt = helper.as_ref().and_then(|_| sample_slot());
|
||||
let samples = own_receipt
|
||||
.iter()
|
||||
.chain(helper_receipt.iter())
|
||||
.cloned()
|
||||
.collect();
|
||||
tasks.push(tokio::spawn(async move {
|
||||
while !own_stop.load(Ordering::SeqCst) {
|
||||
let result = async {
|
||||
@@ -489,18 +574,18 @@ impl Agent {
|
||||
let request = own_clock.begin(generation)?;
|
||||
let bytes = time_response(&own_http, address, &request).await?;
|
||||
ensure!(!own_stop.load(Ordering::SeqCst), "TIME_CONNECTION_CLOSED");
|
||||
own_clock.complete(generation, &bytes)
|
||||
own_clock.complete(generation, &bytes)?;
|
||||
if let Some(slot) = own_receipt.as_ref().filter(|s| s.get().is_none()) {
|
||||
let hash = format!("{:x}", Sha256::digest(&bytes));
|
||||
let _ = slot.set(VerifiedTimeSample::new(request, hash));
|
||||
}
|
||||
Ok::<(), anyhow::Error>(())
|
||||
}
|
||||
.await;
|
||||
if result.is_err() {
|
||||
let _ = own_clock.close_generation(generation);
|
||||
}
|
||||
tokio::time::sleep(if result.is_ok() {
|
||||
Duration::from_millis(20)
|
||||
} else {
|
||||
Duration::from_millis(500)
|
||||
})
|
||||
.await;
|
||||
tokio::time::sleep(mode.interval(result.is_ok())).await;
|
||||
}
|
||||
let _ = own_clock.close_generation(generation);
|
||||
}));
|
||||
@@ -515,18 +600,20 @@ impl Agent {
|
||||
!helper_stop.load(Ordering::SeqCst),
|
||||
"TIME_CONNECTION_CLOSED"
|
||||
);
|
||||
time_helper.time_complete(generation, bytes).await
|
||||
let pending = helper_receipt.as_ref().filter(|s| s.get().is_none());
|
||||
let report =
|
||||
pending.map(|slot| (slot, format!("{:x}", Sha256::digest(&bytes))));
|
||||
time_helper.time_complete(generation, bytes).await?;
|
||||
if let Some((slot, hash)) = report {
|
||||
let _ = slot.set(VerifiedTimeSample::new(request, hash));
|
||||
}
|
||||
Ok::<(), anyhow::Error>(())
|
||||
}
|
||||
.await;
|
||||
if result.is_err() {
|
||||
let _ = time_helper.time_close(generation).await;
|
||||
}
|
||||
tokio::time::sleep(if result.is_ok() {
|
||||
Duration::from_millis(20)
|
||||
} else {
|
||||
Duration::from_millis(500)
|
||||
})
|
||||
.await;
|
||||
tokio::time::sleep(mode.interval(result.is_ok())).await;
|
||||
}
|
||||
let _ = time_helper.time_close(generation).await;
|
||||
}));
|
||||
@@ -537,6 +624,7 @@ impl Agent {
|
||||
clock,
|
||||
helper,
|
||||
tasks,
|
||||
samples,
|
||||
});
|
||||
Ok(())
|
||||
}
|
||||
@@ -787,6 +875,13 @@ impl Agent {
|
||||
return false;
|
||||
}
|
||||
if rmm_agent_windows::actions::supported(job) {
|
||||
if let rmm_domain::jobs::Action::RunScript {
|
||||
windows_execution_profile: Some(profile),
|
||||
..
|
||||
} = &job.action
|
||||
{
|
||||
return self.binding.is_some() && self.config.profile_enabled(*profile);
|
||||
}
|
||||
return true;
|
||||
}
|
||||
#[cfg(feature = "system-helper")]
|
||||
@@ -816,9 +911,12 @@ impl Agent {
|
||||
{
|
||||
caps.extend(["rmm.sync.v1", "refresh_inventory"].map(str::to_string));
|
||||
if rmm_agent_windows::actions::powershell().is_ok() {
|
||||
// The process_remote_signed profile is implemented but remains
|
||||
// unpublished until its separate native qualification passes.
|
||||
caps.extend(["run_script", "script.powershell/1"].map(str::to_string));
|
||||
if self.config.profile_enabled(
|
||||
rmm_domain::jobs::WindowsExecutionProfile::PowerShell51RemoteSigned,
|
||||
) {
|
||||
caps.push(rmm_agent_windows::actions::REMOTE_SIGNED_PROFILE_CAPABILITY.into());
|
||||
}
|
||||
}
|
||||
}
|
||||
caps
|
||||
@@ -1554,7 +1652,9 @@ impl Agent {
|
||||
);
|
||||
self.clock = self.clock.for_generation(generation);
|
||||
#[cfg(feature = "system-helper")]
|
||||
self.start_time_refresh(generation, &identity)?;
|
||||
if self.config.enable_jobs {
|
||||
self.start_time_refresh(generation, &identity)?;
|
||||
}
|
||||
self.queue_inventory(generation)?;
|
||||
self.queue_update_observation(generation)?;
|
||||
self.replay(&channel, generation).await?;
|
||||
@@ -1673,6 +1773,15 @@ impl Agent {
|
||||
}
|
||||
}
|
||||
if heartbeat.elapsed() >= heartbeat_after {
|
||||
#[cfg(feature = "system-helper")]
|
||||
if !self.config.enable_jobs
|
||||
&& self.time_refresh.is_none()
|
||||
&& self.start_time_refresh(generation, &identity).is_err()
|
||||
{
|
||||
// An absent or unreadable profile must never take passive
|
||||
// inventory offline. Retry setup at the next heartbeat.
|
||||
eprintln!("PASSIVE_SIGNED_TIME_UNAVAILABLE");
|
||||
}
|
||||
let payload = Payload::Heartbeat(Heartbeat {
|
||||
instance_id: self.instance.clone(),
|
||||
uptime_seconds: self.started.elapsed().as_secs(),
|
||||
@@ -1689,6 +1798,14 @@ impl Agent {
|
||||
)?;
|
||||
channel.poll(poll).await?;
|
||||
}
|
||||
#[cfg(feature = "system-helper")]
|
||||
if let Some(refresh) = &mut self.time_refresh {
|
||||
let state = &self.config.state_directory;
|
||||
refresh.samples.retain(|slot| {
|
||||
slot.get()
|
||||
.is_none_or(|sample| sample.persist(state).is_err())
|
||||
});
|
||||
}
|
||||
heartbeat = Instant::now();
|
||||
heartbeat_after = Duration::from_millis(rand::random_range(27000..33000));
|
||||
}
|
||||
@@ -1748,7 +1865,7 @@ fn service_run(stop: &'static AtomicBool) -> Result<()> {
|
||||
);
|
||||
let path = Path::new(&arguments[2]);
|
||||
ensure!(path.is_absolute(), "ABSOLUTE_CONFIG_REQUIRED");
|
||||
let config: Config = serde_json::from_slice(&protected_read(path, 32768)?)?;
|
||||
let config = Config::read(path)?;
|
||||
native::require_local_service()?;
|
||||
ensure!(
|
||||
config.state_directory.is_absolute(),
|
||||
@@ -1889,7 +2006,7 @@ pub fn main() -> Result<()> {
|
||||
args.len() == 3 && args[1] == "--config",
|
||||
"SERVICE_ARGUMENTS"
|
||||
);
|
||||
let config: Config = serde_json::from_slice(&protected_read(Path::new(&args[2]), 32768)?)?;
|
||||
let config = Config::read(Path::new(&args[2]))?;
|
||||
// Shared transport reads its one DNS identity. Set it before SCM dispatch
|
||||
// creates its service thread and before any Tokio/collector threads exist.
|
||||
unsafe {
|
||||
@@ -1991,15 +2108,58 @@ mod tests {
|
||||
}
|
||||
#[test]
|
||||
fn old_passive_configuration_cannot_enable_jobs_or_read_the_clock() {
|
||||
let config:Config=serde_json::from_value(serde_json::json!({"server_name":"example.invalid","connect_address":"127.0.0.1:443","ca_file":"C:/fixture/ca.pem","state_directory":"C:/fixture/state","enrollment_token_file":"C:/fixture/token","transport":"auto"})).unwrap();
|
||||
let config: Config = serde_json::from_value(passive_test_config()).unwrap();
|
||||
assert!(!config.enable_jobs);
|
||||
assert!(config.job_binding_file.is_none());
|
||||
assert!(config.windows_execution_profile.is_none());
|
||||
let clock = JobClock::new(config.enable_jobs);
|
||||
assert_eq!(
|
||||
clock.now().unwrap_err().to_string(),
|
||||
"WINDOWS_JOBS_NOT_ENABLED"
|
||||
);
|
||||
}
|
||||
fn passive_test_config() -> serde_json::Value {
|
||||
serde_json::json!({
|
||||
"server_name":"example.invalid","connect_address":"127.0.0.1:443",
|
||||
"ca_file":"C:/fixture/ca.pem","state_directory":"C:/fixture/state",
|
||||
"enrollment_token_file":"C:/fixture/token","transport":"auto"
|
||||
})
|
||||
}
|
||||
#[test]
|
||||
fn remote_signed_requires_explicit_profile_jobs_and_binding() {
|
||||
let profile = rmm_domain::jobs::WindowsExecutionProfile::PowerShell51RemoteSigned;
|
||||
let mut config: Config = serde_json::from_value(passive_test_config()).unwrap();
|
||||
config.enable_jobs = true;
|
||||
config.job_binding_file = Some("C:/fixture/binding.json".into());
|
||||
assert!(!config.profile_enabled(profile));
|
||||
config.windows_execution_profile = Some(profile);
|
||||
assert_eq!(
|
||||
config.profile_enabled(profile),
|
||||
cfg!(feature = "system-helper")
|
||||
);
|
||||
config.enable_jobs = false;
|
||||
assert!(!config.profile_enabled(profile));
|
||||
config.enable_jobs = true;
|
||||
config.job_binding_file = None;
|
||||
assert!(!config.profile_enabled(profile));
|
||||
|
||||
let mut value = passive_test_config();
|
||||
value["windows_execution_profile"] = serde_json::json!("powershell_51_remote_signed");
|
||||
assert_eq!(
|
||||
serde_json::from_value::<Config>(value.clone())
|
||||
.unwrap()
|
||||
.windows_execution_profile,
|
||||
Some(profile)
|
||||
);
|
||||
for invalid in [
|
||||
serde_json::Value::Null,
|
||||
serde_json::json!(true),
|
||||
serde_json::json!("Bypass"),
|
||||
] {
|
||||
value["windows_execution_profile"] = invalid;
|
||||
assert!(serde_json::from_value::<Config>(value.clone()).is_err());
|
||||
}
|
||||
}
|
||||
#[test]
|
||||
fn legacy_inventory_keeps_original_bytes_until_concrete_core_ack() {
|
||||
let directory =
|
||||
|
||||
@@ -10,6 +10,29 @@ use uuid::Uuid;
|
||||
const SECOND_NS: u64 = 1_000_000_000;
|
||||
const MAX_BASE_ERROR_NS: u64 = 10_000_000;
|
||||
|
||||
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
|
||||
pub enum SamplingMode {
|
||||
Passive,
|
||||
Jobs,
|
||||
}
|
||||
impl SamplingMode {
|
||||
pub fn configured(jobs: bool, profile: &std::path::Path) -> std::io::Result<Option<Self>> {
|
||||
if jobs {
|
||||
return Ok(Some(Self::Jobs));
|
||||
}
|
||||
Ok(profile.try_exists()?.then_some(Self::Passive))
|
||||
}
|
||||
|
||||
pub fn interval(self, verified: bool) -> std::time::Duration {
|
||||
use std::time::Duration;
|
||||
match (self, verified) {
|
||||
(Self::Passive, _) => Duration::from_secs(30),
|
||||
(Self::Jobs, true) => Duration::from_millis(20),
|
||||
(Self::Jobs, false) => Duration::from_millis(500),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
fn independent_time_key(time_key_hex: &str, job_key_hex: &str) -> Result<[u8; 32]> {
|
||||
fn decode(value: &str) -> Result<[u8; 32]> {
|
||||
ensure!(
|
||||
@@ -728,12 +751,11 @@ mod installed {
|
||||
settings.agent.service_sid.clone(),
|
||||
settings.helper.service_sid.clone(),
|
||||
];
|
||||
files.push(PinnedFile::open(
|
||||
files.push(PinnedFile::open_read_shared(
|
||||
Path::new(PUBLIC_ROOT),
|
||||
true,
|
||||
&readers,
|
||||
&[],
|
||||
false,
|
||||
)?);
|
||||
let mut config_file =
|
||||
PinnedFile::open(Path::new(CONFIG_PATH), false, &readers, &[], false)?;
|
||||
@@ -1137,6 +1159,30 @@ pub use installed::{BoundClock, CONFIG_PATH, Comparison, RuntimeClock, SignedClo
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn passive_sampling_requires_a_profile_and_uses_heartbeat_cadence() {
|
||||
let dir = std::env::temp_dir().join(Uuid::new_v4().to_string());
|
||||
std::fs::create_dir(&dir).unwrap();
|
||||
let profile = dir.join("time-attestation.json");
|
||||
assert_eq!(SamplingMode::configured(false, &profile).unwrap(), None);
|
||||
assert_eq!(
|
||||
SamplingMode::configured(true, &profile).unwrap(),
|
||||
Some(SamplingMode::Jobs)
|
||||
);
|
||||
std::fs::write(&profile, b"{}").unwrap();
|
||||
assert_eq!(
|
||||
SamplingMode::configured(false, &profile).unwrap(),
|
||||
Some(SamplingMode::Passive)
|
||||
);
|
||||
for verified in [false, true] {
|
||||
assert_eq!(
|
||||
SamplingMode::Passive.interval(verified),
|
||||
std::time::Duration::from_secs(30)
|
||||
);
|
||||
}
|
||||
std::fs::remove_dir_all(dir).unwrap();
|
||||
}
|
||||
fn sample(ns: u64) -> Sample {
|
||||
Sample {
|
||||
wall_utc_ns: 1_800_000_000_000_000_000 + ns as i64,
|
||||
|
||||
@@ -32,3 +32,5 @@ libc = "0.2.177"
|
||||
rmm-updater-handoff = { path = "../updater-handoff" }
|
||||
base64 = "=0.22.1"
|
||||
hex.workspace = true
|
||||
|
||||
rmm-updater = { path = "../updater" }
|
||||
|
||||
@@ -0,0 +1,966 @@
|
||||
//! Passive authenticated catalog metadata only. No artifact request, preview,
|
||||
//! approval, staging, consumption, capability, service or filesystem write.
|
||||
use anyhow::{Context, Result, ensure};
|
||||
use chrono::{DateTime, Utc};
|
||||
use openssl::{
|
||||
pkey::{Id, PKey},
|
||||
sign::Verifier,
|
||||
};
|
||||
use rmm_domain::{
|
||||
agent_update::{Platform, ReleaseEnvelope, ReleaseManifest, UpdateKeyringFile},
|
||||
agent_update_provisioning::{
|
||||
BASELINE_SIGNATURE_DOMAIN, InstalledReleaseRecord, LocalUpdatePolicy,
|
||||
},
|
||||
jobs::hash,
|
||||
};
|
||||
use rmm_privileged_helper::{Binding, TrustedClock};
|
||||
use rmm_updater::{
|
||||
ActiveRelease, Platform as ReleasePlatform, ReleaseRelation, SignedRelease, TrustedContext,
|
||||
TrustedUpdateKey, UpdateKeyring, verify_release,
|
||||
};
|
||||
use serde::Deserialize;
|
||||
use std::{
|
||||
fs::{File, OpenOptions},
|
||||
io::Read,
|
||||
net::SocketAddr,
|
||||
os::unix::fs::{MetadataExt, OpenOptionsExt},
|
||||
path::{Path, PathBuf},
|
||||
time::{Duration, Instant},
|
||||
};
|
||||
use tokio::sync::oneshot;
|
||||
#[cfg(test)]
|
||||
use uuid::Uuid;
|
||||
|
||||
const POLICY: &str = "/etc/rmm-agent-updater/policy.json";
|
||||
const KEYRING: &str = "/etc/rmm-agent-updater/keyring.json";
|
||||
const RECORD: &str = "/var/lib/rmm-agent-updater/installed-record.json";
|
||||
const RESPONSE_LIMIT: usize = 64 * 1024;
|
||||
const DAY: Duration = Duration::from_secs(24 * 60 * 60);
|
||||
|
||||
use rmm_domain::agent_update::{
|
||||
CatalogCandidate as Candidate, CatalogCheckReport as Report, CatalogCheckStatus as Status,
|
||||
};
|
||||
fn empty(status: Status) -> Report {
|
||||
Report {
|
||||
schema_version: 1,
|
||||
source_id: "mtls:release-catalog-v1".into(),
|
||||
checked_at: Utc::now(),
|
||||
status,
|
||||
candidate: None,
|
||||
}
|
||||
}
|
||||
/// Old servers already accept this ordinary bounded Linux observation shape.
|
||||
/// The outer timestamp says when the cache was read; checked_at is not restamped.
|
||||
pub fn observation(report: Report, collected_at: DateTime<Utc>) -> serde_json::Value {
|
||||
let (quality, error) = match report.status {
|
||||
Status::Available | Status::Current => ("valid", None),
|
||||
Status::NotConfigured => ("unknown", Some("UPDATE_CATALOG_NOT_CONFIGURED")),
|
||||
Status::Unavailable => ("error", Some("UPDATE_CATALOG_CHECK_UNAVAILABLE")),
|
||||
};
|
||||
serde_json::json!({"scope":"linux.agent_update.catalog","source_id":"agent:cached-release-catalog-v1",
|
||||
"observed_at":collected_at,"quality":quality,"completeness":"complete","truncated":false,
|
||||
"error_code":error,"data":report})
|
||||
}
|
||||
struct Pending {
|
||||
receiver: oneshot::Receiver<Report>,
|
||||
task: tokio::task::JoinHandle<()>,
|
||||
}
|
||||
impl Drop for Pending {
|
||||
fn drop(&mut self) {
|
||||
self.task.abort();
|
||||
}
|
||||
}
|
||||
#[derive(Default)]
|
||||
pub struct Checker {
|
||||
report: Option<Report>,
|
||||
started: Option<Instant>,
|
||||
pending: Option<Pending>,
|
||||
}
|
||||
impl Checker {
|
||||
pub fn cached(&self, now: DateTime<Utc>) -> Option<Report> {
|
||||
self.report
|
||||
.as_ref()
|
||||
.filter(|report| report.validate(now, now))
|
||||
.cloned()
|
||||
}
|
||||
/// Called by the normal passive update collector. IO runs in a background
|
||||
/// task; a slow HTTPS peer never blocks heartbeat/cancel/control dispatch.
|
||||
pub fn poll(
|
||||
&mut self,
|
||||
binding: Option<&Binding>,
|
||||
clock: TrustedClock,
|
||||
address: SocketAddr,
|
||||
client: impl FnOnce() -> Result<reqwest::Client>,
|
||||
) -> Report {
|
||||
if let Some(pending) = &mut self.pending {
|
||||
match pending.receiver.try_recv() {
|
||||
Ok(report) => {
|
||||
self.report = Some(report);
|
||||
self.pending.take();
|
||||
}
|
||||
Err(oneshot::error::TryRecvError::Empty) => {}
|
||||
Err(oneshot::error::TryRecvError::Closed) => {
|
||||
self.report = Some(empty(Status::Unavailable));
|
||||
self.pending.take();
|
||||
}
|
||||
}
|
||||
}
|
||||
let interval = if self
|
||||
.report
|
||||
.as_ref()
|
||||
.is_some_and(|r| matches!(r.status, Status::Available | Status::Current))
|
||||
{
|
||||
DAY
|
||||
} else {
|
||||
Duration::from_secs(60)
|
||||
};
|
||||
if self.pending.is_none() && self.started.is_none_or(|t| t.elapsed() >= interval) {
|
||||
self.started = Some(Instant::now());
|
||||
let prepared = binding
|
||||
.map(|binding| {
|
||||
Trust::load(
|
||||
binding,
|
||||
Path::new(POLICY),
|
||||
Path::new(KEYRING),
|
||||
Path::new(RECORD),
|
||||
)
|
||||
})
|
||||
.transpose();
|
||||
match prepared {
|
||||
Ok(None | Some(None)) => self.report = Some(empty(Status::NotConfigured)),
|
||||
Err(_) => self.report = Some(empty(Status::Unavailable)),
|
||||
Ok(Some(Some(trust))) => {
|
||||
let transport = if clock.trusted() {
|
||||
client()
|
||||
} else {
|
||||
Err(anyhow::anyhow!("UPDATE_CATALOG_CLOCK_UNTRUSTED"))
|
||||
};
|
||||
match transport {
|
||||
Err(_) => self.report = Some(empty(Status::Unavailable)),
|
||||
Ok(client) => {
|
||||
let (sender, receiver) = oneshot::channel();
|
||||
let task = tokio::spawn(async move {
|
||||
let result = tokio::time::timeout(
|
||||
Duration::from_secs(35),
|
||||
request(&client, address, &trust, &clock),
|
||||
)
|
||||
.await;
|
||||
let report = result
|
||||
.ok()
|
||||
.and_then(Result::ok)
|
||||
.unwrap_or_else(|| empty(Status::Unavailable));
|
||||
let _ = sender.send(report);
|
||||
});
|
||||
self.pending = Some(Pending { receiver, task });
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
self.report
|
||||
.clone()
|
||||
.unwrap_or_else(|| empty(Status::Unavailable))
|
||||
}
|
||||
}
|
||||
|
||||
/// Protected, public local records only. Missing provisioning is not an invitation
|
||||
/// to bootstrap trust from the HTTP response, current job or a writable file.
|
||||
struct Protected {
|
||||
path: PathBuf,
|
||||
file: File,
|
||||
stamp: [u64; 10],
|
||||
raw: Vec<u8>,
|
||||
limit: usize,
|
||||
}
|
||||
fn stamp(m: &std::fs::Metadata) -> [u64; 10] {
|
||||
[
|
||||
m.dev(),
|
||||
m.ino(),
|
||||
m.uid().into(),
|
||||
m.gid().into(),
|
||||
m.mode().into(),
|
||||
m.len(),
|
||||
m.mtime() as u64,
|
||||
m.ctime() as u64,
|
||||
m.mtime_nsec() as u64,
|
||||
m.ctime_nsec() as u64,
|
||||
]
|
||||
}
|
||||
fn parents(path: &Path) -> Result<()> {
|
||||
ensure!(path.is_absolute(), "UPDATE_CATALOG_ANCHOR_PATH");
|
||||
for parent in path.ancestors().skip(1) {
|
||||
let m = std::fs::symlink_metadata(parent)?;
|
||||
ensure!(
|
||||
m.is_dir() && !m.file_type().is_symlink() && m.uid() == 0 && m.mode() & 0o022 == 0,
|
||||
"UPDATE_CATALOG_ANCHOR_PARENT"
|
||||
);
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
impl Protected {
|
||||
fn read(path: &Path, limit: usize) -> Result<Self> {
|
||||
parents(path)?;
|
||||
let mut file = OpenOptions::new()
|
||||
.read(true)
|
||||
.custom_flags(libc::O_NOFOLLOW | libc::O_NONBLOCK | libc::O_CLOEXEC)
|
||||
.open(path)?;
|
||||
let m = file.metadata()?;
|
||||
ensure!(
|
||||
m.is_file()
|
||||
&& m.uid() == 0
|
||||
&& m.mode() & 0o022 == 0
|
||||
&& m.nlink() == 1
|
||||
&& m.len() > 0
|
||||
&& m.len() <= limit as u64,
|
||||
"UPDATE_CATALOG_ANCHOR_FILE"
|
||||
);
|
||||
let before = stamp(&m);
|
||||
let mut raw = Vec::new();
|
||||
(&mut file).take(limit as u64 + 1).read_to_end(&mut raw)?;
|
||||
ensure!(
|
||||
raw.len() as u64 == m.len() && stamp(&file.metadata()?) == before,
|
||||
"UPDATE_CATALOG_ANCHOR_CHANGED"
|
||||
);
|
||||
let result = Self {
|
||||
path: path.to_owned(),
|
||||
file,
|
||||
stamp: before,
|
||||
raw,
|
||||
limit,
|
||||
};
|
||||
ensure!(
|
||||
stamp(&std::fs::symlink_metadata(path)?) == result.stamp,
|
||||
"UPDATE_CATALOG_ANCHOR_REPLACED"
|
||||
);
|
||||
Ok(result)
|
||||
}
|
||||
fn recheck(&self) -> Result<()> {
|
||||
let current = Self::read(&self.path, self.limit)?;
|
||||
ensure!(
|
||||
stamp(&self.file.metadata()?) == self.stamp
|
||||
&& current.stamp == self.stamp
|
||||
&& current.raw == self.raw,
|
||||
"UPDATE_CATALOG_ANCHOR_REPLACED"
|
||||
);
|
||||
Ok(())
|
||||
}
|
||||
}
|
||||
struct Trust {
|
||||
files: Vec<Protected>,
|
||||
keys: UpdateKeyring,
|
||||
record: InstalledReleaseRecord,
|
||||
protocol: u32,
|
||||
state: u32,
|
||||
generation: u64,
|
||||
}
|
||||
impl Trust {
|
||||
fn load(binding: &Binding, policy: &Path, keys: &Path, record: &Path) -> Result<Option<Self>> {
|
||||
let result = (|| -> Result<Self> {
|
||||
let policy = Protected::read(policy, 65536)?;
|
||||
let (local, _) =
|
||||
LocalUpdatePolicy::from_bytes(&policy.raw).map_err(anyhow::Error::msg)?;
|
||||
ensure!(
|
||||
local.keyring_path == KEYRING && local.installed_record_path == RECORD,
|
||||
"UPDATE_CATALOG_FIXED_ANCHOR_PATHS"
|
||||
);
|
||||
let keys = Protected::read(keys, 16384)?;
|
||||
let record = Protected::read(record, 32768)?;
|
||||
let result = Self::verify(binding, &policy.raw, &keys.raw, &record.raw)?;
|
||||
Ok(Self {
|
||||
files: vec![policy, keys, record],
|
||||
..result
|
||||
})
|
||||
})();
|
||||
match result {
|
||||
Ok(value) => Ok(Some(value)),
|
||||
Err(error)
|
||||
if error
|
||||
.downcast_ref::<std::io::Error>()
|
||||
.is_some_and(|e| e.kind() == std::io::ErrorKind::NotFound) =>
|
||||
{
|
||||
Ok(None)
|
||||
}
|
||||
Err(error) => Err(error),
|
||||
}
|
||||
}
|
||||
fn verify(
|
||||
binding: &Binding,
|
||||
policy_raw: &[u8],
|
||||
keys_raw: &[u8],
|
||||
record_raw: &[u8],
|
||||
) -> Result<Self> {
|
||||
let (policy, _) = LocalUpdatePolicy::from_bytes(policy_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_CATALOG_LOCAL_IDENTITY"
|
||||
);
|
||||
let keys: UpdateKeyringFile = serde_json::from_slice(keys_raw)?;
|
||||
ensure!(keys.validate(), "UPDATE_CATALOG_KEYRING");
|
||||
let mut trusted = Vec::new();
|
||||
for key in &keys.keys {
|
||||
let public: [u8; 32] = hex::decode(&key.public_key_hex)?
|
||||
.try_into()
|
||||
.map_err(|_| anyhow::anyhow!("UPDATE_CATALOG_KEY_SIZE"))?;
|
||||
ensure!(
|
||||
key.platform == Platform::LinuxX64 && key.public_key_hex != binding.public_key_hex,
|
||||
"UPDATE_CATALOG_KEY_SEPARATION"
|
||||
);
|
||||
trusted.push(TrustedUpdateKey::new(
|
||||
public,
|
||||
ReleasePlatform::LinuxX64,
|
||||
key.first_sequence,
|
||||
key.last_sequence,
|
||||
key.revoked,
|
||||
)?);
|
||||
}
|
||||
let keyring = UpdateKeyring::new(keys.generation, trusted)?;
|
||||
let baseline = policy
|
||||
.initial_baseline
|
||||
.decode()
|
||||
.map_err(anyhow::Error::msg)?;
|
||||
// Only the independently signed bootstrap can currently authenticate
|
||||
// the floor here. Later Updated records require the separate guarded
|
||||
// Full history observer; do not guess a floor from parsed root JSON.
|
||||
ensure!(
|
||||
baseline.payload_bytes == record_raw
|
||||
&& hash(record_raw) == policy.initial_record_sha256,
|
||||
"UPDATE_CATALOG_GUARDED_HISTORY_REQUIRED"
|
||||
);
|
||||
let signer = keys
|
||||
.keys
|
||||
.iter()
|
||||
.find(|key| {
|
||||
hash(&hex::decode(&key.public_key_hex).unwrap_or_default())
|
||||
== policy.initial_baseline.key_id
|
||||
})
|
||||
.context("UPDATE_CATALOG_BASELINE_KEY")?;
|
||||
ensure!(!signer.revoked, "UPDATE_CATALOG_BASELINE_REVOKED");
|
||||
let public =
|
||||
PKey::public_key_from_raw_bytes(&hex::decode(&signer.public_key_hex)?, Id::ED25519)?;
|
||||
let mut signed = BASELINE_SIGNATURE_DOMAIN.to_vec();
|
||||
signed.extend_from_slice(&baseline.payload_bytes);
|
||||
ensure!(
|
||||
Verifier::new_without_digest(&public)?.verify_oneshot(&baseline.signature, &signed)?,
|
||||
"UPDATE_CATALOG_BASELINE_SIGNATURE"
|
||||
);
|
||||
let decoded = baseline
|
||||
.record
|
||||
.release_envelope
|
||||
.decode()
|
||||
.map_err(anyhow::Error::msg)?;
|
||||
let result = Self {
|
||||
files: vec![],
|
||||
keys: keyring,
|
||||
protocol: decoded.manifest.protocol_major,
|
||||
state: decoded.manifest.state_schema,
|
||||
generation: keys.generation,
|
||||
record: baseline.record,
|
||||
};
|
||||
result.release(&result.record.release_envelope, result.record.activated_at)?;
|
||||
Ok(result)
|
||||
}
|
||||
fn release(
|
||||
&self,
|
||||
envelope: &ReleaseEnvelope,
|
||||
now: u64,
|
||||
) -> Result<rmm_updater::VerifiedRelease> {
|
||||
let decoded = envelope.decode().map_err(anyhow::Error::msg)?;
|
||||
verify_release(
|
||||
SignedRelease {
|
||||
schema_version: envelope.schema_version,
|
||||
key_id: &envelope.key_id,
|
||||
payload_bytes: &decoded.payload_bytes,
|
||||
signature: &decoded.signature,
|
||||
},
|
||||
&self.keys,
|
||||
&TrustedContext {
|
||||
platform: ReleasePlatform::LinuxX64,
|
||||
now_utc_seconds: now,
|
||||
keyring_generation: self.generation,
|
||||
protocol_major: self.protocol,
|
||||
state_schema: self.state,
|
||||
updater_version: 1,
|
||||
minimum_release_sequence: self.record.activation_floor,
|
||||
active_release: Some(ActiveRelease {
|
||||
sequence: self.record.activation_floor,
|
||||
manifest_sha256: self.record.manifest_sha256.clone(),
|
||||
}),
|
||||
},
|
||||
)
|
||||
}
|
||||
fn response(&self, bytes: &[u8], now: DateTime<Utc>) -> Result<Report> {
|
||||
ensure!(
|
||||
!bytes.is_empty() && bytes.len() <= RESPONSE_LIMIT,
|
||||
"UPDATE_CATALOG_RESPONSE_LIMIT"
|
||||
);
|
||||
let response: CatalogResponse = serde_json::from_slice(bytes)?;
|
||||
ensure!(!response.job_created, "UPDATE_CATALOG_UNEXPECTED_JOB");
|
||||
match (response.status.as_str(), response.release) {
|
||||
("not_configured", None) => Ok(empty(Status::NotConfigured)),
|
||||
("available", Some(release)) => {
|
||||
ensure!(
|
||||
release
|
||||
.release_envelope
|
||||
.decode()
|
||||
.map_err(anyhow::Error::msg)?
|
||||
.manifest
|
||||
== release.manifest,
|
||||
"UPDATE_CATALOG_UNSIGNED_VIEW_CHANGED"
|
||||
);
|
||||
let verified =
|
||||
self.release(&release.release_envelope, u64::try_from(now.timestamp())?)?;
|
||||
let manifest = verified.manifest();
|
||||
Ok(Report {
|
||||
schema_version: 1,
|
||||
source_id: "mtls:release-catalog-v1".into(),
|
||||
checked_at: now,
|
||||
status: if verified.relation() == ReleaseRelation::SameActiveManifest {
|
||||
Status::Current
|
||||
} else {
|
||||
Status::Available
|
||||
},
|
||||
candidate: Some(Candidate {
|
||||
release_id: manifest.release_id,
|
||||
release_sequence: manifest.release_sequence,
|
||||
version: manifest.version.clone(),
|
||||
manifest_sha256: verified.manifest_sha256().into(),
|
||||
keyring_generation: verified.keyring_generation(),
|
||||
}),
|
||||
})
|
||||
}
|
||||
_ => anyhow::bail!("UPDATE_CATALOG_RESPONSE_SHAPE"),
|
||||
}
|
||||
}
|
||||
}
|
||||
#[derive(Deserialize)]
|
||||
#[serde(deny_unknown_fields)]
|
||||
struct CatalogResponse {
|
||||
status: String,
|
||||
release: Option<CatalogRelease>,
|
||||
#[serde(rename = "observed_at")]
|
||||
_observed_at: DateTime<Utc>,
|
||||
#[serde(rename = "server_time")]
|
||||
_server_time: DateTime<Utc>,
|
||||
job_created: bool,
|
||||
}
|
||||
#[derive(Deserialize)]
|
||||
#[serde(deny_unknown_fields)]
|
||||
struct CatalogRelease {
|
||||
release_envelope: ReleaseEnvelope,
|
||||
manifest: ReleaseManifest,
|
||||
}
|
||||
async fn request(
|
||||
client: &reqwest::Client,
|
||||
address: SocketAddr,
|
||||
trust: &Trust,
|
||||
clock: &TrustedClock,
|
||||
) -> Result<Report> {
|
||||
ensure!(clock.trusted(), "UPDATE_CATALOG_CLOCK_UNTRUSTED");
|
||||
let bytes = fetch(client, address).await?;
|
||||
ensure!(clock.trusted(), "UPDATE_CATALOG_CLOCK_UNTRUSTED");
|
||||
for file in &trust.files {
|
||||
file.recheck()?;
|
||||
}
|
||||
trust.response(&bytes, Utc::now())
|
||||
}
|
||||
|
||||
async fn fetch(client: &reqwest::Client, address: SocketAddr) -> Result<Vec<u8>> {
|
||||
let response = client
|
||||
.get(format!(
|
||||
"https://{}:{}/agent/v1/releases/current?platform=x86_64-unknown-linux-gnu",
|
||||
crate::https_channel::server_name()?,
|
||||
address.port()
|
||||
))
|
||||
.send()
|
||||
.await?;
|
||||
crate::https_channel::bounded_body(response, RESPONSE_LIMIT, "application/json").await
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
use base64::{Engine, engine::general_purpose::URL_SAFE_NO_PAD};
|
||||
use openssl::{
|
||||
pkey::Private,
|
||||
sign::Signer,
|
||||
ssl::{SslAcceptor, SslMethod, SslVerifyMode},
|
||||
};
|
||||
use rmm_domain::{
|
||||
agent_update::{ArtifactDescriptor, ArtifactRole},
|
||||
agent_update_provisioning::{ActivationEvidence, SignedBaselineRecord},
|
||||
};
|
||||
use serde_json::json;
|
||||
use std::{
|
||||
io::Write,
|
||||
net::TcpListener,
|
||||
os::unix::fs::{PermissionsExt, symlink},
|
||||
};
|
||||
|
||||
fn envelope(
|
||||
key: &PKey<Private>,
|
||||
sequence: u64,
|
||||
protocol: u32,
|
||||
state: u32,
|
||||
expires: u64,
|
||||
) -> ReleaseEnvelope {
|
||||
let manifest = ReleaseManifest {
|
||||
schema_version: 1,
|
||||
release_id: Uuid::from_u128(sequence.into()),
|
||||
release_sequence: sequence,
|
||||
version: format!("test-{sequence}"),
|
||||
platform: Platform::LinuxX64,
|
||||
published_at: 1,
|
||||
expires_at: expires,
|
||||
protocol_major: protocol,
|
||||
state_schema: state,
|
||||
minimum_updater_version: 1,
|
||||
artifacts: [
|
||||
ArtifactDescriptor {
|
||||
role: ArtifactRole::Agent,
|
||||
artifact_id: Uuid::from_u128(100),
|
||||
sha256: hash(b"test agent"),
|
||||
bytes: 10,
|
||||
},
|
||||
ArtifactDescriptor {
|
||||
role: ArtifactRole::Helper,
|
||||
artifact_id: Uuid::from_u128(101),
|
||||
sha256: hash(b"test helper"),
|
||||
bytes: 11,
|
||||
},
|
||||
],
|
||||
};
|
||||
let raw = serde_json::to_vec(&manifest).unwrap();
|
||||
let mut signed = rmm_updater::RELEASE_SIGNATURE_DOMAIN.to_vec();
|
||||
signed.extend_from_slice(&raw);
|
||||
ReleaseEnvelope {
|
||||
schema_version: 1,
|
||||
key_id: hash(&key.raw_public_key().unwrap()),
|
||||
payload_bytes: URL_SAFE_NO_PAD.encode(raw),
|
||||
signature: URL_SAFE_NO_PAD.encode(
|
||||
Signer::new_without_digest(key)
|
||||
.unwrap()
|
||||
.sign_oneshot_to_vec(&signed)
|
||||
.unwrap(),
|
||||
),
|
||||
}
|
||||
}
|
||||
struct Fixture {
|
||||
trust: Trust,
|
||||
key: PKey<Private>,
|
||||
binding: Binding,
|
||||
policy: Vec<u8>,
|
||||
keys: Vec<u8>,
|
||||
record: Vec<u8>,
|
||||
}
|
||||
fn fixture() -> Fixture {
|
||||
let key = PKey::generate_ed25519().unwrap();
|
||||
let binding = Binding {
|
||||
tenant_id: Uuid::new_v4(),
|
||||
asset_id: Uuid::new_v4(),
|
||||
agent_id: Uuid::new_v4(),
|
||||
enrollment_generation: 1,
|
||||
assignment_version: 2,
|
||||
public_key_hex: hex::encode(
|
||||
PKey::generate_ed25519().unwrap().raw_public_key().unwrap(),
|
||||
),
|
||||
};
|
||||
let release = envelope(&key, 7, 1, 1, u64::MAX);
|
||||
let record = InstalledReleaseRecord {
|
||||
schema_version: 1,
|
||||
profile: "decoder_compatible_handoff_v1".into(),
|
||||
platform: Platform::LinuxX64,
|
||||
manifest_sha256: hash(&release.decode().unwrap().payload_bytes),
|
||||
release_envelope: release,
|
||||
activation_floor: 7,
|
||||
activated_at: 2,
|
||||
previous_record_sha256: None,
|
||||
activation_evidence: ActivationEvidence::Bootstrap {
|
||||
qualification_receipt_sha256: hash(b"synthetic qualification"),
|
||||
},
|
||||
rolled_back: false,
|
||||
}
|
||||
.bytes()
|
||||
.unwrap();
|
||||
let mut signed = BASELINE_SIGNATURE_DOMAIN.to_vec();
|
||||
signed.extend_from_slice(&record);
|
||||
let baseline = SignedBaselineRecord {
|
||||
schema_version: 1,
|
||||
key_id: hash(&key.raw_public_key().unwrap()),
|
||||
payload_bytes: URL_SAFE_NO_PAD.encode(&record),
|
||||
signature: URL_SAFE_NO_PAD.encode(
|
||||
Signer::new_without_digest(&key)
|
||||
.unwrap()
|
||||
.sign_oneshot_to_vec(&signed)
|
||||
.unwrap(),
|
||||
),
|
||||
};
|
||||
let keys = serde_json::to_vec(&json!({"schema_version":1,"generation":4,"keys":[{"public_key_hex":hex::encode(key.raw_public_key().unwrap()),"platform":"x86_64-unknown-linux-gnu","first_sequence":1,"last_sequence":20,"revoked":false}]})).unwrap();
|
||||
let policy = serde_json::to_vec(&json!({"schema_version":1,"profile":"linux_general_full_v1","tenant_id":binding.tenant_id,"asset_id":binding.asset_id,"agent_id":binding.agent_id,"enrollment_generation":1,"assignment_version":2,
|
||||
"ledger_path":"/var/lib/rmm-helper/consumption.sqlite","lock_path":"/var/lib/rmm-helper/executor.lock","installed_record_path":RECORD,"keyring_path":KEYRING,"health_pin_path":"/etc/rmm-agent-updater/health-key.json","registry_path":"/etc/rmm-agent-updater/reader-registry.json","reader_registry_sha256":hash(b"fixture registry"),
|
||||
"services":[{"unit":"rmm-agent-remote.service","unit_sha256":hash(b"agent")},{"unit":"rmm-helper-cloud.service","unit_sha256":hash(b"general")},{"unit":"rmm-full-maintenance-helper.service","unit_sha256":hash(b"full")}],"updater_service":{"unit":"rmm-agent-updater.service","unit_sha256":hash(b"updater unit")},"updater_binary_sha256":hash(b"updater"),"initial_baseline":baseline,"initial_record_sha256":hash(&record),"initial_manifest_sha256":InstalledReleaseRecord::from_bytes(&record).unwrap().manifest_sha256,"initial_activation_floor":7})).unwrap();
|
||||
let trust = Trust::verify(&binding, &policy, &keys, &record).unwrap();
|
||||
Fixture {
|
||||
trust,
|
||||
key,
|
||||
binding,
|
||||
policy,
|
||||
keys,
|
||||
record,
|
||||
}
|
||||
}
|
||||
fn response(envelope: ReleaseEnvelope) -> Vec<u8> {
|
||||
serde_json::to_vec(&json!({"status":"available","release":{"manifest":envelope.decode().unwrap().manifest,"release_envelope":envelope},"observed_at":Utc::now(),"server_time":Utc::now(),"job_created":false})).unwrap()
|
||||
}
|
||||
#[test]
|
||||
fn catalog_binds_real_release_signatures_floor_protocol_expiry_and_separate_baseline() {
|
||||
let f = fixture();
|
||||
let now = Utc::now();
|
||||
assert_eq!(
|
||||
f.trust
|
||||
.response(&response(envelope(&f.key, 8, 1, 1, u64::MAX)), now)
|
||||
.unwrap()
|
||||
.status,
|
||||
Status::Available
|
||||
);
|
||||
assert_eq!(
|
||||
f.trust
|
||||
.response(&response(envelope(&f.key, 7, 1, 1, u64::MAX)), now)
|
||||
.unwrap()
|
||||
.status,
|
||||
Status::Current
|
||||
);
|
||||
for release in [
|
||||
envelope(&f.key, 6, 1, 1, u64::MAX),
|
||||
envelope(&f.key, 8, 2, 1, u64::MAX),
|
||||
envelope(&f.key, 8, 1, 2, u64::MAX),
|
||||
envelope(&f.key, 8, 1, 1, 10),
|
||||
] {
|
||||
assert!(f.trust.response(&response(release), now).is_err());
|
||||
}
|
||||
let mut bad = envelope(&f.key, 8, 1, 1, u64::MAX);
|
||||
let mut signature = URL_SAFE_NO_PAD.decode(&bad.signature).unwrap();
|
||||
signature[0] ^= 1;
|
||||
bad.signature = URL_SAFE_NO_PAD.encode(signature);
|
||||
assert!(f.trust.response(&response(bad), now).is_err());
|
||||
let mut keys: serde_json::Value = serde_json::from_slice(&f.keys).unwrap();
|
||||
keys["keys"][0]["revoked"] = json!(true);
|
||||
assert!(
|
||||
Trust::verify(
|
||||
&f.binding,
|
||||
&f.policy,
|
||||
&serde_json::to_vec(&keys).unwrap(),
|
||||
&f.record
|
||||
)
|
||||
.is_err()
|
||||
);
|
||||
let mut policy: serde_json::Value = serde_json::from_slice(&f.policy).unwrap();
|
||||
policy["initial_baseline"]["signature"] = json!("A".repeat(86));
|
||||
assert!(
|
||||
Trust::verify(
|
||||
&f.binding,
|
||||
&serde_json::to_vec(&policy).unwrap(),
|
||||
&f.keys,
|
||||
&f.record
|
||||
)
|
||||
.is_err()
|
||||
);
|
||||
let mut binding = f.binding.clone();
|
||||
binding.public_key_hex = hex::encode(f.key.raw_public_key().unwrap());
|
||||
assert!(Trust::verify(&binding, &f.policy, &f.keys, &f.record).is_err());
|
||||
}
|
||||
#[test]
|
||||
fn catalog_rejects_unsigned_view_extra_fields_and_unqualified_record_floor() {
|
||||
let f = fixture();
|
||||
let now = Utc::now();
|
||||
let raw = response(envelope(&f.key, 8, 1, 1, u64::MAX));
|
||||
for field in ["job", "view", "unknown", "missing"] {
|
||||
let mut changed: serde_json::Value = serde_json::from_slice(&raw).unwrap();
|
||||
match field {
|
||||
"job" => changed["job_created"] = json!(true),
|
||||
"view" => changed["release"]["manifest"]["version"] = json!("unsigned"),
|
||||
"unknown" => changed["trusted"] = json!(true),
|
||||
_ => changed["release"] = serde_json::Value::Null,
|
||||
}
|
||||
assert!(
|
||||
f.trust
|
||||
.response(&serde_json::to_vec(&changed).unwrap(), now)
|
||||
.is_err()
|
||||
);
|
||||
}
|
||||
assert!(
|
||||
f.trust
|
||||
.response(&vec![b' '; RESPONSE_LIMIT + 1], now)
|
||||
.is_err()
|
||||
);
|
||||
let mut record = InstalledReleaseRecord::from_bytes(&f.record).unwrap();
|
||||
record.activated_at += 1;
|
||||
assert!(Trust::verify(&f.binding, &f.policy, &f.keys, &record.bytes().unwrap()).is_err());
|
||||
let mut binding = f.binding.clone();
|
||||
binding.assignment_version += 1;
|
||||
assert!(Trust::verify(&binding, &f.policy, &f.keys, &f.record).is_err());
|
||||
let empty = serde_json::to_vec(&json!({"status":"not_configured","release":null,"observed_at":now,"server_time":now,"job_created":false})).unwrap();
|
||||
assert_eq!(
|
||||
f.trust.response(&empty, now).unwrap().status,
|
||||
Status::NotConfigured
|
||||
);
|
||||
}
|
||||
#[test]
|
||||
fn public_anchors_are_read_only_protected_and_missing_configuration_never_builds_client() {
|
||||
// Normal unprivileged cargo test exercises rejection without requiring
|
||||
// chown/sudo. An isolated root run additionally covers the genuine
|
||||
// protected positive file/recheck branch; report that coverage separately.
|
||||
let root_fixture = unsafe { libc::geteuid() } == 0;
|
||||
let root = if root_fixture {
|
||||
PathBuf::from("/run")
|
||||
} else {
|
||||
std::env::temp_dir()
|
||||
}
|
||||
.join(format!("rmm-catalog-test-{}", Uuid::new_v4()));
|
||||
std::fs::create_dir(&root).unwrap();
|
||||
std::fs::set_permissions(&root, std::fs::Permissions::from_mode(0o700)).unwrap();
|
||||
let path = root.join("public.json");
|
||||
std::fs::write(&path, b"public synthetic trust bytes").unwrap();
|
||||
std::fs::set_permissions(&path, std::fs::Permissions::from_mode(0o600)).unwrap();
|
||||
let before = std::fs::metadata(&path).unwrap();
|
||||
if !root_fixture {
|
||||
assert!(Protected::read(&path, 128).is_err());
|
||||
assert_eq!(before.ino(), std::fs::metadata(&path).unwrap().ino());
|
||||
std::fs::remove_dir_all(&root).unwrap();
|
||||
} else {
|
||||
let held = Protected::read(&path, 128).unwrap();
|
||||
held.recheck().unwrap();
|
||||
assert_eq!(before.ino(), std::fs::metadata(&path).unwrap().ino());
|
||||
let alias = root.join("alias");
|
||||
symlink(&path, &alias).unwrap();
|
||||
assert!(Protected::read(&alias, 128).is_err());
|
||||
std::fs::set_permissions(&path, std::fs::Permissions::from_mode(0o622)).unwrap();
|
||||
assert!(Protected::read(&path, 128).is_err());
|
||||
std::fs::set_permissions(&path, std::fs::Permissions::from_mode(0o600)).unwrap();
|
||||
std::fs::write(&path, b"different synthetic public bytes").unwrap();
|
||||
assert!(held.recheck().is_err());
|
||||
drop(held);
|
||||
std::fs::remove_dir_all(&root).unwrap();
|
||||
}
|
||||
let mut checker = Checker::default();
|
||||
let report = checker.poll(
|
||||
None,
|
||||
TrustedClock::new(),
|
||||
"127.0.0.1:1".parse().unwrap(),
|
||||
|| panic!("missing anchor must not load device TLS keys"),
|
||||
);
|
||||
assert_eq!(report.status, Status::NotConfigured);
|
||||
let again = checker.poll(
|
||||
None,
|
||||
TrustedClock::new(),
|
||||
"127.0.0.1:1".parse().unwrap(),
|
||||
|| panic!("cadence must not create client"),
|
||||
);
|
||||
assert_eq!(report.checked_at, again.checked_at);
|
||||
}
|
||||
#[tokio::test]
|
||||
async fn actual_mtls_catalog_fetch_keeps_fixed_route_and_bounds_untrusted_http() {
|
||||
let f = fixture();
|
||||
let name = crate::https_channel::server_name().unwrap();
|
||||
let (ca, ca_key) = crate::runtime_tests::certificate("catalog test CA", None, false);
|
||||
let (server, server_key) =
|
||||
crate::runtime_tests::certificate(&name, Some((&ca, &ca_key)), true);
|
||||
let (device, device_key) =
|
||||
crate::runtime_tests::certificate("catalog test device", Some((&ca, &ca_key)), false);
|
||||
let cases = [
|
||||
("200 OK", response(envelope(&f.key, 8, 1, 1, u64::MAX))),
|
||||
("302 Found", b"no redirect".to_vec()),
|
||||
("200 OK", vec![b'x'; RESPONSE_LIMIT + 1]),
|
||||
];
|
||||
for (index, (status, body)) in cases.into_iter().enumerate() {
|
||||
let mut acceptor = SslAcceptor::mozilla_intermediate(SslMethod::tls_server()).unwrap();
|
||||
acceptor.set_certificate(&server).unwrap();
|
||||
acceptor.set_private_key(&server_key).unwrap();
|
||||
acceptor.cert_store_mut().add_cert(ca.clone()).unwrap();
|
||||
acceptor.set_verify(SslVerifyMode::PEER | SslVerifyMode::FAIL_IF_NO_PEER_CERT);
|
||||
let acceptor = acceptor.build();
|
||||
let listener = TcpListener::bind("127.0.0.1:0").unwrap();
|
||||
let address = listener.local_addr().unwrap();
|
||||
let worker = std::thread::spawn(move || {
|
||||
let (socket, _) = listener.accept().unwrap();
|
||||
socket
|
||||
.set_read_timeout(Some(Duration::from_secs(5)))
|
||||
.unwrap();
|
||||
let mut tls = acceptor.accept(socket).unwrap();
|
||||
assert!(tls.ssl().peer_certificate().is_some());
|
||||
let mut request = Vec::new();
|
||||
let mut byte = [0];
|
||||
while !request.ends_with(b"\r\n\r\n") {
|
||||
tls.read_exact(&mut byte).unwrap();
|
||||
request.push(byte[0]);
|
||||
assert!(request.len() < 8192);
|
||||
}
|
||||
let headers = String::from_utf8(request).unwrap();
|
||||
assert!(headers.starts_with(
|
||||
"GET /agent/v1/releases/current?platform=x86_64-unknown-linux-gnu HTTP/1.1\r\n"
|
||||
));
|
||||
assert!(!headers.to_ascii_lowercase().contains("authorization:"));
|
||||
let wire = format!(
|
||||
"HTTP/1.1 {status}\r\nContent-Type: application/json\r\nContent-Length: {}\r\nLocation: https://unexpected.invalid/\r\nConnection: close\r\n\r\n",
|
||||
body.len()
|
||||
);
|
||||
tls.write_all(wire.as_bytes()).unwrap();
|
||||
let _ = tls.write_all(&body);
|
||||
});
|
||||
let client = crate::https_channel::mtls_client(
|
||||
address,
|
||||
&ca.to_pem().unwrap(),
|
||||
&device.to_pem().unwrap(),
|
||||
&device_key.private_key_to_pem_pkcs8().unwrap(),
|
||||
)
|
||||
.unwrap();
|
||||
let result = fetch(&client, address).await;
|
||||
if index == 0 {
|
||||
assert_eq!(
|
||||
f.trust
|
||||
.response(&result.unwrap(), Utc::now())
|
||||
.unwrap()
|
||||
.status,
|
||||
Status::Available
|
||||
);
|
||||
} else {
|
||||
assert!(result.is_err());
|
||||
}
|
||||
worker.join().unwrap();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod wire_tests {
|
||||
use super::*;
|
||||
use prost::Message;
|
||||
use rmm_protocol::{Envelope, InventorySnapshot, Payload};
|
||||
use serde_json::json;
|
||||
use sha2::Digest;
|
||||
#[test]
|
||||
fn catalog_wire_shape_is_accepted_by_original_linux_observation_contract() {
|
||||
let original = include_bytes!("../../../tests/agent_update/catalog-check-inventory.json");
|
||||
let now = "2026-11-15T12:00:00Z".parse().unwrap();
|
||||
let stored =
|
||||
rmm_domain::inventory_document::validate_for_scope(original, now, "linux.base")
|
||||
.unwrap();
|
||||
assert_eq!(
|
||||
stored,
|
||||
serde_json::from_slice::<serde_json::Value>(original).unwrap()
|
||||
);
|
||||
let report: Report =
|
||||
serde_json::from_value(stored["observations"][0]["data"].clone()).unwrap();
|
||||
let document = serde_json::to_vec(&report).unwrap();
|
||||
assert_eq!(serde_json::from_slice::<Report>(&document).unwrap(), report);
|
||||
assert!(report.validate(now, now));
|
||||
}
|
||||
#[test]
|
||||
fn normal_linux_snapshot_carries_cached_check_through_existing_scope_without_restamping_it() {
|
||||
let now = Utc::now();
|
||||
let report = Report {
|
||||
schema_version: 1,
|
||||
source_id: "mtls:release-catalog-v1".into(),
|
||||
checked_at: now - chrono::Duration::hours(2),
|
||||
status: Status::Unavailable,
|
||||
candidate: None,
|
||||
};
|
||||
let base = json!({"os":"Linux","hostname":"synthetic-codec","architecture":"x86_64","root_total_bytes":2,"root_available_bytes":1,"root_available_inodes":1,
|
||||
"collection_started_at":now,"collection_completed_at":now,"observations":[observation(report.clone(),now)]});
|
||||
let data = serde_json::to_vec(&base).unwrap();
|
||||
let envelope = Envelope {
|
||||
protocol_major: 1,
|
||||
protocol_minor: 0,
|
||||
message_id: Uuid::new_v4().to_string(),
|
||||
agent_id: Uuid::new_v4().to_string(),
|
||||
enrollment_generation: 1,
|
||||
connection_generation: 1,
|
||||
boot_id: Uuid::new_v4().to_string(),
|
||||
sequence: 1,
|
||||
observed_at: now.timestamp_millis(),
|
||||
payload: Some(Payload::InventorySnapshot(InventorySnapshot {
|
||||
snapshot_id: Uuid::new_v4().to_string(),
|
||||
scope: "linux.base".into(),
|
||||
schema_version: 1,
|
||||
chunk_index: 0,
|
||||
chunk_count: 1,
|
||||
sha256: sha2::Sha256::digest(&data).to_vec(),
|
||||
data,
|
||||
completeness: "partial".into(),
|
||||
})),
|
||||
};
|
||||
let decoded = Envelope::decode(envelope.encode_to_vec().as_slice()).unwrap();
|
||||
let Some(Payload::InventorySnapshot(snapshot)) = decoded.payload else {
|
||||
panic!("snapshot")
|
||||
};
|
||||
let stored = rmm_domain::inventory_document::validate_for_scope(
|
||||
&snapshot.data,
|
||||
now,
|
||||
&snapshot.scope,
|
||||
)
|
||||
.unwrap();
|
||||
assert_eq!(stored, base);
|
||||
assert_eq!(
|
||||
stored["observations"][0]["data"]["checked_at"],
|
||||
json!(report.checked_at)
|
||||
);
|
||||
// Exact pre-existing outer keys/scopes: old validators already support
|
||||
// bounded generic linux.* observations; no agent.update extension is sent.
|
||||
assert!(!stored.as_object().unwrap().contains_key("catalog_check"));
|
||||
assert_eq!(
|
||||
stored["observations"][0]["scope"],
|
||||
"linux.agent_update.catalog"
|
||||
);
|
||||
for field in ["candidate", "schema", "time", "unknown"] {
|
||||
let mut bad = base.clone();
|
||||
match field {
|
||||
"candidate" => bad["observations"][0]["data"]["candidate"] = json!({}),
|
||||
"schema" => bad["observations"][0]["data"]["schema_version"] = json!(2),
|
||||
"time" => {
|
||||
bad["observations"][0]["data"]["checked_at"] =
|
||||
json!(now + chrono::Duration::seconds(2))
|
||||
}
|
||||
_ => bad["observations"][0]["data"]["ready"] = json!(true),
|
||||
}
|
||||
assert!(
|
||||
rmm_domain::inventory_document::validate_for_scope(
|
||||
&serde_json::to_vec(&bad).unwrap(),
|
||||
now,
|
||||
"linux.base"
|
||||
)
|
||||
.is_err(),
|
||||
"catalog field must be denied: {field}"
|
||||
);
|
||||
}
|
||||
let original = json!({"agent_update":rmm_domain::agent_update::AgentUpdateObservation::not_configured(Platform::LinuxX64,now)});
|
||||
assert!(
|
||||
rmm_domain::inventory_document::validate_for_scope(
|
||||
&serde_json::to_vec(&original).unwrap(),
|
||||
now,
|
||||
"agent.update"
|
||||
)
|
||||
.is_ok()
|
||||
);
|
||||
let mut no_catalog = base;
|
||||
no_catalog.as_object_mut().unwrap().remove("observations");
|
||||
no_catalog
|
||||
.as_object_mut()
|
||||
.unwrap()
|
||||
.remove("collection_started_at");
|
||||
no_catalog
|
||||
.as_object_mut()
|
||||
.unwrap()
|
||||
.remove("collection_completed_at");
|
||||
assert!(
|
||||
rmm_domain::inventory_document::validate_for_scope(
|
||||
&serde_json::to_vec(&no_catalog).unwrap(),
|
||||
now,
|
||||
"linux.base"
|
||||
)
|
||||
.is_ok()
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -1,3 +1,4 @@
|
||||
mod agent_update_catalog;
|
||||
mod agent_update_health;
|
||||
mod apt;
|
||||
mod bootstrap;
|
||||
@@ -60,6 +61,7 @@ struct Agent<C: reconcile::SyncClock = reconcile::NativeClock> {
|
||||
mode: wire_channel::Mode,
|
||||
certificates: certificate_rotation::RotationStore,
|
||||
rotation_policy: certificate_rotation::RotationPolicy,
|
||||
catalog: agent_update_catalog::Checker,
|
||||
}
|
||||
#[derive(Default)]
|
||||
struct EffectFence {
|
||||
@@ -495,7 +497,9 @@ impl<C: reconcile::SyncClock> Agent<C> {
|
||||
let sender = self.inventory_tx.clone();
|
||||
let extended = env::var("RMM_EXTENDED_INVENTORY").unwrap_or_else(|_| "1".into()) == "1";
|
||||
let binding = self.binding.clone();
|
||||
let catalog = self.catalog.cached(Utc::now());
|
||||
tokio::task::spawn_blocking(move || {
|
||||
let collected_at = Utc::now();
|
||||
let result = rmm_agent_linux::wire::snapshot(extended).and_then(|mut inventory| {
|
||||
if extended {
|
||||
inventory["observations"]
|
||||
@@ -504,6 +508,17 @@ impl<C: reconcile::SyncClock> Agent<C> {
|
||||
.push(apt::planning_observation(binding.as_ref()));
|
||||
inventory["collection_completed_at"] = serde_json::json!(Utc::now());
|
||||
}
|
||||
if let Some(report) = catalog {
|
||||
if inventory.get("observations").is_none() {
|
||||
inventory["observations"] = serde_json::json!([]);
|
||||
inventory["collection_started_at"] = serde_json::json!(collected_at);
|
||||
}
|
||||
inventory["observations"]
|
||||
.as_array_mut()
|
||||
.context("INVENTORY_OBSERVATIONS")?
|
||||
.push(agent_update_catalog::observation(report, Utc::now()));
|
||||
inventory["collection_completed_at"] = serde_json::json!(Utc::now());
|
||||
}
|
||||
let bytes = serde_json::to_vec(&inventory)?;
|
||||
ensure!(bytes.len() <= 512 * 1024, "INVENTORY_WIRE_LIMIT");
|
||||
Ok((bytes, Utc::now().timestamp_millis()))
|
||||
@@ -522,6 +537,19 @@ impl<C: reconcile::SyncClock> Agent<C> {
|
||||
rmm_domain::agent_update::Platform::LinuxX64,
|
||||
Utc::now(),
|
||||
);
|
||||
let address = self.address;
|
||||
let ca = &self.ca;
|
||||
let certificates = &self.certificates;
|
||||
self.catalog
|
||||
.poll(self.binding.as_ref(), self.clock.clone(), address, || {
|
||||
let identity = certificates.current(Utc::now().timestamp())?;
|
||||
https_channel::mtls_client(
|
||||
address,
|
||||
ca,
|
||||
&identity.certificate_pem,
|
||||
&identity.private_key_pem,
|
||||
)
|
||||
});
|
||||
let data = serde_json::to_vec(&serde_json::json!({"agent_update":observation}))?;
|
||||
let envelope = self.envelope(
|
||||
generation,
|
||||
@@ -988,6 +1016,7 @@ async fn main() -> Result<()> {
|
||||
mode,
|
||||
certificates,
|
||||
rotation_policy,
|
||||
catalog: agent_update_catalog::Checker::default(),
|
||||
};
|
||||
agent.recover_interrupted()?;
|
||||
let mut backoff = 1_u64;
|
||||
|
||||
@@ -150,6 +150,7 @@ fn new_process_persists_interruption_before_helper_io_without_unlock_or_repeat()
|
||||
mode: wire_channel::Mode::Wss,
|
||||
certificates,
|
||||
rotation_policy: certificate_rotation::RotationPolicy::default(),
|
||||
catalog: agent_update_catalog::Checker::default(),
|
||||
};
|
||||
// A forged local consumption/start cannot become a purported grant result.
|
||||
agent
|
||||
@@ -219,7 +220,7 @@ impl reconcile::SyncClock for Clock {
|
||||
Ok(Utc::now())
|
||||
}
|
||||
}
|
||||
fn certificate(
|
||||
pub(super) fn certificate(
|
||||
name: &str,
|
||||
issuer: Option<(&X509, &PKey<openssl::pkey::Private>)>,
|
||||
server: bool,
|
||||
@@ -537,6 +538,7 @@ async fn run(mode: wire_channel::Mode, trusted: bool, forged: bool, rounds: u64)
|
||||
mode,
|
||||
certificates,
|
||||
rotation_policy: certificate_rotation::RotationPolicy::default(),
|
||||
catalog: agent_update_catalog::Checker::default(),
|
||||
};
|
||||
for _ in 0..rounds {
|
||||
assert!(
|
||||
|
||||
@@ -780,3 +780,63 @@ pub fn job_health_public_key(job: &crate::jobs::JobPayload) -> Result<[u8; 32],
|
||||
.try_into()
|
||||
.map_err(|_| "UPDATE_HEALTH_KEY")
|
||||
}
|
||||
|
||||
/// Diagnostic catalog metadata inside the existing linux.base observations
|
||||
/// vector. This is never an AgentUpdateObservation/CandidatePreview or authority.
|
||||
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize, schemars::JsonSchema)]
|
||||
#[serde(rename_all = "snake_case")]
|
||||
pub enum CatalogCheckStatus {
|
||||
NotConfigured,
|
||||
Unavailable,
|
||||
Available,
|
||||
Current,
|
||||
}
|
||||
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize, schemars::JsonSchema)]
|
||||
#[serde(deny_unknown_fields)]
|
||||
pub struct CatalogCandidate {
|
||||
pub release_id: Uuid,
|
||||
pub release_sequence: u64,
|
||||
pub version: String,
|
||||
pub manifest_sha256: String,
|
||||
pub keyring_generation: u64,
|
||||
}
|
||||
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize, schemars::JsonSchema)]
|
||||
#[serde(deny_unknown_fields)]
|
||||
pub struct CatalogCheckReport {
|
||||
pub schema_version: u32,
|
||||
pub source_id: String,
|
||||
/// Actual authenticated check, not the later cache/inventory collection.
|
||||
pub checked_at: chrono::DateTime<chrono::Utc>,
|
||||
pub status: CatalogCheckStatus,
|
||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||
pub candidate: Option<CatalogCandidate>,
|
||||
}
|
||||
impl CatalogCheckReport {
|
||||
pub fn validate(
|
||||
&self,
|
||||
collected_at: chrono::DateTime<chrono::Utc>,
|
||||
now: chrono::DateTime<chrono::Utc>,
|
||||
) -> bool {
|
||||
self.schema_version == 1
|
||||
&& self.source_id == "mtls:release-catalog-v1"
|
||||
&& self.checked_at <= collected_at + chrono::Duration::seconds(1)
|
||||
&& self.checked_at <= now + chrono::Duration::seconds(45)
|
||||
&& self.checked_at >= now - chrono::Duration::hours(72)
|
||||
&& match (&self.status, &self.candidate) {
|
||||
(CatalogCheckStatus::Available | CatalogCheckStatus::Current, Some(candidate)) => {
|
||||
!candidate.release_id.is_nil()
|
||||
&& candidate.release_sequence > 0
|
||||
&& candidate.keyring_generation > 0
|
||||
&& digest(&candidate.manifest_sha256)
|
||||
&& !candidate.version.is_empty()
|
||||
&& candidate.version.len() <= 64
|
||||
&& candidate
|
||||
.version
|
||||
.bytes()
|
||||
.all(|b| b.is_ascii_alphanumeric() || b".-+_".contains(&b))
|
||||
}
|
||||
(CatalogCheckStatus::NotConfigured | CatalogCheckStatus::Unavailable, None) => true,
|
||||
_ => false,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -150,6 +150,26 @@ pub fn validate_for_scope(
|
||||
.data
|
||||
.get("host_reboot_required")
|
||||
.is_some_and(|v| !v.is_boolean());
|
||||
if o.scope == "linux.agent_update.catalog" {
|
||||
let report: crate::agent_update::CatalogCheckReport =
|
||||
serde_json::from_value(o.data.clone())
|
||||
.map_err(|_| "INVALID_AGENT_UPDATE_CATALOG_REPORT")?;
|
||||
let quality = match report.status {
|
||||
crate::agent_update::CatalogCheckStatus::Available
|
||||
| crate::agent_update::CatalogCheckStatus::Current => "valid",
|
||||
crate::agent_update::CatalogCheckStatus::NotConfigured => "unknown",
|
||||
crate::agent_update::CatalogCheckStatus::Unavailable => "error",
|
||||
};
|
||||
if scope != "linux.base"
|
||||
|| o.source_id != "agent:cached-release-catalog-v1"
|
||||
|| o.quality != quality
|
||||
|| o.completeness != "complete"
|
||||
|| o.truncated
|
||||
|| !report.validate(o.observed_at, now)
|
||||
{
|
||||
return Err("INVALID_AGENT_UPDATE_CATALOG_REPORT");
|
||||
}
|
||||
}
|
||||
if !o.scope.starts_with(prefix)
|
||||
|| o.scope.len() > 64
|
||||
|| !(o
|
||||
|
||||
@@ -128,7 +128,7 @@ async fn device_list(
|
||||
.map_err(|e| e.0)?;
|
||||
let mut page =
|
||||
crate::pagination::Cursor::parse(state, &principal, "devices:agent_id:asc", query)?;
|
||||
let rows = sqlx::query("SELECT a.agent_id,a.asset_id,a.revoked_at,a.last_contact_at,a.certificate_sha256,a.last_authenticated_certificate_sha256,a.last_authenticated_at,a.capabilities,a.enrollment_generation,a.assignment_version,o.observed_at,o.received_at,o.data,o.source_id FROM agent_installations a LEFT JOIN LATERAL (SELECT observed_at,received_at,data,source_id FROM observations WHERE tenant_id=a.tenant_id AND agent_id=a.agent_id AND received_at<=$2 ORDER BY observed_at DESC, received_at DESC LIMIT 1) o ON true WHERE ($1::uuid IS NULL OR a.asset_id=$1) AND a.agent_id>$3 AND a.created_at<=$2 ORDER BY a.agent_id LIMIT $4")
|
||||
let rows = sqlx::query("SELECT a.agent_id,a.asset_id,a.revoked_at,a.last_contact_at,a.certificate_sha256,a.last_authenticated_certificate_sha256,a.last_authenticated_at,a.capabilities,a.enrollment_generation,a.assignment_version,o.observed_at,o.received_at,o.data,o.source_id FROM agent_installations a LEFT JOIN LATERAL (SELECT observed_at,received_at,data,source_id FROM observations WHERE tenant_id=a.tenant_id AND agent_id=a.agent_id AND source_id IN ('linux.base','windows.base') AND received_at<=$2 ORDER BY observed_at DESC, received_at DESC LIMIT 1) o ON true WHERE ($1::uuid IS NULL OR a.asset_id=$1) AND a.agent_id>$3 AND a.created_at<=$2 ORDER BY a.agent_id LIMIT $4")
|
||||
.bind(asset)
|
||||
.bind(page.as_of).bind(page.last).bind(i64::from(page.limit)+1)
|
||||
.fetch_all(&mut *tx).await.map_err(|_| StatusCode::SERVICE_UNAVAILABLE)?;
|
||||
|
||||
@@ -520,8 +520,36 @@ mod tests {
|
||||
os::unix::fs::OpenOptionsExt,
|
||||
time::Duration,
|
||||
};
|
||||
// The production census correctly denies a changing descriptor table.
|
||||
// Other parallel unit tests open/close files in this same test process;
|
||||
// exercise each actual /proc fixture in a separate exact-test process.
|
||||
fn in_isolated_fixture(name: &str) -> bool {
|
||||
const CHILD: &str = "RMM_CENSUS_EXACT_TEST_PROCESS";
|
||||
if std::env::var_os(CHILD).as_deref() == Some(std::ffi::OsStr::new(name)) {
|
||||
return true;
|
||||
}
|
||||
let output = std::process::Command::new(std::env::current_exe().unwrap())
|
||||
.args(["--exact", name, "--test-threads=1"])
|
||||
.env(CHILD, name)
|
||||
.output()
|
||||
.unwrap();
|
||||
assert!(
|
||||
output.status.success()
|
||||
&& String::from_utf8_lossy(&output.stdout).contains("1 passed; 0 failed"),
|
||||
"isolated census fixture: {:?}\n{}\n{}",
|
||||
output.status.code(),
|
||||
String::from_utf8_lossy(&output.stdout),
|
||||
String::from_utf8_lossy(&output.stderr)
|
||||
);
|
||||
false
|
||||
}
|
||||
#[test]
|
||||
fn private_thread_fd_table_cannot_hide_a_reader_from_the_group_probe() {
|
||||
if !in_isolated_fixture(
|
||||
"census_process::tests::private_thread_fd_table_cannot_hide_a_reader_from_the_group_probe",
|
||||
) {
|
||||
return;
|
||||
}
|
||||
assert_eq!(unsafe { libc::geteuid() }, 0);
|
||||
let path = std::path::Path::new("/run")
|
||||
.join(format!("rmm-census-thread-{}", uuid::Uuid::new_v4()));
|
||||
@@ -625,6 +653,11 @@ mod tests {
|
||||
}
|
||||
#[test]
|
||||
fn actual_proc_probe_detects_existing_descriptors_and_mapped_inode_without_exporting_paths() {
|
||||
if !in_isolated_fixture(
|
||||
"census_process::tests::actual_proc_probe_detects_existing_descriptors_and_mapped_inode_without_exporting_paths",
|
||||
) {
|
||||
return;
|
||||
}
|
||||
// An isolated network-none container process, not a host-wide scan,
|
||||
// service/namespace qualification or admission-positive fixture.
|
||||
assert_eq!(unsafe { libc::geteuid() }, 0);
|
||||
|
||||
@@ -81,7 +81,13 @@ pub fn verify_history(
|
||||
let mut signed = BASELINE_SIGNATURE_DOMAIN.to_vec();
|
||||
signed.extend_from_slice(&initial.payload_bytes);
|
||||
verifier.verify_strict(&signed, &Signature::from_bytes(&initial.signature))?;
|
||||
verify_record_release(&keyring, protected_keyring.generation, &initial.record)?;
|
||||
verify_record_release(
|
||||
&keyring,
|
||||
protected_keyring.generation,
|
||||
&initial.record,
|
||||
initial_release.manifest.protocol_major,
|
||||
initial_release.manifest.state_schema,
|
||||
)?;
|
||||
|
||||
ensure!(
|
||||
predecessor_records.len() < MAX_RECORDS
|
||||
@@ -156,7 +162,13 @@ pub fn verify_history(
|
||||
&& record.activated_at >= parent.activated_at,
|
||||
"UPDATE_HISTORY_FLOOR_OR_ROLLBACK"
|
||||
);
|
||||
verify_record_release(&keyring, protected_keyring.generation, record)?;
|
||||
verify_record_release(
|
||||
&keyring,
|
||||
protected_keyring.generation,
|
||||
record,
|
||||
initial_release.manifest.protocol_major,
|
||||
initial_release.manifest.state_schema,
|
||||
)?;
|
||||
let grant = verify_update(db, guard, binding, raw, record, parent_digest, parent)?;
|
||||
ensure!(grants.insert(grant), "UPDATE_HISTORY_REUSED_GRANT");
|
||||
ensure!(*digest == hash(raw), "UPDATE_HISTORY_RECORD_CHANGED");
|
||||
@@ -280,6 +292,8 @@ fn verify_record_release(
|
||||
keys: &UpdateKeyring,
|
||||
generation: u64,
|
||||
record: &InstalledReleaseRecord,
|
||||
baseline_protocol_major: u32,
|
||||
baseline_state_schema: u32,
|
||||
) -> Result<()> {
|
||||
ensure!(
|
||||
!record.rolled_back,
|
||||
@@ -306,8 +320,11 @@ fn verify_record_release(
|
||||
platform,
|
||||
now_utc_seconds: record.activated_at,
|
||||
keyring_generation: generation,
|
||||
protocol_major: decoded.manifest.protocol_major,
|
||||
state_schema: decoded.manifest.state_schema,
|
||||
// Anchor compatibility to the separately signed, qualified
|
||||
// bootstrap. A signed successor cannot attest its own decoder
|
||||
// compatibility by supplying both sides of this comparison.
|
||||
protocol_major: baseline_protocol_major,
|
||||
state_schema: baseline_state_schema,
|
||||
updater_version: 1,
|
||||
minimum_release_sequence: record.activation_floor,
|
||||
active_release: Some(ActiveRelease {
|
||||
@@ -786,6 +803,9 @@ mod tests {
|
||||
active: Vec<u8>,
|
||||
}
|
||||
fn fixture() -> Fixture {
|
||||
fixture_target_contract(1, 1)
|
||||
}
|
||||
fn fixture_target_contract(protocol_major: u32, state_schema: u32) -> Fixture {
|
||||
let release = SigningKey::from_bytes(&[71; 32]); // public synthetic TEST seed
|
||||
let jobs = SigningKey::from_bytes(&[72; 32]);
|
||||
let health = SigningKey::from_bytes(&[73; 32]);
|
||||
@@ -801,8 +821,13 @@ mod tests {
|
||||
let Action::UpdateAgent { update } = &mut job.action else {
|
||||
panic!("fixture action")
|
||||
};
|
||||
let target = envelope(update.manifest().unwrap(), 2, &release);
|
||||
let mut target_manifest = update.manifest().unwrap();
|
||||
target_manifest.protocol_major = protocol_major;
|
||||
target_manifest.state_schema = state_schema;
|
||||
let target = envelope(target_manifest, 2, &release);
|
||||
let mut old = target.decode().unwrap().manifest;
|
||||
old.protocol_major = 1;
|
||||
old.state_schema = 1;
|
||||
old.release_id = update.predecessor.release_id;
|
||||
old.artifacts[0].artifact_id = Uuid::from_u128(901);
|
||||
old.artifacts[1].artifact_id = Uuid::from_u128(902);
|
||||
@@ -1404,6 +1429,150 @@ mod tests {
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn signed_successor_cannot_self_attest_compatibility_with_retained_baseline() {
|
||||
// These fixtures contain genuine release, baseline, job and health
|
||||
// signatures and a complete consumed/native publication chain. Only
|
||||
// the successor's decoder contract differs from the original baseline.
|
||||
for (protocol, schema, error) in [
|
||||
(2, 1, "incompatible release protocol"),
|
||||
(1, 2, "incompatible release state schema"),
|
||||
] {
|
||||
let f = fixture_target_contract(protocol, schema);
|
||||
let before = f.db.total_changes();
|
||||
let rejected = verify_history(
|
||||
&f.db,
|
||||
&f.guard,
|
||||
&f.binding,
|
||||
&f.keys,
|
||||
&f.baseline,
|
||||
&[],
|
||||
&f.active,
|
||||
)
|
||||
.unwrap_err();
|
||||
assert!(rejected.to_string().contains(error), "{rejected:#}");
|
||||
assert_eq!(f.db.total_changes(), before);
|
||||
assert_eq!(
|
||||
InstalledReleaseRecord::from_bytes(&f.initial)
|
||||
.unwrap()
|
||||
.activation_floor,
|
||||
1
|
||||
);
|
||||
assert_eq!(
|
||||
InstalledReleaseRecord::from_bytes(&f.active)
|
||||
.unwrap()
|
||||
.activation_floor,
|
||||
2
|
||||
);
|
||||
}
|
||||
let f = fixture();
|
||||
let before = f.db.total_changes();
|
||||
assert_eq!(
|
||||
verify_history(
|
||||
&f.db,
|
||||
&f.guard,
|
||||
&f.binding,
|
||||
&f.keys,
|
||||
&f.baseline,
|
||||
&[],
|
||||
&f.active,
|
||||
)
|
||||
.unwrap()
|
||||
.bytes()
|
||||
.unwrap(),
|
||||
f.active
|
||||
);
|
||||
assert_eq!(f.db.total_changes(), before);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn retained_predecessor_is_not_a_rollback_receipt_and_unknown_stays_closed() {
|
||||
let f = fixture();
|
||||
// Even a genuine release-signed exact predecessor with the retained
|
||||
// higher floor is only metadata. V1 has no rollback activation witness.
|
||||
let active = InstalledReleaseRecord::from_bytes(&f.active).unwrap();
|
||||
let mut returned = InstalledReleaseRecord::from_bytes(&f.initial).unwrap();
|
||||
returned.activation_floor = active.activation_floor;
|
||||
returned.activated_at = active.activated_at + 1;
|
||||
returned.previous_record_sha256 = Some(hash(&f.active));
|
||||
returned.activation_evidence = active.activation_evidence.clone();
|
||||
returned.rolled_back = true;
|
||||
let returned = returned.bytes().unwrap();
|
||||
let before = f.db.total_changes();
|
||||
assert!(
|
||||
verify_history(
|
||||
&f.db,
|
||||
&f.guard,
|
||||
&f.binding,
|
||||
&f.keys,
|
||||
&f.baseline,
|
||||
std::slice::from_ref(&f.active),
|
||||
&returned,
|
||||
)
|
||||
.unwrap_err()
|
||||
.to_string()
|
||||
.contains("UPDATE_HISTORY_FLOOR_OR_ROLLBACK")
|
||||
);
|
||||
assert!(
|
||||
verify_history(
|
||||
&f.db,
|
||||
&f.guard,
|
||||
&f.binding,
|
||||
&f.keys,
|
||||
&f.baseline,
|
||||
&[],
|
||||
&f.initial,
|
||||
)
|
||||
.is_err()
|
||||
);
|
||||
assert_eq!(f.db.total_changes(), before);
|
||||
assert_eq!(
|
||||
InstalledReleaseRecord::from_bytes(&returned)
|
||||
.unwrap()
|
||||
.activation_floor,
|
||||
2
|
||||
);
|
||||
|
||||
// A previously stored Unknown is never reclassified from a retained
|
||||
// healthy target or a proposed predecessor return. This is a synthetic
|
||||
// local fixture mutation; the verifier itself performs no writes.
|
||||
let unknown = serde_json::to_vec(&Outcome::unknown("synthetic unresolved update")).unwrap();
|
||||
f.db.execute("UPDATE execution_evidence SET outcome=?1", [&unknown])
|
||||
.unwrap();
|
||||
f.db.execute("UPDATE consumed SET result=?1", [&unknown])
|
||||
.unwrap();
|
||||
let before = f.db.total_changes();
|
||||
assert!(
|
||||
verify_history(
|
||||
&f.db,
|
||||
&f.guard,
|
||||
&f.binding,
|
||||
&f.keys,
|
||||
&f.baseline,
|
||||
&[],
|
||||
&f.active,
|
||||
)
|
||||
.is_err()
|
||||
);
|
||||
assert!(
|
||||
verify_history(
|
||||
&f.db,
|
||||
&f.guard,
|
||||
&f.binding,
|
||||
&f.keys,
|
||||
&f.baseline,
|
||||
std::slice::from_ref(&f.active),
|
||||
&returned,
|
||||
)
|
||||
.is_err()
|
||||
);
|
||||
let retained: Vec<u8> =
|
||||
f.db.query_row("SELECT outcome FROM execution_evidence", [], |r| r.get(0))
|
||||
.unwrap();
|
||||
assert_eq!(retained, unknown);
|
||||
assert_eq!(f.db.total_changes(), before);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn completed_history_rejects_file_only_rollback_forks_and_tampered_activation_without_writes() {
|
||||
let f = fixture();
|
||||
|
||||
@@ -2,15 +2,32 @@
|
||||
const fs = require('node:fs');
|
||||
const path = require('node:path');
|
||||
const crypto = require('node:crypto');
|
||||
const { isDeepStrictEqual } = require('node:util');
|
||||
const { chromium } = require('../../web/node_modules/playwright');
|
||||
const root = path.resolve(__dirname, '../..');
|
||||
const assert = (value) => { if (!value) throw new Error('UI contract mismatch'); };
|
||||
function checkWindowsHello(job, planBytes) {
|
||||
const payload = job.payload;
|
||||
const action = {
|
||||
action: 'run_script', interpreter: 'powershell', script_utf8: "Write-Output 'Zeitprofil-Test'\r\n",
|
||||
arguments: [], expected_stdout: 'Zeitprofil-Test\r\n', windows_execution_profile: 'powershell_51_remote_signed',
|
||||
};
|
||||
const stored = JSON.parse(Buffer.from(planBytes).toString('utf8'));
|
||||
assert(stored.jobs.length === 1 && isDeepStrictEqual(stored.jobs[0].payload, payload));
|
||||
assert(payload.tenant_id === '11111111-1111-4111-8111-111111111111'
|
||||
&& payload.agent_id === '63ea15b2-0643-403d-b5b4-cba1288dbea3'
|
||||
&& payload.asset_id === 'a176520e-8a91-4e93-a78b-8e7620f430e0'
|
||||
&& payload.execution_identity === 'agent_service' && isDeepStrictEqual(payload.action, action));
|
||||
assert(stored.jobs[0].job_payload_hash === job.job_payload_hash
|
||||
&& stored.jobs[0].script_sha256 === job.script_sha256
|
||||
&& crypto.createHash('sha256').update(action.script_utf8, 'utf8').digest('hex') === job.script_sha256);
|
||||
}
|
||||
(async () => {
|
||||
const file = path.resolve(process.argv[2]);
|
||||
const stat = fs.lstatSync(file);
|
||||
assert(stat.isFile() && !stat.isSymbolicLink() && stat.uid === process.getuid() && (stat.mode & 0o777) === 0o600);
|
||||
const expected = JSON.parse(fs.readFileSync(file, 'utf8'));
|
||||
assert(expected.profile === 'dev/test' && ['hello', 'refresh_inventory', 'cancel_queued'].includes(expected.case));
|
||||
assert(expected.profile === 'dev/test' && ['hello', 'refresh_inventory', 'cancel_queued', 'windows_hello'].includes(expected.case));
|
||||
assert(expected.expected_principal === 'simulated-testprincipal-a');
|
||||
const loginFile = path.join(root, 'credentials/server-browser-login.json');
|
||||
const loginStat = fs.lstatSync(loginFile);
|
||||
@@ -38,7 +55,7 @@ const assert = (value) => { if (!value) throw new Error('UI contract mismatch');
|
||||
assert(pending.approval_state === 'pending_approval' && pending.job_count === 0 && pending.execution_state === null);
|
||||
await op.getByRole('button', { name: 'Unveränderlichen Plan zur Prüfung öffnen', exact: true }).click();
|
||||
const detail = page.locator('section').filter({ has: page.getByRole('heading', { name: 'Unveränderlicher Plan / Genehmigungsdetail', exact: true }) });
|
||||
const rendered = JSON.parse(await detail.locator('pre').first().innerText());
|
||||
const rendered = JSON.parse(await detail.getByLabel('Alle festen Zielpreviews, exakte Skriptinhalte/Hashes, Parameter, Rechte, Fristen, Rollout und Nachbedingungen', { exact: true }).innerText());
|
||||
assert(rendered.plan_hash === expected.plan.plan_hash && crypto.createHash('sha256').update(Buffer.from(rendered.plan_payload_bytes)).digest('hex') === expected.plan.plan_hash);
|
||||
assert(JSON.stringify(rendered.plan_payload_bytes) === JSON.stringify(expected.plan.plan_payload_bytes));
|
||||
assert(rendered.jobs.length === 1 && rendered.resolved_targets.length === 1);
|
||||
@@ -47,7 +64,15 @@ const assert = (value) => { if (!value) throw new Error('UI contract mismatch');
|
||||
assert(payload.agent_id === expected.agent_id && payload.asset_id === expected.asset_id && payload.tenant_id === expected.tenant_id);
|
||||
assert(payload.execution_identity === 'agent_service' && payload.max_runtime_seconds === 60 && payload.max_output_bytes <= 65536);
|
||||
assert(Date.parse(payload.start_before) > Date.now());
|
||||
if (expected.case === 'hello' || expected.case === 'cancel_queued') assert(payload.action.action === 'run_script' && payload.action.interpreter === 'posix_sh' && payload.action.script_utf8 === "printf '%s\\n' 'Hello World'\n" && payload.action.expected_stdout === 'Hello World\n');
|
||||
if (expected.case === 'windows_hello') {
|
||||
checkWindowsHello(job, rendered.plan_payload_bytes);
|
||||
assert(expected.stage === 'pending_approval' && expected.preapproval.jobs === 0
|
||||
&& expected.preapproval.outbox === 0 && expected.preapproval.permits === 0);
|
||||
assert(pending.plan_id === rendered.plan_id && pending.operation_id === expected.operation_id);
|
||||
await detail.getByLabel('Feste PowerShell-Prozessprofile', { exact: true })
|
||||
.getByText('Asset: ' + payload.asset_id + ' · Windows PowerShell5.1 · agent_service · RemoteSigned · nur Jobprozess', { exact: true }).waitFor();
|
||||
}
|
||||
else if (expected.case === 'hello' || expected.case === 'cancel_queued') assert(payload.action.action === 'run_script' && payload.action.interpreter === 'posix_sh' && payload.action.script_utf8 === "printf '%s\\n' 'Hello World'\n" && payload.action.expected_stdout === 'Hello World\n');
|
||||
else assert(payload.action.action === 'refresh_inventory' && payload.action.scope === 'linux.base');
|
||||
const approve = detail.getByRole('button', { name: 'SIMULIERT: Diesen festen Plan ausdrücklich genehmigen', exact: true });
|
||||
assert(await approve.isDisabled());
|
||||
|
||||
@@ -6,6 +6,7 @@ Credentials stay on the cloud server; the browser reads its protected login
|
||||
file. All SQL is fixed read-only evidence, scoped to the one cloud VM.
|
||||
"""
|
||||
import argparse
|
||||
from datetime import timedelta
|
||||
import hashlib
|
||||
import http.client
|
||||
import json
|
||||
@@ -24,6 +25,38 @@ import vm_mvp_acceptance as contract
|
||||
ROOT = bootstrap.ROOT
|
||||
TENANT = bootstrap.TENANT
|
||||
require = bootstrap.require
|
||||
WINDOWS_AGENT = '63ea15b2-0643-403d-b5b4-cba1288dbea3'
|
||||
WINDOWS_ASSET = 'a176520e-8a91-4e93-a78b-8e7620f430e0'
|
||||
WINDOWS_SCRIPT = "Write-Output 'Zeitprofil-Test'\r\n"
|
||||
WINDOWS_STDOUT = 'Zeitprofil-Test\r\n'
|
||||
|
||||
|
||||
def windows_hello_input():
|
||||
start = contract.now()
|
||||
return dict(
|
||||
tenant_id=TENANT, action='run_script', targets=dict(asset_ids=[WINDOWS_ASSET]),
|
||||
parameters=dict(
|
||||
execution_identity='agent_service', timeout_seconds=60, max_output_bytes=65536,
|
||||
arguments=[], expected_stdout=WINDOWS_STDOUT,
|
||||
variants=[dict(os_family='windows', interpreter='powershell', encoding='utf-8',
|
||||
script_utf8=WINDOWS_SCRIPT, windows_execution_profile='powershell_51_remote_signed')]),
|
||||
schedule=contract.schedule(start, start + timedelta(minutes=15)),
|
||||
rollout=dict(max_parallel=1, halt_after_failures=1),
|
||||
reason='Erste genehmigte PowerShell-Textausgabe auf der Windows-Test-VM')
|
||||
|
||||
|
||||
def verify_windows_hello(result):
|
||||
report = result['result']
|
||||
proof = report['evidence']
|
||||
contract.require(result['state'] == 'succeeded' and report['exit_code'] == 0
|
||||
and bytes(report['stdout']) == WINDOWS_STDOUT.encode() and bytes(report['stderr']) == b''
|
||||
and report['output_truncated'] is False and proof['postconditions_passed'] is True
|
||||
and proof['execution_sid'] == 'S-1-5-19' and proof['interpreter'] == 'powershell'
|
||||
and proof['script_sha256'] == hashlib.sha256(WINDOWS_SCRIPT.encode()).hexdigest()
|
||||
and proof['windows_execution_profile'] == 'powershell_51_remote_signed'
|
||||
and proof['execution_policy'] == 'process_remote_signed_requested'
|
||||
and proof['execution_policy_requested'] == 'RemoteSigned'
|
||||
and proof['execution_policy_scope'] == 'process', 'windows_hello_evidence')
|
||||
|
||||
|
||||
def prepare_browser():
|
||||
@@ -147,13 +180,18 @@ class Backend:
|
||||
def main():
|
||||
parser=argparse.ArgumentParser(description=__doc__)
|
||||
parser.add_argument('--execute-dev-test-ui',action='store_true',required=True)
|
||||
parser.add_argument('--case',choices=('hello','refresh_inventory','cancel_queued'),default='hello')
|
||||
parser.add_argument('--case',choices=('hello','refresh_inventory','cancel_queued','windows_hello'),default='hello')
|
||||
parser.add_argument('--transport',choices=('wss','https'))
|
||||
args=parser.parse_args();os.umask(0o077)
|
||||
contract.require(not (Path.home()/'.local/share/rust-discovery/remote-agent').exists(),'notebook_must_not_have_client')
|
||||
prepare_browser()
|
||||
installed=contract.protected_json(ROOT/'devstate/remote-vm.json')
|
||||
identity=installed['identity']
|
||||
windows = args.case == 'windows_hello'
|
||||
if windows:
|
||||
contract.require(args.transport is None, 'windows_keep_current_transport')
|
||||
identity = dict(agent_id=WINDOWS_AGENT, asset_id=WINDOWS_ASSET)
|
||||
else:
|
||||
prepare_browser()
|
||||
installed=contract.protected_json(ROOT/'devstate/remote-vm.json')
|
||||
identity=installed['identity']
|
||||
settings=dict(tenant_id=TENANT,**identity)
|
||||
def evidence(kind,**extra):
|
||||
return bootstrap.rpc('server.conf',server,dict(kind=kind,tenant_id=TENANT,agent_id=identity['agent_id'],**extra))
|
||||
@@ -172,11 +210,18 @@ def main():
|
||||
observed=bootstrap.rpc('server.conf',bootstrap.server,dict(action='observe',agent_id=identity['agent_id']))
|
||||
contract.require(observed['sync_ready'] and not observed['restore_blocked'],'signed_sync_gate_required')
|
||||
needed={'refresh_inventory' if args.case=='refresh_inventory' else 'run_script','rmm.sync.v1'}
|
||||
if windows:
|
||||
needed.update(('windows.base/1', 'script.powershell/1', 'script.powershell.process_remote_signed/1'))
|
||||
contract.require(needed<=set(device['capabilities']),'actual_vm_capability_required')
|
||||
request=contract.case_input(args.case,settings)
|
||||
if windows:
|
||||
prepare_browser()
|
||||
request=windows_hello_input() if windows else contract.case_input(args.case,settings)
|
||||
plan=backend.call('operations.plan',dict(tenant_id=TENANT,input=request))
|
||||
contract.require(hashlib.sha256(bytes(plan['plan_payload_bytes'])).hexdigest()==plan['plan_hash'] and len(plan['jobs'])==1,'immutable_plan')
|
||||
job=plan['jobs'][0]
|
||||
if windows:
|
||||
contract.require(job['payload']['agent_id']==WINDOWS_AGENT and job['payload']['asset_id']==WINDOWS_ASSET
|
||||
and job['payload']['tenant_id']==TENANT, 'fixed_windows_target_required')
|
||||
folder=ROOT/'devstate/cloud-acceptance'/uuid.uuid4().hex;folder.mkdir(mode=0o700,parents=True)
|
||||
checkpoint=dict(profile='dev/test',case=args.case,expected_principal='simulated-testprincipal-a',**settings,
|
||||
plan=plan,job=job,stage='planned',no_retry=True,transport=observed['transport'],server_connection=observed)
|
||||
@@ -205,6 +250,8 @@ def main():
|
||||
contract.require(result['state']=='succeeded' and result['result']['evidence']['postconditions_passed'],'native_postconditions_required')
|
||||
if args.case=='hello':
|
||||
contract.require(result['result']['exit_code']==0 and bytes(result['result']['stdout'])==b'Hello World\n','exact_stdout_required')
|
||||
elif windows:
|
||||
verify_windows_hello(result)
|
||||
elif args.case=='refresh_inventory':
|
||||
contract.require(contract.timestamp(result['result']['evidence']['observed_at'])>=contract.timestamp(request['schedule']['not_before']),'fresh_inventory_required')
|
||||
gate=evidence('gate',job_id=job['job_id']);audit=evidence('audit',operation_id=pending['operation_id'])
|
||||
|
||||
@@ -0,0 +1,428 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
# Finish the single, console-verified public-file publication on the test VM.
|
||||
# Run in a fresh Windows PowerShell process. No SSH or RMM job is involved.
|
||||
[CmdletBinding()]
|
||||
param([switch]$InitialCreate, [switch]$ResumeEmpty)
|
||||
$ErrorActionPreference = 'Stop'
|
||||
if ($InitialCreate -and $ResumeEmpty) { throw 'Choose one publication operation' }
|
||||
$caseId = 'ad9fd154-b2be-4f5d-9e17-65abb721ceaf'
|
||||
$controllerHash = 'd8b4fd4fd9ca5310cc1591ce3c2ccae5bd72a2ade43b21a8187cfdfb960b3427'
|
||||
$configHash = '2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b'
|
||||
$bootstrap = 'C:\ProgramData\RustDiscoveryBootstrap'
|
||||
$casePath = Join-Path $bootstrap "time-profile-$caseId"
|
||||
$original = Join-Path (Join-Path $bootstrap $controllerHash) 'InstallPublicTimeProfile.ps1'
|
||||
$originalBytes = [IO.File]::ReadAllBytes($original)
|
||||
$sha = [Security.Cryptography.SHA256]::Create()
|
||||
try {
|
||||
$digest = [BitConverter]::ToString($sha.ComputeHash($originalBytes)).Replace('-', '')
|
||||
} finally { $sha.Dispose() }
|
||||
if ($digest -ne $controllerHash) { throw 'Unexpected original controller' }
|
||||
|
||||
# Import the verified definitions (including native FileID/SCM checks) from the
|
||||
# installed original. Its first top-level preflight and install body are excluded.
|
||||
$source = [Text.Encoding]::UTF8.GetString($originalBytes)
|
||||
$boundary = "`nCheckControl `$boot `$true`n"
|
||||
$index = $source.IndexOf($boundary, [StringComparison]::Ordinal)
|
||||
if ($index -lt 1 -or $index -ne $source.LastIndexOf($boundary, [StringComparison]::Ordinal)) {
|
||||
throw 'Original controller definition boundary missing'
|
||||
}
|
||||
$intent = Get-Content -LiteralPath (Join-Path $casePath 'intent.json') -Raw | ConvertFrom-Json
|
||||
if ($intent.id -cne $caseId -or $intent.request.id -cne $caseId -or
|
||||
$intent.request.script_sha256 -cne $controllerHash -or $intent.request.config_sha256 -cne $configHash) {
|
||||
throw 'Unexpected original intent'
|
||||
}
|
||||
$global:RmmTimeProfilePayload = $intent.request
|
||||
. ([scriptblock]::Create($source.Substring(0, $index)))
|
||||
|
||||
CheckControl $boot $true
|
||||
CheckControl $folder $true
|
||||
foreach ($leaf in 'intent.json','publish-intent.json','directory-acl-intent.json','directory-acl-done.json') {
|
||||
CheckControl (Join-Path $folder $leaf) $false
|
||||
}
|
||||
CheckControl $active $false
|
||||
$activeRecord = Get-Content -LiteralPath $active -Raw | ConvertFrom-Json
|
||||
if ($activeRecord.id -cne $caseId -or $activeRecord.script_sha256 -cne $controllerHash -or
|
||||
$activeRecord.config_sha256 -cne $configHash -or $activeRecord.no_retry -ne $true) {
|
||||
throw 'Unexpected active publication record'
|
||||
}
|
||||
$bytes = ConfigBytes
|
||||
$publish = Get-Content -LiteralPath (Join-Path $folder 'publish-intent.json') -Raw | ConvertFrom-Json
|
||||
$aclDone = Get-Content -LiteralPath (Join-Path $folder 'directory-acl-done.json') -Raw | ConvertFrom-Json
|
||||
$staged = Join-Path $folder 'time-attestation.candidate.json'
|
||||
$resultPath = Join-Path $folder 'result.json'
|
||||
$reservation = Join-Path $folder 'console-finalization-intent.json'
|
||||
$initialReservation = Join-Path $folder 'console-initial-create-intent.json'
|
||||
$initialResult = Join-Path $folder 'console-initial-create-result.json'
|
||||
$initialError = Join-Path $folder 'console-initial-create-error.json'
|
||||
$initialVerified = Join-Path $folder 'console-initial-create-verified.json'
|
||||
$resumeReservation = Join-Path $folder 'console-resume-empty-intent.json'
|
||||
$resumeVerified = Join-Path $folder 'console-resume-empty-verified.json'
|
||||
$resumeResult = Join-Path $folder 'console-resume-empty-result.json'
|
||||
$resumeError = Join-Path $folder 'console-resume-empty-error.json'
|
||||
$absent = @($resultPath,$initialVerified,$initialResult,$resumeReservation,$resumeVerified,$resumeResult,$resumeError)
|
||||
if (!$ResumeEmpty) { $absent += @($target,$initialReservation,$initialError) }
|
||||
if ($InitialCreate -or $ResumeEmpty) {
|
||||
$priorError = Join-Path $folder 'console-finalization-error.json'
|
||||
CheckControl $reservation $false
|
||||
CheckControl $priorError $false
|
||||
$priorReservation = Get-Content -LiteralPath $reservation -Raw | ConvertFrom-Json
|
||||
$priorFailure = Get-Content -LiteralPath $priorError -Raw | ConvertFrom-Json
|
||||
if ($priorReservation.id -cne $caseId -or $priorReservation.config_sha256 -cne $configHash -or
|
||||
$priorFailure.id -cne $caseId -or $priorFailure.phase -cne 'File.Move' -or
|
||||
$priorFailure.hresult -cne '0x80070020' -or $priorFailure.exception -cne 'System.IO.IOException') {
|
||||
throw 'Expected the recorded sharing violation from the original single finalization attempt'
|
||||
}
|
||||
} else {
|
||||
$absent += $reservation
|
||||
}
|
||||
foreach ($path in $absent) {
|
||||
if (Test-Path -LiteralPath $path) { throw 'Existing target or finalization record: read original case' }
|
||||
}
|
||||
$stagedAcl = ReadAcl $staged $false
|
||||
$rootAcl = ReadAcl $helperRoot $true
|
||||
$expected = @{
|
||||
volume_serial = '9815088561147542064'
|
||||
file_id = '6d990300000003000000000000000000'
|
||||
bytes = 1177
|
||||
acl_sha256 = '3a426f649cd6ff4e82bf70205c8ecc7d5b2c0775fa1e10fc30ce35de9bb12493'
|
||||
sha256 = $configHash
|
||||
}
|
||||
if ($publish.create_once -ne $true -or $publish.config_sha256 -cne $configHash -or
|
||||
!(JsonEqual $expected $publish.staged) -or !(JsonEqual $expected (FileIdentity $staged)) -or
|
||||
(FileVolume $helperRoot) -cne $expected.volume_serial -or $rootAcl.Sddl -cne $aclDone.sddl -or
|
||||
(AclHash $helperRoot) -cne '186d85132cf0e16cbb9623ad9636b7777741939a8cae3d689a2af1eb267a7f49') {
|
||||
throw 'Original file identity or permissions changed'
|
||||
}
|
||||
if ($ResumeEmpty) {
|
||||
CheckControl $initialReservation $false
|
||||
CheckControl $initialError $false
|
||||
$creation = Get-Content -LiteralPath $initialReservation -Raw | ConvertFrom-Json
|
||||
$failure = Get-Content -LiteralPath $initialError -Raw | ConvertFrom-Json
|
||||
if ($creation.id -cne $caseId -or $creation.config_sha256 -cne $configHash -or
|
||||
$creation.create_new -isnot [bool] -or !$creation.create_new -or !$creation.utc -or
|
||||
!(JsonEqual $expected $creation.staged) -or $failure.id -cne $caseId -or
|
||||
$failure.phase -cne 'verify_creation' -or $failure.hresult -cne '0x80131501' -or
|
||||
$failure.exception -cne 'System.Management.Automation.RuntimeException') {
|
||||
throw 'Unexpected initial creation intent or failure'
|
||||
}
|
||||
}
|
||||
if ($p.probe_sha256 -cne '727732fb4b38ac5431a330527bd52a3ab80af8f189ae75a7b48eceb1d4b69cac' -or
|
||||
$p.system_probe_sha256 -cne '77a344912c61b7ac4a92152ae1b534ca7c36fe6f7dc4675783f20558c3a7f434') {
|
||||
throw 'Unexpected native status probes'
|
||||
}
|
||||
$before = ActualState $true
|
||||
SameLive $request.expected_native $before
|
||||
SameLive $intent.before $before
|
||||
if ($before.agent_kernel.creation_filetime -cne '134392294174782153' -or
|
||||
$before.helper_kernel.creation_filetime -cne '134392294130218261') { throw 'Service generation changed' }
|
||||
|
||||
# FileStandardInfo supplies the hard-link count and directory/delete-pending state
|
||||
# from the same exclusive handle used to write, flush, hash and publish the DACL.
|
||||
function Initialize-InitialProfileNative {
|
||||
Add-Type -TypeDefinition @'
|
||||
using System;
|
||||
using System.ComponentModel;
|
||||
using System.IO;
|
||||
using System.Runtime.InteropServices;
|
||||
using Microsoft.Win32.SafeHandles;
|
||||
|
||||
public static class RmmInitialProfileFile {
|
||||
[StructLayout(LayoutKind.Sequential)]
|
||||
private struct StandardInfo {
|
||||
public long AllocationSize, EndOfFile;
|
||||
public uint NumberOfLinks;
|
||||
public byte DeletePending, Directory;
|
||||
}
|
||||
[DllImport("kernel32.dll", SetLastError=true)]
|
||||
private static extern bool GetFileInformationByHandleEx(
|
||||
SafeFileHandle handle, int infoClass, out StandardInfo info, uint size);
|
||||
[StructLayout(LayoutKind.Sequential)]
|
||||
private struct TagInfo { public uint Attributes, ReparseTag; }
|
||||
|
||||
[DllImport("kernel32.dll", SetLastError=true)]
|
||||
private static extern bool GetFileInformationByHandleEx(
|
||||
SafeFileHandle handle, int infoClass, out TagInfo info, uint size);
|
||||
[DllImport("kernel32.dll", CharSet=CharSet.Unicode, ExactSpelling=true, SetLastError=true)]
|
||||
private static extern SafeFileHandle CreateFileW(string path, uint access, uint sharing,
|
||||
IntPtr security, uint disposition, uint flags, IntPtr template);
|
||||
|
||||
private static void CheckAttributes(SafeFileHandle handle, bool directory) {
|
||||
TagInfo info;
|
||||
if (!GetFileInformationByHandleEx(handle, 9, out info, (uint)Marshal.SizeOf(typeof(TagInfo))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if ((info.Attributes & (uint)FileAttributes.ReparsePoint) != 0 ||
|
||||
((info.Attributes & (uint)FileAttributes.Directory) != 0) != directory)
|
||||
throw new InvalidOperationException("Unexpected file type or reparse point");
|
||||
}
|
||||
|
||||
[StructLayout(LayoutKind.Sequential)]
|
||||
private struct UnicodeString { public ushort Length, MaximumLength; public IntPtr Buffer; }
|
||||
[StructLayout(LayoutKind.Sequential)]
|
||||
private struct ObjectAttributes {
|
||||
public int Length;
|
||||
public IntPtr RootDirectory, ObjectName;
|
||||
public uint Attributes;
|
||||
public IntPtr SecurityDescriptor, SecurityQoS;
|
||||
}
|
||||
[StructLayout(LayoutKind.Sequential)]
|
||||
private struct IoStatus { public IntPtr Status, Information; }
|
||||
[DllImport("ntdll.dll")]
|
||||
private static extern int NtOpenFile(out SafeFileHandle file, uint access, ref ObjectAttributes attributes,
|
||||
out IoStatus io, uint share, uint options);
|
||||
[DllImport("ntdll.dll")]
|
||||
private static extern uint RtlNtStatusToDosError(int status);
|
||||
|
||||
// Open-only, relative to the held volume root. OBJ_DONT_REPARSE applies to
|
||||
// the complete relative path, including ProgramData and the helper directory.
|
||||
public static FileStream OpenExistingTarget() {
|
||||
const string relativePath = @"ProgramData\RustDiscoverySystem\time-attestation.json";
|
||||
const uint backupSemanticsNoFollow = 0x02200000;
|
||||
using (SafeFileHandle root = CreateFileW(@"C:\", 0xA0, 7, IntPtr.Zero, 3,
|
||||
backupSemanticsNoFollow, IntPtr.Zero)) {
|
||||
if (root.IsInvalid) throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
CheckAttributes(root, true);
|
||||
UnicodeString name = new UnicodeString();
|
||||
name.Length = checked((ushort)(relativePath.Length * sizeof(char)));
|
||||
name.MaximumLength = name.Length;
|
||||
name.Buffer = Marshal.StringToHGlobalUni(relativePath);
|
||||
IntPtr nativeName = IntPtr.Zero;
|
||||
try {
|
||||
nativeName = Marshal.AllocHGlobal(Marshal.SizeOf(typeof(UnicodeString)));
|
||||
Marshal.StructureToPtr(name, nativeName, false);
|
||||
ObjectAttributes attributes = new ObjectAttributes();
|
||||
attributes.Length = Marshal.SizeOf(typeof(ObjectAttributes));
|
||||
attributes.RootDirectory = root.DangerousGetHandle();
|
||||
attributes.ObjectName = nativeName;
|
||||
attributes.Attributes = 0x1040; // OBJ_DONT_REPARSE | OBJ_CASE_INSENSITIVE
|
||||
const uint readWriteAcl = 0x00160083; // synchronize, WRITE_DAC, READ_CONTROL, attributes and data
|
||||
const uint options = 0x62; // FILE_NON_DIRECTORY_FILE | FILE_SYNCHRONOUS_IO_NONALERT | FILE_WRITE_THROUGH
|
||||
IoStatus io;
|
||||
SafeFileHandle h;
|
||||
int status = NtOpenFile(out h, readWriteAcl, ref attributes, out io, 0, options);
|
||||
if (status != 0) throw new Win32Exception((int)RtlNtStatusToDosError(status));
|
||||
try {
|
||||
CheckSingleFile(h, 0);
|
||||
return new FileStream(h, FileAccess.ReadWrite);
|
||||
} catch { h.Dispose(); throw; }
|
||||
} finally {
|
||||
Marshal.FreeHGlobal(nativeName);
|
||||
Marshal.FreeHGlobal(name.Buffer);
|
||||
}
|
||||
}
|
||||
}
|
||||
public static void CheckSingleFile(SafeFileHandle handle, long expectedLength) {
|
||||
CheckAttributes(handle, false);
|
||||
StandardInfo info;
|
||||
if (!GetFileInformationByHandleEx(handle, 1, out info, (uint)Marshal.SizeOf(typeof(StandardInfo))))
|
||||
throw new Win32Exception(Marshal.GetLastWin32Error());
|
||||
if (info.NumberOfLinks != 1 || info.DeletePending != 0 || info.Directory != 0 ||
|
||||
info.EndOfFile != expectedLength)
|
||||
throw new InvalidOperationException("Expected one regular file of the exact size");
|
||||
}
|
||||
}
|
||||
'@
|
||||
}
|
||||
|
||||
function Get-HeldProfileFileId([IO.FileStream]$Stream) {
|
||||
$id = New-Object RmmPipeNative+FileId
|
||||
if (![RmmPipeNative]::GetFileInformationByHandleEx($Stream.SafeFileHandle, 18, [ref]$id, 24)) {
|
||||
throw 'New file identity unavailable'
|
||||
}
|
||||
return @{
|
||||
volume_serial=$id.Volume.ToString([Globalization.CultureInfo]::InvariantCulture)
|
||||
file_id=([BitConverter]::ToString($id.Id)).Replace('-','').ToLowerInvariant()
|
||||
}
|
||||
}
|
||||
|
||||
function Get-HeldProfileIdentity([IO.FileStream]$Stream) {
|
||||
[RmmInitialProfileFile]::CheckSingleFile($Stream.SafeFileHandle, 1177)
|
||||
$identity = Get-HeldProfileFileId $Stream
|
||||
$Stream.Position = 0
|
||||
$algorithm = [Security.Cryptography.SHA256]::Create()
|
||||
try { $digest = [BitConverter]::ToString($algorithm.ComputeHash($Stream)).Replace('-','').ToLowerInvariant() }
|
||||
finally { $algorithm.Dispose() }
|
||||
$sddl = $Stream.GetAccessControl().GetSecurityDescriptorSddlForm($aclSections)
|
||||
$identity.bytes = $Stream.Length
|
||||
$identity.sha256 = $digest
|
||||
$identity.acl_sha256 = BytesHash ([Text.Encoding]::UTF8.GetBytes($sddl))
|
||||
return $identity
|
||||
}
|
||||
|
||||
# Both accepted strings retain the protected DACL, owner, group and all ACEs.
|
||||
# Windows stored the newly created file without the auto-inherited marker.
|
||||
function Test-ProfileDescriptor([string]$ExpectedSddl, [string]$ActualSddl) {
|
||||
if (!$ExpectedSddl.StartsWith('O:BAG:BAD:PAI(', [StringComparison]::Ordinal)) { return $false }
|
||||
return $ActualSddl -ceq $ExpectedSddl -or $ActualSddl -ceq $ExpectedSddl.Replace('D:PAI(', 'D:P(')
|
||||
}
|
||||
|
||||
function New-OriginalPublicProfile {
|
||||
Initialize-InitialProfileNative
|
||||
$aclSections = [Security.AccessControl.AccessControlSections]'Owner,Group,Access'
|
||||
$accessOnly = [Security.AccessControl.AccessControlSections]::Access
|
||||
$draftAcl = [Security.AccessControl.FileSecurity]::new()
|
||||
$draftAcl.SetSecurityDescriptorSddlForm($stagedAcl.Sddl, $aclSections)
|
||||
foreach ($sid in @($agentSid,$helperSid)) {
|
||||
$deny = [Security.AccessControl.FileSystemAccessRule]::new(
|
||||
[Security.Principal.SecurityIdentifier]::new($sid),
|
||||
[Security.AccessControl.FileSystemRights]::ReadData, [Security.AccessControl.AccessControlType]::Deny)
|
||||
$draftAcl.AddAccessRule($deny)
|
||||
}
|
||||
$draftSddl = $draftAcl.GetSecurityDescriptorSddlForm($aclSections)
|
||||
if (!$draftAcl.AreAccessRulesProtected -or $draftSddl -ceq $stagedAcl.Sddl) { throw 'Initial protected DACL required' }
|
||||
|
||||
if ((BytesHash ([Text.Encoding]::UTF8.GetBytes($draftSddl))) -cne
|
||||
'd4726c7973c9b0cd8a66c1b129d1b5eb58d2bbfc1b103018e0a31a71fb1d9020') {
|
||||
throw 'Unexpected draft descriptor for this case'
|
||||
}
|
||||
$reserved = $false
|
||||
$phase = 'CreateNew'
|
||||
$descriptorFailure = $null
|
||||
if ($ResumeEmpty) {
|
||||
$attemptResult = $resumeResult
|
||||
$attemptError = $resumeError
|
||||
$attemptVerified = $resumeVerified
|
||||
} else {
|
||||
$attemptResult = $initialResult
|
||||
$attemptError = $initialError
|
||||
$attemptVerified = $initialVerified
|
||||
}
|
||||
try {
|
||||
if ($ResumeEmpty) {
|
||||
$phase = 'open_existing_empty'
|
||||
$stream = [RmmInitialProfileFile]::OpenExistingTarget()
|
||||
} else {
|
||||
$since = [DateTime]::UtcNow.ToString('o')
|
||||
WriteNew $initialReservation @{id=$caseId; config_sha256=$configHash; utc=$since; staged=$expected; create_new=$true}
|
||||
$reserved = $true
|
||||
$rights = [Security.AccessControl.FileSystemRights]'ReadData,WriteData,ReadAttributes,ReadPermissions,ChangePermissions,Synchronize'
|
||||
$stream = [IO.FileStream]::new($target, [IO.FileMode]::CreateNew,
|
||||
$rights, [IO.FileShare]::None, 4096,
|
||||
[IO.FileOptions]::WriteThrough, $draftAcl)
|
||||
}
|
||||
try {
|
||||
$phase = 'verify_creation'
|
||||
$actualSddl = $stream.GetAccessControl().GetSecurityDescriptorSddlForm($aclSections)
|
||||
if (!(Test-ProfileDescriptor $draftSddl $actualSddl)) {
|
||||
$descriptorFailure = @{expected_sddl=$draftSddl; actual_sddl=$actualSddl; bytes=$null}
|
||||
try {
|
||||
$descriptorFailure.bytes = $stream.Length
|
||||
$fileId = Get-HeldProfileFileId $stream
|
||||
$descriptorFailure.file_id = $fileId.file_id
|
||||
$descriptorFailure.volume_serial = $fileId.volume_serial
|
||||
} catch {
|
||||
$descriptorFailure.metadata_hresult = '0x{0:X8}' -f $_.Exception.GetBaseException().HResult
|
||||
}
|
||||
throw 'Unexpected security descriptor on new file'
|
||||
}
|
||||
[RmmInitialProfileFile]::CheckSingleFile($stream.SafeFileHandle, 0)
|
||||
$emptyId = Get-HeldProfileFileId $stream
|
||||
if ($emptyId.volume_serial -cne $expected.volume_serial -or
|
||||
$emptyId.file_id -ceq $expected.file_id -or $emptyId.file_id -ceq ('0' * 32)) {
|
||||
throw 'Unexpected volume or identity on held empty target'
|
||||
}
|
||||
$draftHash = BytesHash ([Text.Encoding]::UTF8.GetBytes($actualSddl))
|
||||
if ($ResumeEmpty) {
|
||||
$since = [DateTime]::UtcNow.ToString('o')
|
||||
WriteNew $resumeReservation @{
|
||||
id=$caseId; utc=$since; config_sha256=$configHash; target_id=$emptyId.file_id
|
||||
volume_serial=$emptyId.volume_serial; draft_acl_sha256=$draftHash; bytes=0
|
||||
}
|
||||
$reserved = $true
|
||||
}
|
||||
$phase = 'write_verify'
|
||||
$stream.Write($bytes, 0, $bytes.Length)
|
||||
$stream.Flush($true)
|
||||
$new = Get-HeldProfileIdentity $stream
|
||||
if ($new.volume_serial -cne $expected.volume_serial -or $new.file_id -ceq $expected.file_id -or
|
||||
$new.file_id -cne $emptyId.file_id -or $new.sha256 -cne $configHash -or
|
||||
$new.acl_sha256 -cne $draftHash) {
|
||||
throw 'New held bytes, identity or staging permissions differ'
|
||||
}
|
||||
SameLive $before (ActualState $true)
|
||||
$null = Kernel 'agent' $before.service $heldAgent
|
||||
$null = Kernel 'helper' $before.helper_service $heldHelper
|
||||
if (!(JsonEqual $expected (FileIdentity $staged)) -or (AclHash $helperRoot) -cne $rootAclHash) {
|
||||
throw 'Original source or target directory changed before publication'
|
||||
}
|
||||
WriteNew $attemptVerified @{
|
||||
id=$caseId; utc=$since; original_candidate=$expected; held_target=$new
|
||||
}
|
||||
# Change only the DACL by handle after the verified bytes and FileID
|
||||
# are durable. A crash before this point leaves service reads denied.
|
||||
$phase = 'publish_dacl'
|
||||
$final = $stream.GetAccessControl()
|
||||
$final.SetSecurityDescriptorSddlForm($stagedAcl.Sddl, $accessOnly)
|
||||
$stream.SetAccessControl($final)
|
||||
$stream.Flush($true)
|
||||
$actualFinal = $stream.GetAccessControl().GetSecurityDescriptorSddlForm($aclSections)
|
||||
if (!(Test-ProfileDescriptor $stagedAcl.Sddl $actualFinal)) { throw 'Unexpected final descriptor' }
|
||||
$new.acl_sha256 = BytesHash ([Text.Encoding]::UTF8.GetBytes($actualFinal))
|
||||
if (!(JsonEqual $new (Get-HeldProfileIdentity $stream))) { throw 'Held publication readback failed' }
|
||||
} finally { $stream.Dispose() }
|
||||
|
||||
$phase = 'readback'
|
||||
$null = ReadAcl $target $false
|
||||
$published = FileIdentity $target
|
||||
if (!(JsonEqual $new $published) -or !(JsonEqual $expected (FileIdentity $staged)) -or
|
||||
(AclHash $helperRoot) -cne $rootAclHash) { throw 'Final source/target binding failed' }
|
||||
$after = ActualState $true
|
||||
SameLive $before $after
|
||||
$null = Kernel 'agent' $before.service $heldAgent
|
||||
$null = Kernel 'helper' $before.helper_service $heldHelper
|
||||
$outcome = @{
|
||||
id=$caseId; installed=$true; publication_since=$since; configuration=$published
|
||||
original_candidate=$expected; source_candidate_preserved=$true; initial_create=$true
|
||||
native=$after; clock_runtime_qualified=$false; services_changed=$false; private_key_read=$false
|
||||
no_jobs=$true; original_move_failed=$true
|
||||
}
|
||||
if ($ResumeEmpty) { $outcome.resumed_empty = $true }
|
||||
WriteNew $attemptResult $outcome
|
||||
} catch {
|
||||
$cause = $_.Exception.GetBaseException()
|
||||
$failure = @{id=$caseId; phase=$phase; hresult=('0x{0:X8}' -f $cause.HResult); exception=$cause.GetType().FullName}
|
||||
if ($null -ne $descriptorFailure) { $failure.creation_descriptor = $descriptorFailure }
|
||||
if ($reserved) { WriteNew $attemptError $failure }
|
||||
throw
|
||||
}
|
||||
}
|
||||
|
||||
$heldAgent = [RmmPipeNative]::Open([int]$before.service.pid)
|
||||
try {
|
||||
$heldHelper = [RmmPipeNative]::Open([int]$before.helper_service.pid)
|
||||
try {
|
||||
$null = Kernel 'agent' $before.service $heldAgent
|
||||
$null = Kernel 'helper' $before.helper_service $heldHelper
|
||||
if ($InitialCreate -or $ResumeEmpty) {
|
||||
$rootAclHash = '186d85132cf0e16cbb9623ad9636b7777741939a8cae3d689a2af1eb267a7f49'
|
||||
New-OriginalPublicProfile
|
||||
'Zeitprofil am gebundenen Dateihandle veroeffentlicht und nachgelesen.'
|
||||
return
|
||||
}
|
||||
# WriteNew uses CreateNew. Concurrent or later invocations cannot republish.
|
||||
WriteNew $reservation @{id=$caseId; config_sha256=$configHash; utc=[DateTime]::UtcNow.ToString('o')}
|
||||
try {
|
||||
[IO.File]::Move($staged, $target)
|
||||
} catch {
|
||||
$cause = $_.Exception.GetBaseException()
|
||||
$failure = @{id=$caseId; phase='File.Move'; hresult=('0x{0:X8}' -f $cause.HResult); exception=$cause.GetType().FullName}
|
||||
WriteNew (Join-Path $folder 'console-finalization-error.json') $failure
|
||||
throw ("File.Move: {0} ({1})." -f $failure.exception, $failure.hresult)
|
||||
}
|
||||
$null = ReadAcl $target $false
|
||||
$published = FileIdentity $target
|
||||
if (!(JsonEqual $expected $published) -or (Test-Path -LiteralPath $staged)) { throw 'Publication postcheck failed' }
|
||||
$after = ActualState $true
|
||||
SameLive $before $after
|
||||
$null = Kernel 'agent' $before.service $heldAgent
|
||||
$null = Kernel 'helper' $before.helper_service $heldHelper
|
||||
WriteNew $resultPath @{
|
||||
id=$caseId; installed=$true; install_not_before=$intent.install_not_before
|
||||
configuration=$published; native=$after; original_root_sddl=$intent.original_root_sddl
|
||||
root_sddl=(Get-Acl -LiteralPath $helperRoot).Sddl; no_jobs=$true
|
||||
clock_runtime_qualified=$false; services_changed=$false; private_key_read=$false
|
||||
console_finalized=$true; original_move_failed=$true
|
||||
}
|
||||
'Zeitprofil veroeffentlicht; Dateiidentitaet und Dienstgenerationen geprueft.'
|
||||
} finally { $heldHelper.Dispose() }
|
||||
} finally { $heldAgent.Dispose() }
|
||||
@@ -0,0 +1,112 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
[CmdletBinding()]
|
||||
param(
|
||||
[Parameter(Mandatory)][DateTimeOffset]$PreviousExpiry,
|
||||
[Parameter(Mandatory)][DateTimeOffset]$Until,
|
||||
[switch]$ResumeInterrupted
|
||||
)
|
||||
$ErrorActionPreference = 'Stop'
|
||||
$utcNow = [DateTimeOffset]::UtcNow
|
||||
if ($PreviousExpiry -ge $utcNow -or $Until -le $utcNow -or $Until -gt $utcNow.AddHours(4)) {
|
||||
throw 'Expected an expired previous window and a new deadline within four hours.'
|
||||
}
|
||||
$dir = 'C:\ProgramData\RmmDevAccess'
|
||||
$configPath = Join-Path $dir 'bootstrap-public.json'
|
||||
$raw = [IO.File]::ReadAllText($configPath)
|
||||
$cfg = $raw | ConvertFrom-Json
|
||||
$user = Get-LocalUser -Name 'rmm-dev'
|
||||
$task = Get-ScheduledTask -TaskPath '\' -TaskName 'RmmDevReverseTunnel'
|
||||
$expectedState = if ($ResumeInterrupted) { 'Disabled' } else { 'Ready' }
|
||||
$expectedExpiry = if ($ResumeInterrupted) { $Until } else { $PreviousExpiry }
|
||||
$mismatches = @(
|
||||
if ($task.State -ne $expectedState) { "task state $($task.State) (expected $expectedState)" }
|
||||
if (!$user.Enabled) { 'rmm-dev is disabled' }
|
||||
if (!$user.AccountExpires) {
|
||||
'rmm-dev has no account expiry'
|
||||
} elseif ($user.AccountExpires.ToUniversalTime() -ne $expectedExpiry.UtcDateTime) {
|
||||
"account expiry $($user.AccountExpires.ToUniversalTime().ToString('o')) (expected $($expectedExpiry.UtcDateTime.ToString('o')))"
|
||||
}
|
||||
if ([DateTimeOffset]::Parse($cfg.expires_at) -ne $expectedExpiry) {
|
||||
"configuration expiry $($cfg.expires_at) (expected $($expectedExpiry.UtcDateTime.ToString('o')))"
|
||||
}
|
||||
if ($cfg.server -cne 'discovery.ease-technologies.de') { 'configured server differs' }
|
||||
$sshdState = (Get-Service -Name sshd).Status
|
||||
if ($sshdState -ne 'Running') { "sshd state $sshdState (expected Running)" }
|
||||
)
|
||||
if ($mismatches.Count -gt 0) {
|
||||
throw ('Maintenance window preflight failed: ' + ($mismatches -join ', '))
|
||||
}
|
||||
$pinned = (Get-Content -LiteralPath (Join-Path $dir 'known_hosts') -Raw).Trim()
|
||||
if ($pinned -cne ('discovery.ease-technologies.de ' + $cfg.server_host_key)) {
|
||||
throw 'Unexpected SSH host pin.'
|
||||
}
|
||||
$listeners = @(Get-NetTCPConnection -State Listen -LocalPort 22222)
|
||||
if ($listeners.Count -ne 1 -or $listeners[0].LocalAddress -ne '127.0.0.1') {
|
||||
throw 'Expected only the original loopback SSH listener.'
|
||||
}
|
||||
$backup = Join-Path $dir ('console-window-' + [guid]::NewGuid().ToString() + '.bak')
|
||||
$originalRaw = $raw
|
||||
if ($ResumeInterrupted) {
|
||||
$owners = @(Get-CimInstance Win32_Process -Filter "Name='powershell.exe' OR Name='pwsh.exe' OR Name='ssh.exe'" | Where-Object {
|
||||
$_.ProcessId -ne $PID -and ($_.CommandLine -match '(?:rmm-window-[0-9a-f-]+|Open-ConsoleMaintenanceWindow)\.ps1' -or
|
||||
($_.Name -eq 'ssh.exe' -and $_.CommandLine -match '127\.0\.0\.1:22240:127\.0\.0\.1:22222'))
|
||||
})
|
||||
if ($owners.Count) { throw 'An existing maintenance console or forwarding process is still active. End the original console with Ctrl+C first.' }
|
||||
$copies = @(Get-ChildItem -LiteralPath $dir -Filter 'console-window-*.bak' -File -Force)
|
||||
if ($copies.Count -ne 1 -or $copies[0].Name -notmatch '^console-window-[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}\.bak$' -or
|
||||
($copies[0].Attributes -band [IO.FileAttributes]::ReparsePoint) -or $copies[0].Length -gt 32768) {
|
||||
throw 'Expected one original maintenance-window backup.'
|
||||
}
|
||||
$backup = $copies[0].FullName
|
||||
if (Test-Path -LiteralPath ($backup + '.closed')) { throw 'Backup already closed.' }
|
||||
$originalRaw = [IO.File]::ReadAllText($backup)
|
||||
$original = $originalRaw | ConvertFrom-Json
|
||||
if ([DateTimeOffset]::Parse($original.expires_at) -ne $PreviousExpiry) { throw 'Backup expiry differs.' }
|
||||
$original.expires_at = $Until.ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:sszzz')
|
||||
if (($original | ConvertTo-Json -Compress) -cne $raw) { throw 'Backup does not reconstruct the current public configuration.' }
|
||||
}
|
||||
$candidate = $backup + '.new'
|
||||
$sshArgs = @('-F','NUL','-N','-T','-o','BatchMode=yes','-o','IdentitiesOnly=yes',
|
||||
'-o','ForwardAgent=no','-o','StrictHostKeyChecking=yes','-o','GlobalKnownHostsFile=NUL',
|
||||
'-o',('UserKnownHostsFile=' + $dir + '\known_hosts'),'-o','ExitOnForwardFailure=yes',
|
||||
'-o','ConnectTimeout=10','-o','ServerAliveInterval=15','-o','ServerAliveCountMax=2',
|
||||
'-i',($dir + '\tunnel_ed25519'),'-R','127.0.0.1:22240:127.0.0.1:22222',
|
||||
'rmm-win-tunnel@discovery.ease-technologies.de')
|
||||
$ssh = $null
|
||||
$disabled = $false
|
||||
$accountChanged = $false
|
||||
try {
|
||||
if (!$ResumeInterrupted) {
|
||||
$cfg.expires_at = $Until.ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:sszzz')
|
||||
[IO.File]::WriteAllText($candidate, ($cfg | ConvertTo-Json -Compress), (New-Object Text.UTF8Encoding($false)))
|
||||
Disable-ScheduledTask -InputObject $task | Out-Null
|
||||
$disabled = $true
|
||||
}
|
||||
if ((Get-ScheduledTask -TaskPath '\' -TaskName $task.TaskName).State -ne 'Disabled' -or
|
||||
[IO.File]::ReadAllText($configPath) -cne $raw) { throw 'Existing bootstrap changed.' }
|
||||
if ($ResumeInterrupted) {
|
||||
$disabled = $true
|
||||
} else {
|
||||
[IO.File]::Replace($candidate, $configPath, $backup)
|
||||
Set-LocalUser -SID $user.SID -AccountExpires $Until.LocalDateTime
|
||||
}
|
||||
$accountChanged = $true
|
||||
if ((Get-LocalUser -SID $user.SID).AccountExpires.ToUniversalTime() -ne $Until.UtcDateTime) {
|
||||
throw 'Unexpected account expiry after renewal.'
|
||||
}
|
||||
$ssh = Start-Process -FilePath "$env:WINDIR\System32\OpenSSH\ssh.exe" -ArgumentList $sshArgs -PassThru -NoNewWindow
|
||||
if ($ssh.WaitForExit(1500)) { throw "SSH exited with code $($ssh.ExitCode)." }
|
||||
Write-Host "Tunnelfenster gestartet bis $($Until.LocalDateTime). Zum Beenden Strg+C druecken."
|
||||
while ([DateTimeOffset]::UtcNow -lt $Until) {
|
||||
if ($ssh.WaitForExit(500)) { throw "SSH exited with code $($ssh.ExitCode)." }
|
||||
}
|
||||
} finally {
|
||||
if ($null -ne $ssh) {
|
||||
try { if (!$ssh.HasExited) { $ssh.Kill(); $ssh.WaitForExit() } } finally { $ssh.Dispose() }
|
||||
}
|
||||
if ($accountChanged) { Set-LocalUser -SID $user.SID -AccountExpires $PreviousExpiry.LocalDateTime }
|
||||
if ($disabled -and (Test-Path -LiteralPath $backup)) { [IO.File]::Replace($backup, $configPath, ($backup + '.closed')) }
|
||||
if ($disabled -and [IO.File]::ReadAllText($configPath) -ceq $originalRaw) { Enable-ScheduledTask -InputObject $task | Out-Null }
|
||||
if (!$ResumeInterrupted -and (Test-Path -LiteralPath $candidate)) { Remove-Item -LiteralPath $candidate }
|
||||
}
|
||||
@@ -0,0 +1,152 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
# The relay receives a fixed public receipt. There is no command reader.
|
||||
param([Parameter(Mandatory)][DateTimeOffset]$Until, [switch]$ResumeEmpty)
|
||||
$ErrorActionPreference = 'Stop'
|
||||
$deadline = [DateTimeOffset]::UtcNow.AddMinutes(12)
|
||||
if ($deadline -gt $until) { $deadline = $until }
|
||||
if ($deadline -le [DateTimeOffset]::UtcNow) { throw 'Das Wartungsfenster ist abgelaufen.' }
|
||||
|
||||
$base = 'https://gitea.incoso.eu/kevin_janssen/rust-discovery/raw/commit/b614b6f5be9d700eef20586a038aa9643356049a/deploy/windows'
|
||||
$bootstrap = 'C:\ProgramData\RustDiscoveryBootstrap'
|
||||
$caseId = 'ad9fd154-b2be-4f5d-9e17-65abb721ceaf'
|
||||
$case = Join-Path $bootstrap "time-profile-$caseId"
|
||||
$access = 'C:\ProgramData\RmmDevAccess'
|
||||
$sshBin = Join-Path $env:WINDIR 'System32\OpenSSH'
|
||||
$known = Join-Path $access 'known_hosts'
|
||||
$key = Join-Path $access 'tunnel_ed25519'
|
||||
$fp = & "$sshBin\ssh-keygen.exe" -lf $known
|
||||
if ($LASTEXITCODE -ne 0 -or @($fp).Count -ne 1 -or
|
||||
$fp.Split(' ')[1] -cne 'SHA256:+NEin4XJc3CbhjQi7/ZpMIgxOrXn8AT2tlpTaXW5quw') { throw 'Server-Hostpin stimmt nicht.' }
|
||||
$session = [guid]::NewGuid().ToString()
|
||||
$work = Join-Path $bootstrap "time-receipt-$session"
|
||||
$null = New-Item -ItemType Directory -Path $work
|
||||
$listener = $null
|
||||
$ssh = $null
|
||||
$scripts = [ordered]@{
|
||||
'Complete-OriginalTimeProfile.ps1' = 'aacc56321dccc6efe496a782d4cf67defba5b0be6759cba08d9e0b775913210b'
|
||||
'Read-PassiveTimeSamples.ps1' = 'd9e2b9344c19af1296b86ec70ba754ef820f369ac5ec897979bd4233e0722d04'
|
||||
}
|
||||
try {
|
||||
foreach ($name in $scripts.Keys) {
|
||||
$path = Join-Path $work $name
|
||||
Invoke-WebRequest -UseBasicParsing -Uri "$base/$name" -OutFile $path -TimeoutSec 30
|
||||
if ((Get-FileHash -LiteralPath $path).Hash -ne $scripts[$name]) { throw "Downloadhash: $name" }
|
||||
Unblock-File -LiteralPath $path
|
||||
}
|
||||
$listener = [Net.Sockets.TcpListener]::new([Net.IPAddress]::Loopback, 0)
|
||||
$listener.Start(4)
|
||||
$port = $listener.LocalEndpoint.Port
|
||||
$options = @('-F','NUL','-N','-T','-o','BatchMode=yes','-o','IdentitiesOnly=yes',
|
||||
'-o','ForwardAgent=no','-o','StrictHostKeyChecking=yes','-o','GlobalKnownHostsFile=NUL',
|
||||
'-o',"UserKnownHostsFile=$known",'-o','ExitOnForwardFailure=yes','-o','ConnectTimeout=10',
|
||||
'-o','ServerAliveInterval=15','-o','ServerAliveCountMax=2','-i',$key,
|
||||
'-R',"127.0.0.1:22240:127.0.0.1:$port",'rmm-win-tunnel@discovery.ease-technologies.de')
|
||||
$ssh = Start-Process -FilePath "$sshBin\ssh.exe" -ArgumentList $options -PassThru -NoNewWindow
|
||||
if ($ssh.WaitForExit(1800)) { throw "SSH Exit $($ssh.ExitCode)" }
|
||||
Write-Host 'Wartungsfenster aktiv. Dieses Fenster offen lassen. Strg+C beendet es.'
|
||||
$method = 'initial_create'
|
||||
$prefix = 'console-initial-create'
|
||||
$arguments = @{ InitialCreate=$true }
|
||||
if ($ResumeEmpty) {
|
||||
$method = 'resume_empty'
|
||||
$prefix = 'console-resume-empty'
|
||||
$arguments = @{ ResumeEmpty=$true }
|
||||
}
|
||||
$receipt = [ordered]@{session=$session; case_id=$caseId; method=$method; phase='preflight'; read_only_channel=$true}
|
||||
$result = Join-Path $case "$prefix-result.json"
|
||||
$intentPath = Join-Path $case "$prefix-intent.json"
|
||||
$failurePath = Join-Path $case "$prefix-error.json"
|
||||
$receipt.finalizer_invoked = $false
|
||||
try {
|
||||
if (Test-Path -LiteralPath $failurePath) { throw 'Previous profile finalization error recorded' }
|
||||
if (!(Test-Path -LiteralPath $result)) {
|
||||
if (Test-Path -LiteralPath $intentPath) { throw 'Previous profile finalization intent without result' }
|
||||
$receipt.finalizer_invoked = $true
|
||||
$null = & (Join-Path $work 'Complete-OriginalTimeProfile.ps1') @arguments
|
||||
}
|
||||
$record = Get-Content -LiteralPath $result -Raw | ConvertFrom-Json
|
||||
$actual = Get-FileHash -LiteralPath 'C:\ProgramData\RustDiscoverySystem\time-attestation.json'
|
||||
if ($record.id -cne $caseId -or $record.installed -ne $true -or
|
||||
$record.initial_create -ne $true -or $record.source_candidate_preserved -ne $true -or
|
||||
$record.services_changed -ne $false -or $record.private_key_read -ne $false -or $record.clock_runtime_qualified -ne $false -or
|
||||
$actual.Hash -ne '2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b') { throw 'Unexpected publication result' }
|
||||
$marker = Get-Content -LiteralPath $intentPath -Raw | ConvertFrom-Json
|
||||
if ($marker.id -cne $caseId -or $marker.utc -cne $record.publication_since -or
|
||||
$marker.config_sha256 -ne $actual.Hash -or $record.configuration.sha256 -ne $actual.Hash -or
|
||||
$record.original_candidate.file_id -cne '6d990300000003000000000000000000' -or
|
||||
$record.configuration.file_id -cnotmatch '^[0-9a-f]{32}$' -or $record.configuration.file_id -ceq '6d990300000003000000000000000000') { throw 'Unexpected finalization intent' }
|
||||
if ($ResumeEmpty) {
|
||||
if ($record.resumed_empty -ne $true -or $marker.target_id -cne $record.configuration.file_id) {
|
||||
throw 'Recovered profile file identity differs from the recovery intent'
|
||||
}
|
||||
$receipt.resumed_empty = $true
|
||||
$receipt.reserved_target_id = $marker.target_id
|
||||
}
|
||||
$receipt.phase = 'published'
|
||||
$receipt.publication_since = $record.publication_since
|
||||
$receipt.initial_create = $record.initial_create
|
||||
$receipt.source_candidate_preserved = $record.source_candidate_preserved
|
||||
$receipt.services_changed = $record.services_changed
|
||||
$receipt.private_key_read = $record.private_key_read
|
||||
$receipt.clock_runtime_qualified = $record.clock_runtime_qualified
|
||||
$receipt.source_id = $record.original_candidate.file_id
|
||||
$receipt.target_id = $record.configuration.file_id
|
||||
$receipt.config_sha256 = $actual.Hash.ToLowerInvariant()
|
||||
$receipt.result_sha256 = (Get-FileHash -LiteralPath $result).Hash
|
||||
} catch {
|
||||
$receipt.phase = 'finalization_failed'
|
||||
$receipt.exception_type = $_.Exception.GetBaseException().GetType().FullName
|
||||
$receipt.line = $_.InvocationInfo.ScriptLineNumber
|
||||
$receipt.file = [IO.Path]::GetFileName($_.InvocationInfo.ScriptName)
|
||||
Write-Warning $_.Exception.Message
|
||||
if (Test-Path -LiteralPath $failurePath) {
|
||||
$failure = Get-Content -LiteralPath $failurePath -Raw | ConvertFrom-Json
|
||||
if ($failure.id -ceq $caseId -and $failure.hresult -cmatch '^0x[0-9A-Fa-f]{8}$') {
|
||||
$receipt.hresult = $failure.hresult
|
||||
if ($failure.phase -cmatch '^[A-Za-z][A-Za-z0-9_.-]{0,63}$') { $receipt.failure_phase = $failure.phase }
|
||||
$descriptor = $failure.creation_descriptor
|
||||
if ($failure.phase -ceq 'verify_creation' -and $null -ne $descriptor -and
|
||||
$descriptor.expected_sddl -is [string] -and $descriptor.expected_sddl.Length -le 4096 -and
|
||||
$descriptor.actual_sddl -is [string] -and $descriptor.actual_sddl.Length -le 4096) {
|
||||
$receipt.creation_descriptor = @{
|
||||
expected_sddl=$descriptor.expected_sddl; actual_sddl=$descriptor.actual_sddl; bytes=$descriptor.bytes
|
||||
}
|
||||
if ($descriptor.file_id -cmatch '^[0-9a-f]{32}$' -and $descriptor.volume_serial -cmatch '^[0-9]{1,20}$') {
|
||||
$receipt.creation_descriptor.file_id = $descriptor.file_id
|
||||
$receipt.creation_descriptor.volume_serial = $descriptor.volume_serial
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
$readScript = Join-Path $work 'Read-PassiveTimeSamples.ps1'
|
||||
$readInput = @{id=$session; agent_sha256='0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c'; helper_sha256='59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e'} | ConvertTo-Json -Compress
|
||||
while ([DateTimeOffset]::UtcNow -lt $deadline -and !$ssh.HasExited) {
|
||||
if (!$listener.Pending()) { Start-Sleep -Milliseconds 250; continue }
|
||||
$client = $listener.AcceptTcpClient()
|
||||
try {
|
||||
if ($receipt.phase -eq 'published') {
|
||||
$receipt.native = $null
|
||||
try {
|
||||
$json = $readInput | & "$env:WINDIR\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy RemoteSigned -File $readScript
|
||||
if ($LASTEXITCODE -eq 0) { $receipt.native = ($json -join "`n") | ConvertFrom-Json }
|
||||
} catch { Write-Warning 'Passive Zeitbelege aktuell nicht lesbar.' }
|
||||
}
|
||||
$client.SendTimeout = 3000
|
||||
$body = [Text.Encoding]::UTF8.GetBytes(($receipt | ConvertTo-Json -Depth 16 -Compress))
|
||||
if ($body.Length -gt 65536) { throw 'Ergebnis zu gross.' }
|
||||
$client.GetStream().Write($body,0,$body.Length)
|
||||
} catch { Write-Warning $_.Exception.Message } finally { $client.Dispose() }
|
||||
}
|
||||
} finally {
|
||||
if ($null -ne $ssh) {
|
||||
try { if (!$ssh.HasExited) { $ssh.Kill(); $ssh.WaitForExit() } } finally { $ssh.Dispose() }
|
||||
}
|
||||
if ($null -ne $listener) { $listener.Stop() }
|
||||
foreach ($name in $scripts.Keys) {
|
||||
$path = Join-Path $work $name
|
||||
if (Test-Path -LiteralPath $path) { Remove-Item -LiteralPath $path }
|
||||
}
|
||||
if ((Get-ChildItem -LiteralPath $work -Force | Measure-Object).Count -eq 0) { [IO.Directory]::Delete($work) }
|
||||
}
|
||||
@@ -0,0 +1,212 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
# Publish the next trusted-OS profile from actual passive service observations.
|
||||
[CmdletBinding()]
|
||||
param([Parameter(Mandatory)][ValidateSet('Prepare','Publish','Read','FinishStarts')][string]$Action)
|
||||
$ErrorActionPreference='Stop'
|
||||
$commonHash='c54e36b32a2fcccb072f2cca52a38b6c4da31755d86205599016c5d180f5cec4'
|
||||
$common=Join-Path $PSScriptRoot 'Set-PassiveJobPair.ps1'
|
||||
if ((Get-FileHash -LiteralPath $common -Algorithm SHA256).Hash -ne $commonHash) {
|
||||
throw 'The reviewed passive-pair controller must be next to this script'
|
||||
}
|
||||
$text=[Text.Encoding]::UTF8.GetString([IO.File]::ReadAllBytes($common))
|
||||
$first="`n`$originalCase = "
|
||||
$last="`nif (`$Mode -eq 'Read') {"
|
||||
$i=$text.IndexOf($first,[StringComparison]::Ordinal)
|
||||
$j=$text.IndexOf($last,[StringComparison]::Ordinal)
|
||||
if ($i -lt 0 -or $j -le $i -or $i -ne $text.LastIndexOf($first,[StringComparison]::Ordinal) -or
|
||||
$j -ne $text.LastIndexOf($last,[StringComparison]::Ordinal)) { throw 'Passive-pair definition boundary' }
|
||||
# Fixed declarations and functions only. Its Prepare, Install and Restore bodies are excluded.
|
||||
. ([scriptblock]::Create($text.Substring($i,$j-$i)))
|
||||
CheckControl $work $true
|
||||
$activation=(Marker 'profile-publish-intent')
|
||||
$ready=(Marker 'profile-prepared')
|
||||
$success=(Marker 'profile-published')
|
||||
function RequireNewPassivePair {
|
||||
if ((Hash $config) -cne $configHash -or (Hash $helperBinary) -cne $helperHash -or
|
||||
(Test-Path -LiteralPath (Marker 'restore-intent'))) { throw 'Passive successor pair required' }
|
||||
VerifyFiles (CurrentFiles) $newHashes
|
||||
}
|
||||
function RoleDigests($platformHash,$installedHash,$independentHash,$previous) {
|
||||
$out=@{}
|
||||
foreach ($name in @('agent','system_helper')) {
|
||||
$bound=$installed.agent
|
||||
if ($name -ceq 'system_helper') { $bound=$installed.helper }
|
||||
$old=@($previous.trusted_os_active_guest.qualifications | Where-Object { $_.role -ceq $name })
|
||||
if ($old.Count -ne 1) { throw 'Expected one predecessor witness per role' }
|
||||
$archive=Join-Path $oldFolder ($name+'-qualification.json')
|
||||
CheckControl $archive $false
|
||||
if ((Hash $archive) -cne $old[0].qualification_sha256) { throw 'Original role provenance changed' }
|
||||
$archived=Get-Content -LiteralPath $archive -Raw | ConvertFrom-Json
|
||||
$build='a003dfa8cc2397a99933aceeb2d8dab51f883ab9cdf27876fbfc94a78873044c'
|
||||
if ($name -ceq 'system_helper') {
|
||||
# The old pair receipt linked the later agent and referenced the
|
||||
# separately built helper. Identify the actual helper link itself.
|
||||
$build='04ed34e6e850aca77c1fd4677ddb271f7ccd9492a97f5d4e00ead4c1f032f29d'
|
||||
}
|
||||
Record ('profile-role-'+$name) ([ordered]@{
|
||||
profile='rmm.windows.trusted-os.product-role-prerequisite.v1';role=$name
|
||||
binary_sha256=$bound.image_file.sha256; service=$bound.service; kernel=$bound.kernel
|
||||
image_file=$bound.image_file; predecessor_qualification_sha256=$old[0].qualification_sha256
|
||||
pair_case_id=$id; pair_result_sha256=$installedHash; independent_pair_readback_sha256=$independentHash
|
||||
product_build_receipt_sha256=$build; platform_provenance_sha256=$platformHash
|
||||
raw_capture=$archived.raw_capture; signed_runtime_verified=$false; physical_calibration_claimed=$false
|
||||
})
|
||||
$out[$name]=Hash (Marker ('profile-role-'+$name))
|
||||
}
|
||||
return $out
|
||||
}
|
||||
function BuildSuccessor {
|
||||
$installedHash=Hash (Marker 'installed')
|
||||
$unit=Join-Path $boot 'profile-unit-fcec400-result.json'
|
||||
if ((Hash $unit) -cne '48de474d842ebc87550ba2e27b66086e6aa573973f252f4b8e19ac7b12b75a63') { throw 'Windows unit evidence changed' }
|
||||
$independent=[ordered]@{agent=(LiveRole 'agent' $newHashes.agent);helper=(LiveRole 'helper' $helperHash);files=(CurrentFiles);device=(PreservedDevice)}
|
||||
foreach ($field in $independent.Keys) {
|
||||
if (!(JsonEqual $installed.$field $independent.$field)) { throw "Independent native pair read differs: $field" }
|
||||
}
|
||||
$independent.utc=[DateTime]::UtcNow.ToString('o')
|
||||
$independent.pair_case=$id
|
||||
Record 'profile-independent-native-read' $independent
|
||||
$independentHash=Hash (Marker 'profile-independent-native-read')
|
||||
$old=Get-Content -LiteralPath $target -Raw | ConvertFrom-Json
|
||||
if ($old.schema_version -ne 2 -or $old.key_generation -ne 1 -or
|
||||
$old.server_instance -cne 'c6f9657a-446f-49af-8fb8-bd8932939568' -or
|
||||
$old.trusted_os_active_guest.operating_assumption -cne 'active_guest_no_pause_save_restore_snapshot_migration_host_suspend' -or
|
||||
$old.trusted_os_active_guest.platform -cne 'kvm_qemu_hypervclock' -or
|
||||
@($old.trusted_os_active_guest.qualifications).Count -ne 2) { throw 'Unexpected original V2 contract' }
|
||||
$platform=Join-Path $oldFolder 'platform-provenance.json'
|
||||
CheckControl $platform $false
|
||||
$oldPlatformHash=Hash $platform
|
||||
if ($oldPlatformHash -cne $old.trusted_os_active_guest.platform_provenance_sha256) { throw 'Original platform provenance changed' }
|
||||
Record 'profile-platform' ([ordered]@{
|
||||
profile='rmm.windows.trusted-os.platform-provenance.v1';operating_assumption=$old.trusted_os_active_guest.operating_assumption
|
||||
platform=$old.trusted_os_active_guest.platform;previous_platform_provenance_sha256=$oldPlatformHash
|
||||
predecessor_profile_sha256=$profileHash;pair_case_id=$id;pair_result_sha256=$installedHash
|
||||
independent_pair_readback_sha256=$independentHash;independent_physical_calibration_claimed=$false
|
||||
agent_build_receipt_sha256='a003dfa8cc2397a99933aceeb2d8dab51f883ab9cdf27876fbfc94a78873044c'
|
||||
linux_profile_unit_sha256='ee3a2c99651491a2fd876f1a3463919dc32d9509d9f9ef4eb73a36aa848bb56d'
|
||||
windows_profile_unit_sha256=(Hash $unit)
|
||||
})
|
||||
$platformHash=Hash (Marker 'profile-platform')
|
||||
$roles=RoleDigests $platformHash $installedHash $independentHash $old
|
||||
$profileText=[Text.Encoding]::UTF8.GetString([IO.File]::ReadAllBytes($target))
|
||||
$changes=[ordered]@{}
|
||||
$changes[$oldHashes.agent]=$newHashes.agent
|
||||
$changes[$oldPlatformHash]=$platformHash
|
||||
foreach ($r in $old.trusted_os_active_guest.qualifications) {
|
||||
$changes[$r.qualification_sha256]=$roles[$r.role]
|
||||
}
|
||||
if ($changes.Count -ne 4) { throw 'Expected four independent substitutions' }
|
||||
foreach ($oldValue in $changes.Keys) {
|
||||
$pos=$profileText.IndexOf($oldValue,[StringComparison]::Ordinal)
|
||||
if ($pos -lt 0 -or $pos -ne $profileText.LastIndexOf($oldValue,[StringComparison]::Ordinal)) { throw 'Cannot uniquely bind successor' }
|
||||
$profileText=$profileText.Replace($oldValue,$changes[$oldValue])
|
||||
}
|
||||
$updated=$profileText | ConvertFrom-Json
|
||||
if ($updated.key_generation -ne $old.key_generation -or $updated.server_instance -cne $old.server_instance -or
|
||||
!(JsonEqual $old.binding $updated.binding) -or !(JsonEqual $old.public_keys_hex $updated.public_keys_hex)) {
|
||||
throw 'Unexpected trust-root changes'
|
||||
}
|
||||
$draft=Join-Path $work 'new-time-profile'
|
||||
WriteBytes $draft ([Text.UTF8Encoding]::new($false).GetBytes($profileText))
|
||||
CheckControl $draft $false
|
||||
$oldCopy=Join-Path $work 'old-time-profile'
|
||||
WriteBytes $oldCopy ([IO.File]::ReadAllBytes($target))
|
||||
if ((Hash $oldCopy) -cne $profileHash) { throw 'Time profile predecessor changed' }
|
||||
Record 'profile-prepared' ([ordered]@{
|
||||
id=$id;utc=[DateTime]::UtcNow.ToString('o');predecessor=(FileIdentity $target);successor_sha256=(Hash $draft)
|
||||
source_sha256=$installedHash;independent_sha256=$independentHash;platform_sha256=$platformHash;role_sha256=$roles
|
||||
original_publish_result_sha256='62a04be9c7d08d3687b51eacd6adbe290b91e16ba934d6b5bb531e8764a56cf5'
|
||||
predecessor_revision=1;successor_revision=2;signing_key_generation=$old.key_generation;clock_qualified=$false
|
||||
})
|
||||
}
|
||||
function CheckPrepared {
|
||||
if ($prepared.id -cne $id -or $prepared.predecessor.sha256 -cne $profileHash -or
|
||||
$prepared.successor_revision -ne 2 -or $prepared.predecessor_revision -ne 1 -or $prepared.signing_key_generation -ne 1 -or
|
||||
$prepared.source_sha256 -cne (Hash (Marker 'installed')) -or
|
||||
$prepared.independent_sha256 -cne (Hash (Marker 'profile-independent-native-read')) -or
|
||||
$prepared.platform_sha256 -cne (Hash (Marker 'profile-platform')) -or
|
||||
$prepared.successor_sha256 -cne (Hash (Join-Path $work 'new-time-profile')) -or
|
||||
$prepared.successor_sha256 -ceq $profileHash -or
|
||||
(Hash (Join-Path $work 'old-time-profile')) -cne $profileHash) { throw 'Successor preparation inconsistent' }
|
||||
foreach ($name in @('agent','system_helper')) {
|
||||
if ($prepared.role_sha256.$name -cne (Hash (Marker ('profile-role-'+$name)))) { throw 'Role proof changed' }
|
||||
}
|
||||
}
|
||||
function FinishPublication {
|
||||
$intent=LoadRecord 'profile-publish-intent'
|
||||
$actual=FileIdentity $target
|
||||
if ($intent.id -cne $id -or $intent.prepared_sha256 -cne (Hash $ready) -or
|
||||
$actual.sha256 -cne $prepared.successor_sha256 -or
|
||||
$actual.acl_sha256 -cne $prepared.predecessor.acl_sha256) { throw 'Successor readback failed' }
|
||||
if (Test-Path -LiteralPath (Marker 'time-installed-time')) {
|
||||
if (!(JsonEqual (LoadRecord 'time-installed-time') $actual)) { throw 'Installed profile identity changed' }
|
||||
} else {
|
||||
# An interrupted Replace can finish before the final journal write.
|
||||
# Recognize the recorded candidate and native backup without another Replace.
|
||||
StopCheck
|
||||
$attempt=LoadRecord 'time-replace-time'
|
||||
$previous=FileIdentity (Join-Path $work 'time-replaced-time')
|
||||
if (!(JsonEqual $attempt.previous $prepared.predecessor) -or
|
||||
$previous.sha256 -cne $prepared.predecessor.sha256 -or $previous.file_id -cne $prepared.predecessor.file_id -or
|
||||
$actual.file_id -cne $attempt.candidate.file_id -or $actual.volume_serial -cne $attempt.candidate.volume_serial) {
|
||||
throw 'Unconfirmed profile replacement: inspect current state'
|
||||
}
|
||||
Record 'time-installed-time' $actual
|
||||
}
|
||||
if (Test-Path -LiteralPath $success) { throw 'Already published: use Read' }
|
||||
foreach ($role in @('helper','agent')) {
|
||||
$hash=$newHashes.agent;$name=$agentName
|
||||
if ($role -eq 'helper') { $hash=$helperHash;$name=$helperName }
|
||||
$s=Service $role
|
||||
if ($s.state -ceq 'Stopped') {
|
||||
if (Test-Path -LiteralPath (Marker ('time-start-'+$role))) { throw "Existing unconfirmed $role start; read current state" }
|
||||
StartKnownRole $role $name $hash 'time'
|
||||
} elseif ($s.state -ceq 'Running') {
|
||||
if (!(Test-Path -LiteralPath (Marker ('time-start-'+$role)))) { throw "Unexpected independently started $role" }
|
||||
$null=LiveRole $role $hash
|
||||
} else { throw "Unexpected state $role" }
|
||||
}
|
||||
Record 'profile-published' ([ordered]@{
|
||||
id=$id;utc=[DateTime]::UtcNow.ToString('o');configuration=(FileIdentity $target)
|
||||
predecessor=$prepared.predecessor; successor_revision=2; signing_key_generation=1
|
||||
role_proofs=$prepared.role_sha256; publication_since=$intent.utc
|
||||
agent=(LiveRole 'agent' $newHashes.agent); helper=(LiveRole 'helper' $helperHash)
|
||||
signed_runtime_verified=$false; job_mode=$false;privileged_effects=$false
|
||||
})
|
||||
Write-Output "Published successor profile $id"
|
||||
}
|
||||
if ($Action -ceq 'Read') {
|
||||
$o=[ordered]@{id=$id;read_only=$true;configuration=(FileIdentity $target);agent=(Service 'agent');helper=(Service 'helper');marks=@()}
|
||||
$o.marks=@(Get-ChildItem -LiteralPath $work -Filter 'profile-*.json' -File | Select-Object -ExpandProperty Name)
|
||||
if (Test-Path -LiteralPath $success) { $o.published=LoadRecord 'profile-published' }
|
||||
$o|ConvertTo-Json -Depth 15 -Compress
|
||||
return
|
||||
}
|
||||
RequireNewPassivePair
|
||||
$installed=LoadRecord 'installed'
|
||||
if ($installed.id -cne $id -or $installed.job_mode -ne $false -or $installed.clock_qualified -ne $false) { throw 'Expected passive installation' }
|
||||
if ($Action -ceq 'Prepare') {
|
||||
VerifyPassiveContext
|
||||
if (Test-Path -LiteralPath $activation) { throw 'Already began publication' }
|
||||
BuildSuccessor
|
||||
Write-Output "Prepared successor profile from independent passive service proofs $id"
|
||||
return
|
||||
}
|
||||
$prepared=LoadRecord 'profile-prepared'
|
||||
CheckPrepared
|
||||
if ($Action -ceq 'FinishStarts') { FinishPublication;return }
|
||||
VerifyPassiveContext
|
||||
$held=LoadRecord 'profile-independent-native-read'
|
||||
if (!(JsonEqual $held.agent (LiveRole 'agent' $newHashes.agent)) -or
|
||||
!(JsonEqual $held.helper (LiveRole 'helper' $helperHash)) -or
|
||||
!(JsonEqual $held.device (PreservedDevice)) -or !(JsonEqual $prepared.predecessor (FileIdentity $target))) {
|
||||
throw 'Positive, unchanged passive pair and original time profile required before publication'
|
||||
}
|
||||
Record 'profile-publish-intent' ([ordered]@{id=$id;utc=[DateTime]::UtcNow.ToString('o');prepared_sha256=(Hash $ready)})
|
||||
StopKnownRole 'agent' $agentName $held.agent 'time'
|
||||
StopKnownRole 'helper' $helperName $held.helper 'time'
|
||||
$locations.Add('time',$target)
|
||||
SwapFile 'time' (Join-Path $work 'new-time-profile') $prepared.predecessor $prepared.successor_sha256 'time'
|
||||
$locations.Remove('time')
|
||||
FinishPublication
|
||||
@@ -0,0 +1,184 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
[CmdletBinding()]
|
||||
param(
|
||||
[Parameter(Mandatory)][ValidateRange(1,9223372036854775807)][long]$Generation,
|
||||
[switch]$AfterRestart
|
||||
)
|
||||
$ErrorActionPreference = 'Stop'
|
||||
$caseId = '49c230d8-fb5d-4c64-96b6-e0edce03ed90'
|
||||
$bootDir = 'C:\ProgramData\RustDiscoveryBootstrap'
|
||||
$caseDir = Join-Path $bootDir "job-passive-pair-$caseId"
|
||||
$publication = Join-Path $caseDir 'profile-published.json'
|
||||
$profile = 'C:\ProgramData\RustDiscoverySystem\time-attestation.json'
|
||||
$reader = Join-Path $PSScriptRoot 'Read-PassiveTimeSamples.ps1'
|
||||
$readerHash = 'd9e2b9344c19af1296b86ec70ba754ef820f369ac5ec897979bd4233e0722d04'
|
||||
$agentHash = 'df80b00fc2119b973d690053b9f9e4bdedd8fbc211f67599c3301eeb42e7702f'
|
||||
$helperHash = '59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e'
|
||||
$sessionId = [guid]::NewGuid().ToString()
|
||||
|
||||
function Assert-CasePath([string]$Path, [bool]$Directory) {
|
||||
$item = Get-Item -LiteralPath $Path -Force
|
||||
if ($item.PSIsContainer -ne $Directory -or ($item.Attributes -band [IO.FileAttributes]::ReparsePoint)) {
|
||||
throw 'Unexpected local evidence path type'
|
||||
}
|
||||
$sid = [Security.Principal.SecurityIdentifier]
|
||||
$trusted = @('S-1-5-18','S-1-5-32-544')
|
||||
$acl = Get-Acl -LiteralPath $Path
|
||||
$rules = @($acl.GetAccessRules($true,$true,$sid))
|
||||
if ($acl.GetOwner($sid).Value -notin $trusted -or !$rules.Count) { throw 'Unprotected local evidence path' }
|
||||
foreach ($rule in $rules) {
|
||||
if ($rule.AccessControlType -ne 'Allow' -or $rule.IdentityReference.Value -notin $trusted) {
|
||||
throw 'Unexpected local evidence path access'
|
||||
}
|
||||
}
|
||||
}
|
||||
function Get-FileDigest([string]$Path) {
|
||||
return (Get-FileHash -LiteralPath $Path -Algorithm SHA256).Hash.ToLowerInvariant()
|
||||
}
|
||||
function Get-ByteDigest([byte[]]$Bytes) {
|
||||
$hash = [Security.Cryptography.SHA256]::Create()
|
||||
try { return [BitConverter]::ToString($hash.ComputeHash($Bytes)).Replace('-','').ToLowerInvariant() }
|
||||
finally { $hash.Dispose() }
|
||||
}
|
||||
function Get-BootUuid([string]$Ticks) {
|
||||
if ($Ticks -cnotmatch '^[0-9]{17,19}$') { throw 'Invalid CIM boot ticks' }
|
||||
$hash = Get-ByteDigest ([Text.Encoding]::ASCII.GetBytes("rmm.windows.boot.cim.ticks.v1:$Ticks"))
|
||||
$variant = '89ab'[[Convert]::ToInt32($hash.Substring(16,1),16) -band 3]
|
||||
return $hash.Substring(0,8)+'-'+$hash.Substring(8,4)+'-8'+$hash.Substring(13,3)+'-'+$variant+$hash.Substring(17,3)+'-'+$hash.Substring(20,12)
|
||||
}
|
||||
function Get-UtcNs($Value) {
|
||||
if ($Value -is [datetime]) { $Value = $Value.ToUniversalTime().ToString('o') }
|
||||
if ($Value -cnotmatch '^(\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d)(?:\.(\d{1,9}))?Z$') { throw 'Expected UTC timestamp' }
|
||||
$fraction = ([string]$Matches[2]).PadRight(9,'0')
|
||||
$seconds = [datetime]::ParseExact($Matches[1],"yyyy-MM-dd'T'HH:mm:ss",[Globalization.CultureInfo]::InvariantCulture)
|
||||
return [decimal]$seconds.Ticks * 100 + [decimal]$fraction
|
||||
}
|
||||
function Get-FiletimeNs([string]$Value) {
|
||||
if ($Value -cnotmatch '^[0-9]{1,19}$') { throw 'Invalid filetime' }
|
||||
return [decimal]([datetime]::FromFileTimeUtc([long]$Value).Ticks) * 100
|
||||
}
|
||||
function Get-VerifiedRecord($Wrapped, [string]$Role, $Native, $BootUuid, [decimal]$Since, [decimal]$Now) {
|
||||
if ($null -eq $Wrapped) { throw 'Waiting for both service samples' }
|
||||
$raw = [Convert]::FromBase64String($Wrapped.raw_base64)
|
||||
if ($raw.Length -lt 1 -or $raw.Length -gt 8192 -or (Get-ByteDigest $raw) -cne $Wrapped.sha256 -or $Wrapped.metadata.dacl_checked -ne $true) {
|
||||
throw 'Invalid wrapped report'
|
||||
}
|
||||
# Preserve JSON scalar types and duplicate keys, including all nine fractional digits.
|
||||
$xmlReader = [Runtime.Serialization.Json.JsonReaderWriterFactory]::CreateJsonReader($raw,[Xml.XmlDictionaryReaderQuotas]::Max)
|
||||
try { $doc = [xml]::new(); $doc.Load($xmlReader) } finally { $xmlReader.Close() }
|
||||
$fields = @{}
|
||||
$numbers = @('schema_version','agent_pid','connection_generation')
|
||||
$strings = @('observed_at','role','windows_boot_id','verifier_incarnation','request_sha256','response_sha256')
|
||||
if ($doc.DocumentElement.GetAttribute('type') -cne 'object') { throw 'Invalid report root' }
|
||||
foreach ($node in $doc.DocumentElement.ChildNodes) {
|
||||
$name = $node.Name
|
||||
if ($fields.ContainsKey($name)) { throw 'Duplicate report field' }
|
||||
$type = $node.GetAttribute('type')
|
||||
if ($name -cin $numbers -and $type -ceq 'number' -and $node.InnerText -cmatch '^[1-9][0-9]*$') {
|
||||
$fields[$name] = [long]$node.InnerText
|
||||
} elseif ($name -cin $strings -and $type -ceq 'string') {
|
||||
$fields[$name] = $node.InnerText
|
||||
} else { throw 'Unrecognized report field or type' }
|
||||
}
|
||||
if ($fields.Count -ne 9 -or $fields.schema_version -ne 1 -or $fields.role -cne $Role -or
|
||||
$fields.windows_boot_id -cne $BootUuid -or $fields.agent_pid -ne $Native.runtime.agent.pid -or
|
||||
$fields.connection_generation -ne $Generation) { throw 'Waiting for current role, process, boot and generation' }
|
||||
$uuid = [guid]::ParseExact($fields.verifier_incarnation,'D')
|
||||
if ($uuid -eq [guid]::Empty -or $uuid.ToString() -cne $fields.verifier_incarnation -or
|
||||
$fields.request_sha256 -cnotmatch '^[a-f0-9]{64}$' -or $fields.response_sha256 -cnotmatch '^[a-f0-9]{64}$') { throw 'Invalid report identity' }
|
||||
$observed = Get-UtcNs $fields.observed_at
|
||||
$written = Get-FiletimeNs $Wrapped.metadata.last_write_filetime
|
||||
$birth = Get-FiletimeNs $Native.runtime.agent.birth_filetime
|
||||
if ($Role -ceq 'system_helper') { $birth = [math]::Max($birth,(Get-FiletimeNs $Native.runtime.helper.birth_filetime)) }
|
||||
if ($observed -lt $Since -or $observed -lt $birth -or $Now -lt $observed -or $Now -lt $written -or
|
||||
$Now-$observed -gt 180000000000 -or $Now-$written -gt 180000000000 -or
|
||||
$written-$observed -lt -2000000000 -or $written-$observed -gt 90000000000) { throw 'Waiting for fresh samples from current services' }
|
||||
return $fields
|
||||
}
|
||||
function Read-NativeSamples([string]$Request) {
|
||||
$start = [Diagnostics.ProcessStartInfo]::new()
|
||||
$start.FileName = Join-Path ([Environment]::SystemDirectory) 'WindowsPowerShell\v1.0\powershell.exe'
|
||||
$start.Arguments = '-NoProfile -NonInteractive -ExecutionPolicy RemoteSigned -File "'+$reader+'"'
|
||||
$start.UseShellExecute = $false
|
||||
$start.RedirectStandardInput = $true
|
||||
$start.RedirectStandardOutput = $true
|
||||
$start.RedirectStandardError = $true
|
||||
$child = [Diagnostics.Process]::Start($start)
|
||||
try {
|
||||
$out = $child.StandardOutput.ReadToEndAsync()
|
||||
$err = $child.StandardError.ReadToEndAsync()
|
||||
$child.StandardInput.WriteLine($Request)
|
||||
$child.StandardInput.Close()
|
||||
if (!$child.WaitForExit(30000)) { throw 'Bounded public report read timed out' }
|
||||
if (!$out.Wait(2000) -or !$err.Wait(2000) -or $child.ExitCode -ne 0 -or $err.Result.Length -gt 0 -or
|
||||
$out.Result.Length -gt 65536) { throw 'Original reader did not return a complete native observation' }
|
||||
return ($out.Result | ConvertFrom-Json)
|
||||
} finally {
|
||||
try { if (!$child.HasExited) { $child.Kill() } } finally { $child.Dispose() }
|
||||
}
|
||||
}
|
||||
|
||||
Assert-CasePath $bootDir $true
|
||||
Assert-CasePath $caseDir $true
|
||||
Assert-CasePath $publication $false
|
||||
$publishedHash = Get-FileDigest $publication
|
||||
$pub = Get-Content -LiteralPath $publication -Raw | ConvertFrom-Json
|
||||
$profileHash = Get-FileDigest $profile
|
||||
if ($pub.id -cne $caseId -or $pub.configuration.sha256 -cne $profileHash -or
|
||||
$pub.agent.image_file.sha256 -cne $agentHash -or $pub.helper.image_file.sha256 -cne $helperHash -or
|
||||
$pub.successor_revision -ne 2 -or $pub.job_mode -ne $false) { throw 'Unexpected pair publication' }
|
||||
$since = Get-UtcNs $pub.publication_since
|
||||
$request = @{id=$sessionId;agent_sha256=$agentHash;helper_sha256=$helperHash} | ConvertTo-Json -Compress
|
||||
$clock = [Diagnostics.Stopwatch]::StartNew()
|
||||
$mode = 'passive'
|
||||
if ($AfterRestart) { $mode = 'after-restart' }
|
||||
$readerHandle = [IO.File]::Open($reader,'Open','Read','Read')
|
||||
try {
|
||||
if ((Get-FileDigest $reader) -cne $readerHash) { throw 'Original public sample reader changed' }
|
||||
do {
|
||||
$native = Read-NativeSamples $request
|
||||
if ($native.id -cne $sessionId -or $native.read_only -ne $true) { throw 'Invalid read response' }
|
||||
$agent = $native.runtime.agent
|
||||
$helper = $native.runtime.helper
|
||||
if ($helper.birth_filetime -cne $pub.helper.kernel.creation_filetime -or $helper.pid -ne $pub.helper.kernel.pid) { throw 'Helper generation changed' }
|
||||
if ($AfterRestart) {
|
||||
if ([long]$agent.birth_filetime -le [long]$pub.agent.kernel.creation_filetime) { throw 'Waiting for a later agent generation' }
|
||||
} elseif ($agent.birth_filetime -cne $pub.agent.kernel.creation_filetime -or $agent.pid -ne $pub.agent.kernel.pid) { throw 'Published agent generation changed' }
|
||||
$bootId = Get-BootUuid $native.boot_ticks
|
||||
$now = Get-UtcNs $native.observed_at
|
||||
try {
|
||||
$agentFile = $native.reports.'agent-time-sample.json'
|
||||
$helperFile = $native.reports.'helper-time-sample.json'
|
||||
$a = Get-VerifiedRecord $agentFile 'agent' $native $bootId $since $now
|
||||
$h = Get-VerifiedRecord $helperFile 'system_helper' $native $bootId $since $now
|
||||
foreach ($key in 'verifier_incarnation','request_sha256','response_sha256') {
|
||||
if ($a[$key] -ceq $h[$key]) { throw 'Time roles are not independent' }
|
||||
}
|
||||
break
|
||||
} catch {
|
||||
if (!$_.Exception.Message.StartsWith('Waiting for ') -or $clock.Elapsed.TotalSeconds -ge 120) { throw }
|
||||
Start-Sleep -Seconds 2
|
||||
}
|
||||
} while ($true)
|
||||
} finally { $readerHandle.Dispose() }
|
||||
if ((Get-FileDigest $profile) -cne $profileHash -or (Get-FileDigest $publication) -cne $publishedHash) { throw 'Profile changed during read' }
|
||||
$result = [ordered]@{
|
||||
session_id=$sessionId; pair_case_id=$caseId; mode=$mode; profile_sha256=$profileHash
|
||||
profile_receipt_sha256=$publishedHash; publication_since=$pub.publication_since; observed_at=$native.observed_at
|
||||
agent_pid=$agent.pid; agent_birth_filetime=$agent.birth_filetime; helper_pid=$helper.pid; helper_birth_filetime=$helper.birth_filetime
|
||||
windows_boot_id=$bootId; connection_generation=$Generation; agent_sample_sha256=$agentFile.sha256; helper_sample_sha256=$helperFile.sha256
|
||||
agent_observed_at=$a.observed_at; helper_observed_at=$h.observed_at; agent_verifier_id=$a.verifier_incarnation; helper_verifier_id=$h.verifier_incarnation
|
||||
reader_sha256=$readerHash
|
||||
}
|
||||
$result.native = $native
|
||||
$bytes = [Text.Encoding]::UTF8.GetBytes(($result | ConvertTo-Json -Depth 16 -Compress))
|
||||
$file = Join-Path $caseDir "samples-$mode-$sessionId.json"
|
||||
$out = [IO.File]::Open($file,'CreateNew','Write','None')
|
||||
try { $out.Write($bytes,0,$bytes.Length); $out.Flush($true) } finally { $out.Dispose() }
|
||||
Assert-CasePath $file $false
|
||||
$receiptHash = Get-FileDigest $file
|
||||
if ($receiptHash -cne (Get-ByteDigest $bytes)) { throw 'Receipt readback failed' }
|
||||
$result.Remove('native')
|
||||
$result.receipt_sha256 = $receiptHash
|
||||
$result | ConvertTo-Json -Depth 5 -Compress
|
||||
@@ -0,0 +1,63 @@
|
||||
$ErrorActionPreference='Stop';$p=([Console]::In.ReadLine()|ConvertFrom-Json)
|
||||
if((($p.PSObject.Properties.Name|Sort-Object)-join',')-cne'agent_sha256,helper_sha256,id'-or[guid]::ParseExact($p.id,'D').ToString()-cne$p.id-or$p.agent_sha256-cnotmatch'^[0-9a-f]{64}$'-or$p.helper_sha256-cnotmatch'^[0-9a-f]{64}$'){throw 'Fixed public sample read'}
|
||||
$state='C:\ProgramData\RustDiscovery\state';$agent='RmmDiscoveryWindows';$helper='RmmDiscoverySystemHelper'
|
||||
$agentSid=(New-Object Security.Principal.NTAccount('NT SERVICE',$agent)).Translate([Security.Principal.SecurityIdentifier]).Value
|
||||
$allowed=@('S-1-5-18','S-1-5-32-544',$agentSid)
|
||||
function Check($path,[bool]$directory){
|
||||
$i=Get-Item -LiteralPath $path -Force
|
||||
if($i.PSIsContainer-ne$directory-or($i.Attributes-band[IO.FileAttributes]::ReparsePoint)){throw 'Regular public report path'}
|
||||
$ancestor=$i.Directory;if($directory){$ancestor=$i.Parent};while($null-ne$ancestor){if($ancestor.Attributes-band[IO.FileAttributes]::ReparsePoint){throw 'Public report reparse ancestry'};$ancestor=$ancestor.Parent}
|
||||
$acl=Get-Acl -LiteralPath $path;$owner=$acl.GetOwner([Security.Principal.SecurityIdentifier]).Value
|
||||
if($owner-cnotin$allowed-and!(!$directory-and$owner-ceq'S-1-5-19')){throw 'Public report owner'}
|
||||
$rules=@($acl.GetAccessRules($true,$true,[Security.Principal.SecurityIdentifier]));if(!$rules.Count){throw 'Public report empty DACL'}
|
||||
foreach($r in $rules){if($r.AccessControlType-ne'Allow'-or$r.IdentityReference.Value-cnotin$allowed){throw 'Public report broad DACL'}}
|
||||
if($directory-and!$acl.AreAccessRulesProtected){throw 'Protected public report directory'}
|
||||
return @{owner_sid=$owner;sddl=$acl.Sddl;dacl_checked=$true}
|
||||
}
|
||||
Add-Type -TypeDefinition @'
|
||||
using System; using System.Text; using System.Runtime.InteropServices; using Microsoft.Win32.SafeHandles;
|
||||
public static class RmmPassiveTimeRead {
|
||||
[StructLayout(LayoutKind.Sequential)] public struct Info {public uint Attr,CL,CH,AL,AH,WL,WH,Volume,SizeH,SizeL,Links,IndexH,IndexL;}
|
||||
[DllImport("kernel32.dll",SetLastError=true)] public static extern bool GetFileInformationByHandle(SafeFileHandle h,out Info i);
|
||||
[DllImport("kernel32.dll",SetLastError=true)] static extern IntPtr OpenProcess(uint access,bool inherit,int pid);
|
||||
[DllImport("kernel32.dll",SetLastError=true,CharSet=CharSet.Unicode)] static extern bool QueryFullProcessImageName(IntPtr h,uint flags,StringBuilder text,ref uint size);
|
||||
[DllImport("kernel32.dll",SetLastError=true)] static extern bool GetProcessTimes(IntPtr h,out long creation,out long exit,out long kernel,out long user);
|
||||
[DllImport("kernel32.dll",SetLastError=true)] static extern bool GetExitCodeProcess(IntPtr h,out uint code);
|
||||
[DllImport("kernel32.dll")] static extern bool CloseHandle(IntPtr h);
|
||||
public static string[] Process(int pid){IntPtr h=OpenProcess(0x1000,false,pid);if(h==IntPtr.Zero)throw new InvalidOperationException("QUERY_PROCESS");try{long c,e,k,u;uint code,size=32768;StringBuilder image=new StringBuilder((int)size);if(!GetProcessTimes(h,out c,out e,out k,out u)||!QueryFullProcessImageName(h,0,image,ref size)||!GetExitCodeProcess(h,out code)||code!=259)throw new InvalidOperationException("LIVE_PROCESS");return new string[]{c.ToString(System.Globalization.CultureInfo.InvariantCulture),image.ToString()};}finally{CloseHandle(h);}}
|
||||
}
|
||||
'@
|
||||
function Hash([byte[]]$bytes){$h=[Security.Cryptography.SHA256]::Create();try{return([BitConverter]::ToString($h.ComputeHash($bytes))).Replace('-','').ToLowerInvariant()}finally{$h.Dispose()}}
|
||||
function Runtime($role){
|
||||
$name=$agent;$image='C:\Program Files\RustDiscovery\rmm-agent-windows.exe';$owner='NT AUTHORITY\LocalService';$mode='Auto';$sha=$p.agent_sha256
|
||||
if($role-ceq'helper'){$name=$helper;$image='C:\Program Files\RustDiscovery\rmm-helper-windows.exe';$owner='LocalSystem';$mode='Manual';$sha=$p.helper_sha256}
|
||||
$s=Get-CimInstance Win32_Service -Filter ("Name='"+$name+"'") -OperationTimeoutSec 5
|
||||
if(!$s-or$s.State-cne'Running'-or$s.StartName-cne$owner-or$s.StartMode-cne$mode-or$s.ProcessId-le0-or$s.ServiceType-cne'Own Process'){throw 'Current fixed service role'}
|
||||
$expected='"'+$image+'" --service';if($role-ceq'agent'){$expected+=' --config "C:\ProgramData\RustDiscovery\config.json"'}
|
||||
if($s.PathName-cne$expected){throw 'Current fixed service command'}
|
||||
$native=[RmmPassiveTimeRead]::Process([int]$s.ProcessId)
|
||||
if($native[1]-cne$image-or(Get-FileHash -LiteralPath $image -Algorithm SHA256).Hash.ToLowerInvariant()-cne$sha){throw 'Current fixed service image'}
|
||||
return [ordered]@{pid=[uint32]$s.ProcessId;birth_filetime=$native[0];image=$native[1];sha256=$sha;start_name=$s.StartName;start_mode=$s.StartMode;command=$s.PathName}
|
||||
}
|
||||
function Boot{return (Get-CimInstance Win32_OperatingSystem -Property LastBootUpTime -OperationTimeoutSec 5).LastBootUpTime.ToUniversalTime().Ticks.ToString([Globalization.CultureInfo]::InvariantCulture)}
|
||||
$null=Check 'C:\ProgramData\RustDiscovery' $true;$directory=Check $state $true
|
||||
$boot=Boot;$before=[ordered]@{agent=(Runtime 'agent');helper=(Runtime 'helper')};$reports=[ordered]@{}
|
||||
foreach($name in @('agent-time-sample.json','helper-time-sample.json')){
|
||||
$path=Join-Path $state $name
|
||||
if(!(Test-Path -LiteralPath $path)){$reports[$name]=$null;continue}
|
||||
$stream=[IO.File]::Open($path,[IO.FileMode]::Open,[IO.FileAccess]::Read,[IO.FileShare]::Read)
|
||||
try{
|
||||
$meta=Check $path $false;$info=New-Object RmmPassiveTimeRead+Info
|
||||
if(![RmmPassiveTimeRead]::GetFileInformationByHandle($stream.SafeFileHandle,[ref]$info)-or$info.Links-ne1-or($info.Attr-band0x410)-ne0-or$info.SizeH-ne0-or$info.SizeL-lt1-or$info.SizeL-gt8192-or$stream.Length-ne$info.SizeL){throw 'Single-link bounded public report'}
|
||||
$raw=New-Object byte[] $info.SizeL;$offset=0;while($offset-lt$raw.Length){$count=$stream.Read($raw,$offset,$raw.Length-$offset);if($count-le0){throw 'Complete held public report'};$offset+=$count}
|
||||
$after=New-Object RmmPassiveTimeRead+Info
|
||||
if(![RmmPassiveTimeRead]::GetFileInformationByHandle($stream.SafeFileHandle,[ref]$after)-or$after.IndexH-ne$info.IndexH-or$after.IndexL-ne$info.IndexL-or$after.WH-ne$info.WH-or$after.WL-ne$info.WL-or$after.SizeL-ne$info.SizeL-or$after.Links-ne1){throw 'Stable held public report'}
|
||||
$again=Check $path $false;if($again.sddl-cne$meta.sddl-or$again.owner_sid-cne$meta.owner_sid){throw 'Stable public report security'}
|
||||
$meta['volume']=$info.Volume;$meta['index_high']=$info.IndexH;$meta['index_low']=$info.IndexL;$meta['last_write_filetime']=(([uint64]$info.WH-shl32)-bor$info.WL).ToString([Globalization.CultureInfo]::InvariantCulture)
|
||||
$reports[$name]=@{raw_base64=[Convert]::ToBase64String($raw);sha256=(Hash $raw);metadata=$meta}
|
||||
}finally{$stream.Dispose()}
|
||||
}
|
||||
$after=[ordered]@{agent=(Runtime 'agent');helper=(Runtime 'helper')}
|
||||
$directoryAfter=Check $state $true
|
||||
if(($before|ConvertTo-Json -Depth 8 -Compress)-cne($after|ConvertTo-Json -Depth 8 -Compress)-or(Boot)-cne$boot-or$directory.sddl-cne$directoryAfter.sddl){throw 'Stable process, directory and boot during public read'}
|
||||
@{id=$p.id;read_only=$true;boot_ticks=$boot;runtime=$after;state_metadata=$directory;reports=$reports;observed_at=[DateTime]::UtcNow.ToString('o')}|ConvertTo-Json -Depth 12 -Compress
|
||||
@@ -0,0 +1,136 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
# Resume the single observed interrupted first staging copy on the test VM.
|
||||
[CmdletBinding()]
|
||||
param([Parameter(Mandatory)][ValidateSet('Read','Resume')][string]$Action)
|
||||
$ErrorActionPreference='Stop'
|
||||
$base=Join-Path $PSScriptRoot 'Set-PassiveJobPair.ps1'
|
||||
$baseHash='c54e36b32a2fcccb072f2cca52a38b6c4da31755d86205599016c5d180f5cec4'
|
||||
if ((Get-FileHash -LiteralPath $base).Hash -ne $baseHash) { throw 'Original passive-pair controller differs' }
|
||||
$text=[IO.File]::ReadAllText($base)
|
||||
$i=$text.IndexOf("`n`$originalCase = ",[StringComparison]::Ordinal)
|
||||
$j=$text.IndexOf("`nif (`$Mode -eq 'Read') {",[StringComparison]::Ordinal)
|
||||
if ($i -le 0 -or $j -le $i) { throw 'Original fixed declaration boundary' }
|
||||
. ([scriptblock]::Create($text.Substring($i,$j-$i)))
|
||||
Add-Type -TypeDefinition @'
|
||||
using System;
|
||||
using System.IO;
|
||||
using System.ComponentModel;
|
||||
using System.Runtime.InteropServices;
|
||||
using System.Security.Cryptography;
|
||||
using Microsoft.Win32.SafeHandles;
|
||||
|
||||
public static class RmmPassiveStage {
|
||||
[StructLayout(LayoutKind.Sequential)]
|
||||
private struct Basic { public long Created,Accessed,Written,Changed; public uint Attributes; }
|
||||
[StructLayout(LayoutKind.Sequential)]
|
||||
private struct Standard { public long Allocated,End; public uint Links; public byte Pending,Directory; }
|
||||
[StructLayout(LayoutKind.Sequential)]
|
||||
private struct Id { public ulong Volume, Low, High; }
|
||||
[DllImport("kernel32.dll",CharSet=CharSet.Unicode,ExactSpelling=true,SetLastError=true)]
|
||||
private static extern SafeFileHandle CreateFileW(string path,uint access,uint sharing,IntPtr security,uint disposition,uint flags,IntPtr template);
|
||||
[DllImport("kernel32.dll",SetLastError=true)]
|
||||
private static extern bool GetFileInformationByHandleEx(SafeFileHandle h,int k,out Basic b,uint n);
|
||||
[DllImport("kernel32.dll",SetLastError=true)]
|
||||
private static extern bool GetFileInformationByHandleEx(SafeFileHandle h,int k,out Standard s,uint n);
|
||||
[DllImport("kernel32.dll",SetLastError=true)]
|
||||
private static extern bool GetFileInformationByHandleEx(SafeFileHandle h,int k,out Id id,uint n);
|
||||
[DllImport("kernel32.dll",SetLastError=true)]
|
||||
private static extern bool SetFileInformationByHandle(SafeFileHandle h,int k,ref Basic b,uint n);
|
||||
private static string Hex(byte[] bytes) { return BitConverter.ToString(bytes).Replace("-","").ToLowerInvariant(); }
|
||||
public static uint Check(string expectedId,string digest,string volume,bool clear) {
|
||||
const string path=@"C:\ProgramData\RustDiscoveryBootstrap\job-passive-pair-49c230d8-fb5d-4c64-96b6-e0edce03ed90\install-stage-agent";
|
||||
using (SafeFileHandle h=CreateFileW(path,clear?0x181u:0x81u,0,IntPtr.Zero,3,0x00200000,IntPtr.Zero)) {
|
||||
if (h.IsInvalid) throw new Win32Exception();
|
||||
Basic b; Standard s; Id id;
|
||||
uint nb=(uint)Marshal.SizeOf(typeof(Basic));
|
||||
if (!GetFileInformationByHandleEx(h,0,out b,nb) ||
|
||||
!GetFileInformationByHandleEx(h,1,out s,(uint)Marshal.SizeOf(typeof(Standard))) ||
|
||||
!GetFileInformationByHandleEx(h,18,out id,(uint)Marshal.SizeOf(typeof(Id)))) throw new Win32Exception();
|
||||
string hexId=Hex(BitConverter.GetBytes(id.Low))+Hex(BitConverter.GetBytes(id.High));
|
||||
if (s.Directory!=0 || s.Pending!=0 || s.End!=23541484 || s.Links!=1 || (b.Attributes & 0x410)!=0 ||
|
||||
id.Volume.ToString(System.Globalization.CultureInfo.InvariantCulture)!=volume || expectedId!=hexId)
|
||||
throw new InvalidDataException("Unexpected stage identity/type/links");
|
||||
using (var fs=new FileStream(h,FileAccess.Read))
|
||||
using (var hash=SHA256.Create()) {
|
||||
if (Hex(hash.ComputeHash(fs))!=digest) throw new InvalidDataException("Staged image hash changed");
|
||||
uint original=b.Attributes;
|
||||
if (clear) {
|
||||
if ((original & 1)==0) throw new InvalidDataException("ReadOnly not present");
|
||||
Basic changed=new Basic();changed.Attributes=original & ~1u;
|
||||
if (changed.Attributes==0) changed.Attributes=0x80; // FILE_ATTRIBUTE_NORMAL
|
||||
if (!SetFileInformationByHandle(h,0,ref changed,nb) ||
|
||||
!GetFileInformationByHandleEx(h,0,out b,nb)) throw new Win32Exception();
|
||||
if (b.Attributes!=changed.Attributes) throw new InvalidDataException("Attribute verification");
|
||||
}
|
||||
return original;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
'@
|
||||
VerifyPassiveContext
|
||||
StopCheck
|
||||
CheckControl $work $true
|
||||
$expected=@('prepared.json','install-intent.json','install-stop-agent.json','install-stop-helper.json',
|
||||
'old-agent','old-settings','old-pin','new-settings','new-pin','install-stage-agent')
|
||||
$found=@(Get-ChildItem -LiteralPath $work -Force | ForEach-Object { $_.Name })
|
||||
if (@(Compare-Object -CaseSensitive ($expected|Sort-Object) ($found|Sort-Object)).Count) {
|
||||
throw 'Only the original completed preparation, two stops and first private staging copy may exist'
|
||||
}
|
||||
foreach ($f in $expected) { CheckControl (Join-Path $work $f) $false }
|
||||
$prep=LoadRecord 'prepared';$intent=LoadRecord 'install-intent'
|
||||
if ($prep.id -cne $id -or $intent.id -cne $id -or !(JsonEqual $prep.files (CurrentFiles)) -or
|
||||
!(JsonEqual $prep.device (PreservedDevice)) -or !(JsonEqual $prep.agent (LoadRecord 'install-stop-agent')) -or
|
||||
!(JsonEqual $prep.helper (LoadRecord 'install-stop-helper'))) { throw 'Stored original stop, device or protected file identity changed' }
|
||||
VerifyFiles $prep.files $oldHashes
|
||||
foreach ($n in $locations.Keys) {
|
||||
if ((Hash (Join-Path $work ('old-'+$n))) -cne $oldHashes.$n) { throw 'Recovery backup changed' }
|
||||
}
|
||||
foreach ($n in @('settings','pin')) {
|
||||
if ((Hash (Join-Path $work ('new-'+$n))) -cne $newHashes.$n) { throw 'Settings candidate changed' }
|
||||
}
|
||||
CheckControl (Split-Path $source) $true
|
||||
CheckControl $source $false
|
||||
$stagedPath=Join-Path $work 'install-stage-agent'
|
||||
$originalCopy=FileIdentity $stagedPath
|
||||
$sourceId=FileIdentity $source
|
||||
if ($sourceId.sha256 -cne $newHashes.agent -or $originalCopy.sha256 -cne $newHashes.agent -or
|
||||
$originalCopy.file_id -ceq $sourceId.file_id -or $originalCopy.volume_serial -cne $prep.files.agent.volume_serial -or
|
||||
$originalCopy.file_id -ceq $prep.files.agent.file_id) { throw 'Staged copy not separately bound to expected image' }
|
||||
$flags=[RmmPassiveStage]::Check($originalCopy.file_id,$newHashes.agent,$originalCopy.volume_serial,$false)
|
||||
if ($Action -ceq 'Read') {
|
||||
[ordered]@{id=$id;both_services_stopped=$true;no_replacement_markers=$true;private_stage=$originalCopy
|
||||
attributes=[string]([IO.FileAttributes]$flags);readonly=[bool]($flags -band 1);links=1;source_id=$sourceId.file_id} |
|
||||
ConvertTo-Json -Depth 6 -Compress
|
||||
return
|
||||
}
|
||||
if ($flags -ne 0x2021 -or (Get-Item -LiteralPath $source -Force).Attributes -ne [IO.FileAttributes]0x2021) {
|
||||
throw 'Source and own staging copy must have the observed ReadOnly, Archive, NotContentIndexed attributes'
|
||||
}
|
||||
Record 'install-resume-stage-intent' @{id=$id;utc=[DateTime]::UtcNow.ToString('o');stage=$originalCopy;attributes=$flags;source=$sourceId}
|
||||
$null=[RmmPassiveStage]::Check($originalCopy.file_id,$newHashes.agent,$originalCopy.volume_serial,$true)
|
||||
if (!(JsonEqual $originalCopy (FileIdentity $stagedPath))) { throw 'Changed staged file after clearing its copy-only attribute' }
|
||||
# Run the original checked swap from FlushFile onward for the existing first stage.
|
||||
# For the two JSON files retain the original CreateNew-style copy in full.
|
||||
$from=$text.IndexOf('function SwapFile(',[StringComparison]::Ordinal)
|
||||
$to=$text.IndexOf('function StartKnownRole(',[StringComparison]::Ordinal)
|
||||
$swap=$text.Substring($from,$to-$from)
|
||||
$copy='[IO.File]::Copy($inputPath,$stage,$false)'
|
||||
if (!$swap.Contains($copy) -or $swap.IndexOf($copy) -ne $swap.LastIndexOf($copy)) { throw 'Copy resume boundary' }
|
||||
$branch='if ($name -ceq "agent") { if (!(JsonEqual $originalCopy (FileIdentity $stage))) { throw "Existing private copy changed" } } else { '+$copy+' }'
|
||||
. ([scriptblock]::Create($swap.Replace($copy,$branch)))
|
||||
foreach ($name in $locations.Keys) {
|
||||
$inputPath=Join-Path $work ('new-'+$name)
|
||||
if ($name -ceq 'agent') { $inputPath=$source }
|
||||
SwapFile $name $inputPath $prep.files.$name $newHashes.$name 'install'
|
||||
}
|
||||
VerifyFiles (CurrentFiles) $newHashes
|
||||
StartKnownRole 'helper' $helperName $helperHash 'install'
|
||||
StartKnownRole 'agent' $agentName $newHashes.agent 'install'
|
||||
$a=LiveRole 'agent' $newHashes.agent
|
||||
$h=LiveRole 'helper' $helperHash
|
||||
if (!(JsonEqual $prep.device (PreservedDevice))) { throw 'Device changed after passive restart' }
|
||||
Record 'installed' ([ordered]@{id=$id;utc=[DateTime]::UtcNow.ToString('o');agent=$a;helper=$h;files=(CurrentFiles)
|
||||
device=$prep.device;job_mode=$false;clock_qualified=$false})
|
||||
Write-Output "Installed passive pair from confirmed read-only copy $id"
|
||||
@@ -0,0 +1,215 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
[CmdletBinding()]
|
||||
param([Parameter(Mandatory)][ValidateSet('Inspect','Prepare','Activate','Readback')][string]$Mode)
|
||||
|
||||
$ErrorActionPreference = 'Stop'
|
||||
$caseId = '49c230d8-fb5d-4c64-96b6-e0edce03ed90'
|
||||
$boot = 'C:\ProgramData\RustDiscoveryBootstrap'
|
||||
$case = Join-Path $boot "job-config-$caseId"
|
||||
$root = 'C:\ProgramData\RustDiscovery'
|
||||
$state = Join-Path $root 'state'
|
||||
$config = Join-Path $root 'config.json'
|
||||
$binding = Join-Path $root 'binding.json'
|
||||
$jobs = Join-Path $state 'jobs'
|
||||
$systemRoot = 'C:\ProgramData\RustDiscoverySystem'
|
||||
$pin = Join-Path $systemRoot 'agent-pin.json'
|
||||
$clock = Join-Path $systemRoot 'time-attestation.json'
|
||||
$image = 'C:\Program Files\RustDiscovery\rmm-agent-windows.exe'
|
||||
$helperImage = 'C:\Program Files\RustDiscovery\rmm-helper-windows.exe'
|
||||
$oldConfig = '7c9f6f3642ef84337c3cd761d8a4788c4babe81522fdd987a3eb9b819bc8d851'
|
||||
$oldConfigAcl = '014e89cc8674259dd9ac7f490ffef056b85ada96c6e3574c23f27668b7a9b991'
|
||||
$expectedBinding = '9239ee9f4142735867e77451478bf309fbf449d730a0ede6c958bc8018830dde'
|
||||
$oldAgent = '0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c'
|
||||
$newAgent = 'df80b00fc2119b973d690053b9f9e4bdedd8fbc211f67599c3301eeb42e7702f'
|
||||
$helper = '59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e'
|
||||
$agentSid = ([Security.Principal.NTAccount]::new('NT SERVICE','RmmDiscoveryWindows')).Translate([Security.Principal.SecurityIdentifier]).Value
|
||||
$utf8 = [Text.UTF8Encoding]::new($false,$true)
|
||||
$sidType = [Security.Principal.SecurityIdentifier]
|
||||
$admins = @('S-1-5-18','S-1-5-32-544')
|
||||
$ready = Join-Path $case 'prepared.json'
|
||||
$entered = Join-Path $case 'activation-intent.json'
|
||||
$done = Join-Path $case 'activated.json'
|
||||
$candidate = Join-Path $case 'job-config.candidate.json'
|
||||
$original = Join-Path $case 'passive-config.original.json'
|
||||
$publicBinding = Join-Path $case 'public-binding.json'
|
||||
$next = Join-Path $root "config-$caseId.next"
|
||||
$backup = Join-Path $case 'replaced.original.json'
|
||||
|
||||
function Assert-NormalPath([string]$Path,[bool]$Directory) {
|
||||
$item = Get-Item -LiteralPath $Path -Force
|
||||
if ($item.PSIsContainer -ne $Directory) { throw "Unerwarteter Pfadtyp: $Path" }
|
||||
while ($null -ne $item) {
|
||||
if (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0) { throw "Reparsepunkt: $Path" }
|
||||
if ($item -is [IO.FileInfo]) { $item = $item.Directory } else { $item = $item.Parent }
|
||||
}
|
||||
}
|
||||
function Get-PublicHash([string]$Path) {
|
||||
Assert-NormalPath $Path $false
|
||||
return (Get-FileHash -LiteralPath $Path -Algorithm SHA256).Hash.ToLowerInvariant()
|
||||
}
|
||||
function Get-BytesDigest([byte[]]$Bytes) {
|
||||
$alg = [Security.Cryptography.SHA256]::Create()
|
||||
try { return [BitConverter]::ToString($alg.ComputeHash($Bytes)).Replace('-','').ToLowerInvariant() }
|
||||
finally { $alg.Dispose() }
|
||||
}
|
||||
function Assert-DirectoryAcl([string]$Path,[bool]$AgentCanRead) {
|
||||
Assert-NormalPath $Path $true
|
||||
$acl = Get-Acl -LiteralPath $Path
|
||||
if ($acl.GetOwner($sidType).Value -notin $admins) { throw "Verzeichniseigentuemer: $Path" }
|
||||
$rules = @($acl.GetAccessRules($true,$true,$sidType))
|
||||
if (!$rules.Count) { throw "Leere DACL: $Path" }
|
||||
foreach ($rule in $rules) {
|
||||
$sid = $rule.IdentityReference.Value
|
||||
if ($rule.AccessControlType -ne 'Allow' -or
|
||||
($sid -notin $admins -and !($AgentCanRead -and $sid -ceq $agentSid -and
|
||||
(([long]$rule.FileSystemRights -band (-bnot 0x1200a9)) -eq 0)))) { throw "Verzeichnisrechte: $Path" }
|
||||
}
|
||||
}
|
||||
function Write-Once([string]$Path,[byte[]]$Bytes,[Security.AccessControl.FileSecurity]$Acl) {
|
||||
if ($null -eq $Acl) {
|
||||
$stream = [IO.File]::Open($Path,'CreateNew','Write','None')
|
||||
} else {
|
||||
$stream = [IO.FileStream]::new($Path,[IO.FileMode]::CreateNew,[Security.AccessControl.FileSystemRights]::Write,
|
||||
[IO.FileShare]::None,4096,[IO.FileOptions]::WriteThrough,$Acl)
|
||||
}
|
||||
try { $stream.Write($Bytes,0,$Bytes.Length); $stream.Flush($true) } finally { $stream.Dispose() }
|
||||
}
|
||||
function Save-Record([string]$Path,$Record) {
|
||||
Write-Once $Path ($utf8.GetBytes(($Record | ConvertTo-Json -Depth 8 -Compress))) $null
|
||||
}
|
||||
function Read-PublicJson([string]$Path) {
|
||||
Assert-NormalPath $Path $false
|
||||
if ((Get-Item -LiteralPath $Path).Length -gt 32768) { throw "Datei zu gross: $Path" }
|
||||
return ($utf8.GetString([IO.File]::ReadAllBytes($Path)) | ConvertFrom-Json)
|
||||
}
|
||||
function Get-OriginalAcl {
|
||||
$acl = Get-Acl -LiteralPath $config
|
||||
if ((Get-BytesDigest ($utf8.GetBytes($acl.Sddl))) -cne $oldConfigAcl) { throw 'Originale Konfigurations-DACL abweichend' }
|
||||
return $acl
|
||||
}
|
||||
function Assert-FileAcl([string]$Path,$Expected) {
|
||||
$sections = [Security.AccessControl.AccessControlSections]'Owner,Group,Access'
|
||||
$actual = (Get-Acl -LiteralPath $Path).GetSecurityDescriptorSddlForm($sections)
|
||||
$wanted = $Expected.GetSecurityDescriptorSddlForm($sections)
|
||||
# File creation can omit the auto-inherited marker on this VM. Owner,
|
||||
# group, protected DACL, access masks and ACE sequence must all match.
|
||||
if ($actual -cne $wanted -and $actual -cne $wanted.Replace('D:PAI(', 'D:P(')) {
|
||||
throw "Dateiberechtigungen abweichend: $Path"
|
||||
}
|
||||
}
|
||||
function Get-ConfigurationInputs {
|
||||
if ((Get-PublicHash $config) -cne $oldConfig) { throw 'Passive Originalkonfiguration abweichend' }
|
||||
$null = Get-OriginalAcl
|
||||
$value = Read-PublicJson $config
|
||||
$names = @($value.PSObject.Properties.Name | Sort-Object)
|
||||
if (($names -join ',') -cne 'ca_file,connect_address,enrollment_token_file,server_name,state_directory,transport' -or
|
||||
$value.server_name -cne 'discovery.ease-technologies.de' -or $value.state_directory -ine $state -or $value.transport -cne 'auto') {
|
||||
throw 'Unerwartete passive Konfigurationsfelder'
|
||||
}
|
||||
$value | Add-Member -NotePropertyName job_binding_file -NotePropertyValue $binding
|
||||
$value | Add-Member -NotePropertyName enable_jobs -NotePropertyValue $true
|
||||
$value | Add-Member -NotePropertyName windows_execution_profile -NotePropertyValue 'powershell_51_remote_signed'
|
||||
$peer = Read-PublicJson $pin
|
||||
$b = $peer.binding
|
||||
$canonical = [ordered]@{agent_id=$b.agent_id;asset_id=$b.asset_id;assignment_version=$b.assignment_version;
|
||||
enrollment_generation=$b.enrollment_generation;public_key_hex=$b.public_key_hex;tenant_id=$b.tenant_id}
|
||||
$bindingBytes = $utf8.GetBytes(($canonical | ConvertTo-Json -Compress))
|
||||
if ((Get-BytesDigest $bindingBytes) -cne $expectedBinding) { throw 'Oeffentliche Jobbindung abweichend' }
|
||||
return @{config=$utf8.GetBytes(($value | ConvertTo-Json -Compress)); binding=$bindingBytes}
|
||||
}
|
||||
function Get-JobsAcl {
|
||||
$acl = [Security.AccessControl.DirectorySecurity]::new()
|
||||
$acl.SetSecurityDescriptorSddlForm("O:BAG:BAD:P(A;OICI;FA;;;SY)(A;OICI;FA;;;BA)(A;OICI;0x1301bf;;;$agentSid)")
|
||||
return $acl
|
||||
}
|
||||
function Assert-JobsAcl {
|
||||
Assert-NormalPath $jobs $true
|
||||
$acl = Get-Acl -LiteralPath $jobs
|
||||
if (!$acl.AreAccessRulesProtected -or $acl.GetOwner($sidType).Value -notin $admins) { throw 'Jobverzeichnis nicht geschuetzt' }
|
||||
$expected = (Get-JobsAcl).GetAccessRules($true,$false,$sidType)
|
||||
$rules = $acl.GetAccessRules($true,$true,$sidType)
|
||||
if ($rules.Count -ne $expected.Count) { throw 'Job-DACL Anzahl' }
|
||||
foreach ($e in $expected) {
|
||||
$match = @($rules | Where-Object { !$_.IsInherited -and $_.IdentityReference.Value -ceq $e.IdentityReference.Value -and
|
||||
$_.FileSystemRights -eq $e.FileSystemRights -and $_.AccessControlType -eq $e.AccessControlType -and
|
||||
$_.InheritanceFlags -eq $e.InheritanceFlags -and $_.PropagationFlags -eq $e.PropagationFlags })
|
||||
if ($match.Count -ne 1) { throw 'Job-DACL abweichend' }
|
||||
}
|
||||
}
|
||||
function Get-Readback {
|
||||
$files = [ordered]@{}
|
||||
foreach ($p in @($config,$binding,$candidate,$publicBinding,$original,$next,$backup,$ready,$entered,$done,$image,$helperImage,$clock)) {
|
||||
$files[$p] = if ([IO.File]::Exists($p)) { Get-PublicHash $p } else { $null }
|
||||
}
|
||||
$jobsAcl = $null
|
||||
if (Test-Path -LiteralPath $jobs) {
|
||||
try { Assert-JobsAcl; $jobsAcl = $true } catch { $jobsAcl = $false }
|
||||
}
|
||||
$aclHashes = [ordered]@{}
|
||||
foreach ($p in @($root,$state,$config,$binding,$jobs,$case)) {
|
||||
if (Test-Path -LiteralPath $p) {
|
||||
Assert-NormalPath $p ([IO.Directory]::Exists($p))
|
||||
$aclHashes[$p] = Get-BytesDigest ($utf8.GetBytes((Get-Acl -LiteralPath $p).Sddl))
|
||||
}
|
||||
}
|
||||
$live = Read-PublicJson $config
|
||||
return [ordered]@{case_id=$caseId; agent_state=[string](Get-Service RmmDiscoveryWindows).Status;
|
||||
helper_state=[string](Get-Service RmmDiscoverySystemHelper).Status; files=$files;
|
||||
acl_sha256=$aclHashes; job_profile=$live.windows_execution_profile; jobs_enabled=($live.enable_jobs -eq $true);
|
||||
binding_path_matches=($live.job_binding_file -ceq $binding);
|
||||
jobs_directory=[IO.Directory]::Exists($jobs); jobs_acl_verified=$jobsAcl}
|
||||
}
|
||||
Assert-DirectoryAcl $boot $false
|
||||
Assert-DirectoryAcl $root $true
|
||||
Assert-NormalPath $state $true
|
||||
if (Test-Path -LiteralPath $case) { Assert-DirectoryAcl $case $false }
|
||||
if ($Mode -in @('Inspect','Readback')) { Get-Readback | ConvertTo-Json -Depth 5; return }
|
||||
if ((Get-PublicHash $helperImage) -cne $helper) { throw 'Helper-Build abweichend' }
|
||||
$inputs = Get-ConfigurationInputs
|
||||
$configHash = Get-BytesDigest $inputs.config
|
||||
foreach ($p in @($jobs,$binding,$next,$backup,$entered,$done)) {
|
||||
if (Test-Path -LiteralPath $p) { throw 'Frueherer oder teilweiser Wechsel: Readback verwenden' }
|
||||
}
|
||||
if ($Mode -eq 'Prepare') {
|
||||
if ((Get-PublicHash $image) -cne $oldAgent -or (Get-Service RmmDiscoveryWindows).Status -ne 'Running') { throw 'Passiver Ausgangsagent erforderlich' }
|
||||
if (Test-Path -LiteralPath $case) { throw 'Vorhandener Vorbereitungsfall: Readback verwenden' }
|
||||
$caseAcl = [Security.AccessControl.DirectorySecurity]::new()
|
||||
$caseAcl.SetSecurityDescriptorSddlForm('O:BAG:BAD:P(A;OICI;FA;;;SY)(A;OICI;FA;;;BA)')
|
||||
$null = [IO.Directory]::CreateDirectory($case,$caseAcl)
|
||||
Assert-DirectoryAcl $case $false
|
||||
Write-Once $original ([IO.File]::ReadAllBytes($config)) $null
|
||||
Write-Once $candidate $inputs.config $null
|
||||
Write-Once $publicBinding $inputs.binding $null
|
||||
if ((Get-PublicHash $candidate) -cne $configHash -or (Get-PublicHash $original) -cne $oldConfig -or
|
||||
(Get-PublicHash $publicBinding) -cne $expectedBinding) { throw 'Vorbereitungsdateien abweichend' }
|
||||
Save-Record $ready @{case_id=$caseId; config_sha256=$configHash; original_sha256=$oldConfig; binding_sha256=$expectedBinding}
|
||||
Get-Readback | ConvertTo-Json -Depth 5
|
||||
return
|
||||
}
|
||||
$prepared = Read-PublicJson $ready
|
||||
if ($prepared.case_id -cne $caseId -or $prepared.config_sha256 -cne $configHash -or
|
||||
(Get-PublicHash $candidate) -cne $configHash -or (Get-PublicHash $original) -cne $oldConfig -or
|
||||
(Get-PublicHash $publicBinding) -cne $expectedBinding) { throw 'Vorbereitungsbeleg abweichend' }
|
||||
if ((Get-PublicHash $image) -cne $newAgent -or (Get-Service RmmDiscoveryWindows).Status -ne 'Stopped') { throw 'Neues Agentimage und gestoppter Dienst erforderlich' }
|
||||
$peer = Read-PublicJson $pin
|
||||
$time = Read-PublicJson $clock
|
||||
$roles = @($time.trusted_os_active_guest.qualifications)
|
||||
if ($peer.agent.binary_sha256 -cne $newAgent -or $peer.helper.binary_sha256 -cne $helper -or
|
||||
$roles.Count -ne 2 -or @($roles | Where-Object { $_.role -ceq 'agent' -and $_.binary_sha256 -ceq $newAgent }).Count -ne 1 -or
|
||||
@($roles | Where-Object { $_.role -ceq 'system_helper' -and $_.binary_sha256 -ceq $helper }).Count -ne 1) { throw 'Paar-Pins und Zeitprofil abweichend' }
|
||||
$acl = Get-OriginalAcl
|
||||
Save-Record $entered @{case_id=$caseId; utc=[DateTime]::UtcNow.ToString('o'); config_sha256=$configHash; binding_sha256=$expectedBinding}
|
||||
Write-Once $binding $inputs.binding $acl
|
||||
Assert-FileAcl $binding $acl
|
||||
$null = [IO.Directory]::CreateDirectory($jobs,(Get-JobsAcl))
|
||||
Assert-JobsAcl
|
||||
Write-Once $next $inputs.config $acl
|
||||
Assert-FileAcl $next $acl
|
||||
if ((Get-PublicHash $binding) -cne $expectedBinding -or (Get-PublicHash $next) -cne $configHash -or
|
||||
(Get-PublicHash $config) -cne $oldConfig) { throw 'Vor Austausch unerwartete Dateien' }
|
||||
[IO.File]::Replace($next,$config,$backup,$false)
|
||||
Assert-FileAcl $config $acl
|
||||
if ((Get-PublicHash $config) -cne $configHash -or (Get-PublicHash $backup) -cne $oldConfig) { throw 'Konfigurationswechsel nicht bestaetigt' }
|
||||
Save-Record $done @{case_id=$caseId; utc=[DateTime]::UtcNow.ToString('o'); config_sha256=$configHash; binding_sha256=$expectedBinding}
|
||||
Get-Readback | ConvertTo-Json -Depth 5
|
||||
@@ -0,0 +1,278 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
# Fixed console maintenance of the passive test guest. No queue, network, or script job.
|
||||
[CmdletBinding()]
|
||||
param([Parameter(Mandatory)][ValidateSet('Prepare','InstallPassive','Read','RestorePrevious')][string]$Mode)
|
||||
$ErrorActionPreference = 'Stop'
|
||||
$originalCase = 'ad9fd154-b2be-4f5d-9e17-65abb721ceaf'
|
||||
$originalHash = 'd8b4fd4fd9ca5310cc1591ce3c2ccae5bd72a2ade43b21a8187cfdfb960b3427'
|
||||
$bootstrap = 'C:\ProgramData\RustDiscoveryBootstrap'
|
||||
$oldFolder = Join-Path $bootstrap "time-profile-$originalCase"
|
||||
$original = Join-Path (Join-Path $bootstrap $originalHash) 'InstallPublicTimeProfile.ps1'
|
||||
$raw = [IO.File]::ReadAllBytes($original)
|
||||
$digest = [Security.Cryptography.SHA256]::Create()
|
||||
try { $actual = [BitConverter]::ToString($digest.ComputeHash($raw)).Replace('-','') }
|
||||
finally { $digest.Dispose() }
|
||||
if ($actual -ne $originalHash) { throw 'Original controller hash changed' }
|
||||
$src = [Text.Encoding]::UTF8.GetString($raw)
|
||||
$boundary = "`nCheckControl `$boot `$true`n"
|
||||
$end = $src.IndexOf($boundary,[StringComparison]::Ordinal)
|
||||
if ($end -le 0 -or $end -ne $src.LastIndexOf($boundary,[StringComparison]::Ordinal)) {
|
||||
throw 'Expected the original fixed definition boundary'
|
||||
}
|
||||
$originalIntent = Get-Content -LiteralPath (Join-Path $oldFolder 'intent.json') -Raw | ConvertFrom-Json
|
||||
if ($originalIntent.id -cne $originalCase -or $originalIntent.request.script_sha256 -cne $originalHash) {
|
||||
throw 'Unexpected original case'
|
||||
}
|
||||
$global:RmmTimeProfilePayload = $originalIntent.request
|
||||
. ([scriptblock]::Create($src.Substring(0,$end)))
|
||||
$id = '49c230d8-fb5d-4c64-96b6-e0edce03ed90'
|
||||
$work = Join-Path $boot "job-passive-pair-$id"
|
||||
$oldHashes = [ordered]@{
|
||||
agent='0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c'
|
||||
settings='bbccd710fd564eb5ad57eec5732b413359d09bcb5953f5de9501ccfe826bd3c2'
|
||||
pin='66ef481bd9ded320d6f3dcc82b0ddaf34fdef7d80ac15d06820ff7da75a18c56'
|
||||
}
|
||||
$newHashes = [ordered]@{
|
||||
agent='df80b00fc2119b973d690053b9f9e4bdedd8fbc211f67599c3301eeb42e7702f'
|
||||
settings='7172456d56a55cced2f6ed4af1e9141499f09e67cbb16db32e2308396f9de929'
|
||||
pin='b9517517cec801b10adb5d53e470fc143b8909c45e3bb95b8e4a34281f303623'
|
||||
}
|
||||
$locations = [ordered]@{agent=$agentBinary;settings=$settings;pin=$pin}
|
||||
$profileHash = '2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b'
|
||||
$helperHash = '59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e'
|
||||
$configHash = '7c9f6f3642ef84337c3cd761d8a4788c4babe81522fdd987a3eb9b819bc8d851'
|
||||
$source = Join-Path (Join-Path $boot $newHashes.agent) 'rmm-agent-windows.exe'
|
||||
CheckControl $boot $true
|
||||
CheckControl $oldFolder $true
|
||||
if ((Hash (Join-Path $oldFolder 'console-resume-empty-result.json')) -cne '62a04be9c7d08d3687b51eacd6adbe290b91e16ba934d6b5bb531e8764a56cf5') {
|
||||
throw 'Unexpected original publication result'
|
||||
}
|
||||
|
||||
function Marker($name) { Join-Path $work ($name+'.json') }
|
||||
function Record($name,$value) { WriteNew (Marker $name) $value }
|
||||
function LoadRecord($name) {
|
||||
$path = Marker $name
|
||||
CheckControl $path $false
|
||||
return (Get-Content -LiteralPath $path -Raw | ConvertFrom-Json)
|
||||
}
|
||||
function VerifyPassiveContext {
|
||||
if ((Hash $config) -cne $configHash -or (Hash $target) -cne $profileHash -or
|
||||
(Hash $helperBinary) -cne $helperHash) { throw 'Passive config, predecessor time profile or unchanged helper differs' }
|
||||
foreach ($dir in @((Split-Path $agentBinary),$agentRoot,$helperRoot)) { $null=ReadAcl $dir $true }
|
||||
foreach ($file in @($config,$settings,$pin,$target,$agentBinary,$helperBinary)) { $null=ReadAcl $file $false }
|
||||
$unitProof=Join-Path $boot 'profile-unit-fcec400-result.json'
|
||||
CheckControl $unitProof $false
|
||||
if ((Hash $unitProof) -cne '48de474d842ebc87550ba2e27b66086e6aa573973f252f4b8e19ac7b12b75a63') {
|
||||
throw 'Current native Windows profile unit receipt differs'
|
||||
}
|
||||
}
|
||||
function CurrentFiles {
|
||||
$files=[ordered]@{}
|
||||
foreach ($name in $locations.Keys) { $files[$name]=FileIdentity $locations[$name] }
|
||||
return $files
|
||||
}
|
||||
function VerifyFiles($files,$hashes) {
|
||||
foreach ($name in $locations.Keys) {
|
||||
if ($files.$name.sha256 -cne $hashes.$name) { throw "Unexpected $name bytes" }
|
||||
}
|
||||
}
|
||||
function LiveRole($role,$expectedHash) {
|
||||
$s=Service $role
|
||||
if ($s.state -cne 'Running') { throw "$role must be running" }
|
||||
$handle=[RmmPipeNative]::Open([int]$s.pid)
|
||||
try {
|
||||
$k=Kernel $role $s $handle
|
||||
$f=FileIdentity $k.image
|
||||
if ($f.sha256 -cne $expectedHash -or !(JsonEqual $s (Service $role)) -or ![RmmPipeNative]::Alive($handle)) {
|
||||
throw "$role generation or image changed"
|
||||
}
|
||||
return [ordered]@{service=$s; kernel=$k; image_file=$f}
|
||||
} finally { $handle.Dispose() }
|
||||
}
|
||||
function PreservedDevice {
|
||||
return [ordered]@{
|
||||
config=(FileIdentity $config)
|
||||
identity=(FileIdentity (Join-Path $agentState 'identity.json') $true)
|
||||
certificate=(FileIdentity (Join-Path $agentState 'device.pem') $true)
|
||||
private_key_metadata=(FileIdentityMetadata (Join-Path $agentState 'device.key'))
|
||||
helper=(FileIdentity $helperBinary)
|
||||
time_profile=(FileIdentity $target)
|
||||
}
|
||||
}
|
||||
function FlushFile($path) {
|
||||
$f=[IO.File]::Open($path,'Open','ReadWrite','Read')
|
||||
try { $f.Flush($true) } finally { $f.Dispose() }
|
||||
}
|
||||
function StopKnownRole($role,$name,$bound,$prefix) {
|
||||
$s=Service $role
|
||||
if (!(JsonEqual $s $bound.service)) { throw "$role changed before stop" }
|
||||
$h=[RmmPipeNative]::Open([int]$s.pid)
|
||||
try {
|
||||
if (!(JsonEqual (Kernel $role $s $h) $bound.kernel)) { throw 'Kernel role changed' }
|
||||
Record ($prefix+'-stop-'+$role) $bound
|
||||
Stop-Service -Name $name
|
||||
(Get-Service -Name $name).WaitForStatus('Stopped',[TimeSpan]::FromSeconds(30))
|
||||
if (![RmmPipeNative]::Exited($h,5000)) { throw "$role did not exit" }
|
||||
} finally { $h.Dispose() }
|
||||
}
|
||||
function StopCheck {
|
||||
if ((Service 'agent').state -cne 'Stopped' -or (Service 'helper').state -cne 'Stopped') {
|
||||
throw 'Both services must be stopped'
|
||||
}
|
||||
}
|
||||
function SwapFile($name,$inputPath,$oldId,$newHash,$prefix) {
|
||||
StopCheck
|
||||
$dest=$locations[$name]
|
||||
$backup=Join-Path $work ($prefix+'-replaced-'+$name)
|
||||
$stage=Join-Path $work ($prefix+'-stage-'+$name)
|
||||
CheckControl $inputPath $false
|
||||
if (!(JsonEqual $oldId (FileIdentity $dest)) -or (Hash $inputPath) -cne $newHash -or (Test-Path -LiteralPath $backup)) {
|
||||
throw "Replacement precondition $name"
|
||||
}
|
||||
[IO.File]::Copy($inputPath,$stage,$false)
|
||||
FlushFile $stage
|
||||
$candidate=FileIdentity $stage
|
||||
if ($candidate.sha256 -cne $newHash -or $candidate.volume_serial -cne $oldId.volume_serial) { throw 'Invalid same-volume candidate' }
|
||||
$originalAcl=Get-Acl -LiteralPath $dest
|
||||
Record ($prefix+'-replace-'+$name) ([ordered]@{previous=$oldId;candidate=$candidate})
|
||||
if (!(JsonEqual $oldId (FileIdentity $dest)) -or !(JsonEqual $candidate (FileIdentity $stage))) { throw 'Changed replacement identities' }
|
||||
[IO.File]::Replace($stage,$dest,$backup)
|
||||
$privateAcl=New-Object Security.AccessControl.FileSecurity
|
||||
$privateAcl.SetSecurityDescriptorSddlForm('O:BAG:BAD:P(A;;FA;;;SY)(A;;FA;;;BA)')
|
||||
Set-Acl -LiteralPath $backup -AclObject $privateAcl
|
||||
CheckControl $backup $false
|
||||
if ((AclHash $dest) -cne $oldId.acl_sha256) {
|
||||
Set-Acl -LiteralPath $dest -AclObject $originalAcl
|
||||
}
|
||||
FlushFile $dest
|
||||
$new=FileIdentity $dest
|
||||
if ($new.sha256 -cne $newHash -or $new.acl_sha256 -cne $oldId.acl_sha256 -or (Hash $backup) -cne $oldId.sha256) {
|
||||
throw "Replacement readback $name"
|
||||
}
|
||||
Record ($prefix+'-installed-'+$name) $new
|
||||
}
|
||||
function StartKnownRole($role,$name,$hash,$prefix) {
|
||||
if ((Service $role).state -cne 'Stopped') { throw "$role not stopped" }
|
||||
Record ($prefix+'-start-'+$role) @{old_state='Stopped';expected_hash=$hash}
|
||||
Start-Service -Name $name
|
||||
(Get-Service -Name $name).WaitForStatus('Running',[TimeSpan]::FromSeconds(30))
|
||||
Record ($prefix+'-started-'+$role) (LiveRole $role $hash)
|
||||
}
|
||||
function PrepareFiles($before) {
|
||||
CheckControl (Split-Path $source) $true
|
||||
CheckControl $source $false
|
||||
if ((FileIdentity $source).sha256 -cne $newHashes.agent) { throw 'New agent hash' }
|
||||
foreach ($name in $locations.Keys) {
|
||||
$copy=Join-Path $work ('old-'+$name)
|
||||
[IO.File]::Copy($locations[$name],$copy,$false)
|
||||
# Copy can retain the source descriptor. Restrict backups to the case.
|
||||
$acl=New-Object Security.AccessControl.FileSecurity
|
||||
$acl.SetSecurityDescriptorSddlForm('O:BAG:BAD:P(A;;FA;;;SY)(A;;FA;;;BA)')
|
||||
Set-Acl -LiteralPath $copy -AclObject $acl
|
||||
CheckControl $copy $false
|
||||
FlushFile $copy
|
||||
if ((Hash $copy) -cne $oldHashes.$name) { throw "Backup $name" }
|
||||
}
|
||||
$utf8=[Text.UTF8Encoding]::new($false,$true)
|
||||
foreach ($name in @('settings','pin')) {
|
||||
$data=$utf8.GetString([IO.File]::ReadAllBytes($locations[$name])).Replace($oldHashes.agent,$newHashes.agent)
|
||||
if ($name -eq 'pin') { $data=$data.Replace($oldHashes.settings,$newHashes.settings) }
|
||||
$path=Join-Path $work ('new-'+$name)
|
||||
WriteBytes $path ($utf8.GetBytes($data))
|
||||
if ((Hash $path) -cne $newHashes.$name) { throw "Closed successor bytes $name" }
|
||||
}
|
||||
if (!(JsonEqual $before (CurrentFiles))) { throw 'Original inputs changed during copy' }
|
||||
}
|
||||
if ($Mode -eq 'Read') {
|
||||
$r=[ordered]@{id=$id;mode='read_only';files=(CurrentFiles);agent=(Service 'agent');helper=(Service 'helper');markers=@()}
|
||||
if (Test-Path -LiteralPath $work) {
|
||||
CheckControl $work $true
|
||||
$r.markers=@(Get-ChildItem -LiteralPath $work -Filter '*.json' -File | Select-Object -ExpandProperty Name)
|
||||
if ((Test-Path -LiteralPath (Marker 'installed')) -and $r.files.agent.sha256 -ceq $newHashes.agent -and
|
||||
$r.agent.state -ceq 'Running' -and $r.helper.state -ceq 'Running') {
|
||||
$r.new_agent=LiveRole 'agent' $newHashes.agent
|
||||
$r.unchanged_helper=LiveRole 'helper' $helperHash
|
||||
}
|
||||
}
|
||||
$r|ConvertTo-Json -Depth 12 -Compress
|
||||
return
|
||||
}
|
||||
VerifyPassiveContext
|
||||
if ($Mode -eq 'Prepare') {
|
||||
$before=CurrentFiles
|
||||
VerifyFiles $before $oldHashes
|
||||
$agent=LiveRole 'agent' $oldHashes.agent
|
||||
$helper=LiveRole 'helper' $helperHash
|
||||
$device=PreservedDevice
|
||||
CheckControl (Split-Path $source) $true
|
||||
CheckControl $source $false
|
||||
if ((Hash $source) -cne $newHashes.agent) { throw 'Candidate absent or incorrect before preparation' }
|
||||
[RmmTimeProfileCase]::CreatePrivateOnce($work)
|
||||
CheckControl $work $true
|
||||
PrepareFiles $before
|
||||
Record 'prepared' ([ordered]@{id=$id;utc=[DateTime]::UtcNow.ToString('o');files=$before;device=$device;agent=$agent;helper=$helper})
|
||||
Write-Output "Prepared passive pair $id"
|
||||
return
|
||||
}
|
||||
CheckControl $work $true
|
||||
$prep=LoadRecord 'prepared'
|
||||
if ($prep.id -cne $id -or !(JsonEqual $prep.device (PreservedDevice))) { throw 'Prepared case or preserved device changed' }
|
||||
if ($Mode -eq 'InstallPassive') {
|
||||
if (!(JsonEqual $prep.files (CurrentFiles)) -or !(JsonEqual $prep.agent (LiveRole 'agent' $oldHashes.agent)) -or
|
||||
!(JsonEqual $prep.helper (LiveRole 'helper' $helperHash))) { throw 'Prepared baseline changed' }
|
||||
foreach ($name in $locations.Keys) {
|
||||
if ((Hash (Join-Path $work ('old-'+$name))) -cne $oldHashes.$name) { throw 'Recovery backup changed' }
|
||||
}
|
||||
foreach ($name in @('settings','pin')) {
|
||||
if ((Hash (Join-Path $work ('new-'+$name))) -cne $newHashes.$name) { throw 'Prepared successor changed' }
|
||||
}
|
||||
CheckControl $source $false
|
||||
if ((Hash $source) -cne $newHashes.agent) { throw 'New binary changed' }
|
||||
Record 'install-intent' @{id=$id;utc=[DateTime]::UtcNow.ToString('o')}
|
||||
StopKnownRole 'agent' $agentName $prep.agent 'install'
|
||||
StopKnownRole 'helper' $helperName $prep.helper 'install'
|
||||
foreach ($name in $locations.Keys) {
|
||||
$inputPath=Join-Path $work ('new-'+$name)
|
||||
if ($name -eq 'agent') { $inputPath=$source }
|
||||
SwapFile $name $inputPath $prep.files.$name $newHashes.$name 'install'
|
||||
}
|
||||
VerifyFiles (CurrentFiles) $newHashes
|
||||
StartKnownRole 'helper' $helperName $helperHash 'install'
|
||||
StartKnownRole 'agent' $agentName $newHashes.agent 'install'
|
||||
$a=LiveRole 'agent' $newHashes.agent
|
||||
$h=LiveRole 'helper' $helperHash
|
||||
if (!(JsonEqual $prep.device (PreservedDevice))) { throw 'Device changed after passive restart' }
|
||||
Record 'installed' ([ordered]@{id=$id;utc=[DateTime]::UtcNow.ToString('o');agent=$a;helper=$h;files=(CurrentFiles);device=$prep.device;job_mode=$false;clock_qualified=$false})
|
||||
Write-Output "Installed passive pair $id"
|
||||
return
|
||||
}
|
||||
# An explicit recovery is valid only before publishing any successor time profile
|
||||
# or enabling jobs. Verify all present files against the two known generations.
|
||||
$null=LoadRecord 'install-intent'
|
||||
$observed=CurrentFiles
|
||||
foreach ($name in $locations.Keys) {
|
||||
$hash=$observed.$name.sha256
|
||||
if ($hash -cnotin @($oldHashes.$name,$newHashes.$name) -or
|
||||
(Hash (Join-Path $work ('old-'+$name))) -cne $oldHashes.$name) { throw "Unknown recovery input $name" }
|
||||
}
|
||||
Record 'restore-intent' @{id=$id;utc=[DateTime]::UtcNow.ToString('o')}
|
||||
foreach ($role in @('agent','helper')) {
|
||||
$service=(Service $role)
|
||||
$name=$agentName
|
||||
$imageHash=$observed.agent.sha256
|
||||
if ($role -eq 'helper') { $name=$helperName; $imageHash=$helperHash }
|
||||
if ($service.state -ceq 'Running') { StopKnownRole $role $name (LiveRole $role $imageHash) 'restore' }
|
||||
elseif ($service.state -cne 'Stopped') { throw "Unknown service transition $role" }
|
||||
}
|
||||
StopCheck
|
||||
foreach ($name in $locations.Keys) {
|
||||
if ($observed.$name.sha256 -cne $oldHashes.$name) {
|
||||
SwapFile $name (Join-Path $work ('old-'+$name)) $observed.$name $oldHashes.$name 'restore'
|
||||
}
|
||||
}
|
||||
VerifyFiles (CurrentFiles) $oldHashes
|
||||
StartKnownRole 'helper' $helperName $helperHash 'restore'
|
||||
StartKnownRole 'agent' $agentName $oldHashes.agent 'restore'
|
||||
Record 'restored' @{id=$id;agent=(LiveRole 'agent' $oldHashes.agent);helper=(LiveRole 'helper' $helperHash)}
|
||||
Write-Output "Restored passive predecessor $id"
|
||||
@@ -0,0 +1,100 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
[CmdletBinding()]
|
||||
param()
|
||||
$ErrorActionPreference = 'Stop'
|
||||
|
||||
function Assert-PrivateUnitPath([string]$Path, [bool]$Directory) {
|
||||
$item = Get-Item -LiteralPath $Path -Force
|
||||
if ($item.PSIsContainer -ne $Directory -or ($item.Attributes -band [IO.FileAttributes]::ReparsePoint)) {
|
||||
throw 'Unexpected unit path type'
|
||||
}
|
||||
$acl = Get-Acl -LiteralPath $Path
|
||||
$trusted = @('S-1-5-18', 'S-1-5-32-544')
|
||||
$sidType = [Security.Principal.SecurityIdentifier]
|
||||
if ($acl.GetOwner($sidType).Value -notin $trusted) { throw 'Unexpected unit path owner' }
|
||||
$rules = @($acl.GetAccessRules($true, $true, $sidType))
|
||||
if (!$rules.Count) { throw 'Missing unit path ACL' }
|
||||
foreach ($rule in $rules) {
|
||||
if ($rule.AccessControlType -ne 'Allow' -or $rule.IdentityReference.Value -notin $trusted) {
|
||||
throw 'Unexpected unit path ACL'
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$bootstrap = 'C:\ProgramData\RustDiscoveryBootstrap'
|
||||
$unit = Join-Path $PSScriptRoot 'rmm_agent_windows-9b3e91d827c6ff16.exe'
|
||||
$unitHash = '7d1715dc105c1eb482405511e1b3abf4437c448e186e73923c43dd3c7938710e'
|
||||
$test = 'runtime::tests::remote_signed_requires_explicit_profile_jobs_and_binding'
|
||||
if ((Split-Path -Parent $PSScriptRoot) -ne $bootstrap) { throw 'Private bootstrap directory required' }
|
||||
Assert-PrivateUnitPath $bootstrap $true
|
||||
Assert-PrivateUnitPath $PSScriptRoot $true
|
||||
Assert-PrivateUnitPath $PSCommandPath $false
|
||||
Assert-PrivateUnitPath $unit $false
|
||||
foreach ($entry in (Get-ChildItem -LiteralPath $PSScriptRoot -Force)) {
|
||||
if ($entry.Name -notin @([IO.Path]::GetFileName($PSCommandPath), [IO.Path]::GetFileName($unit))) {
|
||||
throw 'Unit staging directory must contain only the runner and the unit executable'
|
||||
}
|
||||
}
|
||||
$system32 = [Environment]::SystemDirectory
|
||||
$shell = Join-Path $system32 'WindowsPowerShell\v1.0\powershell.exe'
|
||||
if (![Environment]::Is64BitProcess -or [Diagnostics.Process]::GetCurrentProcess().MainModule.FileName -ne $shell -or
|
||||
$PSVersionTable.PSEdition -ne 'Desktop' -or $PSVersionTable.PSVersion.Major -ne 5 -or $PSVersionTable.PSVersion.Minor -ne 1) {
|
||||
throw 'Run with the installed 64-bit Windows PowerShell 5.1'
|
||||
}
|
||||
$policies = [ordered]@{}
|
||||
foreach ($scope in 'MachinePolicy','UserPolicy','Process','CurrentUser','LocalMachine') {
|
||||
$policies[$scope] = [string](Microsoft.PowerShell.Security\Get-ExecutionPolicy -Scope $scope)
|
||||
}
|
||||
|
||||
$handle = [IO.File]::Open($unit, 'Open', 'Read', 'Read')
|
||||
try {
|
||||
$hasher = [Security.Cryptography.SHA256]::Create()
|
||||
try { $actual = [BitConverter]::ToString($hasher.ComputeHash($handle)).Replace('-','').ToLowerInvariant() }
|
||||
finally { $hasher.Dispose() }
|
||||
if ($actual -cne $unitHash -or $handle.Length -ne 18608199) { throw 'Unexpected unit executable' }
|
||||
$start = New-Object Diagnostics.ProcessStartInfo
|
||||
$start.FileName = $unit
|
||||
$start.Arguments = "--exact $test --test-threads=1 --color never"
|
||||
$start.WorkingDirectory = $PSScriptRoot
|
||||
$start.UseShellExecute = $false
|
||||
$start.CreateNoWindow = $true
|
||||
$start.RedirectStandardOutput = $true
|
||||
$start.RedirectStandardError = $true
|
||||
$start.EnvironmentVariables.Clear()
|
||||
$windows = Split-Path -Parent $system32
|
||||
$start.EnvironmentVariables['SystemRoot'] = $windows
|
||||
$start.EnvironmentVariables['WINDIR'] = $windows
|
||||
$start.EnvironmentVariables['SystemDrive'] = [IO.Path]::GetPathRoot($windows).TrimEnd('\')
|
||||
$start.EnvironmentVariables['PATH'] = $system32
|
||||
$proc = [Diagnostics.Process]::Start($start)
|
||||
try {
|
||||
$stdout = $proc.StandardOutput.ReadToEndAsync()
|
||||
$stderr = $proc.StandardError.ReadToEndAsync()
|
||||
if (!$proc.WaitForExit(30000)) {
|
||||
$proc.Kill()
|
||||
throw 'Fixed unit test timed out'
|
||||
}
|
||||
if (!$stdout.Wait(2000) -or !$stderr.Wait(2000) -or $proc.ExitCode -ne 0 -or $stderr.Result.Length -gt 0) {
|
||||
throw 'Fixed unit test failed'
|
||||
}
|
||||
$lines = @($stdout.Result -split '\r?\n' | Where-Object { $_ })
|
||||
if ($lines.Count -ne 3 -or $lines[0] -cne 'running 1 test' -or $lines[1] -cne "test $test ... ok" -or
|
||||
$lines[2] -cnotmatch '^test result: ok\. 1 passed; 0 failed; 0 ignored; 0 measured; (\d+) filtered out; finished in \d+(?:\.\d+)?s$') {
|
||||
throw 'Unexpected test result or filter count'
|
||||
}
|
||||
$filtered = [int]$Matches[1]
|
||||
} finally { $proc.Dispose() }
|
||||
} finally { $handle.Dispose() }
|
||||
|
||||
[ordered]@{
|
||||
observed_at = [DateTimeOffset]::UtcNow.ToString('o')
|
||||
unit_sha256 = $actual
|
||||
test_name = $test
|
||||
passed = 1
|
||||
filtered_out = $filtered
|
||||
powershell_path = $shell
|
||||
powershell_sha256 = (Get-FileHash -LiteralPath $shell -Algorithm SHA256).Hash.ToLowerInvariant()
|
||||
powershell_version = $PSVersionTable.PSVersion.ToString()
|
||||
admin_host_policy_scopes = $policies
|
||||
} | ConvertTo-Json -Depth 3 -Compress
|
||||
@@ -0,0 +1,238 @@
|
||||
#requires -Version 5.1
|
||||
#requires -RunAsAdministrator
|
||||
# The operator supervises this one VM and uses MCP/WebUI separately for the job.
|
||||
[CmdletBinding()]
|
||||
param(
|
||||
[Parameter(Mandatory)][ValidateSet('Open','Close','Unknown','Recover','Readback')][string]$Action,
|
||||
[guid]$SampleId, [string]$SampleSha256,
|
||||
[guid]$JobId, [guid]$AttemptId, [string]$ResultSha256
|
||||
)
|
||||
$ErrorActionPreference = 'Stop'
|
||||
$installer = Join-Path $PSScriptRoot 'Set-FirstLocalServiceJobConfig.ps1'
|
||||
$installerHash = '6ddc554bf85bb4a1382e14363351495d7a3515f281edf9ac56e16775d943850e'
|
||||
if ((Get-FileHash -LiteralPath $installer).Hash -ne $installerHash) { throw 'Wrong configuration controller' }
|
||||
$code = [Text.Encoding]::UTF8.GetString([IO.File]::ReadAllBytes($installer))
|
||||
$first = "`n`$caseId = "
|
||||
$last = "`nAssert-DirectoryAcl `$boot `$false`n"
|
||||
$i = $code.IndexOf($first,[StringComparison]::Ordinal)
|
||||
$j = $code.IndexOf($last,[StringComparison]::Ordinal)
|
||||
if ($i -lt 0 -or $j -le $i -or $i -ne $code.LastIndexOf($first,[StringComparison]::Ordinal) -or
|
||||
$j -ne $code.LastIndexOf($last,[StringComparison]::Ordinal)) { throw 'Configuration definition boundary' }
|
||||
# Import the hash-pinned fixed paths and file checks. Its action body is excluded.
|
||||
. ([scriptblock]::Create($code.Substring($i,$j-$i)))
|
||||
Assert-DirectoryAcl $boot $false
|
||||
Assert-DirectoryAcl $case $false
|
||||
Assert-DirectoryAcl $root $true
|
||||
$pairCase = Join-Path $boot ('job-passive-pair-'+$caseId)
|
||||
$opened = Join-Path $case 'window-open-intent.json'
|
||||
$started = Join-Path $case 'window-job-started.json'
|
||||
$closed = Join-Path $case 'window-passive-confirmed.json'
|
||||
$request = Join-Path $case 'window-close-request.json'
|
||||
$restoreStage = Join-Path $case 'window-restore.candidate.json'
|
||||
$replaced = Join-Path $case 'window-restored-job-config.json'
|
||||
$svcName = 'RmmDiscoveryWindows'
|
||||
$helperName = 'RmmDiscoverySystemHelper'
|
||||
$command = '"' + $image + '" --service --config "' + $config + '"'
|
||||
|
||||
function Save-WindowRecord([string]$Name,$Data) {
|
||||
Save-Record (Join-Path $case ('window-'+$Name+'.json')) $Data
|
||||
}
|
||||
function Get-WindowReadback {
|
||||
$events = [ordered]@{}
|
||||
foreach ($f in @(Get-ChildItem -LiteralPath $case -Filter 'window-*.json' -File)) {
|
||||
$events[$f.Name] = Get-PublicHash $f.FullName
|
||||
}
|
||||
$result = Get-Readback
|
||||
$result['events'] = $events
|
||||
$result['job_config_sha256'] = (Read-PublicJson $ready).config_sha256
|
||||
return $result
|
||||
}
|
||||
function Get-AgentService {
|
||||
$s = Get-CimInstance Win32_Service -Filter "Name='RmmDiscoveryWindows'"
|
||||
if ($s.PathName -ine $command -or $s.StartName -ine 'NT AUTHORITY\LocalService' -or $s.StartMode -ne 'Auto') {
|
||||
throw 'Agent SCM registration changed'
|
||||
}
|
||||
return $s
|
||||
}
|
||||
function Get-LiveProcess([string]$Name,[string]$ExpectedPath,[string]$ExpectedHash) {
|
||||
$s = Get-CimInstance Win32_Service -Filter ("Name='" + $Name + "'")
|
||||
if ($s.State -ne 'Running' -or !$s.ProcessId) { throw "Service unavailable: $Name" }
|
||||
$proc = [Diagnostics.Process]::GetProcessById($s.ProcessId)
|
||||
try {
|
||||
$null = $proc.Handle
|
||||
$birth = $proc.StartTime.ToUniversalTime().ToFileTimeUtc().ToString([Globalization.CultureInfo]::InvariantCulture)
|
||||
$after = Get-CimInstance Win32_Service -Filter ("Name='" + $Name + "'")
|
||||
if ($proc.MainModule.FileName -ine $ExpectedPath -or (Get-PublicHash $ExpectedPath) -cne $ExpectedHash -or
|
||||
$proc.HasExited -or $after.State -ne 'Running' -or $after.ProcessId -ne $proc.Id) { throw "Process changed: $Name" }
|
||||
return @{pid=$proc.Id; birth=$birth}
|
||||
} finally { $proc.Dispose() }
|
||||
}
|
||||
function Stop-WindowAgent($Expected) {
|
||||
$null = Get-AgentService
|
||||
$live = Get-LiveProcess $svcName $image $newAgent
|
||||
if ($null -ne $Expected -and ($live.pid -ne $Expected.pid -or $live.birth -cne $Expected.birth)) {
|
||||
throw 'Unexpected agent generation before stopping'
|
||||
}
|
||||
$proc = [Diagnostics.Process]::GetProcessById([int]$live.pid)
|
||||
$svc = Get-Service $svcName
|
||||
try {
|
||||
$null = $proc.Handle
|
||||
if ($proc.StartTime.ToUniversalTime().ToFileTimeUtc().ToString() -cne $live.birth -or
|
||||
(Get-AgentService).ProcessId -ne $proc.Id) { throw 'Agent generation changed at stop' }
|
||||
$svc.Stop()
|
||||
$svc.WaitForStatus('Stopped',[TimeSpan]::FromSeconds(35))
|
||||
if (!$proc.WaitForExit(5000)) { throw 'Old agent process still present' }
|
||||
} finally { $proc.Dispose(); $svc.Dispose() }
|
||||
}
|
||||
function Start-WindowAgent([string]$Kind) {
|
||||
$s = Get-AgentService
|
||||
if ($s.State -ne 'Stopped' -or $s.ProcessId -ne 0) { throw 'Agent must be stopped before start' }
|
||||
# Preserve the original SCM error and never repeat a start in the same mode.
|
||||
Save-WindowRecord ($Kind+'-start-intent') @{utc=[DateTime]::UtcNow.ToString('o'); config_sha256=(Get-PublicHash $config)}
|
||||
$svc = Get-Service $svcName
|
||||
try { $svc.Start(); $svc.WaitForStatus('Running',[TimeSpan]::FromSeconds(30)) }
|
||||
finally { $svc.Dispose() }
|
||||
return Get-LiveProcess $svcName $image $newAgent
|
||||
}
|
||||
function Confirm-Samples {
|
||||
if ($SampleId -eq [guid]::Empty -or $SampleSha256 -cnotmatch '^[0-9a-f]{64}$') { throw 'Validated server readback required' }
|
||||
Assert-DirectoryAcl $pairCase $false
|
||||
$samplePath = Join-Path $pairCase ('samples-passive-'+$SampleId.ToString()+'.json')
|
||||
if ((Get-PublicHash $samplePath) -cne $SampleSha256) { throw 'Sample receipt hash mismatch' }
|
||||
Assert-NormalPath $samplePath $false
|
||||
if ((Get-Item -LiteralPath $samplePath).Length -gt 131072) { throw 'Sample receipt too large' }
|
||||
$r = $utf8.GetString([IO.File]::ReadAllBytes($samplePath)) | ConvertFrom-Json
|
||||
$profileReceipt = Join-Path $pairCase 'profile-published.json'
|
||||
$pub = Read-PublicJson $profileReceipt
|
||||
$a = Get-LiveProcess $svcName $image $newAgent
|
||||
$h = Get-LiveProcess $helperName $helperImage $helper
|
||||
if ($r.session_id -cne $SampleId.ToString() -or $r.pair_case_id -cne $caseId -or $r.mode -cne 'passive' -or
|
||||
$r.profile_sha256 -cne (Get-PublicHash $clock) -or $r.profile_receipt_sha256 -cne (Get-PublicHash $profileReceipt) -or
|
||||
$pub.configuration.sha256 -cne $r.profile_sha256 -or $r.publication_since -cne $pub.publication_since -or
|
||||
$r.agent_pid -ne $a.pid -or [string]$r.agent_birth_filetime -cne $a.birth -or
|
||||
$r.helper_pid -ne $h.pid -or [string]$r.helper_birth_filetime -cne $h.birth -or
|
||||
$r.connection_generation -lt 1 -or $r.agent_sample_sha256 -cnotmatch '^[0-9a-f]{64}$' -or
|
||||
$r.helper_sample_sha256 -cnotmatch '^[0-9a-f]{64}$' -or $r.agent_sample_sha256 -ceq $r.helper_sample_sha256) {
|
||||
throw 'Samples no longer bind the installed profile and both live service instances'
|
||||
}
|
||||
return $a
|
||||
}
|
||||
function Restore-Passive {
|
||||
$intent = Read-PublicJson $opened
|
||||
$jobHash = (Read-PublicJson $ready).config_sha256
|
||||
if ($intent.case_id -cne $caseId -or $intent.config_sha256 -cne $jobHash -or $intent.original_sha256 -cne $oldConfig -or
|
||||
(Get-PublicHash $original) -cne $oldConfig -or (Get-BytesDigest ($utf8.GetBytes($intent.passive_sddl))) -cne $oldConfigAcl) {
|
||||
throw 'Original passive configuration proof missing'
|
||||
}
|
||||
$s = Get-AgentService
|
||||
if ($s.State -in 'Start Pending','Stop Pending') {
|
||||
$svc=Get-Service $svcName
|
||||
try {
|
||||
$waitFor = if ($s.State -eq 'Start Pending') { 'Running' } else { 'Stopped' }
|
||||
$svc.WaitForStatus($waitFor,[TimeSpan]::FromSeconds(35))
|
||||
} finally { $svc.Dispose() }
|
||||
$s = Get-AgentService
|
||||
}
|
||||
$actual = Get-PublicHash $config
|
||||
if ($actual -cne $oldConfig) {
|
||||
if ($s.State -eq 'Running') { Stop-WindowAgent $null }
|
||||
if ($actual -cne $jobHash -or (Get-AgentService).State -ne 'Stopped') { throw 'Unexpected live config: keep agent stopped' }
|
||||
$acl = [Security.AccessControl.FileSecurity]::new()
|
||||
$acl.SetSecurityDescriptorSddlForm($intent.passive_sddl)
|
||||
if (!(Test-Path -LiteralPath $restoreStage)) {
|
||||
Write-Once $restoreStage ([IO.File]::ReadAllBytes($original)) $acl
|
||||
}
|
||||
if ((Get-PublicHash $restoreStage) -cne $oldConfig -or (Get-PublicHash $config) -cne $jobHash -or
|
||||
(Test-Path -LiteralPath $replaced)) { throw 'Unconfirmed restore state' }
|
||||
Assert-FileAcl $restoreStage $acl
|
||||
[IO.File]::Replace($restoreStage,$config,$replaced,$false)
|
||||
if ((Get-PublicHash $replaced) -cne $jobHash) { throw 'Restored predecessor binding failed' }
|
||||
}
|
||||
if ((Get-PublicHash $config) -cne $oldConfig) { throw 'Passive configuration not restored' }
|
||||
$acl = [Security.AccessControl.FileSecurity]::new()
|
||||
$acl.SetSecurityDescriptorSddlForm($intent.passive_sddl)
|
||||
Assert-FileAcl $config $acl
|
||||
$s = Get-AgentService
|
||||
if ($s.State -eq 'Running' -and (Test-Path -LiteralPath $started)) {
|
||||
$jobGeneration = (Read-PublicJson $started).agent
|
||||
$live = Get-LiveProcess $svcName $image $newAgent
|
||||
if ($live.pid -eq $jobGeneration.pid -and $live.birth -ceq $jobGeneration.birth) {
|
||||
Stop-WindowAgent $jobGeneration
|
||||
$s = Get-AgentService
|
||||
}
|
||||
}
|
||||
if ($s.State -eq 'Stopped') { $live = Start-WindowAgent 'passive' }
|
||||
else { $live = Get-LiveProcess $svcName $image $newAgent }
|
||||
if (!(Test-Path -LiteralPath $closed)) {
|
||||
Save-WindowRecord 'passive-confirmed' @{utc=[DateTime]::UtcNow.ToString('o'); agent=$live; config_sha256=$oldConfig;
|
||||
close_request_present=(Test-Path -LiteralPath $request); service_start_mode=$s.StartMode}
|
||||
}
|
||||
}
|
||||
|
||||
if ($Action -eq 'Readback') { Get-WindowReadback | ConvertTo-Json -Depth 8; return }
|
||||
if ($Action -in 'Close','Unknown') {
|
||||
if (!(Test-Path -LiteralPath $opened) -or (Test-Path -LiteralPath $closed)) { throw 'No open window' }
|
||||
if ($Action -eq 'Close' -and ($JobId -eq [guid]::Empty -or $AttemptId -eq [guid]::Empty -or
|
||||
$ResultSha256 -cnotmatch '^[0-9a-f]{64}$')) { throw 'Exact server terminal result reference required' }
|
||||
Save-Record $request @{utc=[DateTime]::UtcNow.ToString('o'); action=$Action; job_id=$JobId;
|
||||
attempt_id=$AttemptId; result_sha256=$ResultSha256}
|
||||
'Close request recorded'
|
||||
return
|
||||
}
|
||||
$lockPath = Join-Path $case 'window.lock'
|
||||
$lock = [IO.File]::Open($lockPath,'OpenOrCreate','ReadWrite','None')
|
||||
try {
|
||||
if ($Action -eq 'Recover') {
|
||||
if (!(Test-Path -LiteralPath $opened)) { throw 'No original open intent' }
|
||||
Restore-Passive
|
||||
Get-WindowReadback | ConvertTo-Json -Depth 8
|
||||
return
|
||||
}
|
||||
if (Test-Path -LiteralPath $opened) { throw 'Existing window: readback or recover only' }
|
||||
if ((Get-PublicHash $config) -cne $oldConfig -or (Get-PublicHash $original) -cne $oldConfig) { throw 'Expected original passive configuration' }
|
||||
$null = Get-AgentService
|
||||
$expected = Confirm-Samples
|
||||
$passiveAcl = Get-OriginalAcl
|
||||
$prepared = Read-PublicJson $ready
|
||||
$deadline = [DateTime]::UtcNow.AddMinutes(12)
|
||||
Save-Record $opened @{case_id=$caseId; utc=[DateTime]::UtcNow.ToString('o'); deadline=$deadline.ToString('o');
|
||||
config_sha256=$prepared.config_sha256; original_sha256=$oldConfig; passive_sddl=$passiveAcl.Sddl;
|
||||
sample_id=$SampleId; sample_sha256=$SampleSha256; passive_agent=$expected}
|
||||
try {
|
||||
Stop-WindowAgent $expected
|
||||
$null = & $installer -Mode Activate
|
||||
if ((Get-PublicHash $config) -cne $prepared.config_sha256 -or !(Test-Path -LiteralPath $done)) { throw 'Job configuration readback missing' }
|
||||
$running = Start-WindowAgent 'job'
|
||||
Save-Record $started @{utc=[DateTime]::UtcNow.ToString('o'); agent=$running; config_sha256=$prepared.config_sha256}
|
||||
Write-Output 'Job window open. Awaiting the separate approved test and receipt.'
|
||||
$watch = [Diagnostics.Stopwatch]::StartNew()
|
||||
while ($watch.Elapsed.TotalMinutes -lt 12 -and [DateTime]::UtcNow -lt $deadline -and !(Test-Path -LiteralPath $request)) {
|
||||
Start-Sleep -Seconds 2
|
||||
$s = Get-AgentService
|
||||
if ($s.State -ne 'Running' -or $s.ProcessId -ne $running.pid) { throw 'Active agent process lost; result unknown' }
|
||||
}
|
||||
if (!(Test-Path -LiteralPath $request)) { Save-Record $request @{utc=[DateTime]::UtcNow.ToString('o'); action='TimeoutUnknown'} }
|
||||
} catch {
|
||||
$errorRecord = Join-Path $case 'window-error.json'
|
||||
if (!(Test-Path -LiteralPath $errorRecord)) {
|
||||
$s = Get-CimInstance Win32_Service -Filter "Name='RmmDiscoveryWindows'"
|
||||
Save-Record $errorRecord @{utc=[DateTime]::UtcNow.ToString('o'); type=$_.Exception.GetBaseException().GetType().FullName;
|
||||
hresult=('0x{0:X8}' -f $_.Exception.GetBaseException().HResult); line=$_.InvocationInfo.ScriptLineNumber;
|
||||
service_state=$s.State; service_exit_code=$s.ExitCode; service_specific_exit_code=$s.ServiceSpecificExitCode}
|
||||
}
|
||||
throw
|
||||
} finally {
|
||||
try { Restore-Passive }
|
||||
catch {
|
||||
$failure = Join-Path $case 'window-restore-error.json'
|
||||
if (!(Test-Path -LiteralPath $failure)) {
|
||||
$s = Get-CimInstance Win32_Service -Filter "Name='RmmDiscoveryWindows'"
|
||||
Save-Record $failure @{utc=[DateTime]::UtcNow.ToString('o'); type=$_.Exception.GetBaseException().GetType().FullName;
|
||||
hresult=('0x{0:X8}' -f $_.Exception.GetBaseException().HResult); line=$_.InvocationInfo.ScriptLineNumber;
|
||||
service_state=$s.State; service_exit_code=$s.ExitCode; service_specific_exit_code=$s.ServiceSpecificExitCode}
|
||||
}
|
||||
throw
|
||||
}
|
||||
}
|
||||
Get-WindowReadback | ConvertTo-Json -Depth 8
|
||||
} finally { $lock.Dispose() }
|
||||
@@ -230,3 +230,9 @@ Use those same arguments with `-Mode Build -ExpectedPreflight <actual-receipt>`.
|
||||
Populate the isolated public Cargo cache explicitly before an offline build;
|
||||
there is no automatic fetch/retry in the builder. Native setup, native MIDL/ABI,
|
||||
unit execution and deployment results are still outstanding until actually run.
|
||||
|
||||
On November 15, 2026 a read-only check on the running Windows test VM found
|
||||
both CBS and Windows Update restart markers, 96 GiB free on C:, no vswhere
|
||||
at its standard installer path, and no rustc on the development user's PATH.
|
||||
No installer was launched. This check does not determine why the markers are
|
||||
present. Receipt `04a56e7d8a8bf00a110558344248fbb0ca0c2234c5c1ea6e347306bcc84d5c55`.
|
||||
|
||||
@@ -0,0 +1,188 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Read two public service observations; never request time or alter the guest."""
|
||||
import argparse
|
||||
import base64
|
||||
import datetime as dt
|
||||
import hashlib
|
||||
import json
|
||||
import os
|
||||
from pathlib import Path
|
||||
import re
|
||||
import sys
|
||||
import time
|
||||
import uuid
|
||||
|
||||
import system_pipe_upgrade as access_bridge
|
||||
import time_route_context as context_reader
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[2]
|
||||
ACCESS_ROOT = ROOT.parent / 'rust-discovery'
|
||||
STATE = ROOT / 'devstate/windows-passive-time-closeout'
|
||||
FIELDS = {'schema_version', 'agent_pid', 'observed_at', 'role', 'windows_boot_id',
|
||||
'connection_generation', 'verifier_incarnation', 'request_sha256', 'response_sha256'}
|
||||
FILES = {'agent': 'agent-time-sample.json', 'system_helper': 'helper-time-sample.json'}
|
||||
HEX = re.compile(r'[0-9a-f]{64}')
|
||||
SECOND_NS = 1_000_000_000
|
||||
|
||||
# No report is requested from a service. The only content reads on the guest
|
||||
# are these two public JSONs and public executable hashes. CIM/process queries
|
||||
# obtain current boot/SCM/image/birth metadata without starting another binary.
|
||||
SCRIPT = Path(__file__).with_name('Read-PassiveTimeSamples.ps1').read_text(encoding='utf-8')
|
||||
|
||||
|
||||
def need(value, tag):
|
||||
if not value:
|
||||
raise ValueError(tag)
|
||||
|
||||
|
||||
def strict(pairs):
|
||||
value = {}
|
||||
for key, item in pairs:
|
||||
need(key not in value, 'DUPLICATE_PUBLIC_FIELD')
|
||||
value[key] = item
|
||||
return value
|
||||
|
||||
|
||||
def stamp(value):
|
||||
need(type(value) is str, 'UTC_TIMESTAMP_REQUIRED')
|
||||
match = re.fullmatch(r'(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2})(?:\.(\d{1,9}))?Z', value)
|
||||
need(match is not None, 'UTC_TIMESTAMP_REQUIRED')
|
||||
base = dt.datetime.strptime(match[1], '%Y-%m-%dT%H:%M:%S').replace(tzinfo=dt.timezone.utc)
|
||||
elapsed = base - dt.datetime(1970, 1, 1, tzinfo=dt.timezone.utc)
|
||||
return (elapsed.days * 86400 + elapsed.seconds) * SECOND_NS + int((match[2] or '').ljust(9, '0'))
|
||||
|
||||
|
||||
def utc_ns(value):
|
||||
return stamp(value.astimezone(dt.timezone.utc).isoformat().replace('+00:00', 'Z'))
|
||||
|
||||
|
||||
def canonical_uuid(value):
|
||||
need(type(value) is str and str(uuid.UUID(value)) == value and uuid.UUID(value).int > 0, 'UUID_REQUIRED')
|
||||
return value
|
||||
|
||||
|
||||
def sha(path):
|
||||
return hashlib.sha256(Path(path).read_bytes()).hexdigest()
|
||||
|
||||
|
||||
def save(folder, name, value):
|
||||
fd = os.open(folder / name, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, 0o600)
|
||||
with os.fdopen(fd, 'w') as stream:
|
||||
json.dump(value, stream, indent=2)
|
||||
stream.flush()
|
||||
os.fsync(stream.fileno())
|
||||
|
||||
|
||||
def windows_boot(ticks):
|
||||
need(type(ticks) is str and ticks.isascii() and ticks.isdigit() and 17 <= len(ticks) <= 19, 'BOOT_TICKS')
|
||||
raw = bytearray(hashlib.sha256(('rmm.windows.boot.cim.ticks.v1:' + ticks).encode()).digest()[:16])
|
||||
raw[6] = (raw[6] & 15) | 0x80
|
||||
raw[8] = (raw[8] & 63) | 0x80
|
||||
return str(uuid.UUID(bytes=bytes(raw)))
|
||||
|
||||
|
||||
def filetime(value):
|
||||
need(type(value) is str and value.isascii() and value.isdigit(), 'FILETIME_REQUIRED')
|
||||
return (int(value) - 116444736000000000) * 100
|
||||
|
||||
|
||||
def validate(native, server, since, observed_now):
|
||||
need(native['read_only'] is True and server['sql_read_only'] is True and server['secrets_read'] is False, 'READ_ONLY_WITNESSES')
|
||||
current = server['installation']
|
||||
caps = current['capabilities']
|
||||
need(type(caps) is list and len(caps) == 3 and set(caps) == {'windows.base/1', 'heartbeat/1', 'agent.update/1'}, 'PASSIVE_SERVER_CAPABILITIES')
|
||||
boot = windows_boot(native['boot_ticks'])
|
||||
need(current['windows_boot_id'] == boot, 'CURRENT_SERVER_WINDOWS_BOOT')
|
||||
generation = current['connection_generation']
|
||||
need(type(generation) is int and generation > 0, 'CURRENT_POSITIVE_GENERATION')
|
||||
now = stamp(native['observed_at'])
|
||||
need(abs(now - utc_ns(observed_now)) <= 10 * SECOND_NS, 'CURRENT_WINDOWS_UTC')
|
||||
records = []
|
||||
for role, filename in FILES.items():
|
||||
wrapped = native['reports'][filename]
|
||||
need(wrapped is not None, 'PUBLIC_SERVICE_SAMPLE_MISSING')
|
||||
raw = base64.b64decode(wrapped['raw_base64'], validate=True)
|
||||
need(len(raw) <= 8192 and hashlib.sha256(raw).hexdigest() == wrapped['sha256'], 'PUBLIC_SAMPLE_RAW_HASH')
|
||||
record = json.loads(raw, object_pairs_hook=strict)
|
||||
need(set(record) == FIELDS and type(record['schema_version']) is int and record['schema_version'] == 1, 'PUBLIC_SAMPLE_SCHEMA')
|
||||
need(record['role'] == role and type(record['agent_pid']) is int and record['agent_pid'] == native['runtime']['agent']['pid'], 'SAMPLE_PROCESS_ROLE')
|
||||
need(record['windows_boot_id'] == boot and type(record['connection_generation']) is int and record['connection_generation'] == generation, 'SAMPLE_BOOT_GENERATION')
|
||||
canonical_uuid(record['verifier_incarnation'])
|
||||
for field in ('request_sha256', 'response_sha256'):
|
||||
need(type(record[field]) is str and HEX.fullmatch(record[field]) is not None, 'SAMPLE_HASH_FORMAT')
|
||||
observed = stamp(record['observed_at'])
|
||||
modified = filetime(wrapped['metadata']['last_write_filetime'])
|
||||
birth = filetime(native['runtime']['agent']['birth_filetime'])
|
||||
need(since <= observed <= now + 2 * SECOND_NS and birth <= observed, 'SAMPLE_CURRENT_INSTALL_WINDOW')
|
||||
need(0 <= now - modified <= 180 * SECOND_NS and 0 <= now - observed <= 180 * SECOND_NS, 'SAMPLE_FILE_AGE')
|
||||
need(-2 * SECOND_NS <= modified - observed <= 90 * SECOND_NS, 'SAMPLE_PUBLICATION_DELAY')
|
||||
need(wrapped['metadata']['dacl_checked'] is True, 'SAMPLE_PROTECTED_METADATA')
|
||||
records.append(record)
|
||||
for field in ('verifier_incarnation', 'request_sha256', 'response_sha256'):
|
||||
need(records[0][field] != records[1][field], 'INDEPENDENT_ROLE_' + field.upper())
|
||||
return records
|
||||
|
||||
|
||||
def collect(args):
|
||||
need(HEX.fullmatch(args.agent_sha256) and HEX.fullmatch(args.helper_sha256), 'QUALIFIED_RUNTIME_HASHES_REQUIRED')
|
||||
since = stamp(args.profile_after)
|
||||
need(0 <= utc_ns(dt.datetime.now(dt.timezone.utc)) - since <= 600 * SECOND_NS, 'RECENT_PROFILE_INSTALL_WINDOW')
|
||||
STATE.mkdir(parents=True, mode=0o700, exist_ok=True)
|
||||
ident = str(uuid.uuid4())
|
||||
folder = STATE / ident
|
||||
folder.mkdir(mode=0o700)
|
||||
save(folder, 'intent.json', dict(id=ident, operator_sha256=sha(__file__), source_commit='cc821246ccd98ee6d3dc5c1b12c7303d3010e8a7',
|
||||
read_only=True, agent_sha256=args.agent_sha256, helper_sha256=args.helper_sha256, profile_after=args.profile_after,
|
||||
wait_seconds=180, in_progress_read_budget_seconds=105, sample_max_age_seconds=180, no_requests_to_services=True))
|
||||
access_bridge.STATE.mkdir(parents=True, mode=0o700, exist_ok=True)
|
||||
access = access_bridge.Access(ACCESS_ROOT)
|
||||
deadline = time.monotonic() + 180
|
||||
attempt = 0
|
||||
last = 'PUBLIC_SERVICE_SAMPLE_MISSING'
|
||||
while time.monotonic() < deadline:
|
||||
attempt += 1
|
||||
before = context_reader.rpc(access, dict(id=ident, deployment_result_sha256=context_reader.DEPLOYMENT_RESULT_SHA, image=context_reader.IMAGE), folder)
|
||||
native = access.powershell(SCRIPT, dict(id=ident, agent_sha256=args.agent_sha256, helper_sha256=args.helper_sha256), timeout=45)
|
||||
save(folder, f'{attempt:02d}-native.json', native) # persist before assertions
|
||||
after = context_reader.rpc(access, dict(id=ident, deployment_result_sha256=context_reader.DEPLOYMENT_RESULT_SHA, image=context_reader.IMAGE), folder)
|
||||
save(folder, f'{attempt:02d}-server.json', dict(before=before, after=after))
|
||||
try:
|
||||
need(before == after, 'SERVER_CONTEXT_CHANGED_DURING_READ')
|
||||
records = validate(native, after, since, dt.datetime.now(dt.timezone.utc))
|
||||
except ValueError as error:
|
||||
last = str(error)
|
||||
save(folder, f'{attempt:02d}-not-accepted.json', dict(reason=last, read_only=True))
|
||||
if last not in ('PUBLIC_SERVICE_SAMPLE_MISSING', 'SAMPLE_BOOT_GENERATION', 'SAMPLE_PROCESS_ROLE', 'SAMPLE_CURRENT_INSTALL_WINDOW', 'SAMPLE_FILE_AGE', 'SERVER_CONTEXT_CHANGED_DURING_READ'):
|
||||
raise
|
||||
time.sleep(min(5, max(0, deadline-time.monotonic())))
|
||||
continue
|
||||
links = {name: sha(folder/name) for name in ('intent.json', f'{attempt:02d}-native.json', f'{attempt:02d}-server.json')}
|
||||
save(folder, 'receipt.json', dict(id=ident, operator_sha256=sha(__file__), verified=True, read_only=True,
|
||||
historical_role_samples_only=True, current_job_clock_proven=False, records=records, links=links))
|
||||
print(json.dumps(dict(id=ident, verified=True, read_only=True, receipt_sha256=sha(folder/'receipt.json'))))
|
||||
return
|
||||
save(folder, 'incomplete.json', dict(id=ident, verified=False, read_only=True, reason=last, no_diagnostic_triggered=True))
|
||||
print(json.dumps(dict(id=ident, verified=False, reason=last, read_only=True)))
|
||||
raise SystemExit(1)
|
||||
|
||||
|
||||
def guards():
|
||||
forbidden = ('Start-Service', 'Stop-Service', 'Restart-Service', 'Remove-Item', 'WriteAll', 'WriteNew', 'TimeBegin', 'TimeComplete', '--native-probe', 'Snapshot', 'Execute')
|
||||
need(all(item not in SCRIPT for item in forbidden), 'READ_ONLY_SOURCE_ONLY')
|
||||
need(all(name in SCRIPT for name in FILES.values()), 'TWO_FIXED_REPORT_NAMES')
|
||||
print('PASS local source guards; no target call')
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
parser = argparse.ArgumentParser(description=__doc__)
|
||||
parser.add_argument('action', choices=('guards', 'collect'))
|
||||
parser.add_argument('--agent-sha256')
|
||||
parser.add_argument('--helper-sha256')
|
||||
parser.add_argument('--profile-after')
|
||||
args = parser.parse_args()
|
||||
if args.action == 'guards':
|
||||
guards()
|
||||
else:
|
||||
need(all((args.agent_sha256, args.helper_sha256, args.profile_after)), 'ROOT_ACTUAL_PROFILE_AND_RUNTIME_REQUIRED')
|
||||
guards()
|
||||
collect(args)
|
||||
@@ -1,14 +1,16 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Local-only preparation of a new preserving passive Windows code-pair controller.
|
||||
"""Prepare the preserving passive Windows pair with fixed actual route evidence.
|
||||
|
||||
No SSH, staging or target action is exposed here. The generated controller's
|
||||
enter phase remains closed until a separate reviewed source generation binds
|
||||
actual server source/broker/public-time-key/mTLS-route qualification. Original
|
||||
14fb evidence and Main indices are read-only; no time pins or calibration exist
|
||||
in this package. Source review and native PS AST/C# compile remain separate.
|
||||
Preparation reads only the public expires_at from the current protected access
|
||||
configuration. Before effects the guest must match that same expiration in its
|
||||
existing account and bootstrap-public configuration, with a full first-stop
|
||||
budget and a smaller remaining budget at the second stop. No account/tunnel
|
||||
change, RMM job, reboot or clock configuration is performed by this generator.
|
||||
"""
|
||||
import argparse
|
||||
import base64
|
||||
import datetime as dt
|
||||
import re
|
||||
import hashlib
|
||||
import json
|
||||
import os
|
||||
@@ -30,11 +32,16 @@ RUNTIME_INDEX = 'e49231e72aff7b001189b8507200c6c701f73e47f77c29194116cf1da41ca0c
|
||||
COMPONENT_INDEX = '005317e652f50de3e1277be3bc42717318226208015e7c8011e1b73469cc7562'
|
||||
ORIGINAL_RESULT = 'd5c4996821911a5bdac5014e9f985c56bbb592b803f2e33411dd28bb986b8eed'
|
||||
ORIGINAL_INTENT = '374adc97bec41bd798409f7c4f8c7716b085e20d2b6fb64b33f7ab675e6483e2'
|
||||
CANDIDATE = ROOT / 'devstate/windows-signed-clock/freshness-candidate-link-917425d6-412b-4f70-a7db-bc02de6b9b2a'
|
||||
CANDIDATE_RECEIPT = '2abf7fe56633e68864469de2ff9ded21888301bdc737e53211d024cfd044e22e'
|
||||
QUALIFICATION = '6a624ee9b795ce67d80a91536ba242835be9757a2f502d2d9fbc545532e1b560'
|
||||
NEW_AGENT = '751657ee873c4f4d013abc4ea6daaa4641fea2fe55838fb1c701e6a71b57c192'
|
||||
NEW_HELPER = 'acf1e3f3b1609a97e0d5e88a43a421bed530a09a236bfc0dec1b1abbb22d4413'
|
||||
HELPER_CANDIDATE = ROOT / 'devstate/windows-signed-clock/trusted-os-candidate-link-542cbf43-afb2-4994-b141-06e003e5e2e8'
|
||||
HELPER_RECEIPT = '04ed34e6e850aca77c1fd4677ddb271f7ccd9492a97f5d4e00ead4c1f032f29d'
|
||||
HELPER_QUALIFICATION = '96b05fe13f4d459b4b3ef78292beea33827b1ea47293ffb5921c685940e82a4d'
|
||||
CANDIDATE = MAIN / 'devstate/windows-client/operator-window-20261115/observed-agent-build'
|
||||
# Closed until Root supplies the actual completed native qualification receipt.
|
||||
CANDIDATE_RECEIPT = 'f04024f78c2f11f5c66bbdf9278467f5bcc50da5c2bd7336623851bca42dd446'
|
||||
QUALIFICATION = 'f04024f78c2f11f5c66bbdf9278467f5bcc50da5c2bd7336623851bca42dd446'
|
||||
SOURCE_INPUTS = '11717fab51bd1d6bf103b1821cc1e2a84699f46cac21f2cc614acf4b68381fa4'
|
||||
NEW_AGENT = '0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c'
|
||||
NEW_HELPER = '59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e'
|
||||
PROBE = '727732fb4b38ac5431a330527bd52a3ab80af8f189ae75a7b48eceb1d4b69cac'
|
||||
SYSTEM_PROBE = '77a344912c61b7ac4a92152ae1b534ca7c36fe6f7dc4675783f20558c3a7f434'
|
||||
require = prior.require
|
||||
@@ -61,13 +68,35 @@ def controller():
|
||||
marker = "foreach($field in @('old_agent'"
|
||||
index = prefix.index(marker)
|
||||
prefix = prefix[:index] + ("# No caller flag or staged file can replace missing server qualification.\n"
|
||||
"if($p.action-ceq'enter'){throw 'SERVER_TIME_QUALIFICATION_NOT_BOUND'}\n"
|
||||
"# Enter effects require the fixed actual protocol/exit proof below.\n"
|
||||
"if($p.new_agent-cne'"+NEW_AGENT+"'-or$p.new_helper-cne'"+NEW_HELPER+
|
||||
"'){throw 'Fixed signed-clock freshness candidate pair'}\n") + prefix[index:]
|
||||
# Require explicit absence; this bootstrap never creates or adopts a
|
||||
# calibration/public-time-pin file or changes the six-field passive config.
|
||||
marker = 'function State([bool]$new){\n'
|
||||
prefix = replace_once(prefix, marker, marker + " if(Test-Path -LiteralPath (Join-Path $helperRoot 'time-attestation.json')){throw 'Separate time-pin provisioning required; passive bootstrap does not adopt it'}\n")
|
||||
# Compare JSON objects by their contents; serialized member order is not
|
||||
# identity. Arrays retain exact order and empty/null values stay distinct.
|
||||
prefix = replace_once(prefix,
|
||||
"function JsonEqual($a,$b){return(($a|ConvertTo-Json -Depth 40 -Compress)-ceq($b|ConvertTo-Json -Depth 40 -Compress))}",
|
||||
r'''function CanonicalStateValue($value,[int]$depth=0){
|
||||
if($depth-gt40){throw 'Bounded state comparison depth'}
|
||||
if($null-eq$value){return $null}
|
||||
# ETS wrapping does not turn a CLR JSON scalar into a JSON object.
|
||||
$base=$value.PSObject.BaseObject;$culture=[Globalization.CultureInfo]::InvariantCulture
|
||||
if($base-is[string]){return [string]::new($base.ToCharArray())}
|
||||
if($base-is[char]){return [string]::new([char[]]@($base))}
|
||||
if($base-is[bool]){return [bool]::Parse($base.ToString())}
|
||||
if($base-is[sbyte]-or$base-is[int16]-or$base-is[int32]-or$base-is[int64]){return [int64]::Parse($base.ToString($culture),$culture)}
|
||||
if($base-is[byte]-or$base-is[uint16]-or$base-is[uint32]-or$base-is[uint64]){return [uint64]::Parse($base.ToString($culture),$culture)}
|
||||
if($base-is[single]-or$base-is[double]){$number=[double]::Parse($base.ToString('R',$culture),$culture);if([double]::IsNaN($number)-or[double]::IsInfinity($number)){throw 'Finite JSON state number required'};return $number}
|
||||
if($base-is[decimal]){return [decimal]::Parse($base.ToString($culture),$culture)}
|
||||
if($value-is[Collections.IDictionary]){$result=[ordered]@{};foreach($key in @($value.Keys|Sort-Object -CaseSensitive)){if($key-isnot[string]-or$result.Contains($key)){throw 'Nonunique state object key'};$result[$key]=CanonicalStateValue $value[$key] ($depth+1)};return $result}
|
||||
if($value-is[pscustomobject]){$result=[ordered]@{};foreach($property in @($value.PSObject.Properties|Sort-Object -Property Name -CaseSensitive)){if($property.Name-isnot[string]-or$result.Contains($property.Name)){throw 'Nonunique state object key'};$result[$property.Name]=CanonicalStateValue $property.Value ($depth+1)};return $result}
|
||||
if($value-is[Collections.IEnumerable]-and$value-isnot[string]){$result=New-Object 'Collections.Generic.List[object]';foreach($item in $value){$result.Add((CanonicalStateValue $item ($depth+1)))};return ,$result.ToArray()}
|
||||
return $value
|
||||
}
|
||||
function JsonEqual($a,$b){return((ConvertTo-Json -InputObject (CanonicalStateValue $a) -Depth 40 -Compress)-ceq(ConvertTo-Json -InputObject (CanonicalStateValue $b) -Depth 40 -Compress))}''')
|
||||
native = prior.NATIVE.replace('RmmPipeNative', 'RmmSignedClockPairNative')
|
||||
phases = prior.PHASES.replace('SystemPipeUpgrade.ps1', 'SignedClockPairUpgrade.ps1').replace('RmmPipeNative', 'RmmSignedClockPairNative')
|
||||
# No implicit fallthrough may become an effect, even if a future caller
|
||||
@@ -75,36 +104,35 @@ def controller():
|
||||
boundary = "if((Test-Path -LiteralPath $folder)-or(Test-Path -LiteralPath $active)){throw 'Existing pipe intent: readback only'}"
|
||||
phases = replace_once(phases, boundary,
|
||||
"if($p.action-cne'enter'){throw 'EXACT_ENTER_ACTION_REQUIRED'}\n"
|
||||
"throw 'SERVER_TIME_QUALIFICATION_NOT_BOUND'\n" + boundary)
|
||||
"RequireQualifiedTimeRoute\nRequireAccessBudget 420\n" + boundary)
|
||||
phases = phases.replace(" $live=Service $role;", " if($role-ceq'agent'){RequireAccessBudget 420}else{RequireAccessBudget 300}\n $live=Service $role;", 1)
|
||||
route_gate = r'''function RequireAccessBudget([int]$minimumSeconds=420){
|
||||
if($p.access_expiry_utc-isnot[string]-or$p.access_expiry_utc-cnotmatch'^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,7})?Z$'){throw 'Exact protected access expiry'}
|
||||
$limit=[DateTimeOffset]::Parse($p.access_expiry_utc,[Globalization.CultureInfo]::InvariantCulture).UtcDateTime;$actual=(Get-LocalUser -Name 'rmm-dev').AccountExpires.ToUniversalTime()
|
||||
$configPath='C:\ProgramData\RmmDevAccess\bootstrap-public.json';CheckControl $configPath $false;if((Get-Item -LiteralPath $configPath).Length-gt32768){throw 'Bounded public access config'}
|
||||
$public=Get-Content -LiteralPath $configPath -Raw|ConvertFrom-Json;$configured=[DateTimeOffset]::Parse($public.expires_at,[Globalization.CultureInfo]::InvariantCulture).UtcDateTime
|
||||
if($actual-ne$limit-or$configured-ne$limit-or($limit-[DateTime]::UtcNow).TotalSeconds-lt$minimumSeconds){throw 'Insufficient or mismatched actual SSH access budget before service stop'}
|
||||
}
|
||||
function RequireQualifiedTimeRoute{
|
||||
$route='C:\ProgramData\RustDiscoveryBootstrap\time-route\68b841a5-784f-4a34-a8a4-060b267713f0';$control='C:\ProgramData\RustDiscoveryBootstrap\time-route-control\68b841a5-784f-4a34-a8a4-060b267713f0'
|
||||
CheckControl $route $true;CheckControl $control $true
|
||||
foreach($entry in @(@((Join-Path $route 'TimeRouteProbe.exe'),'4ef3fc85f5d140f2ad0ff14745dc5d5453a058203d785235d7dabafdf522b088'),@((Join-Path $route 'report.json'),'9f1635c19c801f95c9828e9e31071a487b430f105a61977ee2d60f076f3d3623'),@((Join-Path $control 'exit.json'),'6d131d2796936913f53286573e56f7fb3e515d04ebbd55ae9d6794440e6053b5'),@((Join-Path $route 'context.json'),'3c0e4ff3b16b86fb4e98d2ff163686305ea533570c40ae3bef1270ab89648ed3'),@((Join-Path $route 'time-public-key.json'),'c31d31d2d61f881d04f55f704abbbf98f4822650c016f39e39d4d2318bc3f6e2'))){CheckControl $entry[0] $false;if((Hash $entry[0])-cne$entry[1]){throw 'Actual passive route and kernel-exit proof changed'}}
|
||||
$report=Get-Content -LiteralPath (Join-Path $route 'report.json') -Raw|ConvertFrom-Json;$exit=Get-Content -LiteralPath (Join-Path $control 'exit.json') -Raw|ConvertFrom-Json
|
||||
if($report.case_id-cne'68b841a5-784f-4a34-a8a4-060b267713f0'-or$report.verified-ne$true-or$report.service_role_proven-ne$false-or$report.trusted_clock_proven-ne$false-or($report.reports.http_status-join',')-cne'200,403,409'-or$report.reports[0].signature_verified-ne$true-or$report.reports[0].whole_request_context_bound-ne$true-or$exit.kernel_process_exited-ne$true-or$exit.exit_code-ne0-or$exit.timed_out-ne$false){throw 'Fixed actual passive protocol proof only'}
|
||||
}
|
||||
'''
|
||||
phases = route_gate+phases
|
||||
# Only the existing fixed passive journal witnesses and authenticated Probe
|
||||
# are used. No helper Snapshot/Apply/Execute or time control operation.
|
||||
return prefix+'\n'+native+prior.READBACK_SERVICE+'\n'+phases
|
||||
|
||||
|
||||
def source_guards(script):
|
||||
require("if($p.action-ceq'enter'){throw 'SERVER_TIME_QUALIFICATION_NOT_BOUND'}" in script,
|
||||
'target effects closed pending actual independently reviewed server evidence')
|
||||
require("$p.action-isnot[string]-or$p.action-cnotin@('baseline','enter','finish','readback')" in script
|
||||
and "$p.action-notin@" not in script, 'strict string and case-sensitive action whitelist')
|
||||
boundary = ("if($p.action-cne'enter'){throw 'EXACT_ENTER_ACTION_REQUIRED'}\n"
|
||||
"throw 'SERVER_TIME_QUALIFICATION_NOT_BOUND'\n"
|
||||
"if((Test-Path -LiteralPath $folder)-or(Test-Path -LiteralPath $active))")
|
||||
require(script.count(boundary) == 1 and script.index(boundary) < script.index(" StopHeld 'agent'"),
|
||||
'explicit exact enter and unconditional qualification gate before all effect flow')
|
||||
require('RmmPipeNative' not in script and 'RmmPipeUpgradePayload' not in script,
|
||||
'only the new controller class and payload identifiers')
|
||||
require(script.count('Start-Service -Name $name') == script.count('Stop-Service -Name $name') == 1,
|
||||
'one fixed-role service-control primitive only')
|
||||
positions = [script.index(x) for x in (" StopHeld 'agent'", " Backup 'agent'", "Backup 'pin'",
|
||||
" Swap 'agent'", "Swap 'pin'", '$swapped=ActualState $true', " StartOnce 'helper'", "StartOnce 'agent'")]
|
||||
require(positions == sorted(positions), 'backups then all four CAS replacements then helper/agent starts')
|
||||
require('[IO.File]::Replace($candidate,$destination,$nativeBackup)' in script,
|
||||
'explicit native original backup, no null backup')
|
||||
require(all(x not in script for x in ('Restart-Service', 'Restart-Computer', 'Stop-Computer',
|
||||
'Set-Service', 'New-Service', 'Remove-Item', 'Invoke-Expression', 'Bypass',
|
||||
'TimeBegin', 'TimeComplete', 'TimeClose', 'ExecutionPolicy Bypass')), 'no extra effect or time-control scope')
|
||||
require('function Snapshot' not in script and 'function Apply' not in script,
|
||||
'no clock-dependent helper synchronization in passive witness')
|
||||
require("$p.action-isnot[string]-or$p.action-cnotin@('baseline','enter','finish','readback')" in script and "$p.action-notin@" not in script,'exact case sensitive actions')
|
||||
require("if($p.action-cne'enter'){throw 'EXACT_ENTER_ACTION_REQUIRED'}\nRequireQualifiedTimeRoute\nRequireAccessBudget 420\n" in script,'actual route and access bound before effects')
|
||||
require(" if($role-ceq'agent'){RequireAccessBudget 420}else{RequireAccessBudget 300}\n $live=Service $role;" in script,'access budget before each actual stop')
|
||||
require('9f1635c19c801f95c9828e9e31071a487b430f105a61977ee2d60f076f3d3623' in script and '6d131d2796936913f53286573e56f7fb3e515d04ebbd55ae9d6794440e6053b5' in script,'actual route report and exit binding')
|
||||
require('TimeBegin' not in script and 'TimeComplete' not in script and 'Restart-Computer' not in script,'no clock/job/reboot scope')
|
||||
|
||||
|
||||
def protected(path, expected):
|
||||
@@ -155,16 +183,30 @@ def write(path, raw):
|
||||
|
||||
|
||||
def prepare(script):
|
||||
require(type(CANDIDATE_RECEIPT) is str and len(CANDIDATE_RECEIPT)==64 and QUALIFICATION==CANDIDATE_RECEIPT,'actual final native agent qualification receipt not yet bound')
|
||||
result, old_intent, settings, pin, policy = original()
|
||||
grant = prior.cb.contract.protected_json(MAIN/'credentials/windows-dev-access.json')
|
||||
expiry = grant.get('expires_at')
|
||||
require(type(expiry) is str and re.fullmatch(r'\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,7})?(?:Z|\+00:00)',expiry) is not None,'protected current access expiry')
|
||||
expiry = expiry.removesuffix('+00:00')+'Z' if expiry.endswith('+00:00') else expiry
|
||||
deadline = dt.datetime.fromisoformat(expiry.replace('Z','+00:00'))
|
||||
require((deadline-dt.datetime.now(dt.timezone.utc)).total_seconds() >= 420,'current authorization window has insufficient total maintenance/readback budget')
|
||||
receipt = protected(CANDIDATE/'receipt.json', CANDIDATE_RECEIPT)
|
||||
require(receipt['source_receipt_sha256'] == QUALIFICATION and receipt['input_count'] == 202
|
||||
and receipt['link_exit'] == 0 and receipt['target_execution'] is False
|
||||
and receipt['artifacts']['rmm-agent-windows.exe']['sha256'] == NEW_AGENT
|
||||
and receipt['artifacts']['rmm-helper-windows.exe']['sha256'] == NEW_HELPER,
|
||||
'actual new offline-linked freshness pair, no native qualification inferred')
|
||||
helper_receipt = protected(HELPER_CANDIDATE/'receipt.json', HELPER_RECEIPT)
|
||||
require(receipt['source_inputs_sha256']==SOURCE_INPUTS and receipt['source_verified_before_after'] is True
|
||||
and receipt['link_exit']==0 and receipt['original_helper_sha256']==NEW_HELPER
|
||||
and receipt['artifacts']['rmm-agent-windows.exe']['sha256']==NEW_AGENT,
|
||||
'actual final source-verified locally linked and natively qualified passive agent')
|
||||
require(helper_receipt['source_receipt_sha256']==HELPER_QUALIFICATION and helper_receipt['link_exit']==0
|
||||
and helper_receipt['artifacts']['rmm-helper-windows.exe']['sha256']==NEW_HELPER,
|
||||
'unchanged independently linked original helper')
|
||||
artifact_sources={'rmm-agent-windows.exe':CANDIDATE/'rmm-agent-windows.exe',
|
||||
'rmm-helper-windows.exe':HELPER_CANDIDATE/'rmm-helper-windows.exe'}
|
||||
artifacts={'rmm-agent-windows.exe':receipt['artifacts']['rmm-agent-windows.exe'],
|
||||
'rmm-helper-windows.exe':helper_receipt['artifacts']['rmm-helper-windows.exe']}
|
||||
ident = str(uuid.uuid4()); folder = STATE/ident; folder.mkdir(mode=0o700,parents=True)
|
||||
script_sha = raw_sha(script.encode())
|
||||
draft = dict(id=ident,old_agent=OLD_AGENT,old_helper=OLD_HELPER,old_policy=OLD_POLICY,old_pin=OLD_PIN,
|
||||
draft = dict(id=ident,access_expiry_utc=expiry,old_agent=OLD_AGENT,old_helper=OLD_HELPER,old_policy=OLD_POLICY,old_pin=OLD_PIN,
|
||||
new_agent=NEW_AGENT,new_helper=NEW_HELPER,new_policy=policy,new_pin=raw_sha(pin),
|
||||
config_sha256=result['native']['config_sha256'],probe_sha256=PROBE,system_probe_sha256=SYSTEM_PROBE,
|
||||
manifest_sha256=CANDIDATE_RECEIPT,qualification_sha256=QUALIFICATION,script_sha256=script_sha,
|
||||
@@ -176,7 +218,7 @@ def prepare(script):
|
||||
for name,raw in items.items():
|
||||
write(folder/name,raw);files[name]=dict(bytes=len(raw),sha256=raw_sha(raw))
|
||||
for name,expected in [('rmm-agent-windows.exe',NEW_AGENT),('rmm-helper-windows.exe',NEW_HELPER)]:
|
||||
source=CANDIDATE/name;metadata=source.lstat()
|
||||
source=artifact_sources[name];metadata=source.lstat()
|
||||
require(metadata.st_nlink == 1 and metadata.st_mode&0o777 == 0o500 and sha(source) == expected,
|
||||
'exact private linked candidate artifact')
|
||||
dependencies=prior.dependencies();dependencies[str(Path(prior.__file__).relative_to(ROOT))]=PRIOR_SOURCE
|
||||
@@ -185,14 +227,15 @@ def prepare(script):
|
||||
original_case=OLD_CASE,original_result_sha256=ORIGINAL_RESULT,original_intent_sha256=ORIGINAL_INTENT,
|
||||
original_runtime_index_sha256=RUNTIME_INDEX,original_component_index_sha256=COMPONENT_INDEX,
|
||||
candidate_receipt_sha256=CANDIDATE_RECEIPT,qualification_sha256=QUALIFICATION,
|
||||
artifacts={name:receipt['artifacts'][name] for name in ('rmm-agent-windows.exe','rmm-helper-windows.exe')},
|
||||
server_qualification_bound=False,enter_enabled=False,time_configuration_created=False,
|
||||
artifacts=artifacts,helper_receipt_sha256=HELPER_RECEIPT,helper_qualification_sha256=HELPER_QUALIFICATION,source_inputs_sha256=SOURCE_INPUTS,
|
||||
linux_result_sha256=receipt['linux_result_sha256'],windows_result_sha256=receipt['windows_result_sha256'],
|
||||
access_expiry_utc=expiry,access_expiry_source='protected current windows-dev-access.json public expires_at; exact VM account/bootstrap-public match before effects',
|
||||
server_qualification_bound=True,enter_enabled=True,time_configuration_created=False,
|
||||
calibration_created=False,target_called=False,main_indices_modified=False,
|
||||
remaining=['independent source review','native PS AST/C# compile-only',
|
||||
'actual server quality/broker/public-time-key/mTLS-route gate binding in separately reviewed source',
|
||||
'fresh native baseline and closed server witnesses','new once-only stage/enter/read operator'])
|
||||
remaining=['fresh current authorized SSH window and exact VM account/public expiry match',
|
||||
'fresh native baseline and closed server witnesses','once-only preserving maintenance and independent readback'])
|
||||
write(folder/'manifest.json',canonical(manifest));print(json.dumps(dict(id=ident,prepared_locally=True,
|
||||
controller_sha256=script_sha,enter_enabled=False,target_called=False)))
|
||||
controller_sha256=script_sha,enter_enabled=True,target_called=False)))
|
||||
|
||||
|
||||
def main():
|
||||
|
||||
@@ -0,0 +1,64 @@
|
||||
"""Local public-record binding fixtures; no SSH, file staging or clock query."""
|
||||
import base64
|
||||
import copy
|
||||
import datetime as dt
|
||||
import hashlib
|
||||
import json
|
||||
import unittest
|
||||
import passive_time_closeout as c
|
||||
|
||||
class Binding(unittest.TestCase):
|
||||
def setUp(self):
|
||||
self.now = dt.datetime(2026,11,15,14,0,tzinfo=dt.timezone.utc)
|
||||
self.since = c.utc_ns(self.now - dt.timedelta(seconds=50))
|
||||
ticks='638987472000000000'
|
||||
boot=c.windows_boot(ticks)
|
||||
epoch=dt.datetime(1601,1,1,tzinfo=dt.timezone.utc)
|
||||
ft=lambda value:str(int((value-epoch).total_seconds())*10000000)
|
||||
self.native=dict(read_only=True,boot_ticks=ticks,observed_at=self.now.isoformat().replace('+00:00','Z'),runtime=dict(agent=dict(pid=1234,birth_filetime=ft(self.now-dt.timedelta(minutes=1)))),reports={})
|
||||
self.server=dict(sql_read_only=True,secrets_read=False,installation=dict(windows_boot_id=boot,connection_generation=10,capabilities=['windows.base/1','heartbeat/1','agent.update/1']))
|
||||
for i,(role,name) in enumerate(c.FILES.items()):
|
||||
record=dict(schema_version=1,agent_pid=1234,observed_at=(self.now-dt.timedelta(seconds=20)).isoformat().replace('+00:00','Z'),role=role,windows_boot_id=boot,connection_generation=10,verifier_incarnation=f'11111111-1111-4111-8111-{i+1:012d}',request_sha256=str(i+1)*64,response_sha256=str(i+3)*64)
|
||||
raw=json.dumps(record).encode()
|
||||
self.native['reports'][name]=dict(raw_base64=base64.b64encode(raw).decode(),sha256=hashlib.sha256(raw).hexdigest(),metadata=dict(last_write_filetime=ft(self.now-dt.timedelta(seconds=2)),dacl_checked=True))
|
||||
def modify(self,name,field,value):
|
||||
wrapped=self.native['reports'][name]
|
||||
record=json.loads(base64.b64decode(wrapped['raw_base64']))
|
||||
record[field]=value
|
||||
raw=json.dumps(record).encode()
|
||||
wrapped.update(raw_base64=base64.b64encode(raw).decode(),sha256=hashlib.sha256(raw).hexdigest())
|
||||
def test_current_independent_pair(self):
|
||||
self.assertEqual(len(c.validate(self.native,self.server,self.since,self.now)),2)
|
||||
def test_pid_boot_generation_and_expired_sample_are_denied(self):
|
||||
good=copy.deepcopy(self.native)
|
||||
for field,value in [('agent_pid',1233),('windows_boot_id','11111111-1111-4111-8111-111111111111'),('connection_generation',9),('observed_at','2026-11-15T13:00:00Z'),('role','system_helper')]:
|
||||
self.native=copy.deepcopy(good);self.modify('agent-time-sample.json',field,value)
|
||||
with self.assertRaises(ValueError):c.validate(self.native,self.server,self.since,self.now)
|
||||
def test_same_verifier_request_or_response_is_denied(self):
|
||||
good=copy.deepcopy(self.native)
|
||||
first=json.loads(base64.b64decode(good['reports']['agent-time-sample.json']['raw_base64']))
|
||||
for field in ['verifier_incarnation','request_sha256','response_sha256']:
|
||||
self.native=copy.deepcopy(good);self.modify('helper-time-sample.json',field,first[field])
|
||||
with self.assertRaises(ValueError):c.validate(self.native,self.server,self.since,self.now)
|
||||
def test_duplicate_json_field_and_unprotected_metadata_are_denied(self):
|
||||
wrapped=self.native['reports']['agent-time-sample.json'];raw=base64.b64decode(wrapped['raw_base64'])
|
||||
changed=raw[:-1]+b',"schema_version":1}'
|
||||
wrapped.update(raw_base64=base64.b64encode(changed).decode(),sha256=hashlib.sha256(changed).hexdigest())
|
||||
with self.assertRaises(ValueError):c.validate(self.native,self.server,self.since,self.now)
|
||||
self.setUp();self.native['reports']['agent-time-sample.json']['metadata']['dacl_checked']=False
|
||||
with self.assertRaises(ValueError):c.validate(self.native,self.server,self.since,self.now)
|
||||
def test_missing_sample_is_explicit(self):
|
||||
self.native['reports']['helper-time-sample.json']=None
|
||||
with self.assertRaisesRegex(ValueError,'PUBLIC_SERVICE_SAMPLE_MISSING'):c.validate(self.native,self.server,self.since,self.now)
|
||||
def test_native_seven_and_chrono_nine_digits_keep_exact_install_boundary(self):
|
||||
native='2026-11-15T13:59:40.1234567Z'
|
||||
chrono='2026-11-15T13:59:40.123456701Z'
|
||||
self.assertEqual(c.stamp(chrono)-c.stamp(native),1)
|
||||
self.modify('agent-time-sample.json','observed_at',native)
|
||||
self.modify('helper-time-sample.json','observed_at',chrono)
|
||||
since=c.stamp(native)
|
||||
self.assertEqual(len(c.validate(self.native,self.server,since,self.now)),2)
|
||||
with self.assertRaisesRegex(ValueError,'SAMPLE_CURRENT_INSTALL_WINDOW'):
|
||||
c.validate(self.native,self.server,since+1,self.now)
|
||||
|
||||
if __name__=='__main__':unittest.main()
|
||||
@@ -0,0 +1,140 @@
|
||||
"""Local contract fixtures only; no native qualification or target calls."""
|
||||
import base64
|
||||
import copy
|
||||
import json
|
||||
import tempfile
|
||||
import unittest
|
||||
from pathlib import Path
|
||||
from unittest.mock import patch
|
||||
|
||||
import time_profile_config as t
|
||||
from vm_mvp_acceptance import GuardError
|
||||
|
||||
|
||||
def fixture():
|
||||
binding = {'tenant_id':'11111111-1111-4111-8111-111111111111',
|
||||
'agent_id':'22222222-2222-4222-8222-222222222222',
|
||||
'asset_id':'33333333-3333-4333-8333-333333333333',
|
||||
'enrollment_generation':1,'assignment_version':1,'public_key_hex':'11'*32}
|
||||
public = {'public-binding.json':binding,'qualified-time-public-key.json':{
|
||||
'key_generation':1,'server_instance':'44444444-4444-4444-8444-444444444444',
|
||||
'key_id':'local_fixture_only','public_key_hex':'22'*32},'public-platform.json':{'fixture_only':True}}
|
||||
agent_sid = 'S-1-5-80-1-2-3-4-5';helper_sid = 'S-1-5-80-1-2-3-4-6'
|
||||
result = {'id':'55555555-5555-4555-8555-555555555555','verified':True,'completed':True,
|
||||
'no_jobs':True,'windows_jobs_enabled':False,'helper_effects_enabled':False,
|
||||
'clock_authority_not_proven':True,'private_key_read':False}
|
||||
native = dict(agent_id=binding['agent_id'],asset_id=binding['asset_id'],
|
||||
binary_sha256=t.IMAGES['agent'],helper_sha256=t.IMAGES['system_helper'],
|
||||
policy_sha256='a'*64,pin_sha256='b'*64,files={})
|
||||
for role, service, kernel, label, user, image in (
|
||||
('agent','service','agent_kernel','agent','S-1-5-19','rmm-agent-windows.exe'),
|
||||
('system_helper','helper_service','helper_kernel','helper','S-1-5-18','rmm-helper-windows.exe')):
|
||||
native[service] = dict(state='Running',pid=42,creation_filetime='123',owner_sid=user)
|
||||
native[kernel] = dict(pid=42,creation_filetime='123',owner_sid=user,service_sid=agent_sid if role=='agent' else helper_sid,
|
||||
kernel_handle_bound=True,service_sid_enabled=True,
|
||||
image='C:\\Program Files\\RustDiscovery\\'+image)
|
||||
native['files'][label] = dict(file_id='a'*32,sha256=t.IMAGES[role])
|
||||
result['native'] = native
|
||||
settings = dict(binding=binding,enable_effects=False,agent=dict(service_sid=agent_sid),helper=dict(service_sid=helper_sid))
|
||||
payload = dict(new_agent=t.IMAGES['agent'],new_helper=t.IMAGES['system_helper'],
|
||||
new_policy='a'*64,new_pin='b'*64,qualification_sha256=t.LINK_RECEIPT,
|
||||
manifest_sha256=t.LINK_RECEIPT,settings_base64=base64.b64encode(t.canonical(settings)).decode())
|
||||
return public,result,payload,{'local-service':{'fixture_only':True},'system':{'fixture_only':True}}
|
||||
|
||||
|
||||
class PublicProfileContract(unittest.TestCase):
|
||||
def setUp(self):
|
||||
self.values = fixture()
|
||||
self.pair = patch.object(t,'PAIR_ID',self.values[1]['id']);self.pair.start();self.addCleanup(self.pair.stop)
|
||||
|
||||
def render(self, values=None):
|
||||
return t.produce(*(values or self.values),'c'*64,'d'*64)[0]
|
||||
|
||||
def test_v2_fixture_links_both_exact_roles_without_runtime_success(self):
|
||||
items = self.render();config=json.loads(items['time-attestation.json'])
|
||||
self.assertEqual(config['schema_version'],2)
|
||||
self.assertNotIn('base_error_ns',config)
|
||||
for role in config['trusted_os_active_guest']['qualifications']:
|
||||
raw=items[role['role']+'-qualification.json'];value=json.loads(raw)
|
||||
self.assertEqual(t.sha(raw),role['qualification_sha256'])
|
||||
self.assertFalse(value['signed_runtime_verified']);self.assertFalse(value['physical_calibration_claimed'])
|
||||
self.assertEqual(value['source_sha256'],t.SOURCE_SHA if role['role']=='agent' else t.ORIGINAL_SOURCE_SHA)
|
||||
|
||||
def test_missing_or_not_completed_actual_pair_is_denied(self):
|
||||
for field in ('verified','completed','no_jobs'):
|
||||
values=copy.deepcopy(self.values);values[1].pop(field)
|
||||
with self.assertRaises(GuardError):self.render(values)
|
||||
|
||||
def test_wrong_kernel_birth_account_sid_image_or_fileid_is_denied(self):
|
||||
for field,value in [('creation_filetime','124'),('owner_sid','S-1-5-18'),
|
||||
('service_sid_enabled',False),('kernel_handle_bound',False),
|
||||
('service_sid','S-1-5-18'),('image','C:\\wrong.exe')]:
|
||||
values=copy.deepcopy(self.values);values[1]['native']['agent_kernel'][field]=value
|
||||
with self.assertRaises(GuardError):self.render(values)
|
||||
values=copy.deepcopy(self.values);values[1]['native']['files']['agent']['file_id']='bad'
|
||||
with self.assertRaises(GuardError):self.render(values)
|
||||
|
||||
def test_image_build_policy_and_identity_drift_is_denied(self):
|
||||
for field in ('new_agent','new_helper','new_policy','new_pin','qualification_sha256','manifest_sha256'):
|
||||
values=copy.deepcopy(self.values);values[2][field]='0'*64
|
||||
with self.assertRaises(GuardError):self.render(values)
|
||||
values=copy.deepcopy(self.values);values[0]['public-binding.json']['agent_id']='99999999-9999-4999-8999-999999999999'
|
||||
with self.assertRaises(GuardError):self.render(values)
|
||||
|
||||
def test_no_actual_pair_pins_blocks_before_creating_any_case(self):
|
||||
with tempfile.TemporaryDirectory() as root, patch.object(t,'STATE',Path(root)/'absent'),patch.object(t,'PAIR_ID',None):
|
||||
with self.assertRaises(GuardError):t.prepare()
|
||||
self.assertFalse(t.STATE.exists())
|
||||
|
||||
def test_bounded_nofollow_read_duplicate_json_and_createonce(self):
|
||||
with tempfile.TemporaryDirectory() as root:
|
||||
path=Path(root)/'value.json';t.write(path,b'{"a":1}\n')
|
||||
self.assertEqual(t.read(path)[1],{'a':1})
|
||||
with self.assertRaises(FileExistsError):t.write(path,b'{}')
|
||||
with self.assertRaises(GuardError):t.read(path,'0'*64)
|
||||
link=Path(root)/'link';link.symlink_to(path)
|
||||
with self.assertRaises(OSError):t.read(link)
|
||||
bad=Path(root)/'duplicate.json';t.write(bad,b'{"a":1,"a":2}')
|
||||
with self.assertRaises(GuardError):t.read(bad)
|
||||
with self.assertRaises(GuardError):t.read(path,limit=1)
|
||||
|
||||
|
||||
class OriginalPartialDiagnosticContract(unittest.TestCase):
|
||||
def test_closed_reader_cannot_publish_or_repair(self):
|
||||
source=t.partial_reader()
|
||||
self.assertIn('time-profile-'+t.PARTIAL_ID,source)
|
||||
self.assertIn('time-attestation.candidate.json',source)
|
||||
self.assertIn('old_move_hresult_unknown=$true',source)
|
||||
for forbidden in ('[IO.File]::Move','Set-Acl','WriteBytes','WriteNew','Start-Service','Stop-Service','CreateDirectory'):
|
||||
self.assertNotIn(forbidden,source)
|
||||
|
||||
def test_diagnostic_executes_bound_reader_without_legacy_load_or_target_success(self):
|
||||
import datetime as dt
|
||||
from unittest.mock import Mock
|
||||
manifest={'id':t.PARTIAL_ID,'generator_sha256':t.PARTIAL_GENERATOR_SHA,
|
||||
'script_sha256':t.PARTIAL_SCRIPT_SHA,'request':{'config_sha256':t.PARTIAL_CONFIG_SHA}}
|
||||
result={'id':t.PARTIAL_ID,'read_only':True,'retry_authorized':False,
|
||||
'installation_verified':False,'clock_runtime_qualified':False}
|
||||
access=Mock();access.powershell.return_value=result
|
||||
expiry=(dt.datetime.now(dt.timezone.utc)+dt.timedelta(hours=1)).isoformat()
|
||||
with tempfile.TemporaryDirectory() as root,patch.object(t,'ROOT',Path(root)), \
|
||||
patch.object(t,'read',side_effect=[(b'original',manifest),(b'staged',None)]), \
|
||||
patch.object(t,'load_case',side_effect=AssertionError('original case must not adopt new generator')), \
|
||||
patch.object(t.raw_capture,'CaptureAccess',return_value=access), \
|
||||
patch.object(t.prior.cb.contract,'protected_json',return_value={'expires_at':expiry}):
|
||||
t.diagnose_partial()
|
||||
call=access.powershell.call_args
|
||||
executed=base64.b64decode(call.args[1]['source_base64'])
|
||||
self.assertIn(t.sha(executed),call.args[0])
|
||||
cases=list((Path(root)/'devstate/windows-time-profile-diagnostics').iterdir())
|
||||
self.assertEqual(len(cases),1)
|
||||
intent=json.loads((cases[0]/'intent.json').read_bytes())
|
||||
receipt=json.loads((cases[0]/'receipt.json').read_bytes())
|
||||
self.assertEqual(intent['reader_sha256'],t.sha(executed))
|
||||
self.assertEqual(receipt['reader_sha256'],t.sha(executed))
|
||||
self.assertTrue(receipt['old_move_hresult_unknown'])
|
||||
self.assertEqual((cases[0]/'reader.ps1').read_bytes(),executed)
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
unittest.main()
|
||||
@@ -0,0 +1,613 @@
|
||||
#!/usr/bin/env python3
|
||||
"""First public V2 time pin for one actual qualified Windows product pair.
|
||||
|
||||
prepare/guards are local only. No target operation happens on import.
|
||||
Missing native product-role/readback evidence blocks preparation; diagnostics
|
||||
are never relabelled as calibrated product clocks or signed runtime success.
|
||||
"""
|
||||
import argparse
|
||||
import base64
|
||||
import copy
|
||||
import hashlib
|
||||
import json
|
||||
import os
|
||||
from pathlib import Path
|
||||
import re
|
||||
import stat
|
||||
import uuid
|
||||
|
||||
import system_pipe_upgrade as prior
|
||||
import signed_clock_capture_acceptance as raw_capture
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[2]
|
||||
CLOCK = ROOT.parent / 'rust-discovery-signed-clock'
|
||||
MAIN = ROOT.parent / 'rust-discovery'
|
||||
STATE = ROOT / 'devstate/windows-time-profile-config'
|
||||
PUBLIC = CLOCK / 'devstate/windows-time-profile-public-preparation/c3077acf-12da-410e-9f55-e75a1cd0a75f'
|
||||
PAIR_ID = '4887940a-4c9c-4807-aaf2-6fbc94faad46'
|
||||
PAIR_RESULT_SHA = '2898a72b4b0d84159cc11d80765cbfa4206faf7038d0e860429c8b1a57538ee2'
|
||||
PAIR_INTENT_SHA = '40e9cd557225504429b51dcecd4322b32d7f0973bcbb8e2a2e52516917907b85'
|
||||
PAIR_READBACK_SHA = '63e453fb915cadee028407a6aeaa8c7d209ae88ed12a6d4d4307d4fd25e4c539'
|
||||
PAIR_ROOT = CLOCK / 'devstate/windows-signed-clock/passive-pair-upgrade'
|
||||
SOURCE_CASE = CLOCK / 'devstate/windows-signed-clock/trusted-os-qualification-c4679433-b632-4d6e-8668-f0f2fb54a542'
|
||||
LINK_CASE = MAIN / 'devstate/windows-client/operator-window-20261115/observed-agent-build'
|
||||
ORIGINAL_SOURCE_SHA = 'd8594c1eba2c2cc5d5fde4a462b2110aa2e7e64081452b742c4ed81a2cfb477d'
|
||||
SOURCE_SHA = '342494c4f9e7eca439c059745591a8e907026da20f56b223fcb0eb0707aa6d82'
|
||||
SOURCE_RECEIPT = '96b05fe13f4d459b4b3ef78292beea33827b1ea47293ffb5921c685940e82a4d'
|
||||
LINK_RECEIPT = 'f04024f78c2f11f5c66bbdf9278467f5bcc50da5c2bd7336623851bca42dd446'
|
||||
LINK_INPUTS = '11717fab51bd1d6bf103b1821cc1e2a84699f46cac21f2cc614acf4b68381fa4'
|
||||
ORIGINAL_LINK_RECEIPT = '04ed34e6e850aca77c1fd4677ddb271f7ccd9492a97f5d4e00ead4c1f032f29d'
|
||||
NATIVE_RESULTS = {
|
||||
'linux': ('84592e7a-6554-4a7d-a73f-2bdebdb9e9a8', '150954b0ab290d8e9fbda5616f6df071168efd88a9f1d8b48b2bd8a5f5de7c20'),
|
||||
'windows': ('44059065-c17e-43c3-86aa-d4d131454ccb', 'b235bdd444c112ff91cbc5f160d39d69ef79fb419b9b2ab7ccdcec06009d5c6b')}
|
||||
ORIGINAL_IMAGES = {'agent': '26dc9d2f6928c5a41050ac9324e041c065e7a9ae52324416f3bb6222c002ae6b',
|
||||
'system_helper': '59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e'}
|
||||
IMAGES = {'agent': '0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c',
|
||||
'system_helper': ORIGINAL_IMAGES['system_helper']}
|
||||
ASSUMPTION = 'active_guest_no_pause_save_restore_snapshot_migration_host_suspend'
|
||||
PUBLIC_SHAS = {'qualified-time-public-key.json': 'c31d31d2d61f881d04f55f704abbbf98f4822650c016f39e39d4d2318bc3f6e2',
|
||||
'public-platform.json': '94ae865e0e3449f6901f4d5f593aacbd5829b06340e296e19e6f0159a157cba3',
|
||||
'public-binding.json': '9239ee9f4142735867e77451478bf309fbf449d730a0ede6c958bc8018830dde',
|
||||
'input-provenance.json': '1c0db66cd0692024f68bddd71949692d274380a86e4b880fea0756479ceb5d0c',
|
||||
'receipt.json': '97e4db147f31f3cff134d2bc596d7d73ea5330b8b5a87971f215bb03a9751391'}
|
||||
RAW = CLOCK / 'devstate/windows-signed-clock-capture-completion/ccba6d8f-c58f-4d2d-a51c-1efb3bfbabdf'
|
||||
RAW_RECEIPTS = {'local-service': '10dd411be265d018489bf9477747ce2d5846ac04128f583425aec4b3c9d5252b',
|
||||
'system': '7409309ea6d586566373f570d6950c60ce2597cf939f261e6d2ea4def004a22f'}
|
||||
require = prior.require
|
||||
|
||||
def sha(raw):
|
||||
return hashlib.sha256(raw).hexdigest()
|
||||
|
||||
def canonical(value):
|
||||
return (json.dumps(value, sort_keys=True, separators=(',', ':'), ensure_ascii=False) + '\n').encode()
|
||||
|
||||
def strict_object(items):
|
||||
value = {}
|
||||
for key, item in items:
|
||||
require(key not in value, 'duplicate public JSON field')
|
||||
value[key] = item
|
||||
return value
|
||||
|
||||
def read(path, expected=None, limit=2*1024*1024, decode=True, public=False):
|
||||
fd = os.open(path, os.O_RDONLY | os.O_NOFOLLOW | os.O_NONBLOCK)
|
||||
with os.fdopen(fd, 'rb') as stream:
|
||||
before = os.fstat(stream.fileno())
|
||||
modes = (0o600,0o644,0o664) if public and expected is not None else (0o600,)
|
||||
require(stat.S_ISREG(before.st_mode) and before.st_uid == os.getuid() and before.st_nlink == 1
|
||||
and stat.S_IMODE(before.st_mode) in modes and 0 < before.st_size <= limit,
|
||||
'private bounded actual public evidence')
|
||||
raw = stream.read(limit + 1); after = os.fstat(stream.fileno())
|
||||
require((before.st_dev,before.st_ino,before.st_size,before.st_mtime_ns,before.st_ctime_ns)
|
||||
== (after.st_dev,after.st_ino,after.st_size,after.st_mtime_ns,after.st_ctime_ns)
|
||||
and len(raw) == before.st_size and (expected is None or sha(raw) == expected),
|
||||
'unchanged independently pinned public evidence')
|
||||
return raw, json.loads(raw, object_pairs_hook=strict_object) if decode else None
|
||||
|
||||
def write(path, raw):
|
||||
fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, 0o600)
|
||||
with os.fdopen(fd,'wb') as stream:
|
||||
stream.write(raw); stream.flush(); os.fsync(stream.fileno())
|
||||
fd = os.open(path.parent,os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW)
|
||||
try: os.fsync(fd)
|
||||
finally: os.close(fd)
|
||||
|
||||
def public_inputs():
|
||||
values = {name: read(PUBLIC/name,digest)[1] for name,digest in PUBLIC_SHAS.items()}
|
||||
pin, platform, binding = (values[n] for n in ('qualified-time-public-key.json','public-platform.json','public-binding.json'))
|
||||
require(set(pin) == {'algorithm','schema_version','key_generation','key_id','server_instance','public_key_hex'}
|
||||
and pin['algorithm'] == 'Ed25519' and pin['schema_version'] == 1
|
||||
and type(pin['key_generation']) is int and pin['key_generation'] > 0
|
||||
and re.fullmatch('[A-Za-z0-9_-]{1,64}',pin['key_id'])
|
||||
and re.fullmatch('[a-f0-9]{64}',pin['public_key_hex']), 'actual separate public time key')
|
||||
require(str(uuid.UUID(pin['server_instance'])) == pin['server_instance'] and uuid.UUID(pin['server_instance']).int > 0,
|
||||
'actual server instance')
|
||||
require(set(binding) == {'tenant_id','asset_id','agent_id','enrollment_generation','assignment_version','public_key_hex'}
|
||||
and all(str(uuid.UUID(binding[k])) == binding[k] and uuid.UUID(binding[k]).int > 0 for k in ('tenant_id','asset_id','agent_id'))
|
||||
and type(binding['enrollment_generation']) is int and binding['enrollment_generation'] == 1
|
||||
and type(binding['assignment_version']) is int and binding['assignment_version'] == 1
|
||||
and bytes.fromhex(pin['public_key_hex']) != bytes.fromhex(binding['public_key_hex']), 'unchanged actual identity and distinct time/job keys')
|
||||
require(platform['schema'] == 1 and platform['hypervisor'] == 'kvm' and platform['state'] == 'running'
|
||||
and platform['domain_uuid'] == '1ec0d319-24bc-4953-a6b2-52b85449be07'
|
||||
and platform['has_genid'] is False
|
||||
and {'name':'hypervclock','present':'yes'} in platform['timers'], 'actual selectively observed active KVM platform')
|
||||
provenance = values['input-provenance.json']
|
||||
require(provenance['candidate_images'] == ORIGINAL_IMAGES and provenance['operating_assumption'] == ASSUMPTION
|
||||
and provenance['platform'] == 'kvm_qemu_hypervclock' and provenance['roles_qualified'] is False
|
||||
and provenance['time_config_created'] is False and provenance['target_called'] is False,
|
||||
'original incomplete public preparation stays incomplete and unchanged')
|
||||
return values
|
||||
|
||||
def source_inputs():
|
||||
_, source = read(SOURCE_CASE/'receipt.json',SOURCE_RECEIPT)
|
||||
read(SOURCE_CASE/'source/crates/agent-windows/src/signed_clock.rs',ORIGINAL_SOURCE_SHA,decode=False)
|
||||
_, link = read(LINK_CASE/'receipt.json',LINK_RECEIPT)
|
||||
_, inputs = read(LINK_CASE/'source-inputs.json',LINK_INPUTS)
|
||||
require(len(inputs) == 202 and len({item['path'] for item in inputs}) == 202,
|
||||
'exact updated source input set')
|
||||
clock = [item for item in inputs if item['path'] == 'crates/agent-windows/src/signed_clock.rs']
|
||||
require(len(clock) == 1 and clock[0]['sha256'] == SOURCE_SHA, 'same qualified V2 clock source')
|
||||
read(LINK_CASE/'source/crates/agent-windows/src/signed_clock.rs',SOURCE_SHA,decode=False)
|
||||
original_path = CLOCK/'devstate/windows-signed-clock/trusted-os-candidate-link-542cbf43-afb2-4994-b141-06e003e5e2e8'
|
||||
_, original = read(original_path/'receipt.json',ORIGINAL_LINK_RECEIPT)
|
||||
require(source['source_sha256'] == original['source_sha256'] == ORIGINAL_SOURCE_SHA
|
||||
and source['input_count'] == link['input_count'] == 202
|
||||
and source['inputs_sha256'] == original['inputs_sha256']
|
||||
and original['source_receipt_sha256'] == SOURCE_RECEIPT
|
||||
and link['source_receipt_sha256'] == ORIGINAL_LINK_RECEIPT
|
||||
and link['source_inputs_sha256'] == LINK_INPUTS
|
||||
and source['inputs_verified_before_after'] is True and link['source_verified_before_after'] is True
|
||||
and source['checks']['linux_signed_clock_guards']['passed'] == 8
|
||||
and link['link_exit'] == 0 and link['original_helper_sha256'] == IMAGES['system_helper']
|
||||
and link['target'] == 'x86_64-pc-windows-gnu' and link['patches'] == ['656102b','cc82124'],
|
||||
'actual fixed V2 source and linked product pair, no runtime success inferred')
|
||||
for artifact, role in ((link['artifacts']['rmm-agent-windows.exe'],'agent'),
|
||||
(original['artifacts']['rmm-helper-windows.exe'],'system_helper')):
|
||||
require(artifact['sha256'] == IMAGES[role] and artifact['machine'] == 'PE_AMD64', 'same actual linked role image')
|
||||
for platform in ('linux','windows'):
|
||||
case, binary_sha = NATIVE_RESULTS[platform]
|
||||
_, result = read(LINK_CASE.parent/case/'result.json',link[platform+'_result_sha256'],public=True)
|
||||
output = result['stdout'] if platform == 'linux' else '\n'.join(result['lines'])
|
||||
names = re.findall(r'^test (signed_clock::tests::[a-z_]+) \.\.\. ok$', output, re.MULTILINE)
|
||||
expected = set(source['checks']['linux_signed_clock_guards']['selected']) | {
|
||||
'signed_clock::tests::passive_sampling_requires_a_profile_and_uses_heartbeat_cadence'}
|
||||
require(result['test_binary_sha256'] == binary_sha
|
||||
and result['exit' if platform=='linux' else 'exit_code'] == 0
|
||||
and len(names) == 9 and set(names) == expected
|
||||
and '9 passed; 0 failed; 0 ignored' in output, 'same-source actual native nine guards')
|
||||
return source,link
|
||||
|
||||
def raw_inputs():
|
||||
require(sha(Path(raw_capture.__file__).read_bytes()) ==
|
||||
'dd6c575a119751429448e40e6f306cf79efa3a86c49bf2cd32a7783937177770',
|
||||
'unchanged original raw-role decoder')
|
||||
records = {}
|
||||
for role, digest in RAW_RECEIPTS.items():
|
||||
_, receipt = read(RAW/('start-'+role+'-receipt.json'),digest)
|
||||
raw_link = receipt['raw_reply']
|
||||
require(raw_link['filename'] == 'start-'+role+'-reply.json', 'fixed original raw role namespace')
|
||||
_, reply = read(RAW/raw_link['filename'],raw_link['sha256'])
|
||||
require(receipt['calibrated'] is False and receipt['clock_authority'] is False
|
||||
and reply['calibrated'] is False and reply['clock_authority'] is False,
|
||||
'raw probe is never a product calibration')
|
||||
for key in ('native_witness','server_witness','preservation'):
|
||||
item = receipt[key]
|
||||
require(Path(item['filename']).name == item['filename'], 'fixed sibling evidence leaf')
|
||||
read(RAW/item['filename'],item['sha256'])
|
||||
raw_capture.validate_role(role,reply['roles'][role],'efd17b43-7e04-49a7-9bd4-862d13365eec')
|
||||
records[role] = {'receipt_sha256':digest,'probe_image_sha256':raw_capture.EXE_SHA,
|
||||
'raw_report_sha256':reply['roles'][role]['raw_report_sha256']}
|
||||
return records
|
||||
|
||||
def validate_pair(result, intent):
|
||||
require(result.get('id') == PAIR_ID and result.get('verified') is True and result.get('completed') is True
|
||||
and result.get('no_jobs') is True and result.get('windows_jobs_enabled') is False
|
||||
and result.get('helper_effects_enabled') is False and result.get('clock_authority_not_proven') is True
|
||||
and result.get('private_key_read') is False, 'actual completed passive pair required; no missing or dummy result')
|
||||
payload = intent.get('payload',intent)
|
||||
require(payload['new_agent'] == IMAGES['agent'] and payload['new_helper'] == IMAGES['system_helper']
|
||||
and payload['qualification_sha256'] == LINK_RECEIPT and payload['manifest_sha256'] == LINK_RECEIPT,
|
||||
'actual exact V2 pair source chain')
|
||||
native = result['native']
|
||||
require(native['binary_sha256'] == IMAGES['agent'] and native['helper_sha256'] == IMAGES['system_helper']
|
||||
and native['policy_sha256'] == payload['new_policy'] and native['pin_sha256'] == payload['new_pin'], 'complete native image/pin pair')
|
||||
qualifications = []
|
||||
for role,service,kernel,label,user in [('agent','service','agent_kernel','agent','S-1-5-19'),('system_helper','helper_service','helper_kernel','helper','S-1-5-18')]:
|
||||
s,k,f = native[service],native[kernel],native['files'][label]
|
||||
require(s['state'] == 'Running' and type(s['pid']) is int and s['pid'] > 0
|
||||
and k['pid'] == s['pid'] and k['creation_filetime'] == s['creation_filetime']
|
||||
and k['owner_sid'] == s['owner_sid'] == user and k['service_sid_enabled'] is True
|
||||
and k['kernel_handle_bound'] is True and f['sha256'] == IMAGES[role]
|
||||
and k['image'] == ('C:\\Program Files\\RustDiscovery\\rmm-agent-windows.exe' if role=='agent'
|
||||
else 'C:\\Program Files\\RustDiscovery\\rmm-helper-windows.exe')
|
||||
and re.fullmatch(r'S-1-5-80-(?:[0-9]+-){4}[0-9]+',k['service_sid'])
|
||||
and re.fullmatch('[0-9]+',k['creation_filetime']) and re.fullmatch('[a-f0-9]{32}',f['file_id']),
|
||||
'actual SCM/kernel account, enabled service SID, birth and image FileID')
|
||||
qualifications.append({'role':role,'binary_sha256':IMAGES[role],'service':copy.deepcopy(s),
|
||||
'kernel':copy.deepcopy(k),'image_file':copy.deepcopy(f)})
|
||||
return native,payload,qualifications
|
||||
|
||||
def produce(public, pair_result, pair_intent, raw, result_sha, intent_sha):
|
||||
native,payload,roles = validate_pair(pair_result,pair_intent)
|
||||
binding = public['public-binding.json']; pin=public['qualified-time-public-key.json']
|
||||
require(native['agent_id'] == binding['agent_id'] and native['asset_id'] == binding['asset_id'], 'same actual device binding')
|
||||
settings = json.loads(base64.b64decode(payload['settings_base64'],validate=True),object_pairs_hook=strict_object)
|
||||
require(settings['binding'] == binding and settings['enable_effects'] is False
|
||||
and settings['agent']['service_sid'] == roles[0]['kernel']['service_sid']
|
||||
and settings['helper']['service_sid'] == roles[1]['kernel']['service_sid']
|
||||
and settings['agent']['service_sid'] != settings['helper']['service_sid'], 'actual reciprocal settings and distinct service roles')
|
||||
platform = {'profile':'rmm.windows.trusted-os.platform-provenance.v1','operating_assumption':ASSUMPTION,
|
||||
'platform':'kvm_qemu_hypervclock','public_platform_sha256':PUBLIC_SHAS['public-platform.json'],
|
||||
'original_public_preparation_sha256':PUBLIC_SHAS['input-provenance.json'],
|
||||
'source_sha256':SOURCE_SHA,'source_receipt_sha256':SOURCE_RECEIPT,
|
||||
'product_pair_receipt_sha256':LINK_RECEIPT,'pair_result_sha256':result_sha,
|
||||
'pair_intent_sha256':intent_sha,'independent_pair_readback_sha256':PAIR_READBACK_SHA,
|
||||
'independent_physical_calibration_claimed':False}
|
||||
items={'platform-provenance.json':canonical(platform),'public-platform.json':canonical(public['public-platform.json'])}
|
||||
# The original platform file is separately retained below using its actual
|
||||
# bytes; this canonical descriptive copy is never mislabelled as its hash.
|
||||
references=[]
|
||||
for role in roles:
|
||||
role.update(profile='rmm.windows.trusted-os.product-role-prerequisite.v1',pair_case_id=PAIR_ID,
|
||||
pair_result_sha256=result_sha,pair_intent_sha256=intent_sha,
|
||||
independent_pair_readback_sha256=PAIR_READBACK_SHA,
|
||||
source_sha256=SOURCE_SHA if role['role']=='agent' else ORIGINAL_SOURCE_SHA,
|
||||
original_source_receipt_sha256=SOURCE_RECEIPT,product_pair_receipt_sha256=LINK_RECEIPT,
|
||||
platform_provenance_sha256=sha(items['platform-provenance.json']),
|
||||
raw_capture=raw['local-service' if role['role']=='agent' else 'system'],
|
||||
signed_runtime_verified=False,physical_calibration_claimed=False)
|
||||
name=role['role']+'-qualification.json';items[name]=canonical(role)
|
||||
references.append({'role':role['role'],'binary_sha256':role['binary_sha256'],'qualification_sha256':sha(items[name])})
|
||||
value={'schema_version':2,'key_generation':pin['key_generation'],'server_instance':pin['server_instance'],
|
||||
'binding':binding,'public_keys_hex':{pin['key_id']:pin['public_key_hex']},
|
||||
'trusted_os_active_guest':{'operating_assumption':ASSUMPTION,'platform':'kvm_qemu_hypervclock',
|
||||
'platform_provenance_sha256':sha(items['platform-provenance.json']),'qualifications':references}}
|
||||
items['time-attestation.json']=canonical(value)
|
||||
require(len(items['time-attestation.json'])<=16384, 'real bounded public V2 configuration')
|
||||
return items,native,payload
|
||||
|
||||
# Controller and transport are defined below; no remote action on import.
|
||||
|
||||
HEADER = r'''
|
||||
$ErrorActionPreference='Stop';$request=$global:RmmTimeProfilePayload
|
||||
if(!$request-or$request.action-isnot[string]-or$request.action-cnotin@('install','read')-or[guid]::ParseExact($request.id,'D').ToString()-cne$request.id-or$request.profile-cne'rmm.windows.initial-public-time-profile.v2'){throw 'Exact initial time-profile operation'}
|
||||
$p=$request.pair_payload
|
||||
$boot='C:\ProgramData\RustDiscoveryBootstrap';$folder=Join-Path $boot ('time-profile-'+$request.id)
|
||||
$agentRoot='C:\ProgramData\RustDiscovery';$agentState=Join-Path $agentRoot 'state';$helperRoot='C:\ProgramData\RustDiscoverySystem';$helperState=Join-Path $helperRoot 'state'
|
||||
$config=Join-Path $agentRoot 'config.json';$settings=Join-Path $helperRoot 'helper.json';$pin=Join-Path $helperRoot 'agent-pin.json'
|
||||
$agentBinary='C:\Program Files\RustDiscovery\rmm-agent-windows.exe';$helperBinary='C:\Program Files\RustDiscovery\rmm-helper-windows.exe'
|
||||
$agentName='RmmDiscoveryWindows';$helperName='RmmDiscoverySystemHelper';$sys='S-1-5-18';$admin='S-1-5-32-544'
|
||||
$agentSid=(New-Object Security.Principal.NTAccount('NT SERVICE',$agentName)).Translate([Security.Principal.SecurityIdentifier]).Value
|
||||
$helperSid=(New-Object Security.Principal.NTAccount('NT SERVICE',$helperName)).Translate([Security.Principal.SecurityIdentifier]).Value
|
||||
$target=Join-Path $helperRoot 'time-attestation.json';$active=Join-Path $boot 'time-profile-initial-active.json'
|
||||
'''
|
||||
|
||||
BODY = r'''
|
||||
function ReadAcl($path,[bool]$directory){
|
||||
Check $path $directory;$acl=Get-Acl -LiteralPath $path
|
||||
if($acl.GetOwner([Security.Principal.SecurityIdentifier]).Value-cnotin@($sys,$admin)){throw 'Public pin owner must remain SYSTEM/Administrators'}
|
||||
$seen=@{};foreach($rule in $acl.GetAccessRules($true,$true,[Security.Principal.SecurityIdentifier])){
|
||||
$id=$rule.IdentityReference.Value;$rights=[int64]$rule.FileSystemRights
|
||||
if($rule.AccessControlType-cne'Allow'-or$id-cnotin@($sys,$admin,$agentSid,$helperSid)-or($id-cnotin@($sys,$admin)-and($rights-band(-bnot 0x1200a9))-ne0)){throw 'Only exact native reader rights, no foreign writer'}
|
||||
$seen[$id]=$true
|
||||
};foreach($id in @($sys,$admin)){if(!$seen[$id]){throw 'Privileged public-pin role missing'}}
|
||||
return $acl
|
||||
}
|
||||
function GrantRootReaders{
|
||||
$acl=ReadAcl $helperRoot $true
|
||||
foreach($id in @($agentSid,$helperSid)){
|
||||
$present=$false;foreach($rule in $acl.GetAccessRules($true,$true,[Security.Principal.SecurityIdentifier])){if($rule.IdentityReference.Value-ceq$id-and([int64]$rule.FileSystemRights-band0x1200a9)-eq0x1200a9){$present=$true}}
|
||||
if(!$present){$acl.AddAccessRule((New-Object Security.AccessControl.FileSystemAccessRule((New-Object Security.Principal.SecurityIdentifier($id)),[Security.AccessControl.FileSystemRights]0x1200a9,'None','None','Allow')))}
|
||||
}
|
||||
# This-folder-only ACEs: do not expose state/PKI/ledger/intent descendants.
|
||||
Set-Acl -LiteralPath $helperRoot -AclObject $acl;$null=ReadAcl $helperRoot $true
|
||||
}
|
||||
function SetPinAcl($path){
|
||||
$acl=New-Object Security.AccessControl.FileSecurity;$acl.SetSecurityDescriptorSddlForm(('O:BAG:BAD:P(A;;FA;;;SY)(A;;FA;;;BA)(A;;0x1200a9;;;'+$agentSid+')(A;;0x1200a9;;;'+$helperSid+')'))
|
||||
Set-Acl -LiteralPath $path -AclObject $acl;$null=ReadAcl $path $false
|
||||
}
|
||||
function NewPrivateCase{
|
||||
[RmmTimeProfileCase]::CreatePrivateOnce($folder);CheckControl $folder $true
|
||||
}
|
||||
function FileVolume($path){
|
||||
$handle=[RmmPipeNative]::CreateFile($path,0x80,7,[IntPtr]::Zero,3,0x2200000,[IntPtr]::Zero)
|
||||
try{if($handle.IsInvalid){throw 'Protected directory identity handle'};$id=New-Object RmmPipeNative+FileId;if(![RmmPipeNative]::GetFileInformationByHandleEx($handle,18,[ref]$id,24)){throw 'Protected directory volume'};return $id.Volume.ToString([Globalization.CultureInfo]::InvariantCulture)}finally{$handle.Dispose()}
|
||||
}
|
||||
function SameLive($before,$after){
|
||||
Preserved $before $after $false
|
||||
foreach($field in @('files','service','helper_service','agent_kernel','helper_kernel')){if(!(JsonEqual $before.$field $after.$field)){throw 'Same original data/PKI/FileIDs/services/process generations required'}}
|
||||
}
|
||||
function ConfigBytes{
|
||||
$bytes=[Convert]::FromBase64String($request.config_base64)
|
||||
if($bytes.Length-gt16384-or$bytes.Length-lt1-or(BytesHash $bytes)-cne$request.config_sha256){throw 'Fixed complete public config bytes'}
|
||||
$value=[Text.Encoding]::UTF8.GetString($bytes)|ConvertFrom-Json
|
||||
if($value.schema_version-ne2-or$value.key_generation-ne$request.key_generation-or$value.server_instance-cne$request.server_instance-or!(JsonEqual $value.binding $request.binding)-or$value.trusted_os_active_guest.operating_assumption-cne'active_guest_no_pause_save_restore_snapshot_migration_host_suspend'-or$value.trusted_os_active_guest.platform-cne'kvm_qemu_hypervclock'-or@($value.trusted_os_active_guest.qualifications).Count-ne2-or$value.trusted_os_active_guest.qualifications[0].role-cne'agent'-or$value.trusted_os_active_guest.qualifications[0].binary_sha256-cne$p.new_agent-or$value.trusted_os_active_guest.qualifications[1].role-cne'system_helper'-or$value.trusted_os_active_guest.qualifications[1].binary_sha256-cne$p.new_helper){throw 'Closed real schema2/profile/role binding'}
|
||||
return ,$bytes
|
||||
}
|
||||
CheckControl $boot $true
|
||||
if($PSCommandPath-cne(Join-Path (Join-Path $boot $request.script_sha256) 'InstallPublicTimeProfile.ps1')-or(Hash $PSCommandPath)-cne$request.script_sha256){throw 'Exact reviewed public-pin controller'}
|
||||
CheckControl $PSCommandPath $false
|
||||
$expected=$request.expected_native
|
||||
$before=ActualState $true;SameLive $expected $before
|
||||
if($before.agent_kernel.service_sid-cne$agentSid-or$before.helper_kernel.service_sid-cne$helperSid){throw 'Same actual qualified service SIDs'}
|
||||
$null=ReadAcl $helperRoot $true
|
||||
if($request.action-ceq'read'){
|
||||
$records=[ordered]@{};if(Test-Path -LiteralPath $folder){CheckControl $folder $true;foreach($name in @('intent.json','directory-acl-intent.json','directory-acl-done.json','publish-intent.json','result.json')){$path=Join-Path $folder $name;$records[$name]=$null;if(Test-Path -LiteralPath $path){CheckControl $path $false;if((Get-Item -LiteralPath $path -Force).Length-gt2097152){throw 'Bounded original public-pin history'};$records[$name]=Get-Content -LiteralPath $path -Raw|ConvertFrom-Json}}}
|
||||
if($records['intent.json']){foreach($field in $request.PSObject.Properties.Name){if($field-cne'action'-and!(JsonEqual $records['intent.json'].request.$field $request.$field)){throw 'Same original public-pin intent only'}}}
|
||||
$activeRecord=$null;if(Test-Path -LiteralPath $active){CheckControl $active $false;if((Get-Item -LiteralPath $active -Force).Length-gt8192){throw 'Bounded public-pin active marker'};$activeRecord=Get-Content -LiteralPath $active -Raw|ConvertFrom-Json;if($activeRecord.id-cne$request.id-or$activeRecord.config_sha256-cne$request.config_sha256-or$activeRecord.script_sha256-cne$request.script_sha256){throw 'Another initial public-pin case; no adoption'}}
|
||||
$current=$null;if(Test-Path -LiteralPath $target){$null=ReadAcl $target $false;$current=FileIdentity $target;if($current.sha256-cne$request.config_sha256){throw 'Unexpected existing configuration; no adoption'}}
|
||||
@{id=$request.id;read_only=$true;records=$records;active=$activeRecord;configuration=$current;native=$before;root_sddl=(Get-Acl -LiteralPath $helperRoot).Sddl;clock_runtime_qualified=$false;no_jobs=$true}|ConvertTo-Json -Depth 50 -Compress;exit0
|
||||
}
|
||||
if($request.action-cne'install'){throw 'Exact install action only'}
|
||||
if((Test-Path -LiteralPath $target)-or(Test-Path -LiteralPath $folder)-or(Test-Path -LiteralPath $active)){throw 'Existing initial time profile or partial attempt: original read only'}
|
||||
$bytes=ConfigBytes
|
||||
$rootSddl=(Get-Acl -LiteralPath $helperRoot).Sddl
|
||||
$heldAgent=[RmmPipeNative]::Open([int]$before.service.pid);$heldHelper=[RmmPipeNative]::Open([int]$before.helper_service.pid)
|
||||
try{
|
||||
$null=Kernel 'agent' $before.service $heldAgent;$null=Kernel 'helper' $before.helper_service $heldHelper
|
||||
$installNotBefore=[DateTime]::UtcNow.ToString('o')
|
||||
NewPrivateCase
|
||||
WriteNew (Join-Path $folder 'intent.json') @{id=$request.id;request=$request;before=$before;original_root_sddl=$rootSddl;install_not_before=$installNotBefore;no_retry=$true}
|
||||
WriteNew $active @{id=$request.id;config_sha256=$request.config_sha256;script_sha256=$request.script_sha256;no_retry=$true}
|
||||
foreach($item in $request.provenance.PSObject.Properties){if($item.Name-cnotmatch'^(platform-provenance|public-platform|original-public-platform|agent-qualification|system_helper-qualification|qualified-time-public-key|public-binding)\.json$'){throw 'Closed public provenance leaves'};$raw=[Convert]::FromBase64String($item.Value);if($raw.Length-gt65536){throw 'Bounded public provenance'};WriteBytes (Join-Path $folder $item.Name) $raw}
|
||||
$staged=Join-Path $folder 'time-attestation.candidate.json';WriteBytes $staged $bytes;SetPinAcl $staged
|
||||
if((FileIdentity $staged).sha256-cne$request.config_sha256-or(FileVolume $folder)-cne(FileVolume $helperRoot)){throw 'Verified complete same-volume public pin'}
|
||||
SameLive $before (ActualState $true)
|
||||
if((Get-Acl -LiteralPath $helperRoot).Sddl-cne$rootSddl){throw 'Immediate directory ACL CAS'}
|
||||
WriteNew (Join-Path $folder 'directory-acl-intent.json') @{old_sddl=$rootSddl;readers=@($agentSid,$helperSid);this_folder_only=$true}
|
||||
GrantRootReaders
|
||||
WriteNew (Join-Path $folder 'directory-acl-done.json') @{sddl=(Get-Acl -LiteralPath $helperRoot).Sddl}
|
||||
SameLive $before (ActualState $true)
|
||||
$null=Kernel 'agent' $before.service $heldAgent;$null=Kernel 'helper' $before.helper_service $heldHelper
|
||||
if(Test-Path -LiteralPath $target){throw 'Target appeared before no-overwrite publication'}
|
||||
$stagedId=FileIdentity $staged
|
||||
WriteNew (Join-Path $folder 'publish-intent.json') @{config_sha256=$request.config_sha256;staged=$stagedId;create_once=$true}
|
||||
[IO.File]::Move($staged,$target)
|
||||
$null=ReadAcl $target $false;$published=FileIdentity $target
|
||||
if(!(JsonEqual $published $stagedId)){throw 'Exact same file identity/hash/ACL after publication'}
|
||||
$after=ActualState $true;SameLive $before $after
|
||||
$null=Kernel 'agent' $before.service $heldAgent;$null=Kernel 'helper' $before.helper_service $heldHelper
|
||||
$result=@{id=$request.id;installed=$true;install_not_before=$installNotBefore;configuration=$published;native=$after;original_root_sddl=$rootSddl;root_sddl=(Get-Acl -LiteralPath $helperRoot).Sddl;no_jobs=$true;clock_runtime_qualified=$false;services_changed=$false;private_key_read=$false}
|
||||
WriteNew (Join-Path $folder 'result.json') $result;$result|ConvertTo-Json -Depth 50 -Compress
|
||||
}finally{$heldAgent.Dispose();$heldHelper.Dispose()}
|
||||
'''.replace('exit0','exit 0')
|
||||
|
||||
|
||||
def controller():
|
||||
"""Reuse only existing read-only witnesses, not any old phase/repair code."""
|
||||
require(sha(Path(prior.__file__).read_bytes()) == 'e466576673a0e5c332cfc1613ae88a62f5b526015ced76b1d22473e292a995e0'
|
||||
and sha(Path(prior.u.__file__).read_bytes()) == 'f8dc1c8fbc064e253b1fbe130fb628afef58cf45c2bafb6837d6716125b42d38', 'unchanged reviewed original readonly witness sources')
|
||||
source = prior.u.SCRIPT
|
||||
# Every selected section ends at the next named function. No StartOnce,
|
||||
# StopPinned, Swap, Backup, original phase, or old payload dispatch is copied.
|
||||
names = ['Check','BytesHash','Hash','AclHash','CheckControl','Service','Probe','Diagnostic','RawAgentProbe','EmptyIntentStore','State','Preserved']
|
||||
functions=[]
|
||||
for name in names:
|
||||
start=source.index('function '+name+'(') if 'function '+name+'(' in source else source.index('function '+name+'{')
|
||||
end=source.find('\nfunction ',start+1)
|
||||
require(end>start, 'closed existing readonly witness boundary')
|
||||
functions.append(source[start:end])
|
||||
# File writers are new, closed by the controller's fixed namespace only.
|
||||
writers=r'''function WriteBytes($path,[byte[]]$bytes){$file=[IO.File]::Open($path,[IO.FileMode]::CreateNew,[IO.FileAccess]::Write,[IO.FileShare]::Read);try{$file.Write($bytes,0,$bytes.Length);$file.Flush($true)}finally{$file.Dispose()}}
|
||||
function WriteNew($path,$value){WriteBytes $path ([Text.Encoding]::UTF8.GetBytes(($value|ConvertTo-Json -Depth 50 -Compress)))}'''
|
||||
return HEADER+'\n'+STRUCTURAL+'\n'+'\n'.join(functions)+'\n'+prior.NATIVE+'\n'+CASE_NATIVE+'\n'+writers+'\n'+BODY
|
||||
|
||||
# Same reviewed structural comparison as e6debe5; member order is not identity.
|
||||
STRUCTURAL = r'''function CanonicalStateValue($value,[int]$depth=0){
|
||||
if($depth-gt40){throw 'Bounded state comparison depth'}
|
||||
if($null-eq$value){return $null}
|
||||
# ETS wrapping does not turn a CLR JSON scalar into a JSON object.
|
||||
$base=$value.PSObject.BaseObject;$culture=[Globalization.CultureInfo]::InvariantCulture
|
||||
if($base-is[string]){return [string]::new($base.ToCharArray())}
|
||||
if($base-is[char]){return [string]::new([char[]]@($base))}
|
||||
if($base-is[bool]){return [bool]::Parse($base.ToString())}
|
||||
if($base-is[sbyte]-or$base-is[int16]-or$base-is[int32]-or$base-is[int64]){return [int64]::Parse($base.ToString($culture),$culture)}
|
||||
if($base-is[byte]-or$base-is[uint16]-or$base-is[uint32]-or$base-is[uint64]){return [uint64]::Parse($base.ToString($culture),$culture)}
|
||||
if($base-is[single]-or$base-is[double]){$number=[double]::Parse($base.ToString('R',$culture),$culture);if([double]::IsNaN($number)-or[double]::IsInfinity($number)){throw 'Finite JSON state number required'};return $number}
|
||||
if($base-is[decimal]){return [decimal]::Parse($base.ToString($culture),$culture)}
|
||||
if($value-is[Collections.IDictionary]){$result=[ordered]@{};foreach($key in @($value.Keys|Sort-Object -CaseSensitive)){if($key-isnot[string]-or$result.Contains($key)){throw 'Nonunique state object key'};$result[$key]=CanonicalStateValue $value[$key] ($depth+1)};return $result}
|
||||
if($value-is[pscustomobject]){$result=[ordered]@{};foreach($property in @($value.PSObject.Properties|Sort-Object -Property Name -CaseSensitive)){if($property.Name-isnot[string]-or$result.Contains($property.Name)){throw 'Nonunique state object key'};$result[$property.Name]=CanonicalStateValue $property.Value ($depth+1)};return $result}
|
||||
if($value-is[Collections.IEnumerable]-and$value-isnot[string]){$result=New-Object 'Collections.Generic.List[object]';foreach($item in $value){$result.Add((CanonicalStateValue $item ($depth+1)))};return ,$result.ToArray()}
|
||||
return $value
|
||||
}
|
||||
function JsonEqual($a,$b){return((ConvertTo-Json -InputObject (CanonicalStateValue $a) -Depth 40 -Compress)-ceq(ConvertTo-Json -InputObject (CanonicalStateValue $b) -Depth 40 -Compress))}'''
|
||||
CASE_NATIVE = r'''Add-Type -TypeDefinition @'
|
||||
using System;
|
||||
using System.ComponentModel;
|
||||
using System.Runtime.InteropServices;
|
||||
using System.Security.AccessControl;
|
||||
public static class RmmTimeProfileCase {
|
||||
[StructLayout(LayoutKind.Sequential)] struct Attributes {public int Length;public IntPtr Descriptor;public int Inherit;}
|
||||
[DllImport("kernel32.dll",EntryPoint="CreateDirectoryW",ExactSpelling=true,CharSet=CharSet.Unicode,SetLastError=true)]
|
||||
[return:MarshalAs(UnmanagedType.Bool)] static extern bool CreateDirectory(string path,ref Attributes security);
|
||||
public static void CreatePrivateOnce(string path){
|
||||
RawSecurityDescriptor sd=new RawSecurityDescriptor("O:BAG:BAD:P(A;OICI;FA;;;SY)(A;OICI;FA;;;BA)");
|
||||
byte[] raw=new byte[sd.BinaryLength];sd.GetBinaryForm(raw,0);GCHandle pin=GCHandle.Alloc(raw,GCHandleType.Pinned);
|
||||
try{Attributes attributes=new Attributes{Length=Marshal.SizeOf(typeof(Attributes)),Descriptor=pin.AddrOfPinnedObject(),Inherit=0};
|
||||
if(!CreateDirectory(path,ref attributes))throw new Win32Exception(Marshal.GetLastWin32Error(),"TIME_PROFILE_PRIVATE_CREATE_ONCE");
|
||||
}finally{pin.Free();}
|
||||
}
|
||||
}
|
||||
'@'''
|
||||
|
||||
LAUNCH = r'''$ErrorActionPreference='Stop';$request=([Console]::In.ReadLine()|ConvertFrom-Json)
|
||||
if(!$request-or$request.action-isnot[string]-or$request.action-cnotin@('install','read')-or$request.script_sha256-cnotmatch'^[a-f0-9]{64}$'){throw 'Fixed public-pin launch'}
|
||||
$script=Join-Path (Join-Path 'C:\ProgramData\RustDiscoveryBootstrap' $request.script_sha256) 'InstallPublicTimeProfile.ps1'
|
||||
$item=Get-Item -LiteralPath $script -Force;if($item.PSIsContainer-or($item.Attributes-band[IO.FileAttributes]::ReparsePoint)-or$item.Length-gt100000-or(Get-FileHash -LiteralPath $script -Algorithm SHA256).Hash.ToLowerInvariant()-cne$request.script_sha256){throw 'Exact bounded immutable time-pin script'}
|
||||
$acl=Get-Acl -LiteralPath $script;if($acl.GetOwner([Security.Principal.SecurityIdentifier]).Value-cnotin@('S-1-5-18','S-1-5-32-544')){throw 'Private launch owner'}
|
||||
foreach($rule in $acl.GetAccessRules($true,$true,[Security.Principal.SecurityIdentifier])){if($rule.AccessControlType-cne'Allow'-or$rule.IdentityReference.Value-cnotin@('S-1-5-18','S-1-5-32-544')){throw 'Private launch DACL'}}
|
||||
$global:RmmTimeProfilePayload=$request;& $script
|
||||
'''
|
||||
|
||||
def guards():
|
||||
script=controller()
|
||||
for forbidden in ('Stop-Service','Start-Service','Restart-Computer','Set-Date','AdjustTokenPrivileges',
|
||||
'function Swap','function Backup','function StartOnce','CreateService(', 'DeleteService('):
|
||||
require(forbidden not in script, 'no service/clock/job effect imported')
|
||||
require("$request.action-cnotin@('install','read')" in script
|
||||
and "if($request.action-cne'install')" in script
|
||||
and '[IO.File]::Move($staged,$target)' in script
|
||||
and script.index("'publish-intent.json') @") < script.index('[IO.File]::Move($staged,$target)')
|
||||
and 'This-folder-only ACEs' in script and '0x1200a9' in script
|
||||
and 'CreatePrivateOnce' in script, 'closed create-once public-pin effects')
|
||||
return script
|
||||
|
||||
def prepare():
|
||||
# All prerequisites are checked BEFORE creating a local installation case.
|
||||
# Source/link/role constants deliberately remain unset until actual evidence.
|
||||
require(PAIR_ID is not None and str(uuid.UUID(PAIR_ID)) == PAIR_ID
|
||||
and all(isinstance(value,str) and re.fullmatch('[a-f0-9]{64}',value)
|
||||
for value in (PAIR_RESULT_SHA,PAIR_INTENT_SHA,PAIR_READBACK_SHA)),
|
||||
'actual completed new pair and independently pinned role readback required')
|
||||
public=public_inputs(); source_inputs(); raw=raw_inputs()
|
||||
pair=PAIR_ROOT/PAIR_ID
|
||||
result_raw,result=read(pair/'result.json',PAIR_RESULT_SHA)
|
||||
intent_path=pair/'intent.json'
|
||||
if not intent_path.exists(): intent_path=pair/'bound-payload.json'
|
||||
intent_raw,intent=read(intent_path,PAIR_INTENT_SHA)
|
||||
_, independent=read(pair/'independent-readback.json',PAIR_READBACK_SHA)
|
||||
require(independent.get('id') == PAIR_ID and independent.get('completed') is True
|
||||
and independent.get('read_only') is True and independent.get('no_job') is True
|
||||
and independent.get('no_service_action') is True
|
||||
and result['independent_readback_sha256'] == PAIR_READBACK_SHA
|
||||
and result['intent_sha256'] == PAIR_INTENT_SHA
|
||||
and all(independent['native'][key] == result['native'][key]
|
||||
for key in ('files','service','helper_service','agent_kernel','helper_kernel')),
|
||||
'original independent same-generation role and file readback')
|
||||
items,native,payload=produce(public,result,intent,raw,sha(result_raw),sha(intent_raw))
|
||||
items['original-public-platform.json']=read(PUBLIC/'public-platform.json',PUBLIC_SHAS['public-platform.json'])[0]
|
||||
for name in ('qualified-time-public-key.json','public-binding.json'):
|
||||
items[name]=read(PUBLIC/name,PUBLIC_SHAS[name])[0]
|
||||
script=guards().encode(); ident=str(uuid.uuid4()); script_sha=sha(script)
|
||||
keep=('old_agent','old_helper','new_agent','new_helper','old_policy','old_pin','new_policy','new_pin',
|
||||
'config_sha256','probe_sha256','system_probe_sha256','intent_leaves')
|
||||
public_payload={key:payload[key] for key in keep}
|
||||
request={'profile':'rmm.windows.initial-public-time-profile.v2','id':ident,'action':'read',
|
||||
'script_sha256':script_sha,'config_sha256':sha(items['time-attestation.json']),
|
||||
'config_base64':base64.b64encode(items.pop('time-attestation.json')).decode(),
|
||||
'pair_payload':public_payload,'expected_native':native,'binding':public['public-binding.json'],
|
||||
'key_generation':public['qualified-time-public-key.json']['key_generation'],
|
||||
'server_instance':public['qualified-time-public-key.json']['server_instance'],
|
||||
'provenance':{name:base64.b64encode(value).decode() for name,value in items.items()}}
|
||||
# Existing transport passes the payload on stdin, not on the command line.
|
||||
require(len(canonical(request))<=128*1024,'bounded public bootstrap request')
|
||||
STATE.mkdir(mode=0o700,parents=True,exist_ok=True);ident_dir=STATE/ident;ident_dir.mkdir(mode=0o700)
|
||||
write(ident_dir/'InstallPublicTimeProfile.ps1',script)
|
||||
write(ident_dir/'time-attestation.json',base64.b64decode(request['config_base64'],validate=True))
|
||||
for name,value in items.items(): write(ident_dir/name,value)
|
||||
manifest={'profile':request['profile'],'id':ident,'generator_sha256':sha(Path(__file__).read_bytes()),
|
||||
'script_sha256':script_sha,'request':request,'pair_result_sha256':sha(result_raw),
|
||||
'pair_intent_sha256':sha(intent_raw),'source_receipt_sha256':SOURCE_RECEIPT,
|
||||
'product_link_receipt_sha256':LINK_RECEIPT,'target_called':False,'clock_runtime_qualified':False,
|
||||
'files':{name:{'sha256':sha(value),'bytes':len(value)} for name,value in items.items()}}
|
||||
write(ident_dir/'manifest.json',canonical(manifest))
|
||||
print(json.dumps({'id':ident,'prepared_locally':True,'target_called':False,
|
||||
'config_sha256':request['config_sha256'],'manifest_sha256':sha(canonical(manifest))}))
|
||||
|
||||
def load_case(ident):
|
||||
require(str(uuid.UUID(ident))==ident and uuid.UUID(ident).version==4,'canonical original time-pin case')
|
||||
folder=STATE/ident; _,manifest=read(folder/'manifest.json')
|
||||
require(manifest['id']==ident and manifest['generator_sha256']==sha(Path(__file__).read_bytes())
|
||||
and manifest['script_sha256']==sha(guards().encode()),'same exact reviewed operator and case')
|
||||
require(read(folder/'InstallPublicTimeProfile.ps1',decode=False)[0]==guards().encode(), 'same controller bytes')
|
||||
request=manifest['request'];read(folder/'time-attestation.json',request['config_sha256'])
|
||||
for name,item in manifest['files'].items(): read(folder/name,item['sha256'])
|
||||
return folder,manifest
|
||||
|
||||
def target(action,ident):
|
||||
"""Only Root invokes these explicit phases after independent review."""
|
||||
folder,manifest=load_case(ident)
|
||||
require(action in ('stage','install','read'),'closed public-pin phase')
|
||||
if action!='read':
|
||||
write(folder/(action+'-attempt.json'),canonical({'id':ident,'action':action,'once':True,'lost_reply_read_original_case_only':True}))
|
||||
access=raw_capture.CaptureAccess(MAIN)
|
||||
if action=='stage':
|
||||
path=folder/'InstallPublicTimeProfile.ps1';digest=manifest['script_sha256']
|
||||
stage=prior.u.transport.PREPARE_SCRIPT.replace('TransportAcceptance.ps1',path.name)
|
||||
observed=access.powershell(stage,{'sha256':digest})
|
||||
if not observed['already_uploaded']:
|
||||
import subprocess
|
||||
config=prior.cb.contract.protected_json(MAIN/'credentials/windows-dev-access.json')
|
||||
prefix=config['ssh_prefix'];args=['sftp']+[p for p in prefix[1:-1] if p!='-T']+['-b','-',prefix[-1]]
|
||||
remote='/C:/ProgramData/RustDiscoveryBootstrap/'+digest+'/'+path.name
|
||||
reply=subprocess.run(args,input=('put '+json.dumps(str(path.resolve()))+' '+json.dumps(remote)+'\n').encode(),capture_output=True,timeout=60)
|
||||
write(folder/'stage-transport.json',canonical({'returncode':reply.returncode,'stdout_b64':base64.b64encode(reply.stdout).decode(),'stderr_b64':base64.b64encode(reply.stderr).decode()}))
|
||||
require(reply.returncode==0,'once-only fixed script transfer; lost reply read only')
|
||||
observed=access.powershell(stage,{'sha256':digest})
|
||||
require(observed['already_uploaded'] is True and observed['sha256']==digest,'exact staged public-pin controller')
|
||||
result={'id':ident,'staged':True,'script_sha256':digest,'configuration_installed':False}
|
||||
else:
|
||||
request=copy.deepcopy(manifest['request']);request['action']=action
|
||||
result=access.powershell(LAUNCH,request,timeout=120)
|
||||
require(result['id']==ident and result.get('no_jobs') is True and result.get('clock_runtime_qualified') is False,
|
||||
'same native public-pin result, never clock readiness')
|
||||
output=folder/((action+'-'+str(uuid.uuid4()) if action=='read' else action)+'-reply.json')
|
||||
write(output,canonical(result))
|
||||
print(json.dumps({'id':ident,'action':action,'reply_sha256':sha(canonical(result)),'clock_runtime_qualified':False}))
|
||||
|
||||
# Dedicated read-only path for the already attempted original case. It never
|
||||
# passes through load_case(): changing the generator must not rewrite or adopt
|
||||
# the original staged controller/intent hash binding.
|
||||
PARTIAL_ID = 'ad9fd154-b2be-4f5d-9e17-65abb721ceaf'
|
||||
PARTIAL_MANIFEST_SHA = '0c9a3ffeed490757f7bd8c63d7e2ec28156212945094621f511e20679ce0b3b0'
|
||||
PARTIAL_GENERATOR_SHA = 'a8d55b60d413c1d68f568c173e6ea32727cef8645e61eb772d24f98e22b0b10a'
|
||||
PARTIAL_SCRIPT_SHA = 'd8b4fd4fd9ca5310cc1591ce3c2ccae5bd72a2ade43b21a8187cfdfb960b3427'
|
||||
PARTIAL_CONFIG_SHA = '2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b'
|
||||
PARTIAL_CASE = ROOT.parent/'rust-discovery-agent-updater'/'devstate/windows-time-profile-config'/PARTIAL_ID
|
||||
|
||||
|
||||
def partial_reader():
|
||||
"""Fixed file/ACL/marker observation only; no service or publication code."""
|
||||
require(sha(Path(prior.__file__).read_bytes())=='e466576673a0e5c332cfc1613ae88a62f5b526015ced76b1d22473e292a995e0'
|
||||
and sha(Path(prior.u.__file__).read_bytes())=='f8dc1c8fbc064e253b1fbe130fb628afef58cf45c2bafb6837d6716125b42d38',
|
||||
'exact original metadata-only primitive sources')
|
||||
source = prior.u.SCRIPT
|
||||
functions = []
|
||||
for name in ('Check','BytesHash','Hash','AclHash','CheckControl'):
|
||||
start=source.index('function '+name+'(');end=source.find('\nfunction ',start+1)
|
||||
require(end>start,'closed original read-only function');functions.append(source[start:end])
|
||||
native=prior.NATIVE.split('function FileIdentity(',1)[0]
|
||||
identity='function FileIdentity('+prior.NATIVE.split('function FileIdentity(',1)[1].split('function Kernel(',1)[0]
|
||||
header=r'''$ErrorActionPreference='Stop';$inputRecord=$global:RmmPartialReaderInput
|
||||
if((($inputRecord.PSObject.Properties.Name|Sort-Object)-join',')-cne'kind'-or$inputRecord.kind-cne'original-public-time-profile-ad9-readonly'){throw 'Fixed original partial profile observation'}
|
||||
$sys='S-1-5-18';$admin='S-1-5-32-544';$agentSid=(New-Object Security.Principal.NTAccount('NT SERVICE','RmmDiscoveryWindows')).Translate([Security.Principal.SecurityIdentifier]).Value;$helperSid=(New-Object Security.Principal.NTAccount('NT SERVICE','RmmDiscoverySystemHelper')).Translate([Security.Principal.SecurityIdentifier]).Value
|
||||
$folder='C:\ProgramData\RustDiscoveryBootstrap\time-profile-ad9fd154-b2be-4f5d-9e17-65abb721ceaf';$root='C:\ProgramData\RustDiscoverySystem';$active='C:\ProgramData\RustDiscoveryBootstrap\time-profile-initial-active.json'
|
||||
'''
|
||||
body=r'''function ErrorNumber($errorRecord){$ex=$errorRecord.Exception.GetBaseException();$h=[int64]$ex.HResult-band0xffffffffL;$win32=$null;if(($h-band0xffff0000L)-eq0x80070000L){$win32=$h-band0xffffL};return @{exception_type=$ex.GetType().FullName;hresult_hex=('0x{0:x8}'-f$h);win32_code=$win32}}
|
||||
function ObservePublic($path){
|
||||
if(!(Test-Path -LiteralPath $path)){return @{present=$false}}
|
||||
try{Check $path $false;$item=Get-Item -LiteralPath $path -Force;if($item.Length-gt16384){throw 'Bounded public profile only'};$identity=FileIdentity $path;return @{present=$true;identity=$identity;attributes=[int64]$item.Attributes;creation_filetime=$item.CreationTimeUtc.ToFileTimeUtc().ToString();last_write_filetime=$item.LastWriteTimeUtc.ToFileTimeUtc().ToString();expected_hash=($identity.sha256-ceq'2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b')}}catch{return @{present=$true;observation_failed=$true;error=(ErrorNumber $_)}}
|
||||
}
|
||||
CheckControl $folder $true;Check $root $true
|
||||
$records=[ordered]@{};foreach($name in @('intent.json','directory-acl-intent.json','directory-acl-done.json','publish-intent.json','publish-failure.json','result.json')){$path=Join-Path $folder $name;if(!(Test-Path -LiteralPath $path)){$records[$name]=@{present=$false};continue};CheckControl $path $false;$item=Get-Item -LiteralPath $path -Force;if($item.Length-gt2097152){throw 'Bounded original marker'};$value=Get-Content -LiteralPath $path -Raw|ConvertFrom-Json
|
||||
$record=@{present=$true;sha256=(Hash $path);bytes=$item.Length}
|
||||
if($name-ceq'intent.json'){if($value.id-cne'ad9fd154-b2be-4f5d-9e17-65abb721ceaf'-or$value.request.config_sha256-cne'2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b'-or$value.request.script_sha256-cne'd8b4fd4fd9ca5310cc1591ce3c2ccae5bd72a2ade43b21a8187cfdfb960b3427'){throw 'Original intent binding'};$record.install_not_before=$value.install_not_before;$record.no_retry=$value.no_retry}
|
||||
if($name-ceq'publish-intent.json'){if($value.config_sha256-cne'2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b'-or$value.create_once-ne$true){throw 'Original publication binding'};$record.staged=$value.staged}
|
||||
if($name-ceq'directory-acl-intent.json'){$record.old_sddl=$value.old_sddl};if($name-ceq'directory-acl-done.json'){$record.sddl=$value.sddl}
|
||||
if($name-ceq'publish-failure.json'){$record.failure=@{exception_type=$value.exception_type;hresult_hex=$value.hresult_hex;win32_code=$value.win32_code}}
|
||||
$records[$name]=$record
|
||||
}
|
||||
$activeRecord=@{present=$false};if(Test-Path -LiteralPath $active){CheckControl $active $false;if((Get-Item -LiteralPath $active).Length-gt8192){throw 'Bounded active original marker'};$a=Get-Content -LiteralPath $active -Raw|ConvertFrom-Json;if($a.id-cne'ad9fd154-b2be-4f5d-9e17-65abb721ceaf'-or$a.config_sha256-cne'2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b'-or$a.script_sha256-cne'd8b4fd4fd9ca5310cc1591ce3c2ccae5bd72a2ade43b21a8187cfdfb960b3427'){throw 'Original active binding'};$activeRecord=@{present=$true;sha256=(Hash $active);id=$a.id;config_sha256=$a.config_sha256;script_sha256=$a.script_sha256}}
|
||||
@{id='ad9fd154-b2be-4f5d-9e17-65abb721ceaf';read_only=$true;candidate=(ObservePublic (Join-Path $folder 'time-attestation.candidate.json'));target=(ObservePublic (Join-Path $root 'time-attestation.json'));records=$records;active=$activeRecord;root_sddl=(Get-Acl -LiteralPath $root).Sddl;old_move_hresult_unknown=$true;retry_authorized=$false;installation_verified=$false;clock_runtime_qualified=$false;private_key_read=$false;service_action=$false}|ConvertTo-Json -Depth 20 -Compress
|
||||
'''
|
||||
reader=header+'\n'+'\n'.join(functions)+'\n'+native+identity+'\n'+body
|
||||
require(all(token not in reader for token in ('[IO.File]::Move','Set-Acl','WriteBytes','WriteNew','Start-Service','Stop-Service','CreateDirectory','function State','function Probe')),'read-only original partial observer')
|
||||
return reader
|
||||
|
||||
|
||||
def diagnose_partial():
|
||||
# Only a future explicitly authorized maintenance window may call this.
|
||||
# The original install/read code and original markers stay untouched.
|
||||
import datetime as dt
|
||||
import subprocess
|
||||
raw,manifest=read(PARTIAL_CASE/'manifest.json',PARTIAL_MANIFEST_SHA)
|
||||
require(manifest['id']==PARTIAL_ID and manifest['generator_sha256']==PARTIAL_GENERATOR_SHA
|
||||
and manifest['script_sha256']==PARTIAL_SCRIPT_SHA
|
||||
and manifest['request']['config_sha256']==PARTIAL_CONFIG_SHA,'fixed original failed installation only')
|
||||
read(PARTIAL_CASE/'InstallPublicTimeProfile.ps1',PARTIAL_SCRIPT_SHA,decode=False)
|
||||
access=raw_capture.CaptureAccess(MAIN)
|
||||
grant=prior.cb.contract.protected_json(MAIN/'credentials/windows-dev-access.json')
|
||||
expiry=dt.datetime.fromisoformat(grant['expires_at'].replace('Z','+00:00'))
|
||||
require((expiry-dt.datetime.now(dt.timezone.utc)).total_seconds()>=60,'current confirmed access window required for read')
|
||||
source=partial_reader();digest=sha(source.encode());root=ROOT/'devstate/windows-time-profile-diagnostics';root.mkdir(mode=0o700,parents=True,exist_ok=True)
|
||||
folder=root/str(uuid.uuid4());folder.mkdir(mode=0o700)
|
||||
write(folder/'intent.json',canonical({'id':folder.name,'original_case':PARTIAL_ID,'original_manifest_sha256':PARTIAL_MANIFEST_SHA,'reader_sha256':digest,'read_only':True,'no_retry':True}))
|
||||
# A small launcher avoids Windows' command-line limit. The source hash is
|
||||
# generated from this closed reader, never accepted from a caller.
|
||||
launcher=r'''$ErrorActionPreference='Stop';$q=([Console]::In.ReadLine()|ConvertFrom-Json);$raw=[Convert]::FromBase64String($q.source_base64);$h=[Security.Cryptography.SHA256]::Create();try{$s=([BitConverter]::ToString($h.ComputeHash($raw))).Replace('-','').ToLowerInvariant()}finally{$h.Dispose()};if($s-cne'READER_SHA'){throw 'Exact original partial reader'};$global:RmmPartialReaderInput=$q.input_record;&([scriptblock]::Create([Text.Encoding]::UTF8.GetString($raw)))'''.replace('READER_SHA',digest)
|
||||
write(folder/'reader.ps1',source.encode())
|
||||
try:result=access.powershell(launcher,{'source_base64':base64.b64encode(source.encode()).decode(),'input_record':{'kind':'original-public-time-profile-ad9-readonly'}},timeout=45)
|
||||
except subprocess.TimeoutExpired:
|
||||
write(folder/'timeout.json',canonical({'read_only':True,'timeout_seconds':45,'old_move_hresult_unknown':True}));raise RuntimeError('original diagnostic read timed out; no publication attempted') from None
|
||||
write(folder/'reply.json',canonical(result))
|
||||
require(result['id']==PARTIAL_ID and result['read_only'] is True and result['retry_authorized'] is False
|
||||
and result['installation_verified'] is False and result['clock_runtime_qualified'] is False,'diagnostic observation is no installation success or authority')
|
||||
write(folder/'receipt.json',canonical({'id':folder.name,'original_case':PARTIAL_ID,'reader_sha256':digest,'original_manifest_sha256':PARTIAL_MANIFEST_SHA,'reply_sha256':sha(canonical(result)),'read_only':True,'old_move_hresult_unknown':True}))
|
||||
print(json.dumps({'id':folder.name,'original_case':PARTIAL_ID,'read_only':True,'receipt_sha256':sha((folder/'receipt.json').read_bytes())}))
|
||||
|
||||
if __name__=='__main__':
|
||||
parser=argparse.ArgumentParser(description=__doc__);parser.add_argument('action',choices=('guards','prepare','stage','install','read','diagnose-partial'));parser.add_argument('--case');arguments=parser.parse_args()
|
||||
if arguments.action=='guards': guards();print('PASS closed public-profile source guards; no target action')
|
||||
elif arguments.action=='prepare': prepare()
|
||||
elif arguments.action=='diagnose-partial':
|
||||
require(arguments.case is None,'diagnostic is fixed to the original ad9 case');diagnose_partial()
|
||||
else: target(arguments.action,arguments.case)
|
||||
@@ -19,7 +19,7 @@ EXE_BYTES=19172660
|
||||
PIN=ROOT/'devstate/server-time-source-bootstrap/qualified-time-public-key.json'
|
||||
PIN_SHA='c31d31d2d61f881d04f55f704abbbf98f4822650c016f39e39d4d2318bc3f6e2'
|
||||
# Root pins {id, receipt_sha256} only after the actual post-deploy collector read.
|
||||
CONTEXT_GATE=None
|
||||
CONTEXT_GATE={'id':'68b841a5-784f-4a34-a8a4-060b267713f0','receipt_sha256':'658fa5ffa63c6e412237f5feb718b745bb560230f17c54e437ad8bd98e9ad65b'}
|
||||
require,save,load,sha=original.require,original.save,original.load,original.sha
|
||||
|
||||
SCRIPT=r'''$ErrorActionPreference='Stop';$p=([Console]::In.ReadLine()|ConvertFrom-Json)
|
||||
@@ -187,3 +187,96 @@ if __name__=='__main__':
|
||||
if a.action=='guards':guards();print('PASS source guards; no target call')
|
||||
elif a.action=='prepare':require(a.case is None,'actual sealed context determines own case');prepare()
|
||||
else:require(a.case is not None,'original case required');run(a.action,a.case)
|
||||
|
||||
# Direct, read-only recovery of this original staged case after the historical
|
||||
# upgrade finish reader timed out. No historical manifest or reply is rewritten.
|
||||
DIRECT_CASE='68b841a5-784f-4a34-a8a4-060b267713f0'
|
||||
DIRECT_MANIFEST='22f3bc7c143a893729f193133858696f377a84296c5843bde8b1354c1493389b'
|
||||
DIRECT_OPERATOR='a817f45b43fa15feaa24a8ec8d4eea404f0e2bcf75ff252da166aebfa63b5c55'
|
||||
|
||||
|
||||
def direct_source():
|
||||
prior=original.pipe
|
||||
checks=prior.PREFIX.split('function Check(',1)[1].split('function PrivateBackupAcl',1)[0]
|
||||
service=prior.PREFIX.split('function Service($role){',1)[1].split('function Probe(',1)[0]
|
||||
native=prior.NATIVE.split('function FileIdentity(',1)[0]
|
||||
identity=prior.NATIVE.split('function FileIdentity(',1)[1].split('function Kernel(',1)[0]
|
||||
kernel=prior.NATIVE.split('function Kernel(',1)[1].split('function ActualState',1)[0]
|
||||
metadata=prior.NATIVE.split('function FileIdentityMetadata(',1)[1].split('function SameOriginal',1)[0]
|
||||
return r'''$ErrorActionPreference='Stop';$p=$global:RmmRouteDirectPreservationPayload
|
||||
if((($p.PSObject.Properties.Name|Sort-Object)-join',')-cne'kind'-or$p.kind-cne'fixed-time-route-direct-preservation'){throw 'Fixed readonly observation'}
|
||||
$agentName='RmmDiscoveryWindows';$helperName='RmmDiscoverySystemHelper';$sys='S-1-5-18';$admin='S-1-5-32-544'
|
||||
$agentRoot='C:\ProgramData\RustDiscovery';$agentState=Join-Path $agentRoot 'state';$helperRoot='C:\ProgramData\RustDiscoverySystem';$helperState=Join-Path $helperRoot 'state'
|
||||
$agentBinary='C:\Program Files\RustDiscovery\rmm-agent-windows.exe';$helperBinary='C:\Program Files\RustDiscovery\rmm-helper-windows.exe'
|
||||
$agentSid=(New-Object Security.Principal.NTAccount('NT SERVICE',$agentName)).Translate([Security.Principal.SecurityIdentifier]).Value
|
||||
$helperSid=(New-Object Security.Principal.NTAccount('NT SERVICE',$helperName)).Translate([Security.Principal.SecurityIdentifier]).Value
|
||||
'''+'function JsonEqual($a,$b){return(($a|ConvertTo-Json -Depth 40 -Compress)-ceq($b|ConvertTo-Json -Depth 40 -Compress))}\n'+'function Check('+checks+'function Service($role){'+service+'\n'+native+'function FileIdentity('+identity+'function Kernel('+kernel+'function FileIdentityMetadata('+metadata+r'''
|
||||
$services=[ordered]@{};$kernels=[ordered]@{};foreach($role in @('agent','helper')){$s=Service $role;if($s.state-cne'Running'){throw 'Both original services running'};$h=[RmmPipeNative]::Open([int]$s.pid);try{$kernels[$role]=Kernel $role $s $h;if(!(JsonEqual $s (Service $role))){throw 'Actual service race'}}finally{$h.Dispose()};$services[$role]=$s}
|
||||
$files=[ordered]@{};foreach($entry in @(@('agent',$agentBinary),@('helper',$helperBinary),@('settings',(Join-Path $helperRoot 'helper.json')),@('pin',(Join-Path $helperRoot 'agent-pin.json')),@('config',(Join-Path $agentRoot 'config.json')),@('ca',(Join-Path $agentRoot 'server-ca.pem')),@('identity',(Join-Path $agentState 'identity.json')),@('certificate',(Join-Path $agentState 'device.pem')))){$files[$entry[0]]=FileIdentity $entry[1] ($entry[0]-in@('ca','identity','certificate'))}
|
||||
$files.private_key=FileIdentityMetadata (Join-Path $agentState 'device.key')
|
||||
$db=[ordered]@{};foreach($entry in @(@('telemetry',(Join-Path $agentState 'telemetry.sqlite')),@('helper',(Join-Path $helperState 'ledger.sqlite')),@('lock',(Join-Path $helperState 'executor.lock')))){$m=FileIdentityMetadata $entry[1];$i=Get-Item -LiteralPath $entry[1];$db[$entry[0]]=@{volume_serial=$m.volume_serial;file_id=$m.file_id;creation_filetime=$i.CreationTimeUtc.ToFileTimeUtc().ToString();acl_sha256=$m.acl_sha256}}
|
||||
@{files=$files;services=$services;kernels=$kernels;database_identities=$db;read_only=$true;private_key_read=$false;database_content_read=$false;services_changed=$false}|ConvertTo-Json -Depth 25 -Compress
|
||||
'''
|
||||
|
||||
|
||||
def direct_witness(access,baseline):
|
||||
source=direct_source();require(all(v not in source for v in ('Start-Service','Stop-Service','WriteNew','PrivateBackupAcl','function Probe','function State')),'direct observation has no old probe or mutation')
|
||||
digest=hashlib.sha256(source.encode()).hexdigest()
|
||||
launcher=r'''$ErrorActionPreference='Stop';$q=([Console]::In.ReadLine()|ConvertFrom-Json)
|
||||
$raw=[Convert]::FromBase64String($q.source_base64);$h=[Security.Cryptography.SHA256]::Create();try{$sha=([BitConverter]::ToString($h.ComputeHash($raw))).Replace('-','').ToLowerInvariant()}finally{$h.Dispose()}
|
||||
if($sha-cne'FIXED_SOURCE_SHA'){throw 'Exact direct reader source'}
|
||||
$global:RmmRouteDirectPreservationPayload=$q.payload
|
||||
& ([scriptblock]::Create([Text.Encoding]::UTF8.GetString($raw)))
|
||||
'''.replace('FIXED_SOURCE_SHA',digest)
|
||||
value=access.powershell(launcher,dict(source_base64=base64.b64encode(source.encode()).decode(),payload=dict(kind='fixed-time-route-direct-preservation')),timeout=45)
|
||||
save(STATE/DIRECT_CASE/('direct-observed-'+str(uuid.uuid4())+'.json'),value)
|
||||
old=baseline['native'];stable=old['stable']
|
||||
require(value['read_only'] is True and value['private_key_read'] is False and value['database_content_read'] is False
|
||||
and value['files']==stable['files'],'actual original public file bytes/FileIDs/ACLs and private-key metadata')
|
||||
for role,name in [('agent','service'),('helper','helper_service')]:
|
||||
require(value['services'][role]==stable[name] and value['kernels'][role]==stable[role+'_kernel'],'same running original service/kernel PID/birth/image/account')
|
||||
telemetry=value['database_identities']['telemetry'];old_id=old['journal']['database_file_id'];old_birth=old['journal']['database_creation']
|
||||
require(int(telemetry['volume_serial'])&0xffffffff==old_id['volume']
|
||||
and int.from_bytes(bytes.fromhex(telemetry['file_id'])[:8],'little')==((old_id['high']<<32)|old_id['low'])
|
||||
and int(telemetry['creation_filetime'])==((old_birth['high']<<32)|old_birth['low']),'original telemetry native identity/creation')
|
||||
value['historical_helper_metadata_comparison']={}
|
||||
for name,previous in [('helper',stable['helper_witness']['helper_ledger']['file']),('lock',stable['helper_witness']['executor_lock'])]:
|
||||
current=value['database_identities'][name]
|
||||
value['historical_helper_metadata_comparison'][name]=dict(volume_equal=current['volume_serial']==previous['file_id']['volume_serial'],file_id_equal=current['file_id']==previous['file_id']['id_hex'],creation_equal=current['creation_filetime']==previous['creation_filetime'],acl_digest_equal=current['acl_sha256']==previous['acl_sha256'],historical_probe_not_repeated=True)
|
||||
return value
|
||||
|
||||
|
||||
def direct(action):
|
||||
require(action in ('run-direct','read-direct'),'fixed passive recovery phase');guards()
|
||||
folder=STATE/DIRECT_CASE;manifest=load(folder/'manifest.json');baseline=load(folder/'baseline.json')
|
||||
require(sha(folder/'manifest.json')==DIRECT_MANIFEST and manifest['operator_sha256']==DIRECT_OPERATOR
|
||||
and manifest['context_gate']==CONTEXT_GATE and manifest['dependencies']==original.dependencies()
|
||||
and sha(folder/'TimeRouteProbe.exe')==EXE_SHA and sha(folder/'time-public-key.json')==PIN_SHA
|
||||
and sha(folder/'context.json')==manifest['context_sha256'] and sha(folder/'TimeRouteAcceptance.ps1')==hashlib.sha256(SCRIPT.encode()).hexdigest(),'fixed original staged case only')
|
||||
stage=load(folder/'stage-reply.json');require(stage==dict(id=DIRECT_CASE,manifest_sha256=DIRECT_MANIFEST,staged=True),'actual original stage response')
|
||||
original.original_main();access=original.CaptureAccess(original.ACCESS_ROOT)
|
||||
operation='run-direct' if action=='run-direct' else 'read-direct-'+str(uuid.uuid4())
|
||||
if action=='run-direct':
|
||||
require(not (folder/'run-attempt.json').exists(),'original automatic run was never attempted')
|
||||
gate_id,context,receipt=gate();require(gate_id==DIRECT_CASE,'same actual context gate')
|
||||
require(collector.rpc(access,dict(id=DIRECT_CASE,deployment_result_sha256=receipt['deployment_result_sha256'],image=collector.IMAGE),folder)==load(context/'response.json'),'actual context still exact')
|
||||
intent_name=operation+'-intent.json'
|
||||
if (folder/intent_name).exists():intent_name=operation+'-preflight-'+str(uuid.uuid4())+'.json'
|
||||
save(folder/intent_name,dict(action=action,operator_sha256=sha(__file__),original_manifest_sha256=DIRECT_MANIFEST,
|
||||
direct_source_sha256=hashlib.sha256(direct_source().encode()).hexdigest(),read_only=action=='read-direct',historical_stage_witness_timeout_retained=True))
|
||||
before_server=original.server_closed(access);require(before_server==baseline['server'],'same closed server original counts and flags')
|
||||
before=direct_witness(access,baseline);save(folder/(operation+'-before.json'),before)
|
||||
payload=dict(action='run' if action=='run-direct' else 'read',id=DIRECT_CASE,manifest_sha256=DIRECT_MANIFEST,context_sha256=manifest['context_sha256'],context_base64=base64.b64encode((folder/'context.json').read_bytes()).decode(),pin_base64=base64.b64encode((folder/'time-public-key.json').read_bytes()).decode())
|
||||
if action=='run-direct':save(folder/'run-direct-start-intent.json',dict(action='run',once=True,no_retry=True,operator_sha256=sha(__file__),direct_before_sha256=sha(folder/(operation+'-before.json'))))
|
||||
try:response=access.powershell(SCRIPT,payload,timeout=45)
|
||||
except subprocess.TimeoutExpired:
|
||||
save(folder/(operation+'-timeout.json'),dict(error='SSH_TIMEOUT_45_SECONDS',result_unknown=True,repeat_run=False));raise RuntimeError('passive response missing; original read only') from None
|
||||
save(folder/(operation+'-reply.json'),response)
|
||||
after_server=original.server_closed(access);after=direct_witness(access,baseline)
|
||||
save(folder/(operation+'-after.json'),after);require(before==after and before_server==after_server,'actual service/PKI/config/native DB identities and closed server counts preserved')
|
||||
save(folder/(operation+'-preservation.json'),dict(id=DIRECT_CASE,operation=operation,operator_sha256=sha(__file__),original_manifest_sha256=DIRECT_MANIFEST,
|
||||
raw_reply_sha256=sha(folder/(operation+'-reply.json')),before_sha256=sha(folder/(operation+'-before.json')),after_sha256=sha(folder/(operation+'-after.json')),
|
||||
server_before=before_server,server_after=after_server,direct_native_preserved=True,old_finish_timeout_remains=True,no_jobs_created=True,no_service_action=True))
|
||||
require(response['id']==DIRECT_CASE and response['manifest_sha256']==DIRECT_MANIFEST,'actual own original reply')
|
||||
if action=='run-direct' or 'report.json' in response.get('records',{}):validate(response,manifest)
|
||||
print(json.dumps(dict(id=DIRECT_CASE,operation=operation,verified='report.json' in response.get('records',{}),preserved=True)))
|
||||
|
||||
@@ -14,8 +14,7 @@ import signed_clock_capture_acceptance as original
|
||||
ROOT=original.ROOT
|
||||
STATE=ROOT/'devstate/windows-time-route-context'
|
||||
# Root binds the actual successful deployment result SHA after its separate read.
|
||||
DEPLOYMENT_RESULT_SHA=None
|
||||
DEPLOYMENT_PATH='/opt/rust-discovery/devstate/time-gateway-deploy-fb87aa88-2b67-4cff-9c90-4cd713380889/result.json'
|
||||
DEPLOYMENT_RESULT_SHA='3017634f101ee8aff62988f195ccb3a7a8b9e03eaa48b8fb339af9ceb3ad2b4b'
|
||||
IMAGE='sha256:422c2c28a91ac512e9317908f4d1fb22247eef857ca95d45e1b1880598b0d611'
|
||||
BINDING_SHA='05c5678fed81e0a2a7cdaaeaf18c64f9837cfbe76c140699a47306c9b4598a18'
|
||||
require,save,load,sha=original.require,original.save,original.load,original.sha
|
||||
@@ -30,7 +29,7 @@ def server_read(p):
|
||||
need(str(uuid.UUID(p['id']))==p['id'] and isinstance(p['deployment_result_sha256'],str) and len(p['deployment_result_sha256'])==64
|
||||
and all(v in '0123456789abcdef' for v in p['deployment_result_sha256'])
|
||||
and p['image']=='sha256:422c2c28a91ac512e9317908f4d1fb22247eef857ca95d45e1b1880598b0d611')
|
||||
path=Path('/opt/rust-discovery/devstate/time-gateway-deploy-fb87aa88-2b67-4cff-9c90-4cd713380889/result.json')
|
||||
path=Path('/opt/rust-discovery/devstate/time-gateway-deploy-fb87aa88-2b67-4cff-9c90-4cd713380889/continue-backend-v1/result.json')
|
||||
metadata=path.lstat();need(stat.S_ISREG(metadata.st_mode) and metadata.st_uid==0 and metadata.st_nlink==1
|
||||
and stat.S_IMODE(metadata.st_mode)==0o600 and metadata.st_size<=65536)
|
||||
def identity(m):return(m.st_dev,m.st_ino,m.st_mode,m.st_uid,m.st_gid,m.st_nlink,m.st_size,m.st_mtime_ns,m.st_ctime_ns)
|
||||
|
||||
@@ -0,0 +1,89 @@
|
||||
# Migration0016: passives Updateinventar annehmen
|
||||
|
||||
Am2026-11-15 ist Migration0016 tatsächlich auf dem permanenten Server mit dem
|
||||
regulären SQLx-Migrationspfad ausgeführt und separat nachgelesen worden. Der
|
||||
bisherige Check `observations_source_id_check` ließ nur `linux.base` und
|
||||
`windows.base` zu. Die laufende Gatewayversion kannte bereits die passive
|
||||
`agent.update`-Beobachtung; der Datenbankcheck verweigerte deren Speicherung.
|
||||
Nach dem neuen Windowsagentenwechsel waren15 entsprechende Fehler beobachtet
|
||||
worden. Diese verweigerten Nachrichten werden nicht nachträglich als gespeichert
|
||||
ausgegeben.
|
||||
|
||||
Die additive Datei `migrations/0016_agent_update_observation_scope.sql` erweitert
|
||||
ausschließlich diese feste Dreiermenge. Freie Scopes bleiben verboten. Im
|
||||
normalen SQLx-Transactionrahmen wird der alte Check ersetzt und der neue Check
|
||||
validiert; ein Fehler rollt die Transaktion zurück. `lock_timeout=3s` begrenzt
|
||||
das Warten auf Tabellenlocks, `statement_timeout=15s` jedes DDL-Statement.
|
||||
Keine DML-, RLS-, FK-, PK-, Tenant-/Geräte-/Zertifikats-, Job-, Grant- oder
|
||||
Policyänderung gehört zur Migration.
|
||||
|
||||
Tatsächlicher Fall: `cc3ea56d-6186-425a-8ef3-90562212fb1b`. Verwendet wurde das
|
||||
bereits vom Orchestrator nativ ARM64 gebaute Image
|
||||
`sha256:6a76343bf65c126458244f5540d4cb740988144fc77877b409f790251e7ddcc7`.
|
||||
Es enthält den vorhandenen `rmm-server migrate`-Entrypoint und die echte
|
||||
SQLx-`migrate!`-Migrationseinbettung. Es wurde kein zusätzlicher Builderlauf
|
||||
gestartet und keine SQLx-Tabellenzeile manuell angelegt oder geändert.
|
||||
|
||||
Ein eigenes privates Compose-Overlay wählte ausschließlich für den temporären
|
||||
`migrate`-Container dieses bereits vorhandene Image (`pull_policy: never`,
|
||||
read-only RootFS, CapDropALL, NoNewPrivileges). Die vorhandene Migration-URL
|
||||
blieb im normalen Compose-/Prozesskontext; sie wurde nicht ausgegeben. Der
|
||||
unterstützte `docker compose … run --no-deps … migrate` führte genau einen
|
||||
wirklichen SQLx-Lauf aus, Exit0. Der eigene gestoppte Container wurde nach
|
||||
seinem Exit-/Image-/Falllabelbeleg entfernt. Kein API-, Gateway- oder
|
||||
PostgreSQLdienst wurde durch diesen Agenten ersetzt oder neu gestartet.
|
||||
API-Filterung und API-only-Deployment sind ein eigener Orchestratorschnitt.
|
||||
|
||||
Die tatsächliche SQLx-Historie besitzt danach Versionen1–16 jeweils mit
|
||||
`success=true`; die alten15 Checksums stimmen unverändert mit den Quellinputs
|
||||
überein. Version16 heißt `agent update observation scope` und besitzt SHA384
|
||||
`e66ec49233c210555b5107d20b925ca6715925871aa2bf94dfb86bd5cfb39c6dc769fdf0049b615fcad503332e1cd8fc`.
|
||||
Die SQL-Datei hat SHA256
|
||||
`fa0953262e3a8da7f3f0366db6f3fa77ad7976ec04327b126036739eea46eebb`.
|
||||
|
||||
Vor dem echten SQLx-Start wurden3127 bestehende Observationzeilen serverseitig
|
||||
über ihre vollständige JSON-Zeilendarstellung gehasht; unmittelbar danach waren alle
|
||||
unverändert. Der ursprüngliche Fallbaseline enthielt3123Zeilen. Deren
|
||||
unveränderte Fingerprints und die vollständige RLS-/Owner-/ACL-/Policy-,
|
||||
FK-/PK-/sonstige Check- und Job-/Plan-/Authorization-/Outbox-/Permit-/Receipt-
|
||||
Zeugen wurden nochmals in einem getrennten Read-only-SQL-Aufruf bestätigt.
|
||||
Neue passive Zeilen durften parallel regulär hinzukommen. Die neue Constraint
|
||||
war tatsächlich `VALIDATED` und enthielt genau
|
||||
`linux.base`, `windows.base`, `agent.update`. API und Gateway liefen während
|
||||
dieser Migration unverändert mit Image422c2c28; PostgreSQL behielt seine
|
||||
ursprüngliche Container-/Imageidentität.
|
||||
|
||||
Ein weiterer lesender Serverabgleich fand bereits drei angenommene
|
||||
`agent.update`-Zeilen, zuletzt15:40:50UTC. Das beweist die normale Speicherung
|
||||
dieses Scopes nach der Migration, keinen separat geprüften Windows-ACK,
|
||||
keine neue Basisinventarabnahme und keine Zeit-/Jobbereitschaft.
|
||||
|
||||
Die Vorherarchive enthalten Katalog-/Migrations-/Policyzeugen und
|
||||
Zeilenfingerprints; ein vollständiger **Vorher-`pg_dump` wurde nicht angelegt**.
|
||||
Ein vollständiger privater Customformat-Dump wurde ausdrücklich **nach** der
|
||||
Migration archiviert: `after-migration-0016.pg_dump`,49,455,447Bytes, SHA256
|
||||
`b89e74eaaea7ec2faa17a44358acca3aead1db0fcf9ccf673e2c5808b3259398`.
|
||||
Er bleibt ausschließlich im Root0700-Fall auf dem Server, Datei0600, und wurde
|
||||
nicht heruntergeladen oder als Vorherbackup bezeichnet. Ein Restoretest wurde
|
||||
hier nicht ausgeführt.
|
||||
|
||||
Zwei harmlose Vorbedingungen scheiterten vor dem eigentlichen SQLx-Lauf und
|
||||
bleiben erhalten: zunächst die Annahme eines vollständigen Buildkontexts
|
||||
statt des tatsächlichen Minimal-Kontexts; danach ein hier nicht unterstütztes
|
||||
Compose-Flag `--no-build`. Für letzteren Fall waren Exit1, Ledger15 und die
|
||||
Abwesenheit eines eigenen Containers belegt. Nach Roots konkreter Korrektur
|
||||
wurde derselbe Originalfall mit einem neuen Create-only-Fortsetzungsintent
|
||||
verwendet; alte Fehler-/Vorherdateien wurden nicht überschrieben. Ein weiterer
|
||||
reiner Absenzmatcher wurde an die tatsächliche Kleinschreibung der Docker-
|
||||
Fehlermeldung angepasst, ebenfalls vor jedem Container-/SQLx-Start. Keine
|
||||
verlorene SQLx-Wirkung wurde blind wiederholt.
|
||||
|
||||
Geschütztes Serverarchiv:
|
||||
`/opt/rust-discovery/devstate/observation-scope-migration-cc3ea56d-6186-425a-8ef3-90562212fb1b/`.
|
||||
Lokaler Belegordner im eigenen Worktree:
|
||||
`devstate/observation-scope-migration/cc3ea56d-6186-425a-8ef3-90562212fb1b/`.
|
||||
Die separate lokale `receipt.json` bindet Originalintent, Fehler, tatsächlichen
|
||||
SQLx-Erfolg, getrennten Read und Nachbackup; SHA256
|
||||
`00ff8f8ffa689bf3917937ce14ae23457e464b921ae7793e9091eab9a83d76c7`.
|
||||
Private Zugangsdaten und
|
||||
Datenbankinhalte wurden weder veröffentlicht noch in Git aufgenommen.
|
||||
@@ -0,0 +1,125 @@
|
||||
# Normaler passiver Releasekatalogcheck
|
||||
|
||||
Stand2026-11-15. Der Linux-Agent ruft den vorhandenen Releasekatalog jetzt aus
|
||||
seinem normalen `queue_update_observation`-Pfad auf. Dies ist ein passiver
|
||||
Metadatencheck, kein Artefaktbezug, Staging, Job oder ausgeführtes Selbstupdate.
|
||||
|
||||
## Aufruf, Vertrauen und Grenzen
|
||||
|
||||
Der Collector startet höchstens einen Hintergrundrequest. Erfolgreiche Checks
|
||||
werden nach24h erneuert; fehlende Konfiguration oder Fehler frühestens nach60s.
|
||||
35s Gesamtfrist und64KiB Antwortlimit gelten zusätzlich zu den vorhandenen
|
||||
mTLS-/HTTPgrenzen. Heartbeats, Cancel und SignedSync warten nicht auf HTTP.
|
||||
Die URL bleibt `/agent/v1/releases/current` am bereits konfigurierten TLSnamen;
|
||||
der vorhandene Connectoverride ändert ausschließlich das TCPziel. Keine
|
||||
Weiterleitung, Umgebungsproxy-, System-CA- oder Jobsigner-Ersatzannahme.
|
||||
|
||||
Verwendet werden ausschließlich die bereits vorgesehenen geschützten öffentlichen
|
||||
Dateien `/etc/rmm-agent-updater/policy.json`, `keyring.json` und
|
||||
`/var/lib/rmm-agent-updater/installed-record.json`. Eigentümer/Eltern sindRoot,
|
||||
keine Symlinks oder gruppen-/weltbeschreibbaren Pfade; reguläre Dateien,
|
||||
ein Hardlink, feste Größenlimits. Gehaltene FD-/Inode-/Metadaten-/Rawbytezeugen
|
||||
werden nach dem Request erneut geprüft. Es entstehen keine lokalen Dateien,
|
||||
keine Schlüsselprovisionierung und keine geänderten Dateirechte.
|
||||
|
||||
Policyidentität muss zum vorhandenen Gerätebinding passen. Separater
|
||||
Releasekeyring, aktuelle Widerrufe/Sequenzbereiche, echte Baseline- und
|
||||
Releasesignaturen, Linuxplattform, qualifizierter Protokoll-/Statevertrag,
|
||||
Updaterversion, Fristen und unveränderter Floor werden unabhängig geprüft.
|
||||
Serverzeit und die zusätzliche unsignierte Manifestansicht ersetzen keine
|
||||
lokale TrustedClock oder signierten Originalbytes; beide Manifestansichten
|
||||
müssen übereinstimmen. Fehlende Anker ergeben `not_configured`, Transport-/TLS-/
|
||||
Prüfprobleme `unavailable`; gültige Metadaten ergeben `available` oder `current`.
|
||||
|
||||
Dieser enge Erstanschluss akzeptiert als Flooranker ausschließlich die exakten
|
||||
separat signierten Bootstrap-InstalledRecordbytes. Ein späterer `Updated`-Record
|
||||
benötigt die noch fehlende unabhängig authentisierte read-only Fullhelper-
|
||||
Historybeobachtung; bloßes Parsen der neueren Recorddatei erzeugt keine
|
||||
Vertrauens- oder Floorfreigabe. Eine tatsächliche geschützte Konfiguration muss
|
||||
für den unprivilegierten Agent lesbar provisioniert sein. Unlesbare Dateien
|
||||
bleiben ehrlich unavailable; dieser Code lockert keine ACL.
|
||||
|
||||
## Übertragung und Darstellung mit älteren Servern
|
||||
|
||||
Der unveränderte `agent.update`-Snapshot erhält **kein zusätzliches Top-Level-
|
||||
Feld**. Seine qualifizierte Vorgänger-/Fullpreview bleibt `not_configured`;
|
||||
Katalogmetadaten sind keine `CandidatePreview` und eröffnen keine Check-/Applycap.
|
||||
|
||||
Der gespeicherte Katalogbericht wird ausschließlich beim ohnehin geplanten
|
||||
normalen Linuxinventar als begrenzte bestehende Unterbeobachtung
|
||||
`linux.agent_update.catalog` übertragen. Kein zusätzlicher Basiscollect wird
|
||||
angefordert. Dieser `linux.base`-/`observations`-Vertrag wird bereits von älteren
|
||||
Servern angenommen; kein neues Protobuftag und keine neue Servercap sind nötig.
|
||||
Die äußere Beobachtungszeit bezeichnet das Lesen des Caches. Das innere
|
||||
`checked_at` bleibt die tatsächliche ursprüngliche Checkzeit und wird beim
|
||||
Übertragen nicht erneuert. Über72h alte Cachewerte werden nicht neu angehängt.
|
||||
|
||||
Der aktuelle Domain-Ingest validiert zusätzlich den bekannten Berichtstyp,
|
||||
Qualität, Zeit, Kandidatenform und geschlossene Feldmenge. Altclients ohne diese
|
||||
Beobachtung bleiben gültig. Die bestehende tenantgebundene Inventoryspeicherung
|
||||
und Geräte-API transportieren dieselben geprüften Daten. Die WebUI zeigt Status,
|
||||
echten Checkzeitpunkt, spätere Cachelesezeit und gegebenenfalls Version/Hash als
|
||||
Text. Sie erzeugt keine Requests oder Bedienung zur Ausführung aus dem Bericht.
|
||||
Gemeinsame synthetische Codecfixture:
|
||||
`tests/agent_update/catalog-check-inventory.json`.
|
||||
|
||||
## Tatsächliche lokale Prüfungen
|
||||
|
||||
Im vorhandenen isolierten Rust1.99.1-Buildcontainer, Netzwerk aus:
|
||||
|
||||
```text
|
||||
cargo test --release --locked --offline -p rmm-agent -p rmm-domain --all-targets
|
||||
cargo clippy --locked --offline -p rmm-agent -p rmm-domain --all-targets -- -D warnings
|
||||
cargo fmt -p rmm-agent -p rmm-domain --check
|
||||
```
|
||||
|
||||
Abschließend89Tests bestanden,0Fehler/ignorierte/gefilterte im gesamten Lauf
|
||||
(Agentbinary32, weitere Agentintegration34, Domain23). Clippy und Formatcheck
|
||||
bestanden. Web55/55 und Typecheck bestanden. Die sechs gezielten neuen Fälle
|
||||
enthalten echte synthetische Ed25519-Baseline-/Releasebytes und einen tatsächlich
|
||||
laufenden lokalen mTLS-Testserver mit eigener CA/Geräteidentität: fester Pfad,
|
||||
Clientzertifikat, Antwort-/Redirect-/Größenverweigerung, Floor/Protokoll/Schema/
|
||||
Ablauf/Keywiderruf, fehlender Anker, falsche Baseline und unzulässige Recordbytes.
|
||||
Der Wirefall durchläuft echte Protobufbytes bis zum tatsächlichen
|
||||
`validate_for_scope`; UI und Rust benutzen dieselbe statische Datenfixture.
|
||||
|
||||
Zusätzlich wurde exakt der positive Kompatibilitätsfall mit dem ursprünglich
|
||||
unveränderten Ingestvalidator aus `c1d8eea` als privatem Datei-Mount ausgeführt:
|
||||
1/1 bestanden. Nach diesem Altvalidatorlauf schlug ein nachfolgender Negativfall
|
||||
zunächst fehl. Nach gezieltem Bereinigen der beiden betroffenen Pakete im eigenen
|
||||
Buildcache und vollständigem Neubuild bestand der gesamte89er-Lauf. Die
|
||||
Altvalidator-, erste Fehler- und abschließenden Logs bleiben getrennt erhalten;
|
||||
der fehlgeschlagene Lauf ist kein Erfolgsbeleg. Ein erster unbenutzter Import
|
||||
wurde ohne Warnungsunterdrückung korrigiert.
|
||||
|
||||
Der öffentliche Datei-Guardtest benötigt keinRoot: Unprivilegiert beweist er die
|
||||
Verweigerung des eigenen unprivilegierten/beschreibbaren Pfads. Nur der gesonderte
|
||||
lokale Rootlauf prüft zusätzlich ein eigenes geschütztes positives Dateifixture.
|
||||
Keine ungekennzeichnete Rootpflicht im neuen Test. Lokale Belege:
|
||||
`devstate/updater-passive-catalog-d86dc473-3e5f-48d4-a196-3a0d618a8e4e/`.
|
||||
|
||||
## Tatsächliche Cloud-Linux-Qualifikation
|
||||
|
||||
Root führte auf der festgelegten Cloud-Linux-Test-VM am2026-11-15 um13:07:09UTC
|
||||
exakt die sechs `agent_update_catalog::`-Fälle alsUID65534 aufx86-64 aus:
|
||||
6bestanden,0Fehler,0ignorierte,26übrige Tests bewusst gefiltert, Exit0,
|
||||
0stderr-Bytes. Der unprivilegierte Datei-Verweigerungszweig ist hierbei geprüft;
|
||||
der privilegierte positive Dateizweig stammt ausschließlich aus dem lokalen
|
||||
Rootlauf. mTLS verwendet auch auf der VM nur den eigenen Loopback-Testserver.
|
||||
Dies ist kein Katalogabruf durch den installierten Produktagenten gegen den
|
||||
Internetserver, keine Clock-/Fullhelper-/Applyqualifikation und kein Windowsbeleg.
|
||||
|
||||
Exakte Testbinary-SHA256:
|
||||
`e8fc4249db06510b6b680f5ddf7e1d539305c54741d1dea2fdc348883f205956`.
|
||||
Erhaltener privater nativer Beleg:
|
||||
`devstate/updater-passive-catalog-linux/4f3e5a4b-98a9-4acf-9106-dcdd4d5d1823/result.json`,
|
||||
SHA256 `332c8903506bf17fa8c9a9a0f512bb64ad82867513d2885359a54a80e4750e6d`.
|
||||
|
||||
## Nächster tatsächlicher Lieferweg
|
||||
|
||||
Noch offen sind der qualifizierte read-only Fullobserver für aktuelle
|
||||
Vorgänger-/Pin-/Historypreview, die normale unverbrauchte Fulladmission,
|
||||
Agent-/Helper-Artefaktstaging vor Handoff, stabiler Updaterbootstrap und der
|
||||
vollständige dauerhafte Rückweg. Agent `supported/accept` und Fullpolicy geben
|
||||
weiterhin keinen Updatejob frei. Es wurde kein Agent installiert, Dienst
|
||||
geändert, Code getauscht, Job angelegt oder genehmigt. Notebook nur Entwicklung.
|
||||
@@ -0,0 +1,89 @@
|
||||
# Erhaltener Decodervertrag und weiterhin gesperrte Rückkehr
|
||||
|
||||
Stand2026-11-15, enger lokaler Quellschnitt im bestehenden Worker. Keine neue
|
||||
Journalversion, kein gestarteter Updater, keine VM- oder Applyabnahme.
|
||||
|
||||
## Konkreter Befund und Änderung
|
||||
|
||||
`history::verify_history` authentisiert die separat release-signierte
|
||||
Bootstrapbaseline, die vollständige aufsteigende InstalledRecord-Kette und die
|
||||
ursprünglichen Job-/Handoff-/Health-/Publikationszeugen im erhaltenen Helperledger.
|
||||
Die bisherige Releaseprüfung übernahm jedoch Protokollhauptversion und
|
||||
Zustandsschema aus genau dem Nachfolgermanifest, dessen Kompatibilität sie prüfte.
|
||||
Eine echte Signatur authentisiert einen Releaseinhalt; sie beweist nicht, dass
|
||||
dieser Inhalt den Decodervertrag des erhaltenen Zustands unterstützt.
|
||||
|
||||
Die bestehende Prüfung bekommt jetzt beide Vergleichswerte ausschließlich aus
|
||||
dem separat signierten qualifizierten Bootstrapmanifest. Jeder historische
|
||||
Nachfolger muss diese Werte erhalten. Aktuelle Keywiderrufe, Schlüsselbereiche,
|
||||
Manifest-/Job-/Healthsignaturen, unveränderte Originalbytes und monotoner Floor
|
||||
bleiben zusätzliche Bedingungen. Die Funktion schreibt weiterhin keine SQLzeile.
|
||||
Es gibt keinen neuen Manifest-/Job-/Handoffcodec und keine Datenmigration.
|
||||
|
||||
Dies schließt eine konkrete Kompatibilitätslücke in einem bereits aufgerufenen
|
||||
Reader: `TrustState::qualify_history` verwendet `verify_history` vor neuer
|
||||
Admission sowie unter dem übernommenen Guard vor dem Austausch. Es ist keine
|
||||
Aussage, dass gleiche Versionsnummern die gesamte tatsächliche Decoderfähigkeit
|
||||
beweisen; diese bleibt Bestandteil der unabhängig qualifizierten Bootstrap- und
|
||||
Releaseartefakte. Eine zukünftige ausdrücklich beauftragte Protokoll- oder
|
||||
Zustandsmigration braucht einen eigenen Vertrag.
|
||||
|
||||
## Weshalb damit noch kein Rollback freigegeben ist
|
||||
|
||||
Im vorhandenen Datenvertrag existiert kein normierter V2-Rückkehrzeuge:
|
||||
|
||||
- `Handoff`, `Event` und `Journal` verstehen nur Schema1 und die Vorwärtsfolge.
|
||||
Ein endgültiges `Unknown` bleibt terminal.
|
||||
- `ActivationEvidence` kennt `Bootstrap` und `Updated` mit positivem Healthbeleg;
|
||||
das Feld `rolled_back` allein authentisiert keine Rückkehrwirkung.
|
||||
- Core verweigert `NativeEffect::RestorePredecessor` sowohl beim Claim als auch
|
||||
bei der Beobachtung. Ein vorhandener Linux-Dateiport ist keine Genehmigung.
|
||||
- History verweigert rückkehrende Records und alte Recorddateien, welche die
|
||||
inzwischen vollständig abgeschlossenen Verbräuche/Publikationen auslassen.
|
||||
|
||||
Der ursprüngliche signierte Job bindet bereits
|
||||
`restore_exact_predecessor_once`. Es fehlen jedoch dessen vollständig gebundene
|
||||
dauerhafte Rückwegphasen, belegter eindeutiger Fehlstart, exklusive Guard-/Owner-
|
||||
Übergabe, jede einzelne native Rückkehrbeobachtung, neuer Prozess-/Healthbeleg,
|
||||
Record-/Floorpublikation und failed-Originaloutcome. Vor erster Applybaseline
|
||||
müssen sämtliche tatsächlich installierten Agent-/General-/Fullreader genau
|
||||
diesen noch fehlenden Vertrag verstehen. Das alte1.20-Paar ist kein Rückkehrziel.
|
||||
Kein paralleles unbeobachtetes Journalformat wird als Ersatz eingeführt.
|
||||
|
||||
## Tatsächliche lokale Prüfungen und Grenzen
|
||||
|
||||
Die neuen Fälle verwenden synthetische, aber echte Ed25519-Release-, Baseline-,
|
||||
Job- und Healthsignaturen samt vollständigen in-memory SQLiteoriginalen. Sie
|
||||
prüfen inkompatible Protokoll- und Zustandsschemas, die unveränderte positive
|
||||
Vorwärtskette, eine vorgeschlagene exakte Vorgängerrückkehr mit erhaltenem
|
||||
höherem Floor sowie gespeichertes Unknown. Vor/nach jeder Readerprüfung bleibt
|
||||
`total_changes` gleich; Unknown-Originalbytes und Floors bleiben erhalten.
|
||||
|
||||
Tatsächlich im vorhandenen isolierten Buildcontainer, Netzwerk aus:
|
||||
|
||||
```text
|
||||
cargo test --release --locked --offline -p rmm-updater-worker --all-targets
|
||||
cargo clippy --locked --offline -p rmm-updater-worker --all-targets -- -D warnings
|
||||
cargo fmt -p rmm-updater-worker --check
|
||||
```
|
||||
|
||||
Abschließender normal paralleler Testlauf:12/12 bestanden,0Fehler,0ignoriert;
|
||||
Clippy und Formatprüfung bestanden. Eine private Quellrückmutation ausschließlich
|
||||
auf den alten selbstreferenzierenden Vergleich macht den neuen signierten
|
||||
Kompatibilitätstest erwartungsgemäß rot: Exit101, `unwrap_err` erhält `Ok`.
|
||||
Die Produktionsquelle wurde hierfür nicht zurückgeändert. Dies belegt den
|
||||
konkreten Readerfehler; es ist keine simulierte Updatewirkung.
|
||||
|
||||
Der erste parallele Lauf hatte10/12 bestanden; zwei vorhandene Selbstprozess-
|
||||
Censusfixtures verweigerten eine während anderer Unitfälle wechselnde FD-Tabelle.
|
||||
Der unveränderte Produktguard bestand im seriellen12er-Lauf. Die beiden Fixtures
|
||||
laufen jetzt je in einem eigenen exakt ausgewählten Testprozess, mit unverändertem
|
||||
Censuscode und echten privaten Thread-FD-/mmap-Proben. Danach bestand der normale
|
||||
parallele12er-Lauf. Der erste Clippylauf fand zwei unnötige Testdatenklone;
|
||||
sie wurden ohne Warnungsunterdrückung entfernt. Alte Fehlerlogs bleiben erhalten.
|
||||
|
||||
Geschützter lokaler Belegpfad:
|
||||
`devstate/updater-history-contract-73511ace-428f-4aaf-8742-720619459907/`.
|
||||
Native Linux-/Windowsqualifikation, Codeaustausch und WebUI-genehmigter Updatejob
|
||||
sind nicht ausgeführt. Frühere native Censusberichte qualifizieren nicht die
|
||||
neue Testbinary. Notebook bleibt ausschließlich Entwicklungsrechner.
|
||||
+57
-1
@@ -1,6 +1,62 @@
|
||||
# Übergabe — Linux-MVP abgeschlossen, Windows wird fortgesetzt
|
||||
|
||||
**15. November 2026.** Der permanente Server betreibt das neue Zeit-Gateway. Migration 15, TLS und Historienvergleich sind abgenommen. Der nächste Windows-Nachweis ist der signierte Abruf mit der Geräteidentität. [Bereitstellungsbeleg](server-time-gateway-deploy.md)
|
||||
**15. November 2026.** Der permanente Server betreibt das Zeit-Gateway.
|
||||
Die Windows-VM hat mit ihrer Geräteidentität die Signatur geprüft. Ein fremder
|
||||
Mandant und eine alte Verbindung wurden abgewiesen. Die Cloud-Linux-VM und
|
||||
der Windowsgast melden sich selbständig und sind über MCP abrufbar.
|
||||
[Gateway](server-time-gateway-deploy.md) · [Windows-Protokolltest](windows-time-route-operator.md)
|
||||
|
||||
Am 15. November liefen auf dem Windowsgast nach dem einmaligen Dienstwechsel
|
||||
der neue Agent unter LocalService und der neue Helper unter SYSTEM. Die
|
||||
separate Nachprüfung bestätigte beide Prozessstarts, das Gerätezertifikat,
|
||||
die Geräteidentität und die bisherigen Journalstrukturen. Der erste Online-Kontakt
|
||||
nach dem Wechsel gelang. Danach wies PostgreSQL den passiven Updatestatus
|
||||
`agent.update` zurück. Der letzte reguläre Kontakt vor der Störung lag um
|
||||
16:17:32 Uhr MEZ. Für die Korrektur wurden auf dem permanenten Server die
|
||||
gefilterte Basisinventarabfrage und Migration 16 aus dem zum laufenden
|
||||
ARM64-Image passenden Builder offline gebaut. Docker meldete Exit 0 für
|
||||
Image `6a76343bf65c` (Buildfall `5ad7c74c-67a1-40b8-8960-d3ba016565af`).
|
||||
Die Migration lief anschließend erfolgreich. Die API arbeitet mit diesem
|
||||
Image. MCP bestätigte zwei neue Windows-Heartbeats um **16:39:46 und
|
||||
16:40:17 Uhr MEZ**, jeweils mit derselben Geräte- und Zertifikatsidentität wie
|
||||
vor dem Dienstwechsel. Die Cloud-Linux-VM meldete sich weiterhin als online.
|
||||
[Dienstwechsel und Telemetrienachweis](windows-signed-clock-upgrade-plan.md)
|
||||
|
||||
Die Erstinstallation des Windows-Zeitprofils ist auf der VM belegt. Der Server empfing zunächst um
|
||||
17:05:36 Uhr MEZ den Fehlercode `0x80070020` beim Verschieben in das
|
||||
Zielverzeichnis. Der Helper hält dort einen Verzeichnishandle, der diesen
|
||||
Schreibzugriff sperrt. Im korrigierten Quellstand erlauben die Handles für
|
||||
das öffentliche Verzeichnis diesen Zugriff. Löschsperre, DACL- und
|
||||
Dateiidentitätsprüfungen bleiben aktiv. Agent und Helper wurden damit für
|
||||
Windows x86-64 gebaut; dieser Build ist noch nicht auf der VM installiert
|
||||
oder dort abgenommen. Beim anschließenden Versuch um 20:24 Uhr MEZ konnte der Gast
|
||||
die neue Zieldatei öffnen. Der Sicherheitsdeskriptor entsprach beim Lesen
|
||||
nicht exakt dem erwarteten Wert. Der Controller stoppte vor dem Schreiben
|
||||
der Profilbytes. Die anschließende Konsolenlesung bestätigte 0 Byte.
|
||||
Eigentümer, Gruppe, DACL-Schutz und alle sechs expliziten Zugriffsregeln
|
||||
stimmten überein. Nur das DACL-Steuerbit für automatische Vererbung (`AI`)
|
||||
fehlte im gelesenen Deskriptor. Um 20:40 Uhr MEZ gelang der Abschluss.
|
||||
Der Gast las die 1177 Profilbytes mit dem erwarteten SHA-256 und derselben
|
||||
Dateikennung zurück, die er vor dem Schreiben festgehalten hatte.
|
||||
Um 20:41 Uhr MEZ bestätigte der Projektserver die ersten zwei getrennten
|
||||
signierten Zeitvergleiche des laufenden Agenten und SYSTEM-Helpers.
|
||||
Die Windows-Skript- und Paketabnahmen stehen aus.
|
||||
[Zeitbelege beider Dienste](windows-passive-time-closeout.md)
|
||||
[VM-Fehlerbeleg und Buildprüfung](windows-time-profile-config.md)
|
||||
|
||||
Die passive Zertifikatserneuerung ist implementiert. Fünf Wiederanlauf- und
|
||||
Fehlerfälle mit Testidentitäten bestanden auch auf Windows. Das Anlegen,
|
||||
Schützen und Wiederöffnen einer separaten Testschlüsseldatei bestand auf
|
||||
der Windows-VM unter dem Entwicklungskonto. Die Erneuerung durch den
|
||||
installierten LocalService-Dienst steht aus.
|
||||
[Zertifikatserneuerung](windows-certificate-renewal.md)
|
||||
|
||||
Der Linux-Agent kann einen signierten Releasekatalog über mTLS prüfen und das
|
||||
Ergebnis im Inventar melden. Sechs gezielte Tests bestanden auf der Cloud-VM.
|
||||
Der Katalogcheck ist im Quellstand integriert. Die laufende Installation hat
|
||||
noch kein Agent-Selbstupdate durchgeführt. [Updatekatalog und offene Schritte](agent-updater-passive-catalog.md)
|
||||
|
||||
## Frühere Zwischenschritte
|
||||
|
||||
**Broker-UDS und echte Signaturen bestanden:** Host und Standard-PIDnamespace-
|
||||
ContainerUID10001 mit getrennten Challenges tatsächlich Ed25519-verifiziert;
|
||||
|
||||
@@ -1,5 +1,28 @@
|
||||
# Tatsächlicher Implementierungsstand
|
||||
|
||||
## Agent-Update-Telemetrie: Migration0016 tatsächlich angewendet — 2026-11-15
|
||||
|
||||
Der permanente Server akzeptiert nun zusätzlich den festen passiven Scope
|
||||
`agent.update`. Regulärer SQLx-Runner aus dem vorhandenen ARM64-Kandidaten6a7634,
|
||||
Exit0 und separate Read-only-Nachprüfung von Version16/Checksum/VALIDATED-Check
|
||||
bestanden. Ursprüngliche Zeilen, RLS/FKs/PK/ACL und Corezeugen erhalten; keine
|
||||
laufenden Dienste durch diesen Schnitt ersetzt. Erste drei regulär angenommene
|
||||
Updatebeobachtungen belegt. API-Basisfilterung ist getrennt. Vorherfingerprints
|
||||
und ausdrücklich erst nachher angelegter privater pg_dump sind dokumentiert;
|
||||
kein vorgetäuschter Vorherbackup-/Restoretest. [Beleg](agent-update-observation-scope.md).
|
||||
|
||||
## Passiver Windows-Zeitabschluss vorbereitet — 2026-11-15
|
||||
|
||||
Ein kleiner rein lesender Collector für die beiden historischen Rollenbelege
|
||||
aus cc82124 ist ausführbar vorbereitet. Er bindet öffentliche Dienstprozesse,
|
||||
Boot, aktuelle Servergeneration, Rollen-/Hashtrennung und enge Datenalter;
|
||||
keine Dienste, IPC, Zeitrequests oder Diagnoseprogramme werden ausgelöst.
|
||||
Lokale Syntax-/Scopeguards und sechs Bindingfixtures bestanden. Der konkrete
|
||||
lokale .NET-/Chrono-Fraktionsparserfehler ist mit exakter Nanosekundenrechnung
|
||||
und +1ns-Grenzfall korrigiert. **Kein VM-Aufruf,
|
||||
keine native Collector-/Rollenabnahme** vor Roots V2-Profil-/Readbacksignal.
|
||||
[Umfang und genaue Grenzen](windows-passive-time-closeout.md).
|
||||
|
||||
## Passiver Windows-Zertifikatspfad — Quellenstand 2026-11-15
|
||||
|
||||
Eigener RotationStore mit geschützten CreateNew-Keydateien und atomarer
|
||||
|
||||
@@ -10,6 +10,7 @@ Pfad bleiben dort sofort relevant.
|
||||
|
||||
| Entdeckung / späteres Thema | Tatsächlicher heutiger Stand | Spätere Aufgabe |
|
||||
| --- | --- | --- |
|
||||
| Gesundheitsübersicht für größere Flotten | Beim Quellabgleich nach der MCP-Abnahme vom 15. November fiel auf, dass `monitoring.get_health` die erste Inventarseite liest und deren Fortsetzungscursor verwirft. Der aktive Testbestand passte auf eine Seite. | Vor Nutzung für größere Mandanten den Cursor für HTTP und MCP durchreichen und den Bezugszeitpunkt beibehalten. `inventory.list_devices` unterstützt bereits Folgeseiten. |
|
||||
| Verfügbarkeit der signierten Serverzeit | Tatsächliche Quellproben derselben laufenden Chronygeneration lieferten50.834ms bei43.596s Syncalter und später295.609ms bei320.110s. Beide gültig; kein kontinuierlicher Verfügbarkeitsnachweis. | Nach dem MVP natürlichen Poll-/Kernel-Fehlerverlauf und Verfügbarkeit messen, gegebenenfalls separat genehmigte Betriebsoptimierung. Fehlende Qualität muss bereits jetzt deny bleiben; keine500ms-Grenzlockerung, erfundene Frische oder implizite Resync-/Konfigurationsänderung. |
|
||||
| Windows-PE nach erneutem Debugstrip | Zwei Lieferkopien mit identischen unveränderten Original-Linkdateien unterscheiden sich nach erneutem Strippen nur an vier Bytes: COFF-Zeitstempel/PE-Prüfsumme, Offsets136/137/216/217. Lokal tatsächlich verglichen; beide ursprünglichen Packs bleiben erhalten. Jeder Pack pinnt seine konkreten Lieferbytes. | Reproduzierbare PE-Werkzeugpipeline vor M7 festlegen. Bis dahin niemals gleichen Lieferhash aus gleicher Rustquelle/gleichem Original-Link behaupten oder ein altes Manifest überschreiben. Kein aktueller Autorisierungs- oder Abnahmebypass. |
|
||||
| Dev-Reversetunnel ohne Zielbanner | Windows-RMM-Heartbeats liefen tatsächlich weiter, während Serverlistener/TCP-Verbindung auf127.0.0.1:22240 vorhanden waren, aber kein SSH-Banner durchkam. Der Bootstraploop überwacht nur das äußere ssh.exe und verbindet nach dessen Ende neu; der Task hat kein RestartOnFailure. Konkrete Ursache des blockierten SSH-Ziels unbewiesen. Keine SSH-/Hostkey-/Expirygrenze gelockert. | Nach dem MVP begrenzte Transport-/Workerdiagnose verbessern. Keine automatische Schlüsselverlängerung, öffentliche Windowsportfreigabe oder pauschalen sshd-/UID-Resets. Der aktuelle manuelle Konsolenneustart bleibt ausdrücklich zeitlich abzustimmen und ist kein RMM-Rebootnachweis. |
|
||||
|
||||
@@ -110,3 +110,37 @@ Die Prüfung des signierten Zeitabrufs aus dem Windowsgast folgt separat.
|
||||
| Nachlese | `b8cc94a9f9ba4d1782e052ef0bf317b5229b9578c646bf393c24b33a9507fab4` |
|
||||
| Historie nach Migration | `cb72a95afc94c9d96ae78a38495e62b59db4598b8ea16996b00d83e2cd6c08a7` |
|
||||
| TLS und öffentliche Zugriffstrennung vor und nach Migration | `f381279d3e5ebbded79b0b3ad587dee09ebf7adbbbf47d9099584f00ddcd95d5` |
|
||||
|
||||
### Wiederverbindung der beiden Geräte
|
||||
|
||||
Nach dem Gatewaywechsel meldeten sich beide bestehenden Geräte selbständig
|
||||
wieder über WSS. Die gespeicherten Daten des Entwicklungsmandanten zeigten am
|
||||
15. November um 12:38 UTC für Linux einen 12 Sekunden alten Kontakt und einen
|
||||
18 Sekunden alten Inventareingang. Für Windows betrugen die Werte 23 bzw.
|
||||
146 Sekunden. Die Verbindungsgenerationen waren 153 und 91. Dafür war kein
|
||||
Live-Auftrag erforderlich. Beleg der lesenden Abfrage
|
||||
`9ce23669ff03a7ec5a08e10437a009a7ae617f472614d161ab082e17c02c2095`.
|
||||
|
||||
Auch die normale MCP-Schnittstelle lieferte beide Geräte im selben Mandanten
|
||||
über `inventory.list_devices`, `inventory.get_device` und
|
||||
`monitoring.get_health`. Linux und Windows standen auf `online`, mit
|
||||
29 bzw. 18 Sekunden seit dem letzten Kontakt. Die Liste enthält außerdem
|
||||
zwei widerrufene Altinstallationen. Die erste Auswertung hatte fälschlich
|
||||
genau zwei Listeneinträge insgesamt erwartet. Die korrigierte Prüfung glich
|
||||
die beiden aktiven Gerätekennungen und den Widerrufsstatus separat ab.
|
||||
Der mandantenweite Gesundheitswert lautete `unknown`. Das Inventar war
|
||||
für beide aktiven Geräte abrufbar. MCP-Beleg
|
||||
`f6fe5ab254c9ca3fad238271601b0f8df2029b6b6138c47ff000d55071ab70cf`.
|
||||
|
||||
Migration 15 hat die beiden Tabellen für Agent-Releases und Updateartefakte
|
||||
auf dem permanenten Server angelegt. Eine lesende Abfrage im PostgreSQL-Katalog
|
||||
bestätigte für beide Tabellen erzwungene Row-Level Security, die Mandantenpolicy
|
||||
und den aktiven Unveränderlichkeits-Trigger. Die Anwendungsrolle darf lesen
|
||||
und einfügen. UPDATE und DELETE sind ihr entzogen. Beide Tabellen waren leer.
|
||||
Beleg `623fe75484f337996e784b24dae0b0be29a4596f2a6842841c7636a99daaf754`.
|
||||
|
||||
Ein zusätzlicher Abruf vom Entwicklungsrechner über den öffentlichen DNS-Namen
|
||||
und Port 443 prüfte den externen Zugang ohne Geräteidentität. TLS wurde gegen
|
||||
die öffentliche CA der Windows-Installation geprüft. POST an die Zeitroute
|
||||
lieferte 401, GET an `/`, `/auth/config` und `/mcp` jeweils 404.
|
||||
Beleg `346c2c60635e52cb758f3e6092f7187a9c35203d1fff3c8f18d1dbca73607607`.
|
||||
|
||||
@@ -260,3 +260,81 @@ Ausgabe und expliziten Root-/SYSTEM-Ausführungsrechten gelegt. Paketabnahmen
|
||||
sind nachgeordnet. Der erneuerte SSH-Bootstrapzugang verleiht selbst keine
|
||||
RMM-Ausführungsrechte und ersetzt keine dieser noch separat nachzuweisenden
|
||||
Genehmigungs- und Ausführungsgrenzen.
|
||||
|
||||
## Manuelles Wartungsfenster am 15. November 2026
|
||||
|
||||
Der Server bestätigte die abgelaufene Freigabe vom 15. November um 13:05:58 UTC.
|
||||
Für die Windows-Entwicklung wurde die Frist desselben Forwarding-Schlüssels auf
|
||||
15:30:00 UTC (16:30 Uhr MEZ) gesetzt. Ein separater SSH-Lesezugriff bestätigte
|
||||
Frist, Hostpin, Schlüsselbindung, SSH-Profil und Konto. Der Port ist serverseitig
|
||||
an Loopback gebunden. Ein einmaliger, aktiver Servertimer für 15:30:00 UTC
|
||||
begrenzt auch eine noch offene Weiterleitung des dedizierten Tunnelkontos dieser
|
||||
Schlüsselgeneration. Das tatsächliche Auslösen des Timers steht noch aus.
|
||||
|
||||
Die Bedienperson öffnet das Fenster in der VM-Konsole mit
|
||||
`deploy/windows/Open-ConsoleMaintenanceWindow.ps1`; Parameter sind
|
||||
`-PreviousExpiry '2026-11-15T13:05:58+00:00' -Until '2026-11-15T15:30:00+00:00'`.
|
||||
Während der einmaligen SSH-Verbindung pausiert das Skript den vorhandenen
|
||||
Autostarttask. Bei normalem Ende oder Strg+C beendet es den Client und stellt die
|
||||
vorherigen Fristen und den Task wieder her. Bei hartem Abbruch oder VM-Ausfall
|
||||
den Zustand über die Konsole prüfen. Lokales PowerShell-Parsing bestanden.
|
||||
VM-Ausführung, SSH-Readback und Dienstwechsel stehen bei Veröffentlichung aus.
|
||||
Die WebUI-Freigabe für Agentjobs gilt weiterhin.
|
||||
|
||||
Das manuell geöffnete Fenster wurde anschließend vom Entwicklungsrechner über
|
||||
die bestehende gepinnte SSH-Verbindung bis zum Windows-Gast geprüft. Die
|
||||
Kontofrist und die Frist in der Bootstrapkonfiguration ergaben beide
|
||||
15:30:00 UTC. Der Gast bestätigte den Servernamen und den deaktivierten
|
||||
Autostarttask. Beide installierten Dienste liefen beim Readback mit ihren
|
||||
bisherigen Prozess-IDs: Agent 5528 als LocalService, Helper 9464 als LocalSystem.
|
||||
Danach wurde die Ablaufzeit im lokalen Zugangsdatensatz an die geprüfte
|
||||
Gastfrist angepasst. Dies ist der Nachweis für den Entwicklungszugang.
|
||||
|
||||
### Unterbrechung nach Ruhezustand des Notebooks
|
||||
|
||||
Das Hostjournal belegt Suspend zwischen 14:48:24 und 15:39:01 Uhr MEZ.
|
||||
Danach blieb die Windows-VM im KVM-Status `running`. Der Entwicklungszugang
|
||||
lieferte bei der SSH-Begrüßung einen Timeout. Auch direkt am bestätigten
|
||||
Loopback-Listener des Servers kam keine Begrüßung an. Um 15:47 Uhr wurde
|
||||
nur die anhand von Konto, Prozess und Listener erneut identifizierte alte
|
||||
Forwarding-Sitzung geschlossen. Schlüssel und vereinbarte Frist von
|
||||
16:30 Uhr MEZ blieben erhalten. Zum erneuten Aufbau ist die VM-Konsole nötig.
|
||||
|
||||
Der Produktagent meldete sich nach dem Resume beim permanenten Server. MCP
|
||||
lieferte bei der Abfrage um 15:48 Uhr MEZ für den Windows-Gast `online`,
|
||||
Quelle `windows.base`, letzter Kontakt 15:47:51 Uhr MEZ. Beim Unterbruch war
|
||||
der Dienstwechsel noch nicht in die Ausführungsphase gelangt.
|
||||
|
||||
Eine weitere reine MCP-Abfrage bestätigte das nach dem Aufwachen neu
|
||||
eingegangene Windows-Inventar. Beobachtungszeit 15:39:13 Uhr MEZ, späterer
|
||||
Kontakt 15:52:23 Uhr MEZ. Betriebssystem, Volumes, Hardware und Software
|
||||
lagen jeweils als `valid/partial` vor. CPU-Anzahl, Verhältnis von freiem zu
|
||||
gesamtem Speicher und die Volumenwerte bestanden die Plausibilitätsprüfung.
|
||||
Windows-Inodes waren ausdrücklich `unsupported` mit leerem Zahlenwert.
|
||||
Beleg-SHA-256 `cce907d4c5e4ca9b788bab4aad8aac1f082b59f6a2922484289f19be061a1162`.
|
||||
Die Abfrage nutzte gespeicherte Telemetrie und erforderte keine SSH-Verbindung.
|
||||
|
||||
Beim erneuten Konsolenstart meldete der Gast die Sammelmeldung
|
||||
`Unexpected account, task, server or previous expiry.`. Sie stammt aus der
|
||||
Vorprüfung vor der ersten Änderung. Welcher Gastwert abweicht, steht bis zum
|
||||
Konsolen-Readback offen. Die Serverfrist wurde zu diesem Zeitpunkt nochmals
|
||||
mit 15:30 UTC bestätigt. Neuere Versionen des Konsolenskripts benennen die
|
||||
abweichenden Felder einzeln. Drei lokal simulierte Vorprüfungen bestanden
|
||||
(Ausgangszustand, drei abweichende Werte, alle sechs Bedingungen abweichend).
|
||||
|
||||
Der Konsolenreadback vom 15. November um 15:59:11 Uhr MEZ ergab
|
||||
`Disabled`, aktives Konto, Konto und Konfiguration beide mit Frist 16:30 Uhr
|
||||
MEZ, passender Servername, laufender sshd und genau eine ausstehende Sicherung.
|
||||
Der Bediener kann diesen konkreten Zustand mit `-ResumeInterrupted` im selben
|
||||
Zeitfenster übernehmen. Das Skript prüft die ursprüngliche Frist der Sicherung
|
||||
und rekonstruiert daraus die aktuelle Konfiguration. Bereits laufende
|
||||
Wartungsprozesse verhindern einen Doppelstart. Bei regulärem Ende verwendet
|
||||
es die ursprüngliche Sicherung zur Rücksetzung. Lokaler Parser- und Fixturetest
|
||||
für passende Sicherung, aktiven Prozess, Konfigurations- und Fristabweichungen
|
||||
bestanden. Die Wiederaufnahme muss auf der Windows-Konsole erfolgen.
|
||||
|
||||
Um 16:04:25 Uhr MEZ war der Windows-Gast über die vom Bediener wieder
|
||||
geöffnete Verbindung erreichbar. Der Gast bestätigte für Konto und Konfiguration
|
||||
denselben Ablauf um 16:30 Uhr MEZ, den erwarteten Servernamen und den
|
||||
deaktivierten Autostarttask. Agent und Helper liefen weiterhin mit ihren
|
||||
ursprünglichen PIDs 5528 und 9464 als LocalService beziehungsweise LocalSystem.
|
||||
|
||||
@@ -8,17 +8,17 @@ Quellen-/Build-/Unitnachweis wird nicht als laufender Dienst-/Jobnachweis ausgeg
|
||||
|
||||
| Bereich | Tatsächlich implementiert/nachgewiesen | Was konkret noch fehlt / warum |
|
||||
| --- | --- | --- |
|
||||
| Passive Windowsverwaltung | Laufender LocalService-Agent, Enrollment/mTLS, WSS/HTTPS/Fallback, Inventar/Heartbeats und Tenanttrennung nativ bestanden. | Zertifikatsrotation und Widerruf noch getrennt auf Windows abnehmen. |
|
||||
| Passive Windowsverwaltung | Laufender LocalService-Agent, Enrollment/mTLS, WSS/HTTPS/Fallback, Inventar/Heartbeats und Tenanttrennung nativ bestanden. Die passive Zertifikatserneuerung ist implementiert. Fünf Tests mit separaten Zertifikaten bestanden auf der Cloud-Linux-VM und auf Windows 11. | Echte Erneuerung durch den LocalService-Dienst mit einer separaten Testidentität und anschließender Wiederverbindung sowie ein eigenständiger Widerrufstest fehlen. [Zertifikatsnachweise](windows-certificate-renewal.md) |
|
||||
| SYSTEM-Trennung | Helper läuft als SYSTEM/Manual; Pipe-v2, gegenseitige Prozess-/Image-/Dateibindung und echte LocalService-Probe bestanden. | Unabhängiger signierter Laufzeitsync und erste genehmigte SYSTEM-Wirkung; die frühere Peerprobe-Störung ist kein aktueller offener Blocker. |
|
||||
| Skriptkonsole | MCP-Antrag, feste Bytes/Plan/WebUI, PowerShell5.1/RemoteSigned-Prozessprofil, Vollwartungsprofil und Ausgabe-/Prozessgrenzen implementiert; native Windows-Vertragsunits bestanden. Linux-UID0-Vollwartungsjob tatsächlich bestanden. | Neue Windowsruntime noch nicht installiert/qualifiziert; erste WebUI-genehmigte LocalService-/SYSTEM-Skripte, tatsächliche Ausgabe und Fehlerverhalten offen. Der laufende Windowsclient bleibt passiv/0Jobs. |
|
||||
| Zeitvertrauen | Signierter Codec, getrennte Agent-/Helperprüfung und ausdrückliches aktives KVM-OS-Profil1.23 implementiert; Linux-first und Windows-Rohcapture belegt. Echter Chronyprovider, einmaliger genehmigter Neustart/Pin, Brokerstart und zwei echte Ed25519-Signaturen samt Container-PID0/Root-Deny bestanden. | Sichere W32Time-Dienstidentitätsbindung erwies sich auf dieser VM als nicht qualifizierbar. Genehmigte Alternative löst den Entwurfsblocker; HTTPS/mTLS-Zeitroute, neue Paarinstallation, geschützte öffentliche Zeitkonfiguration und zwei unabhängig bereite Windowsrollen bleiben native Integrationsarbeit. Keine erfundene Timerkalibrierung. |
|
||||
| Zeitvertrauen | Signierter Codec, getrennte Agent-/Helperprüfung und ausdrückliches aktives KVM-OS-Profil1.23 implementiert; Linux-first und Windows-Rohcapture belegt. Auf dem permanenten Server läuft das Zeit-Gateway. Die Windows-VM prüfte über ihr Gerätezertifikat eine echte signierte Antwort (200). Fremder Mandant (403), alte Verbindung (409) und öffentlicher Zugriff ohne Geräteidentität (401) wurden abgewiesen. | Der HTTPS-Nachweis stammt aus einem separaten Prüfprozess im Gast. Agent und Helper müssen jeweils selbst eine neue Antwort mit ihrem aktuellen Dienst- und Verbindungskontext prüfen. Dafür fehlen auf der VM noch das neue Dienstpaar und die geschützte Zeitkonfiguration. |
|
||||
| Dienst-/MSI-Aktionen | Typisierte SCM-/MSI1.0→1.1-Verträge, getrennte SYSTEM-Policies, Runtime-/Nachbedingungsquellen und native Vertragsunits vorhanden. | Nach Zeit-/Syncbereitschaft je eigene WebUI-genehmigte Dienst- und MSI-Installation/Upgrade/Noop mit echten unabhängigen Nachbedingungen. Keine allgemeine EXE-/OSupdatefreigabe aus Fixtures. |
|
||||
| Strukturierte Eventlogs | Begrenzter Provider-/Worker-/UI-Vertrag und native Vertragsunits vorhanden. | Eigenständig geprüfter Prozess-/Clockkontext des Kindworkers und echte genehmigte Live-Abfrage offen; Parentclock darf nicht als fremder Prozessbeleg verwendet werden. Genehmigte PowerShell-Skripte sind für Logwartung zusätzlich vorgesehen. |
|
||||
| Dauerhafte Windowsjobs | Gemeinsamer Einmalverbrauch, Journale, Dispatch/Abandon/RawMirror und Fehlerverträge implementiert. | Redelivery/ACK-Verlust, Crash/Unknown, Ablauf/Entzug, Reconnect und gemischter Linux-/Windowsplan am echten aktivierten Windowsdienst nachweisen. Linuxerfolge ersetzen diese OS-Nachweise nicht. |
|
||||
| Agent-Selbstupdate | Signierte Codepaare/Releasekatalog, eigene Artefaktstreams, WebUI-Plan, Handoff/Health und Readercensus im Quellpfad; lokale und ausgewählte native Linuxfixtures bestanden. | Ausgelieferter Worker/Full-Admission/Staging, kompatible erhaltende erste Baseline, unklare Record-I/O-Adjudikation und V2-Code-Rückweg fehlen; danach tatsächlicher genehmigter Linux-Apply, anschließend Windows. APT/MSI-Fixtures aktualisieren nicht den Agenten. |
|
||||
| Agent-Selbstupdate | Signierte Codepaare/Releasekatalog, eigene Artefaktstreams, WebUI-Plan, Handoff/Health und Readercensus im Quellpfad; lokale und ausgewählte native Linuxfixtures bestanden. Der passive [Linux-Katalogcheck](agent-updater-passive-catalog.md) ist integriert und mit sechs Fällen auf der Cloud-VM geprüft. | Ausgelieferter Worker/Full-Admission/Staging, kompatible erhaltende erste Baseline, unklare Record-I/O-Adjudikation und V2-Code-Rückweg fehlen; danach tatsächlicher genehmigter Linux-Apply, anschließend Windows. APT/MSI-Fixtures aktualisieren nicht den Agenten. |
|
||||
| Auslieferung/Betrieb | Windows-GNU-Artefakte gebaut und bestimmte Binaries nativ ausgeführt; Verwaltung bleibt SSH-Tunnel, keine öffentliche Dev-Anmeldung. | MSVC-/signierter Installer und eigenständige native Installer-/Reboot-/Lifecyclebelege offen. Produktiver IdP/MFA/HA/Restore sind zusätzliche Betriebsreife, keine bestandene MVP-Produktionsfreigabe. |
|
||||
|
||||
Aktuelle Detailbelege: [Zeitbrokerstart](server-time-broker-start-acceptance.md),
|
||||
Aktuelle Detailbelege: [Windows-Zeitabruf](windows-time-route-operator.md), [Gatewaybereitstellung](server-time-gateway-deploy.md), [Zeitbrokerstart](server-time-broker-start-acceptance.md),
|
||||
[Signaturen](server-time-broker-signature-acceptance.md),
|
||||
[OS-Zeitprofil](windows-trusted-os-clock-source.md),
|
||||
[Pipe-v2](windows-system-pipe-upgrade.md),
|
||||
|
||||
@@ -0,0 +1,190 @@
|
||||
# Lesender Abschluss zweier passiver Windows-Zeitbeobachtungen
|
||||
|
||||
Der Collector `deploy/windows/passive_time_closeout.py` ist lokal vorbereitet
|
||||
und ausführbar. Der native Abschluss über den auf dem Server laufenden Empfänger ist unten dokumentiert. Die
|
||||
V2-Profileinrichtung und ihr ausdrücklich gemeldetes Zeitfenster stehen vor
|
||||
dem Aufruf. Tunnel-/Zugangserneuerung, Profileinrichtung und Dienstwartung sind
|
||||
keine Aktionen dieses Collectors.
|
||||
|
||||
Der unabhängige Quellreview von `cc821246ccd98ee6d3dc5c1b12c7303d3010e8a7`
|
||||
fand im engen Veröffentlichungsdelta keine konkrete Regression. Der Agent hält
|
||||
pro Verbindung den ersten Vergleich je Rolle erst nach erfolgreichem eigenen
|
||||
`complete` bzw. authentifiziertem Helper-`TimeCompleted` fest. Nur der aktuelle
|
||||
Verbindungsowner schreibt beim Heartbeat. Ein verworfener Worker erhält keinen
|
||||
Publikationspfad. Die JSONs sind historische Beobachtungen, keine aktuellen
|
||||
Clockleases, Jobfreigaben oder unabhängig erneut verifizierbare Signaturpakete.
|
||||
|
||||
Auf der Windows-VM liest der Collector ausschließlich die Inhalte von
|
||||
`C:\ProgramData\RustDiscovery\state\agent-time-sample.json` und
|
||||
`helper-time-sample.json`, jeweils höchstens8192Bytes, durch gehaltene Handles.
|
||||
Singlelink, Nicht-Reparse, Dateigröße, native FileID/LastWrite und die
|
||||
SYSTEM-/Administratoren-/Agent-Service-SID-DACL werden geprüft. Die
|
||||
Verzeichnis-DACL und Dateisicherheit müssen während des Reads gleich bleiben.
|
||||
Reparse-Vorfahren werden verweigert. Keine privaten Schlüssel-, Journal- oder
|
||||
Konfigurationsinhalte werden gelesen. Kurze gehaltene Lesehandles können einen
|
||||
gleichzeitigen atomaren Reporttausch vorübergehend verweigern; der bestehende
|
||||
Publisher behält den Sample für einen späteren Heartbeat.
|
||||
|
||||
Vor und nach diesem Read werden ausschließlich öffentliche CIM-/SCM- und
|
||||
native Prozessmetadaten geprüft: beide festen Dienste Running, richtige
|
||||
Konten/Startarten/Kommandos, Agent-/Helper-PID und Geburt, tatsächlicher
|
||||
Prozessimagepfad und erwartete öffentliche Binaryhashes. Der Boot wird aus
|
||||
demselben festen CIM-LastBootUpTime-Vertrag wie im Agenten abgeleitet. Es wird
|
||||
kein Agent-, Helper-, SQLite-/Statusprobeprogramm oder IPC aufgerufen. Die
|
||||
vorhandenen streng gepinnten Bootstraptransporte werden nur lesend verwendet;
|
||||
C#-Interop enthält lediglich Query-APIs.
|
||||
|
||||
Der bestehende `time_route_context` liest davor und danach ausschließlich den
|
||||
öffentlichen registrierten Gerätekontext in einer Read-only-SQL-Transaktion
|
||||
und die feste Gateway-/Serverbootbindung. Die beiden Serverzeugen müssen
|
||||
identisch sein. Die Capabilitymenge muss exakt passiv bleiben. Beide Reports
|
||||
brauchen dieselbe positive aktuelle Serververbindungsgeneration und denselben
|
||||
aktuellen Windows-Boot; ihre Agent-PIDs müssen dem aktuellen Agentprozess
|
||||
entsprechen. Rollen, Feldschema und Datentypen sind exakt; doppelte JSONkeys
|
||||
werden bereits beim Rohparse verweigert. Verifier-UUID, Request- und
|
||||
Response-SHA256 müssen zwischen den Rollen verschieden sein.
|
||||
|
||||
Die Beobachtung muss nach der von Root belegten V2-Einrichtung und nach der
|
||||
aktuellen Agentgeburt liegen. Beobachtungs- und Dateialter sind höchstens180s;
|
||||
Publikationsverzug höchstens90s bei2s Zukunftstoleranz. Der aktuelle Windows-
|
||||
UTC-Read muss höchstens10s vom lokalen Operatorzeitpunkt abweichen. Dies sind
|
||||
Akzeptanzgrenzen für historische Daten, keine behauptete native Zeitgenauigkeit.
|
||||
Fehlende/stale Belege und ein Generationenwechsel erlauben nur neue Readversuche.
|
||||
Das Wartefenster beträgt180s; ein bereits begonnener vollständiger Readsatz
|
||||
hat zusätzlich höchstens105s Transportbudget. Ein Timeout erzeugt einen
|
||||
unvollständigen eigenen Beleg, niemals eine erfolgreiche Abnahme.
|
||||
|
||||
Lokale private Fälle entstehen unter `devstate/windows-passive-time-closeout/`.
|
||||
Rohantworten stehen vor ihrer Validierung auf dem lokalen Datenträger;
|
||||
Acceptancereceipts binden die aktuellen Native-/Serverzeugen per SHA256. Die
|
||||
Befehlsparameter für den späteren Aufruf sind die tatsächlich installierten,
|
||||
qualifizierten Agent-/Helperhashes und Roots UTC-Untergrenze nach der
|
||||
V2-Einrichtung. Keine frei wählbaren Guestpfade, Aktionen oder Abfrageprogramme.
|
||||
|
||||
**Geplant, nicht ausgeführt:**
|
||||
|
||||
```text
|
||||
python3 deploy/windows/passive_time_closeout.py collect \
|
||||
--agent-sha256 <tatsächlich-installierter-qualifizierter-SHA256> \
|
||||
--helper-sha256 <tatsächlich-installierter-qualifizierter-SHA256> \
|
||||
--profile-after <Roots-tatsächliche-V2-Einrichtung-UTC-mit-Z>
|
||||
```
|
||||
|
||||
Tatsächlich lokal ausgeführt und bestanden:
|
||||
|
||||
```text
|
||||
python3 -m py_compile deploy/windows/passive_time_closeout.py
|
||||
python3 deploy/windows/passive_time_closeout.py guards
|
||||
python3 -m unittest discover -s deploy/windows -p test_passive_time_closeout.py
|
||||
```
|
||||
|
||||
Sechs lokale Fixtures prüfen aktuelle unabhängige Rollen, falsche PID/Boot/
|
||||
Generation/Rolle/Beobachtungsfrist, gleiche Verifier-/Request-/Responsewerte,
|
||||
doppelte JSONfelder, fehlende Sicherheitsprüfung und fehlenden Helperbeleg.
|
||||
Der zusätzliche Grenzfall prüft die tatsächlichen sieben .NET- und neun
|
||||
Chrono-Nachkommastellen. Python3.10s ursprüngliches `fromisoformat` verweigert
|
||||
diese Formen; dieser konkrete lokale Fehler wurde vor jedem Zielaufruf
|
||||
behoben. UTC- und FILETIME-Grenzen werden jetzt vollständig mit Ganzzahl-
|
||||
Nanosekunden verglichen. Ein Sample genau an der Installationsuntergrenze wird
|
||||
akzeptiert, eine um1ns spätere Untergrenze verweigert dasselbe Sample. Keine
|
||||
Native- oder Testzeit wird hierfür erfunden.
|
||||
Danach lokal mit vorhandenem `/tmp/rmm-powershell-parser/pwsh` tatsächlich
|
||||
ausgeführt: vollständiger Reader-AST ohne Parserfehler und Kompilierung der
|
||||
C#-Querydefinitionen ohne Methodenaufruf bestanden. `Info` besitzt die
|
||||
erwartete52-Byte-Interopgröße. Lokale Quittung unter
|
||||
`devstate/windows-passive-time-closeout-local/receipt.json`; kein nativer
|
||||
Win32-Aufruf oder VM-Zugriff. Windows-PowerShell5.1-/tatsächliche Win32-Reads
|
||||
und echte Rollenbelege bleiben offen; lokale Prüfungen ersetzen sie nicht.
|
||||
|
||||
Der konkrete Profileinsatz wurde zusätzlich unabhängig rein im Quellcode
|
||||
geprüft (`time_profile_config.py`, SHA256
|
||||
`36f0451a146ca8dc73d4c66b48f2e65fbaefde5c7643133993d1c136cc3318de`).
|
||||
Kein konkreter Befund im geprüften Schnitt: getrennte öffentliche Source-/
|
||||
Plattform-/Key-/Bindingketten, exakte neue Rollen mit PID/Geburt/Token-/Service-
|
||||
SID/Image/FileID, SameLive-/Kernel-CAS vor und nach Veröffentlichung,
|
||||
Intent-vor-ACL/Move, überschreibungsfreier gleichvolumiger Move und ausschließlich
|
||||
ThisFolderOnly-Leserechte für die zwei Rollen. Die UTC-Untergrenze wird vor
|
||||
dem ersten privaten Fallintent aufgezeichnet. Noch ungesetzte Paarbeleg-
|
||||
Konstanten blockieren die Vorbereitung. Der konkrete spätere Rollen-/
|
||||
Readbackbinding-Delta und die tatsächliche Veröffentlichung bleiben separat
|
||||
nachzuweisen. Dieser Review ist keine Profileinrichtung oder native Abnahme.
|
||||
|
||||
Im laufenden Wartungsfenster folgte ein enger unabhängiger Quellreview des
|
||||
konkreten SCM-ETS-Fixes (Clockoperator-SHA256
|
||||
`90c2708c17903e4bc630f6655dba38ff6448251941abd53f5874e991042b0f2c`).
|
||||
Die tatsächlich gelesenen Int32-SID-Typen trugen PowerShell-ETS-Metadaten und
|
||||
wurden vom bisherigen `PSCustomObject`-Zweig als Objekt behandelt. Der Fix
|
||||
behandelt die primitiven CLR-BaseObjects zuerst und rekonstruiert reine
|
||||
JSONskalare. Stringcase und vollständige Integerwerte bleiben erhalten;
|
||||
NaN/Infinity werden verweigert. Arrayreihenfolge, Null, Keykollisions-/Tiefe-
|
||||
und Wirkungs-CAS bleiben unverändert. Keine weiteren konkreten Findings im
|
||||
geprüften Schnitt. Derselbe vollständige Comparator wurde im Profiloperator
|
||||
SHA256 `8588241eac3036e665b6010e4bf9fac1547be88d68f95b4c02cb24e425267c68`
|
||||
per reinem AST-Literalvergleich bytegleich bestätigt. Das ist ausschließlich
|
||||
Source-Review, kein Zielaufruf oder Beleg einer ausgeführten Wartung.
|
||||
|
||||
Falls Reports fehlen, können die bereits vorhandenen passiven Dateien
|
||||
`helper-probe.json` und `pipe-last-error.json` getrennt nur lesend bei der
|
||||
Pipeeingrenzung helfen. Sie enthalten keinen vollständigen Timeworkerfehler;
|
||||
auch Metadaten vorhandener fester `.agent-time.pending`/`.helper-time.pending`
|
||||
können eine unterbrochene Publikation erklären. Dieser Collector liest oder
|
||||
ändert diese zusätzlichen Dateien nicht und löst keine Diagnose aus.
|
||||
|
||||
### Nativer Abschluss am 15. November 2026
|
||||
|
||||
Der Empfänger auf dem permanenten Server prüfte um **20:41:27 Uhr MEZ**
|
||||
beide nach der Veröffentlichung des Profils entstandenen Belege. Der Agent
|
||||
beobachtete seinen Vergleich um `19:40:52.455414900Z`, der SYSTEM-Helper
|
||||
seinen um `19:40:52.524631100Z`. Beide gehörten zu Verbindungsgeneration 145
|
||||
und demselben Windows-Boot. Verifier-UUIDs und die Hashes der beiden
|
||||
Anfragen und Antworten unterschieden sich. Der Agent hatte PID 4420, der
|
||||
Helper PID 10264. Die Serverzeugen vor und nach der Lesung stimmten überein.
|
||||
|
||||
Fall `c23245b7-017e-4643-9872-849f262faf21`, Lesung 36. Der SHA-256 des
|
||||
empfangenen Datensatzes lautet
|
||||
`40d45a9cb3145f8b1159b7c5da0509dd043355aca23d4bec860f37205e3a8551`,
|
||||
der des Abschlussbelegs
|
||||
`f1a79eed223487fa61890ccb274986660b33f2596ae33e1689e9b2afdc7b8884`.
|
||||
Beim separaten Rücklesen stimmten die zwei ursprünglichen Rollenberichte
|
||||
mit den validierten Einträgen überein. Der Server führte weiterhin nur
|
||||
`windows.base/1`, `heartbeat/1` und `agent.update/1`. Für einen späteren
|
||||
Auftrag muss die Uhr beim Prüfen des Grants erneut die Frischegrenzen erfüllen.
|
||||
|
||||
### Konsolenlesung des nachfolgenden Dienstpaars
|
||||
|
||||
`deploy/windows/Read-JobPairTimeSamples.ps1` bindet den ursprünglichen Leser
|
||||
mit SHA-256 `d9e2b9344c19af1296b86ec70ba754ef820f369ac5ec897979bd4233e0722d04`
|
||||
an den Paarfall `49c230d8-fb5d-4c64-96b6-e0edce03ed90`. Vor dem Aufruf
|
||||
muss die tatsächliche Verbindungsgeneration auf dem Projektserver gelesen
|
||||
werden. Der Wrapper prüft die aktuelle Profilquittung und die Prozessgeburt
|
||||
beider Dienste, die Rechte und Dateikennungen anhand der Leserausgabe,
|
||||
den CIM-Bootbezug, die zwei unterschiedlichen Rollen und die Frische der
|
||||
ungeschmälerten Originalreports. Bei fehlenden oder alten Beispielen liest
|
||||
er bis zu zwei Minuten erneut. Für einen bereits laufenden Leseprozess
|
||||
gilt ein maximales Einzelbudget von 30 Sekunden.
|
||||
|
||||
**Geplanter Aufruf als Administrator auf dem Gast:**
|
||||
`Read-JobPairTimeSamples.ps1 -Generation <aktuelle Servergeneration>`.
|
||||
Der unveränderte `Read-PassiveTimeSamples.ps1` muss daneben liegen. Die
|
||||
lokale Quittung entsteht je Aufruf einmalig als
|
||||
`samples-passive-<Sitzungs-ID>.json` im Paarfall. Sie enthält die
|
||||
Originalreports in Base64, ihre SHA-256, Sicherheits-/Dateimetadaten und
|
||||
Prozesszeugen. Die Konsolenausgabe nennt den SHA-256 der Quittung. Für
|
||||
die vollständige Abnahme muss der Betreiber danach die identische
|
||||
Servergeneration und denselben Windows-Boot sowie die Zeit des Reads
|
||||
unabhängig anhand der Serveruhr bestätigen. Der Wrapper meldet seinen
|
||||
lokalen Befund, ohne eine serverseitige Prüfung zu behaupten.
|
||||
|
||||
`-AfterRestart` verlangt die Geburt eines später gestarteten Agentprozesses
|
||||
und aktuelle Belege für genau diese Instanz. Der Build `fcec400` publiziert
|
||||
die Dateien jeweils beim ersten erfolgreichen Vergleich einer **passiven**
|
||||
Verbindung. Nach Umschaltung auf Jobbetrieb müssen Job-Sync und
|
||||
Startgrant die aktuelle Freigabe belegen. Dateien aus einem früheren
|
||||
Prozess können diesen Nachweis nicht erbringen.
|
||||
|
||||
Lokal bestanden die Parserprüfung, je ein unverändertes Fixture für Agent
|
||||
und Helper sowie neun Ablehnungsfälle für doppelte Felder, falschen Typ,
|
||||
PID, Boot, Rolle, Generation, Schema und Zeitgrenzen. Die Boot-ID stimmte
|
||||
mit dem vorhandenen Python-Prüfer überein. Zeitvergleiche unterschieden
|
||||
eine Nanosekunde auch bei der neunstelligen Rust-Ausgabe. Die lokale Prüfung
|
||||
enthielt keine Ausführung des Lesers auf dem Windowsgast.
|
||||
@@ -63,3 +63,140 @@ Produktquellen erzwingen keine neue native Ausführung und verhindern ihren
|
||||
Readback nicht. Neue Starts benötigen weiterhin die exakt qualifizierten
|
||||
aktuellen Quellen. Vollständige Ausgaben/Transportfehler bleiben privat,
|
||||
Standardausgabe enthält nur Status, Fallkennung und Nachweishashes.
|
||||
|
||||
### MCP-Planprüfung nach dem nativen Zeitvergleich am 15. November 2026
|
||||
|
||||
Um 20:44 Uhr MEZ las MCP die Windows-VM über ihre bestehende Geräteidentität
|
||||
als online. Sie meldete über WSS weiterhin `windows.base/1`, `heartbeat/1`
|
||||
und `agent.update/1`. Ein erster lesender Vorabcheck brach vor der Planung
|
||||
ab, weil er für diese passive Verbindung fälschlich `sync_ready=false`
|
||||
erwartete. Der Gateway setzt beim Hello ohne `rmm.sync.v1` den Wert
|
||||
`sync_required=false` und damit `sync_ready=true`. Ein signierter
|
||||
Job-Sync ist daraus nicht abzuleiten.
|
||||
|
||||
Um 20:44:47 Uhr MEZ wies `operations.plan` für genau diese Windows-VM eine
|
||||
PowerShell-Ausgabe einer festen Textzeile unter `agent_service` mit dem Profil
|
||||
`powershell_51_remote_signed` als `UNSUPPORTED_CAPABILITY` zurück. Der
|
||||
Windows-Agent veröffentlicht weder die Skript- noch die Profilfähigkeit.
|
||||
Vor und nach der Plananfrage standen Jobs, Outbox-Einträge, Ausführungspermits
|
||||
und offene Jobs dieses Geräts jeweils auf null. Es erfolgte kein Submit.
|
||||
MCP-Korrelations-ID `b87605ab-69ce-4697-b9ed-9f5b1eeba22c`,
|
||||
Beleg-SHA-256 `0df80d11f7e0ef5e300c4c9657dca3850dad839582b3ba945c1e69795fc68ecc`.
|
||||
|
||||
Für die erste erfolgreiche Skriptabnahme braucht der Dienst die an das Gerät
|
||||
gebundene Jobkonfiguration, qualifizierte Profilfähigkeit, signierten
|
||||
Auftragsabgleich und beim Start erneut frische Zeitbelege. Darauf folgt der
|
||||
unveränderliche Antrag mit Genehmigung in der WebUI.
|
||||
|
||||
### Erster LocalService-Auftrag, Stand 15. November 2026, 21:44 Uhr MEZ
|
||||
|
||||
Der gemeinsame Abnahmelauf kennt jetzt den festen Fall `windows_hello`.
|
||||
Er adressiert ausschließlich die bestehende Windows-Test-VM. Das Skript
|
||||
`Write-Output 'Zeitprofil-Test'` und die erwartete Ausgabe enden jeweils
|
||||
mit CRLF. Der Plan bindet `agent_service` und
|
||||
`powershell_51_remote_signed`. Der Browser prüft diese Angaben am gespeicherten
|
||||
Plan und die sichtbare Prozessoption vor der Freigabe. Der Ergebnisvergleich
|
||||
fordert neben Exit 0 und vollständiger Ausgabe auch die LocalService-SID,
|
||||
den Skripthash und den prozessgebundenen Policybeleg. Die vorhandenen
|
||||
Prüfungen für das Pending, den Freigabeaudit und die Anzahl der Startpermits
|
||||
gelten für diesen Fall.
|
||||
|
||||
Lokal bestanden beim Browser-Planvergleich ein positiver und elf negative
|
||||
Fälle. Der Python-Lauf prüfte den festen Planinput, eine passende
|
||||
Ergebnisquittung und neun abweichende Ergebnisse. Beim ersten lokalen
|
||||
Negativlauf fing der Test eine andere Ausnahmeklasse ab als der Prüfer
|
||||
warf. Der korrigierte Lauf mit dem gemeinsamen Abnahmefehler bestand.
|
||||
|
||||
Tatsächlich ausgeführt wurde
|
||||
`python3 deploy/cloud_mvp_acceptance.py --case windows_hello --execute-dev-test-ui`.
|
||||
Der Lauf stoppte vor der Planung bei `actual_vm_capability_required`.
|
||||
Der gespeicherte MCP-Kontakt um 21:42:59 Uhr MEZ war online, die
|
||||
Verbindungsgeneration betrug 146. Das Gerät meldete seine drei passiven
|
||||
Fähigkeiten. Jobs, Outbox, Permits und offene Aufträge standen auf null.
|
||||
SHA-256 des serverseitig nachgelesenen Zustands im lokalen Beleg
|
||||
`fd0c9af5f4df03a655fcb491212eb62c7777182f02a4e0a69633e5602985943c`.
|
||||
Um 21:44:08 Uhr MEZ bestätigte eine lesende Transaktion für dieselbe
|
||||
Generation `sync_required=false`, `sync_ready=true`,
|
||||
`helper_sync_ready=false` und null Sync-Checkpoints. Ein neuer Plan,
|
||||
eine WebUI-Genehmigung und eine Windows-Ausführung stehen aus.
|
||||
|
||||
Der Browser erreichte um 21:46 Uhr MEZ die echte, private WebUI des
|
||||
Projektservers über deren SSH-Weiterleitung mit TLS-Prüfung. Anmeldung,
|
||||
sichtbare Kennzeichnung `SIMULIERT` und Abmeldung als
|
||||
`simulated-testprincipal-a` gelangen. Die Sitzung meldete
|
||||
`approval_origin=dev_test_browser_simulation` und `testsimulation=true`.
|
||||
Der Server lieferte das Frontend-Bundle `index-CTgvl2jr.js` mit der
|
||||
PowerShell-Profilanzeige. Der Browser öffnete und genehmigte bei diesem
|
||||
Zugangscheck keinen Antrag.
|
||||
|
||||
### Cloud-Linux-Nachweis für die explizite Profilaktivierung
|
||||
|
||||
Am 15. November 2026 um 21:54:37 Uhr MEZ bestand auf der festgelegten
|
||||
Cloud-Linux-VM der portable Test
|
||||
`tests::remote_signed_requires_explicit_profile_jobs_and_binding`.
|
||||
Die Konfigurationsdefinition, die Methode `profile_enabled` und der Test
|
||||
stimmen als Quelltextabschnitte mit dem Windows-Agent in `fcec400` überein.
|
||||
Mit dem Buildfeature `system-helper` akzeptiert die Konfiguration das
|
||||
benannte Prozessprofil nur mit Job-Opt-in und Bindingpfad. Der Test
|
||||
verweigerte einen fehlenden Opt-in, deaktivierten Jobbetrieb, einen
|
||||
fehlenden Bindingpfad sowie ungültige Profilwerte einschließlich `Bypass`.
|
||||
|
||||
Die x86-64-Testdatei lief mit UID 65534, ohne ergänzende Gruppen, mit
|
||||
`no_new_privs` und in einem eigenen Netzwerk-Namespace. Der Aufruf mit
|
||||
exaktem Testnamen endete mit Exit 0, einem bestandenen Test, null
|
||||
ausgefilterten Tests und leerem stderr. Der Bootstrap entfernte das
|
||||
temporäre Testverzeichnis auf der VM. Der Test verwendete lokale
|
||||
Konfigurations-Fixtures. Windows-Dateirechte, LocalService-Jobbetrieb und
|
||||
die Genehmigung in der WebUI brauchen eigene Nachweise.
|
||||
|
||||
| Prüfgegenstand | SHA-256 |
|
||||
| --- | --- |
|
||||
| Originalquelle `runtime.rs` aus `fcec400` | `4f94cce2c0557436cef4ea5accffb4778af2a3faeb7339cea16592c30872b479` |
|
||||
| Extrahierte Testquelle | `2f338af46f38ebe72471dbdc81b0416947a20000bfad18be5b2f626c5c8a5812` |
|
||||
| Testmanifest | `df3fadfa8e94a710de99546c21b6b74635ac9ea70e8a157583ef7bae05cd76e8` |
|
||||
| Linux-Testdatei | `2168e5a6c31e2349b67ad81bcc58a711c3e37a0f03b7fecf0ca24281c5b72b6b` |
|
||||
| VM-Beleg im Fall `28fac5aa-66e4-466f-93fc-f97062031d43` | `ee3a2c99651491a2fd876f1a3463919dc32d9509d9f9ef4eb73a36aa848bb56d` |
|
||||
|
||||
### Native Windows-Profilprüfung des neuen Agenten
|
||||
|
||||
Am 15. November 2026 um 21:56:30 Uhr MEZ bestand auf der Windows-VM genau
|
||||
`runtime::tests::remote_signed_requires_explicit_profile_jobs_and_binding`
|
||||
aus dem Release-Testprogramm des Commits `fcec400`. Ergebnis 1 bestanden,
|
||||
7 gefiltert, Exit 0. Der vor dem Start nachgelesene SHA-256 der EXE war
|
||||
`7d1715dc105c1eb482405511e1b3abf4437c448e186e73923c43dd3c7938710e`.
|
||||
Der Konsolencontroller meldete Windows PowerShell **5.1.26100.9818** (x64).
|
||||
SHA-256 des auf dem Gast erzeugten JSON-Belegs
|
||||
`48de474d842ebc87550ba2e27b66086e6aa573973f252f4b8e19ac7b12b75a63`.
|
||||
Für die Übertragung diente ein temporäres schreibgeschütztes Testmedium.
|
||||
Der Test lief in der bereitgestellten Administratorkonsole. Er prüfte die
|
||||
Profilwahl im neuen Build. Die Ausführung als auftragsverarbeitender
|
||||
LocalService-Dienst muss weiterhin über die normale Genehmigungsstrecke folgen.
|
||||
|
||||
Im selben Gast wurde der neue Agent mit SHA-256
|
||||
`df80b00fc2119b973d690053b9f9e4bdedd8fbc211f67599c3301eeb42e7702f`
|
||||
in das geschützte Bootstrap-Verzeichnis kopiert und dort erneut gehasht.
|
||||
Im Wartungsfall `49c230d8-fb5d-4c64-96b6-e0edce03ed90` bestätigten die
|
||||
beiden Controller ihre Vorbereitung. Sie prüften den laufenden Vorgänger,
|
||||
seine öffentliche Bindung und die Dateirechte und legten die Kandidaten und
|
||||
Rückkehrkopien an. Die Dienstkonfiguration blieb dabei passiv.
|
||||
|
||||
Beim passiven Dienstwechsel stoppte der Controller Agent und Helper. Vor
|
||||
dem ersten Dateitausch scheiterte das Öffnen der Arbeitskopie für
|
||||
`FlushFile` mit „Zugriff verweigert“. Der erste diagnostische Leseaufruf
|
||||
verwendete einen falschen Fallverzeichnisnamen. Der korrigierte Aufruf las
|
||||
den ursprünglichen Fall und bestätigte bei Agent, Helperkonfiguration
|
||||
und Gegenstellen-Pin jeweils ursprüngliche FileID, Hash und ACL-Hash.
|
||||
Beide Dienste waren gestoppt. Es gab die Vorbereitungs- und Stoppbelege,
|
||||
aber keinen Ersetzungsbeleg. Quelle und Arbeitskopie waren 23.541.484
|
||||
Bytes groß, hatten den erwarteten SHA-256 des neuen Agenten und trugen
|
||||
das vom Installationsmedium übernommene Windows-Dateiattribut `ReadOnly`.
|
||||
|
||||
Die native Nachprüfung zeigte genau einen Dateilink für die getrennte
|
||||
Arbeitskopie. Der Reparaturcontroller entfernte ausschließlich an dieser
|
||||
Kopie das `ReadOnly`-Attribut. Er setzte den begonnenen Austausch fort
|
||||
und las beide Dienstrollen nach dem Start zurück. Der neue Agent meldete
|
||||
sich um 22:07:50 Uhr MEZ per WSS mit derselben Geräte- und Zertifikatsidentität
|
||||
in Generation 147. Beide Dienste liefen, der Helper blieb bytegleich und
|
||||
die drei gemeldeten Fähigkeiten blieben passiv. Jobs, Outbox und Permits
|
||||
betrugen jeweils null. MCP-Nachweis
|
||||
`81a748d9c9ee54dc6bc25d5db469f57c8fedb4fc09ce98ac4115fb13957d51d8`.
|
||||
|
||||
@@ -87,3 +87,375 @@ Die Kandidaten751657ee/acf1e3f3 gehören zum Frischefix. Der anschließend
|
||||
ausdrücklich angenommene Zeitmodus aus Spezifikation1.23 ist noch in Umsetzung;
|
||||
er benötigt neue Produktartefakte und eigene Nachweise. Der vorbereitete
|
||||
Controller wird nicht allein aufgrund dieser AST-/Fixtureprüfungen aktiviert.
|
||||
|
||||
## Nachtrag: neues aktives Profilpaar, weiterhin geschlossenes ENTER
|
||||
|
||||
Nach der ausdrücklichen Userentscheidung für das begrenzte aktive OS-Zeitprofil wurde das Produktpaar erneut gelinkt: Agent `26dc9d2f6928c5a41050ac9324e041c065e7a9ae52324416f3bb6222c002ae6b`, Helper `59675a3cbb3a5d213fc764f38379d6b81baaf9d47a7124470cc2767d4985763e`, unveränderlicher Buildreceipt `04ed34e6e850aca77c1fd4677ddb271f7ccd9492a97f5d4e00ead4c1f032f29d` und Qualifikationsbeleg `96b05fe13f4d459b4b3ef78292beea33827b1ea47293ffb5921c685940e82a4d`. Die früheren Plan-/Kandidatengenerationen bleiben erhalten.
|
||||
|
||||
Der korrigierte P1-Aktionsvertrag wurde für genau diese neue Kandidatengeneration beibehalten. Neuer Generator `bbdd0ef4649c97e0fe48e11d3eb8ccdaf7a7e78f9f5614720249ec5fcf8f44af`, lokaler Vorbereitungsfall `2dc20d01-d19e-4d7c-bce9-44f8904f2620`, Manifest `a8f2a39e3a64a0df56ebc45ccab85c7499e63ced44d9f6b17c34bb6a3b6fa904`, PS `ca7478fb61ca46f2c47952a818ea93b43ea522e29b36cbefc4bc15f460286796`. Änderungen gegenüber dem P1-fixierten77fb-Schnitt: nur neue Kandidaten-/Belegpfade und Hashbindungen sowie der tatsächliche Feldname im neuen Linkreceipt. Neue geschlossene Helperpolicy `aed124bfd6eaf84e10f9dfa1da4d403826331a6d3a64ff8182cfead35067cc8a`, Agentpeerpin `27c38c6b7e1985174018a009de5708f5171f585dcab74500a4f4d333f4d8aa76`.
|
||||
|
||||
Python-AST, dieselben Sourceguards und lokale create-only Vorbereitung PASS; keine Zielaktion oder neue native Controllerqualifikation. Beide festen Serversperren und die strikt typisierte/case-sensitive Aktionsgrenze bleiben erhalten. **ENTER bleibt geschlossen**, bis tatsächliches Gateway-/Brokerdeployment und der noch folgende native mTLS-Zeitroutebeleg konkret gebunden und unabhängig geprüft sind. Die [neue feste Routefixture](windows-time-route-fixture.md) ist ausschließlich für diesen passiven200/403/409-Endpunktnachweis vor dem Upgrade gebaut; sie erzeugt keine Dienstrollen-/Clock-/SyncReady-/Jobfreigabe und noch keine V2-Zeitkonfiguration.
|
||||
|
||||
## Native Vorbereitungsprüfung des aktuellen Profilpaarcontrollers
|
||||
|
||||
Der bestehende Controller für26dc/5967 (ca7478fb61ca46f2c47952a818ea93b43ea522e29b36cbefc4bc15f460286796)
|
||||
wurde nach ausdrücklicher Rootdelegation auf Windows ausschließlich im Speicher
|
||||
geparst und seine genau eine feste C#-HereStringdefinition kompiliert.
|
||||
PowerShell5.1.26100.9818, AST0, C#compile-onlytrue, Controller nicht ausgeführt.
|
||||
Keine Stage-, Stop-, Start-, Swap-, Konfigurations- oder Jobaktion. Original14fb-
|
||||
Lesewitnesses vor/nach bewiesen dieselben sechs stabilen nativen Felder,
|
||||
Journalidentität und monotone Sequenz. Fall3962b83b-c194-4318-8925-83e86c840b7f unter
|
||||
`devstate/windows-time-route-native-readonly/`, Receipt
|
||||
69d221997f247c2c291f0c7c079a79f2bae2c943628032835e49955af1ef7289.
|
||||
Das ersetzt nicht die noch fehlende Quellenbindung des tatsächlichen positiven
|
||||
Zeitroutebelegs vor der weiterhin gesperrten Enterphase.
|
||||
|
||||
## Tatsächliche Route bestanden, Paarwechsel noch nicht ausgeführt
|
||||
|
||||
Die passive HTTP-Abnahme68b841a5… ist einschließlich separatem Read tatsächlich
|
||||
bestanden (200/signature/context,403,409, Exit0). Der bestehende Paarcontroller
|
||||
bindet nun direkt die geschützten tatsächlichen Report-/Exit-/Kontext-/Probe-/
|
||||
öffentlichen Pin-Dateien dieser VM; der alte Harddeny-Entwurf bleibt historisch.
|
||||
Die strikte Aktionsgrenze steht weiterhin vor jeder Wirkung. Jobflags/Policies
|
||||
bleiben geschlossen, keine Zeitkonfiguration wird als Teil dieses Austauschs
|
||||
erstellt oder übernommen.
|
||||
|
||||
Stagingversuch0406dd40-c3c4-464b-8cc6-c9b98365d12a: neues Helperimage5967…
|
||||
tatsächlich vollständig im separaten Bootstraphashpfad vorhanden. Der vorhandene
|
||||
kleine lesende Agent-Staging-Prepareaufruf antwortete nach180s nicht. Noch kein
|
||||
Agentupload und kein Controllerinvoke mit Enter, kein ServiceStop/Start/Swap.
|
||||
Dieselbe sporadische SSH-/Commandantwortstörung betrifft damit auch eine kleine
|
||||
Vorbereitung und ist nicht allein dem alten Upgrade-finish-Reader zuzuordnen.
|
||||
Der konkrete Ursprung dieser sporadischen Transportstörung ist noch offen.
|
||||
|
||||
Eine danach begrenzte20s-Statusablesung antwortete tatsächlich: ursprünglicher
|
||||
Agent `RmmDiscoveryWindows` weiterhinRunning5528 mit unverändertem Servicepfad,
|
||||
ursprünglicher SYSTEM-Helper weiterhinRunning9464, neuer Agentbootstrapfile
|
||||
absent, neuer Helperbootstrapfile13143052Bytes vorhanden. Tatsächliche VM-UTC
|
||||
12:59:46, Kontoablauf13:05:58UTC. Der sichere Gesamtpuffer war unterschritten;
|
||||
daher wurde bewusst keine erste Dienständerung begonnen. Beide ursprünglichen
|
||||
laufenden Komponenten sind erhalten. Belege unter dem ursprünglichen0406-Fall:
|
||||
`stage-agent-preflight-timeout.json`, `final-no-stop-status.json`.
|
||||
|
||||
Für das nächste ausdrücklich autorisierte Zeitfenster wurde die alte feste
|
||||
Ablaufzeit aus der Generatorquelle entfernt. Prepare liest ausschließlich
|
||||
`expires_at` aus der aktuellen geschützten lokalen Zugangskonfiguration und
|
||||
verlangt mindestens420s Gesamtbudget vor Vorbereitung. Der konkrete Wert wird
|
||||
unveränderlich im neuen Payload/Manifest gebunden. Auf der VM muss er vor Wirkung
|
||||
mit **beiden** vorhandenen tatsächlichen Ablaufzeiten übereinstimmen: Konto
|
||||
`rmm-dev` und geschützt gelesenes `bootstrap-public.json`. Vor erster Wirkung und
|
||||
Agentstop420s; vor dem anschließenden Helperstop300s Restbudget, damit gewöhnlicher
|
||||
Zeitablauf nicht denselben hohen Grenzwert erneut unterschreitet. Unmittelbare
|
||||
Service-/Kernel-CAS bleiben auf beiden Stops. Dieser Code ändert Konto, Tunnel,
|
||||
Schlüssel oder deren Konfiguration nicht und schafft kein neues Zugangsfenster.
|
||||
|
||||
Pythoncompile und vorhandene Quellguards bestanden. Kein neuer Preparefall mit
|
||||
dem abgelaufenen knappen Fenster, keine weitere Zielaktion nach dem kleinen
|
||||
abschließenden Statusread. Quellenbindung/neue Baseline und tatsächlich einmalige
|
||||
Paarwartung samt Readback bleiben für das nächste bestätigte Fenster offen.
|
||||
|
||||
Nach Ablauf des SSH-Wartungsfensters meldete das gespeicherte MCP-Inventar
|
||||
den Windowsgast weiterhin als `online`. Der Agent hatte den permanenten Server
|
||||
am 15. November 2026 um 14:06:34 MEZ kontaktiert. Die Daten wurden ausschließlich
|
||||
über `inventory.get_device` gelesen. Beleg
|
||||
`003f000e16e53ce3ff8799694e7138e014689e741f69be6577519c616aee6bab`.
|
||||
|
||||
## Neues bestätigtes Fenster: Staging und Baseline tatsächlich bestanden
|
||||
|
||||
Nach erneuter ausdrücklicher Freigabe, tatsächlicher Konsolenbestätigung beider
|
||||
ursprünglichen Dienst-PIDs und Konto-/Konfigurationsablauf15:30UTC entstand der
|
||||
neue Fall5c627d08-aff0-42a1-a922-dcf7eebccb15. Der alte0406-Stagingversuch bleibt
|
||||
unverändert als unvollständiger Versuch ohne Dienständerung erhalten.
|
||||
|
||||
Tatsächlich native Stagingprüfung bestanden: Helper5967… (bereits eigener
|
||||
Bootstraphashpfad), Agent26dc… und fester Controller
|
||||
`d808f47b5de8563e7e32d49dc5a0ad83c988c7de12cc286f1814b3a69e7e27a6`.
|
||||
Danach vollständige native Baseline ohne Timeout: Config-/PKI-/Datei-/ACLbindung
|
||||
und tatsächlicher Helper-DB-/Lock-/Intentzustand stimmen mit dem angenommenen
|
||||
ursprünglichen14fb-Beleg überein. AgentRunning5528, HelperRunning9464.
|
||||
BaselineSHA `cc876073b87086021ba449748deebff8309e06977438bb1854565f5d58cbba88`.
|
||||
Geschlossene Serverflags und Job-/Outbox-/Permitzähler unverändert.
|
||||
Bis zu diesem Beleg kein ServiceStop/Start/Swap, kein Job, kein Zeitprofil.
|
||||
Die anschließende einmalige Enterphase ist ein gesonderter noch offener Schritt.
|
||||
|
||||
## Erste Enterphase vor jeder Wirkung verweigert; Ursache nachgewiesen
|
||||
|
||||
Im Fall5c627d08… wurde Enter genau einmal aufgerufen und mit
|
||||
`Preserved identity config or ACL` verweigert. Kein erneuter Enteraufruf.
|
||||
Die feste unabhängige Originalfallnachlese bestätigt: Fallordner absent,
|
||||
active-intent absent, sämtliche Intent-/Stop-/Swap-/Startmarker absent;
|
||||
ursprüngliche Dienste weiterhinRunning5528/9464. Es gab keine Dienständerung.
|
||||
Der erste Versuch bleibt fehlgeschlagen und wird nicht nachträglich geheilt.
|
||||
|
||||
Eine frische vollständige native Baseline bestätigte alle betroffenen Werte
|
||||
semantisch exakt identisch. Der konkrete Fehler lag im bisherigen PS-`JsonEqual`:
|
||||
Er verglich JSON-Texte einschließlich Objektmemberreihenfolge. Die Python-
|
||||
kanonisch sortierte gespeicherte Baseline und die native PS-Ordered-Ausgabe
|
||||
ordnen `public_hashes`, `identity_acls` und `private_key_metadata` anders an.
|
||||
Das war ein falscher Unterschied trotz unveränderter Werte, kein ACLwechsel.
|
||||
|
||||
Der enge Quellfix normalisiert nur Objektmember für den Inhaltsvergleich;
|
||||
Arrayreihenfolge sowie Null gegenüber leeren Arrays bleiben unterschieden,
|
||||
Tiefe bleibt auf40 begrenzt. Tatsächlich fünf native In-Memory-Gegenfälle
|
||||
bestanden: umgeordnetes Objekt akzeptiert, Scalaränderung, umgekehrtes Array,
|
||||
Null gegenüber leerem Array und Null-Element gegenüber leerem Array verweigert.
|
||||
Keine Dienste, Produktdateien oder Jobs wurden vom Guard verändert. Unabhängiger
|
||||
Quellenreview läuft getrennt; noch keine neue mutierende Controllerausführung.
|
||||
|
||||
Inzwischen behebt Main656102b die passive Zeitprüfung ohne Jobopt-in. Weil das
|
||||
ursprüngliche Paar nachweislich noch unmutiert ist, wird26dc nicht mehr installiert:
|
||||
Root qualifiziert zuerst das notwendige neue Agentimage; Helper5967 bleibt
|
||||
unverändert. Danach neue feste Image-/Controllerbindung und neue Baseline vor
|
||||
**einem** tatsächlichen Paarwechsel. Der fehlgeschlagene5c-Versuch wird dabei
|
||||
weder wiederholt noch als Erfolg ausgegeben.
|
||||
|
||||
## JsonEqual-Korrektur eng geprüft und nativ belegt
|
||||
|
||||
Der unabhängige Quellenreview fand im ersten Normalisierer einen zusätzlichen
|
||||
Randfehler: ein case-sensitives IDictionary mit `A` und `a` hätte beim Kopieren
|
||||
in eine case-insensitive OrderedDictionary einen Wert verlieren können. Beide
|
||||
Objektzweige verweigern nun vor dem Einfügen Nichtstringkeys oder bereits
|
||||
vorhandene kollidierende Namen. Bestehende feste Native-State-DTOs erzeugen
|
||||
solche Kollisionen nicht; der zusätzliche Pfad ist trotzdem geschlossen.
|
||||
|
||||
Unabhängiger enger Re-review der Quelle
|
||||
`4ef8c6787fd3defdd8416401b3b40dd63be0e3afffc195736eed0ce350286201`
|
||||
ohne weiteren konkreten Befund. Nativ anschließend sechs feste In-Memory-Guards
|
||||
bestanden: ursprüngliche fünf Fälle plus case-kollidierendes
|
||||
`Dictionary(StringComparer.Ordinal)` wird verweigert. ResultSHA
|
||||
`2429b869792854ac799c403422e26561df2b2c5310b408e6a7287751129c2a94`
|
||||
im erhaltenen5c-Fall, `comparison-collision-guard-result.json`.
|
||||
Pythoncompile und bestehende Quellguards ebenfalls PASS. Kein Service-/Datei-/
|
||||
Jobeffekt und weiterhin keine26dc-Installation. Der folgende Agentkandidat wird
|
||||
separat durch Root qualifiziert; Controller-/Payloadbindung und neuer echter
|
||||
Baselinebeleg werden erst mit dessen endgültigem Artefakt erzeugt.
|
||||
|
||||
## Ein Austausch mit passiver Zeitprüfung
|
||||
|
||||
Nach der Verweigerung vor dem ersten Dienststopp wurde der ursprüngliche
|
||||
202-Dateien-Quellstand erneut gegen sein Manifest geprüft. Nur drei Quellen
|
||||
haben sich für den Installationskandidaten geändert: Zeitabfrage im Agenten,
|
||||
Auswahl des Abfrageintervalls und Schreiben der zwei historischen
|
||||
Dienstbelege. Die Änderungen kommen aus den Commits `656102b` und `cc82124`.
|
||||
Das Manifest dieser 202 Inputs hat den SHA-256-Wert
|
||||
`11717fab51bd1d6bf103b1821cc1e2a84699f46cac21f2cc614acf4b68381fa4`.
|
||||
Der isolierte Offline-Releasebuild für AMD64 ergab das Agentbild
|
||||
`0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c`.
|
||||
Für den Helper wird das bereits qualifizierte Image `59675a3c…` verwendet.
|
||||
Der Agent-Zwischenbuild `34b7458d…` wurde nicht installiert.
|
||||
|
||||
Die neun gezielten Zeitprüfungen aus diesem konkreten Quellstand bestanden auf
|
||||
der Cloud-Linux-VM als UID 65534, Exit 0. SHA-256 der Ergebnisquittung
|
||||
`333f8d2dba3b35dcd79faafd8faf5c88da321942c9672c0a80f1f2c8fceb24a3`.
|
||||
|
||||
Anschließend bestanden die gleichen neun Tests auf der Windows-VM aus dem
|
||||
separat gebauten AMD64-Librarytestbinary desselben Release-Quellstands, Exit 0.
|
||||
Die Ergebnisquittung hat SHA-256
|
||||
`7700096145afdca74e7473e56c6dd2e65651252e889a696f84bb1fc2441ff513`.
|
||||
Nach erneutem Abgleich aller 202 Quelldateien, des PE-Headers und des Helperhashs
|
||||
wurde das Buildreceipt
|
||||
`f04024f78c2f11f5c66bbdf9278467f5bcc50da5c2bd7336623851bca42dd446`
|
||||
für den einmaligen Dienstwechsel erstellt. Der Windows-Testprozess hat weder
|
||||
einen Dienst ausgetauscht noch einen Agentjob ausgeführt.
|
||||
|
||||
Der exakt gebaute Quellstand für das neue Agentbild liegt in Gitea auf
|
||||
`codex/windows-passive-time-candidate`, Commit
|
||||
`c6c4037d072a96d62136264066d0257782c7a932`. Alle 202 Build-Inputs wurden
|
||||
byteweise mit dem Release-Manifest abgeglichen. Der Ausgangsstand der
|
||||
ursprünglichen Qualifikation entspricht für dieselben 202 Dateien
|
||||
`b8ca8266bbb3b4806f4d20a3039f25196638804e`.
|
||||
|
||||
## Endgültiger passiver Agent und erneute Transportverweigerung
|
||||
|
||||
Root qualifizierte für genau den beobachtbaren passiven Stand cc82124 den
|
||||
Agent0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c.
|
||||
Tatsächliche Linux9-/Windows9-Guards und Release-Link sind im Receipt
|
||||
f04024f78c2f11f5c66bbdf9278467f5bcc50da5c2bd7336623851bca42dd446 gebunden,
|
||||
Sourceinputs11717fab51bd1d6bf103b1821cc1e2a84699f46cac21f2cc614acf4b68381fa4.
|
||||
Helper5967… bleibt aus dem ursprünglichen04ed-Produktreceipt unverändert.
|
||||
Der Generator bindet diese beiden getrennten tatsächlichen Artefaktquellen,
|
||||
keinen nochmals eingebauten26dc-Agenten. Der öffentliche neue lokale Receipt
|
||||
war zunächst0664; nur sein Modus wurde auf0600 gehärtet, Bytes/SHA unverändert.
|
||||
|
||||
Neuer unveränderlicher Fall570c7a86-6509-49e6-b95e-8f0df74b18bf,
|
||||
Controller67d2fb1f9fdfec05b08f53a37be9a7df4cc3bb39f6cde8f950a226286474fd45,
|
||||
bindet das bestätigte15:30UTC-Fenster. Sein allererster kleiner Stage-Read wurde
|
||||
jedoch bereits beim SSHtransport verweigert: return255, stdout0, stderr89Bytes.
|
||||
Ein einzelner begrenzter Statusversuch klassifizierte CONNECTION_TIMEOUT,
|
||||
keinen Authentifizierungs-/Hostkeyfehler. Kein neuer Agenttransfer, kein Enter,
|
||||
keine Dienständerung oder Wiederholung unklarer Wirkung durch diesen Fall.
|
||||
|
||||
Root belegte danach Notebook-System-Suspend13:48:24–14:39:01UTC und einen nicht
|
||||
mehr antwortenden alten Forwardingkanal. Damals existierte weiterhin keine
|
||||
V2-Konfiguration/Zeitauthorität; beide ursprünglichen Produktdienste waren passiv.
|
||||
Root beendete ausschließlich den separat kernelgebundenen alten Bastionforwarder
|
||||
und forderte kontrolliertes Neuöffnen desselben Fensters an. Dieser Wartungsagent
|
||||
änderte weder Tunnel, Konto, Schlüssel noch SSHkonfiguration. Seit Roots Sperre
|
||||
keine weiteren VM-Aufrufe bis bestätigtem Transportreadback.
|
||||
|
||||
Abschließender lokaler Check: Pythoncompile, bestehende Quellguards, exakte
|
||||
saved-controller-/Generatorbytes, neues Agentimage, unverändertes Helperimage,
|
||||
Source-/Native-Receipt und geschützte15:30-Payloadbindung PASS. Beleg
|
||||
74ca4c2572872eb64cecc250aefd4bbffa5d8e4dc9b3729b5b83c19ac07a670f,
|
||||
`final-local-check.json` im570c-Fall. Neue native Baseline, tatsächlicher
|
||||
Paarwechsel und unabhängige Nachlese bleiben offen. Es wird kein Windowsabschluss
|
||||
oder funktionierender installierter Zeitvergleich behauptet.
|
||||
|
||||
## Transport wieder bestätigt: endgültiger570c-Stand nativ bereit
|
||||
|
||||
Nach Roots tatsächlichem Konsolen-/Transportreadback15:04:25UTC wurde ausschließlich
|
||||
der vorhandene570c-Fall fortgesetzt, unverändertes Ende15:30UTC. Tatsächliche
|
||||
Stagebestätigung für Helper5967…, endgültigen Agent0549… und Controller67d2…
|
||||
bestanden. Volle neue native Baseline bestätigt ursprüngliche Running-PIDs5528/9464,
|
||||
unveränderte config/PKI/ACLs und vollständigen bisherigen Helper-DB-/Lock-/Intent-
|
||||
zustand. BaselineSHA
|
||||
b1a7928f89ad2bb9c63720dedea6f343d644c9882052877b5144dc200537f5e7.
|
||||
Geschlossene Serverflags und Windows0-/Linux31/31/27-Zähler unverändert.
|
||||
Noch keine Dienständerung bis zu diesem Baselinebeleg. Nächster Schritt ist die
|
||||
genau einmalige, an diese neuen tatsächlichen Bytes gebundene Enterphase.
|
||||
|
||||
## ETS-Skalartypfehler vor erster Wirkung behoben
|
||||
|
||||
Die einmalige570c-Enterphase verweigerte `Original SCM invariant`. Die reine
|
||||
Nachlese zeigt erneut eigenen Ordner/active-intent und alle Stopmarker absent;
|
||||
Originaldienste laufen5528/9464. Keine Enterwiederholung und keine Dienstwirkung.
|
||||
Isolierter Vergleich aller sechs SCM-Felder inklusive CLR-/Basistyp und Wrapping
|
||||
belegt ausschließlich `sid_type`: Baseline und live beide System.Int32=1, aber
|
||||
der ETS-wrapped Registrywert erfüllt zusätzlich `-is[pscustomobject]` und wurde
|
||||
irrtümlich zu `{}` normalisiert. Die anderen fünf Felder stimmten exakt überein.
|
||||
|
||||
Der Vergleich rekonstruiert jetzt JSON-Skalare aus ihrem CLR-Basiswert vor dem
|
||||
Objektpfad (primitive Strings/Bool/Integer/finite Double/Decimal), ohne ETS-Notes
|
||||
als fachlichen Objektinhalt umzudeuten. Echte JSON-Objekte behalten alle Keys;
|
||||
Casekollisionen/Arrayreihenfolge/Null/Tiefengrenze bleiben geschützt. Unabhängiger
|
||||
enger Review der Quelle90c2708c… ohne weiteren konkreten Befund.
|
||||
|
||||
Tatsächlich anschließend auf derselben VM: vollständiges originales
|
||||
`SameOriginal` gegen gespeicherte Baseline und frischen LiveState bestanden.
|
||||
Zusätzlich native ETS-Add-Member-Fälle für Integer/String/Bool gleich,
|
||||
Scalaränderung/Arrayumkehr/Null gegenüber leerem Array weiterhin verweigert.
|
||||
Result82c4ebe75bff95005ebd946ae99e206ec69648bec93adb17cf683c46fc46212a,
|
||||
`typed-full-pre-effect-comparison.json` im570c-Fall. Weiterhin keine Ordner/active-
|
||||
Marker und keine Dienständerung. Neuer Controllerfall folgt getrennt;570c bleibt
|
||||
als fehlgeschlagene Vorwirkungsphase erhalten.
|
||||
|
||||
## Neuer typkorrigierter Fall4887 nativ bereit
|
||||
|
||||
Fall4887940a-4c9c-4807-aaf2-6fbc94faad46 bindet unverändert Agent0549/Helper5967,
|
||||
denselben echten Quell-/Linux9-/Windows9-Beleg und das unveränderte15:30-Fenster.
|
||||
Controller66ca45e15e8f790c4614db74dd491137d5e28104e2d28ee658cc287debcd021f.
|
||||
Alle festen Stagebytes erneut nativ bestätigt; volle frische Baseline einschließlich
|
||||
ursprünglicher PIDs5528/9464, config/PKI/ACLs und Helper-DB/Lock/Intents bestanden.
|
||||
Baseline00bf31bd5355dc77e0aadd73d2ab57ea32410956ef764f3f2aeb195bd218479e.
|
||||
Geschlossene Servergates unverändert, bis hier weiterhin kein Serviceeffekt.
|
||||
4887 besitzt noch keinen Enterversuch;570c bleibt getrennt vor Wirkung verweigert.
|
||||
|
||||
Nach dem tatsächlichen Dienstwechsel bestätigten SCM und MCP zunächst beide
|
||||
laufenden Dienste und die bisherige Geräteidentität. Der letzte Kontakt blieb
|
||||
dann bei 16:17:32 Uhr MEZ stehen. Um 16:21:38 Uhr authentifizierte der Agent
|
||||
sich weiterhin erfolgreich. Die drei serverseitigen Sperren für Restore,
|
||||
Sequenzregression und Sync-Recovery waren alle aus. Der neue Agent meldet
|
||||
`agent.update/1` und sendet eine passive `not_configured`-Beobachtung. Auf
|
||||
dem Server ließ der CHECK von `observations.source_id` ausschließlich
|
||||
`linux.base` und `windows.base` zu. PostgreSQL protokollierte seit dem Wechsel
|
||||
15 Verletzungen genau dieses CHECKs. Der erste Online-Status war damit kein
|
||||
Nachweis für fortlaufende Heartbeats.
|
||||
|
||||
Die Geräteansicht selektiert im geänderten API-Quellstand gezielt den neuesten
|
||||
Basisdatensatz. Die aus dem Produktcode extrahierte LATERAL-Abfrage lieferte in
|
||||
einer lesenden PostgreSQL-Prüfung auf dem Server die erwarteten Windows- und
|
||||
Linux-Werte sowie NULL für ein Gerät mit ausschließlich Updatebeobachtungen.
|
||||
Auch Mandant und Seitenstichtag wurden im Datensatz gegengeprüft.
|
||||
|
||||
## Tatsächlicher einmaliger Paarwechsel, Abschluss nur lesend wiedergewonnen
|
||||
|
||||
4887 führte den tatsächlichen Paarwechsel genau einmal aus: beide ursprünglichen
|
||||
Prozesse kontrolliert beendet, vier Originaldateien gesichert, Agent/Helper und
|
||||
reziproke geschlossene Settings/Pins vollständig ersetzt, danach Helper und Agent
|
||||
jeweils einmal gestartet. Neue tatsächlich laufende Kernel-/Serviceinstanzen:
|
||||
Agent0549… PID4420, Helper5967… PID10264. Der ursprüngliche Enteraufruf meldete
|
||||
allerdings beim abschließenden Schemaerhaltungscheck einen Fehler; er wurde
|
||||
**nicht** erneut aufgerufen. Originalmarker belegen alle vier Replacements und
|
||||
beide tatsächlichen Starts; `entered.json` wurde wegen des Nachprüfungsfehlers
|
||||
nicht geschrieben. Der erste Postcheck bleibt fehlgeschlagen.
|
||||
|
||||
Der exakte Nachbefund: Telemetriedatei-ID, Creation und Geräteidentitätshash sind
|
||||
identisch. Alle bisherigen Schemaeinträge/Trigger sind bytegleich erhalten;
|
||||
ausschließlich `update_health_inventory` wurde additiv angelegt. Deren komplette
|
||||
DDL entspricht der tatsächlich qualifizierten eingefrorenen Quelle
|
||||
`agent-core/src/update_health_inventory.rs` (Sourceinputs11717fab…). Dies ist
|
||||
keine globale Lockerung des Schemaerhalts: der Abschlussleser verlangt exakt
|
||||
einen zusätzlichen Eintrag, exakt diesen Typ/Namen/DDL und unveränderte übrige
|
||||
Einträge. Die neue Tabelle wurde nicht auf Zeileninhalt abgefragt; es wird keine
|
||||
solche Prüfung behauptet. Bestehende Job-/Reconcilezähler bleiben vollständig0,
|
||||
Serverjob-/Outbox-/Permitgates ebenfalls unverändert geschlossen.
|
||||
|
||||
Eine erste reine Abschlusslesung verweigerte fälschlich wegen PowerShell-
|
||||
Pipelineflattening der Schema-Tupel; nach Beschränkung auf explizite Listen
|
||||
bestand derselbe ausschließlich lesende Originalfallvergleich. Keine weitere
|
||||
Service-/Datei-/Jobmutation war Teil dieser Recovery. Der Reader prüft zusätzlich
|
||||
Originalintent/active-Bindung, vollständigen Config-/PKI-/Privatekeymetadaten-/
|
||||
DB-/Lock-/Helperrowerhalt sowie exakte beiden gespeicherten einzelnen neuen
|
||||
Service-/Kernelstarts. Native tatsächliche Zeitquelle/Clockfreigabe wird dadurch
|
||||
nicht behauptet.
|
||||
|
||||
Anschließend unabhängiger zweiter Originalfallread: dieselben neuen Prozesse,
|
||||
Images und Dateiidentitäten, sämtliche Erhaltungsbedingungen erneut bestanden.
|
||||
Belege im4887-Fall:
|
||||
|
||||
- `completion-readback.json`:13448d833b32dedfb5e07cb4e76f046e666522488ffabbb3a38a57d2d485d1b8
|
||||
- `independent-readback.json`:63e453fb915cadee028407a6aeaa8c7d209ae88ed12a6d4d4307d4fd25e4c539
|
||||
- `intent.json`:40e9cd557225504429b51dcecd4322b32d7f0973bcbb8e2a2e52516917907b85
|
||||
- `bound-payload.json`:074a13fd3e4cdefd85aedb5a9fc17d247994e0e515b71e4e0925f713d37774f7
|
||||
- `result.json`:2898a72b4b0d84159cc11d80765cbfa4206faf7038d0e860429c8b1a57538ee2
|
||||
|
||||
Das Resultat kennzeichnet ausdrücklich `recovered_postcondition_read=true` und
|
||||
`original_enter_postcheck_failed=true`. Es meldet keine erfundene erfolgreiche
|
||||
ursprüngliche Enterantwort. Kein Jobmodus, Effektgate, VM-Reboot, Enrollment,
|
||||
Gerätezertifikatswechsel oder Zeitprofil wurde durch diese Wartung aktiviert.
|
||||
|
||||
Getrennt offen: Parent bestätigte einmaligen korrekten neuen Hello/Identität und
|
||||
unverändertes Gerätezertifikat/Enrollment/Assignment, jedoch noch keine zwei
|
||||
fortlaufenden Heartbeats; gespeicherte Präsenz wurde später stale. Die zusätzliche
|
||||
Capability `agent.update/1` stammt aus dem konkret installierten passiven
|
||||
not_configured-Schema. Heartbeatkontinuität und installierte Clockautorität
|
||||
bleiben im Resultat ausdrücklich **nicht bewiesen**. Windows-MVP damit nicht
|
||||
vollständig abgenommen. Wichtige spätere Werkzeugverbesserung: erwartete additive
|
||||
Schemaentwicklung vor Wartung aus dem qualifizierten Quellstand planen; hierfür
|
||||
jetzt keinen allgemeinen Migrations-/Resumeframework bauen.
|
||||
|
||||
## Serverkorrektur für die passive Telemetrie am 15. November 2026
|
||||
|
||||
Nach SQLx-Migration 16 wurde um 16:39:24 Uhr MEZ ausschließlich der
|
||||
API-Container auf dem permanenten Server neu gestartet. Sein ARM64-Image
|
||||
`6a76343bf65c126458244f5540d4cb740988144fc77877b409f790251e7ddcc7`
|
||||
enthält die Änderung an der Basisinventarabfrage und die Migration.
|
||||
Gateway und PostgreSQL behielten Container-ID und Startzeit.
|
||||
|
||||
Der erste Nachvergleich schlug beim direkten Listenvergleich der
|
||||
Containerkonfiguration fehl. Eine separate lesende Prüfung verglich die Mounts
|
||||
nach Zielpfad. Docker lieferte sie in anderer Reihenfolge. Quelle, Ziel,
|
||||
Modus und übrige Mountattribute stimmten vollständig mit dem vorherigen
|
||||
Container überein. API-Umgebung und Startkonfiguration entsprachen Compose
|
||||
und Image. Verifiziert wurden zudem die Loopback-Bindung, UID/GID 10001,
|
||||
Read-only-Rootfs, CapDrop ALL und no-new-privileges. Es gab genau einen
|
||||
API-Wechsel. Die weitere Prüfung erfolgte am laufenden Container.
|
||||
|
||||
### Erneute Abnahme über MCP
|
||||
|
||||
Zwei getrennte, nach Beginn der Prüfung eingegangene Kontakte des Windows-11-
|
||||
Agenten wurden am 15. November um 16:39:46 und 16:40:17 Uhr MEZ aus
|
||||
`inventory.get_device` gelesen. Beide hatten Präsenz `online`, dasselbe
|
||||
Gerät, dieselbe Agent-ID, Zuordnung, Enrollmentgeneration und dasselbe
|
||||
authentifizierte Zertifikat wie vor dem Paarwechsel. Der Agent meldet
|
||||
`heartbeat/1`, `windows.base/1` und `agent.update/1`.
|
||||
Beleg-SHA-256 `837c7580b9e7cd68de09533f50d91622272c2f2bc288da70d8b4624d2f6a747e`.
|
||||
|
||||
Die MCP-Geräteansicht lieferte das gespeicherte Windows-Basisinventar mit fünf
|
||||
Bereichen und für die Cloud-Linux-VM den Datensatz `linux.base`. Das
|
||||
Windows-Basisinventar stammte von 16:16:59 Uhr MEZ. Die Kontaktzeiten wurden
|
||||
unabhängig davon aktualisiert. PostgreSQL speicherte die separaten
|
||||
Updatemeldungen des Windowsagenten um 16:38:43, 16:39:45 und 16:40:50 Uhr MEZ.
|
||||
Der zuletzt gelesene Updatezustand war `not_configured`. Die Windows-Jobtabelle
|
||||
enthielt für dieses Gerät null Aufträge. Die Prüfung las gespeicherte
|
||||
Telemetrie über den permanenten Server nach Ablauf des SSH-Fensters.
|
||||
|
||||
@@ -0,0 +1,571 @@
|
||||
# Erste öffentliche Windows-Zeitkonfiguration V2
|
||||
|
||||
Stand 2026-11-15: Der reale Paarfall `4887940a-4c9c-4807-aaf2-6fbc94faad46`
|
||||
ist nach abgeschlossener unabhängiger Nachlese gebunden (Result `2898a72b…`,
|
||||
Originalintent `40e9cd55…`, separater Read `63e453fb…`). Die vorherige
|
||||
Verweigerung mit fehlenden Rollenbelegen bleibt als historischer lokaler Test
|
||||
nachgewiesen. Ein Zeitvertrauen oder durchgehende Heartbeats sind durch den
|
||||
Paarabschluss ausdrücklich nicht bewiesen.
|
||||
|
||||
Der Operator prüft die unveränderten öffentlichen Vorbereitungsbelege
|
||||
`c3077acf-12da-410e-9f55-e75a1cd0a75f`, deren getrennten Ed25519-Zeitschlüssel,
|
||||
Gerätebindung und tatsächlich gelesene KVM-Plattform. Die ursprüngliche
|
||||
Vorbereitung bleibt mit `roles_qualified=false` unverändert. Die akzeptierte
|
||||
Betriebsannahme ist ausdrücklich
|
||||
`active_guest_no_pause_save_restore_snapshot_migration_host_suspend`; das ist
|
||||
keine physikalische Kalibrierung und keine automatische Überwachung dieser
|
||||
Betriebsannahme.
|
||||
|
||||
Der neue Agent ist an SHA256
|
||||
`0549d9ebea73cff996938f859b92192cc333de194128d7c6859a3f1d2e85893c`
|
||||
und Buildreceipt `f04024f78c2f11f5c66bbdf9278467f5bcc50da5c2bd7336623851bca42dd446`
|
||||
gebunden. Seine 202 Quellinputs sind durch `11717fab…` fixiert; das tatsächlich
|
||||
erweiterte Zeitmodul hat SHA256 `342494c4…`. Gegen die ursprüngliche Quelle
|
||||
`d8594c1e…` kamen die passive Sampling-Auswahl und deren neunte Prüfung hinzu.
|
||||
Der Helper bleibt `59675a3c…`, aus dem ursprünglichen Linkbeleg `04ed34e6…`
|
||||
und Quellbeleg `96b05fe1…`. Diese unterschiedlichen Provenienzen werden nicht
|
||||
gleichgesetzt. Der tatsächliche neue Paar-Payload verwendet für
|
||||
`qualification_sha256` und `manifest_sha256` jeweils den neuen Beleg `f04024f7…`;
|
||||
der alte Helper-Quellbeleg ist kein Ersatz dafür.
|
||||
|
||||
Bevor ein Fall erstellt werden kann, müssen ein abgeschlossener passiver
|
||||
Paarwechsel und unabhängig fixierte Originalbelege vorliegen. Für beide Rollen
|
||||
werden SCM-Status, PID, Kernel-Prozessgeburt, tatsächliches Konto, aktivierte
|
||||
Service-SID, gehaltener Prozesshandle, Imagepfad, Imagehash und native FileID
|
||||
verknüpft. Die alten numerischen 601-Proben bleiben ausdrücklich rohe
|
||||
Voraussetzungsbelege; sie qualifizieren kein Produktimage. Der Producer erzeugt
|
||||
öffentliche Rollen- und Plattformbelege und daraus das vorhandene strikte
|
||||
V2-Format mit genau beiden Rollen. Er behauptet weder signierte Laufzeitprüfung
|
||||
noch physikalische Genauigkeit. Fehlende oder widersprüchliche Belege sperren.
|
||||
|
||||
## Geplanter Ablauf nach neuem realem Paar-Readback
|
||||
|
||||
Die folgenden Phasen sind **vorbereitet, nicht auf dem Ziel ausgeführt**:
|
||||
|
||||
1. Root bestätigt Original-Paarfall und Originalbeleg-Hashes; diese werden als
|
||||
konkrete Quellenkonstanten gebunden und nochmals geprüft.
|
||||
2. `prepare` liest ausschließlich öffentliche lokale Belege und erzeugt einen
|
||||
privaten, einmaligen Fall. `stage --case <id>` überträgt ausschließlich den
|
||||
fixierten Controller über den bestehenden bestätigten SSH-Transport.
|
||||
3. `install --case <id>` darf genau eine bisher fehlende feste öffentliche Datei
|
||||
veröffentlichen. Bereits vorhandene Datei, aktiver Marker oder Teilfall
|
||||
verweigern einen neuen Installationsversuch. Ein verlorener Antwortweg führt
|
||||
ausschließlich zu `read --case <id>`, nicht zu Wiederholung oder Rollback.
|
||||
4. Root liest den ursprünglichen Fall separat und prüft danach die echten
|
||||
passiven Agent-/Helper-Zeitbelege. Eine erfolgreiche Veröffentlichung allein
|
||||
setzt `clock_runtime_qualified` ausdrücklich nicht auf true.
|
||||
|
||||
## Begrenzte Wirkung und Erhaltungsnachweis
|
||||
|
||||
Der Controller verwendet ausschließlich die vorhandenen lesenden SCM-,
|
||||
Kernel-, FileID-, PKI-Metadaten- und Journalzeugen. Er importiert keine alten
|
||||
Stop-/Start-/Swap-/Repair-Phasen. Die aktuelle Prozessgeneration, beide Images,
|
||||
vier Code-/Policydateien, Konfiguration, Geräteidentität, Zertifikat,
|
||||
Schlüsselmetadaten, Telemetrieidentität, Sequenzmonotonie und leere
|
||||
Job-/Helper-Intents werden vor, während und nach der Veröffentlichung geprüft.
|
||||
Der private Schlüssel wird weder gelesen noch gehasht.
|
||||
|
||||
Eine neue private Bootstrap-Falldirectory wird nativ exklusiv mit geschützter
|
||||
SYSTEM-/Administrators-DACL angelegt. Alle Originalmarker werden create-only
|
||||
geschrieben und geflusht. Nur der öffentliche Helper-Stamm erhält bei Bedarf
|
||||
fehlende `0x001200a9`-Leserechte für beide **Service-SIDs**, ausschließlich für
|
||||
diesen Ordner, ohne Vererbung auf State/PKI/Ledger. Fremde oder weiter gehende
|
||||
Service-Rechte werden verweigert. Die Kandidatdatei erhält vor Veröffentlichung
|
||||
SYSTEM/Administrators-Vollzugriff und dieselben begrenzten Leser. Die feste
|
||||
Zieldatei wird nach durablem Publish-Intent mit einem gleichvolumigen,
|
||||
überschreibungsfreien Move veröffentlicht; anschließend müssen FileID, Hash
|
||||
und DACL unverändert sein. Keine allgemeine Stromausfall-Atomizität wird daraus
|
||||
abgeleitet. Teilzustände bleiben im Originalfall lesbar, ohne automatische
|
||||
Reparatur oder Rechte-Rücksetzung.
|
||||
|
||||
Unmittelbar vor der ersten Erstellung wird `install_not_before` aus der
|
||||
nativen VM-UTC gelesen und im ursprünglichen Intent sowie Ergebnis erhalten.
|
||||
Das ist eine Herkunftsuntergrenze für die nachfolgende separate Nachlese und
|
||||
den passiven Collector, keine eigenständige Uhrvertrauensbehauptung.
|
||||
|
||||
## Laden und tatsächliche Grenzen
|
||||
|
||||
Das vorhandene `signed_clock::native::SignedClock::open` lädt bei jedem Öffnen
|
||||
geschützte Settings, beweist den eigenen Dienstprozess und öffnet den festen
|
||||
Stamm sowie die maximal 16384 Byte große Datei über `PinnedFile`. Besitzer
|
||||
müssen SYSTEM/Administrators bleiben; zusätzliche Leser dürfen nur die
|
||||
festgelegte Lesemaske besitzen. Beide Images müssen zu den Settings passen.
|
||||
Die Prüfung bindet Dateiinhalt und FileID; spätere Rechecks öffnen denselben
|
||||
Namen erneut und verwerfen Austausch oder Änderungen. Fehlerhaft beobachtete
|
||||
Konfigurationen oder fehlgeschlagene Reads stellen alte Autorität nicht wieder
|
||||
her; geänderte Bytes derselben Generation gelten als Fork.
|
||||
|
||||
Im neuen Agenten versucht die passive Heartbeat-Schleife das Setup bei bisher
|
||||
fehlendem Profil erneut. Ein erster Pin benötigt daher nach Quellenvertrag
|
||||
keinen Dienstneustart. Das ist **noch kein VM-Nachweis**. Der Agent schreibt erst
|
||||
nach tatsächlich erfolgreichem `complete` pro Verbindung öffentliche historische
|
||||
`agent-time-sample.json` und `helper-time-sample.json` in sein bestehendes
|
||||
geschütztes State-Verzeichnis. Der Helper-State bleibt unverändert. Root muss
|
||||
diese Originalbelege noch für die tatsächlich installierten Rollen und
|
||||
Konfigurationsbytes prüfen. Ein Statusfile ersetzt kein aktuelles Job-Startgate.
|
||||
|
||||
## Tatsächlich lokal ausgeführt
|
||||
|
||||
- Python-Syntaxprüfung und geschlossene Sourceguards: PASS.
|
||||
- Sechs lokale Vertragsfälle: PASS. Sie prüfen die reinen Referenzbytes,
|
||||
fehlende Paarbelege, falsche Rollen/Images/Geburt/SID/FileID/Policy/Identität,
|
||||
create-only, begrenztes Lesen, Symlink- und Duplicate-JSON-Verweigerung.
|
||||
Positive In-Memory-Fixtures sind ausdrücklich keine native Qualifikation.
|
||||
- Beide erzeugten PowerShell-ASTs mit vorhandenem lokalem Parser: PASS.
|
||||
- Lokale ETS-Integer-/Bool-/String-Reproduktion sowie Objekt-/Arrayreihenfolge:
|
||||
PASS. Der unveränderte Vergleich aus `e6debe5` war unter Windows PowerShell 5
|
||||
unzureichend: ETS-verpacktes `System.Int32=1` konnte im Objektzweig zu `{}`
|
||||
werden. Der exakt übernommene Comparator aus der getrennt geprüften
|
||||
Clockquelle `90c2708c…` rekonstruiert CLR-Skalare vor dem Objektzweig als
|
||||
unadornierte Werte. Der Clockoperator hat diesen Vergleich außerdem tatsächlich
|
||||
gegen den vollständigen alten Livezustand und ETS-Positiv-/Negativfälle
|
||||
geprüft (`82c4ebe7…`). Das ist kein Profilinstallationsnachweis.
|
||||
- Die festgehaltenen öffentlichen Eingänge, rohen Rollenbelege und realen
|
||||
Quell-/Buildbelege werden vom Operator lokal erfolgreich gelesen. Die durch
|
||||
Root tatsächlich ausgeführten neun Linux- und neun Windows-Zeitmodulprüfungen
|
||||
sind über deren Originalbeleg-Hashes und exakte Testnamen angebunden.
|
||||
- `prepare` ohne reale Paarbelege: erwartete Verweigerung ohne angelegten Fall.
|
||||
|
||||
Im ursprünglichen lokalen Quellprüfstand noch nicht ausgeführt: Übertragung,
|
||||
ACL-Änderung, Konfigurationsinstallation,
|
||||
Produktdienst-Laden/Reopen auf der VM, signierte passive Laufzeitabnahme,
|
||||
WebUI-Genehmigung oder RMM-Job. Der damalige Transportausfall nach Notebook-Suspend war später im
|
||||
bestätigten Wartungsfenster behoben. Der vorbereitete Fall `570c7a86…` bleibt
|
||||
unverändert ohne neue Rollenbelege; der tatsächliche neue Paarbeleg ist4887.
|
||||
|
||||
## Tatsächlicher gebundener Vorbereitungsschritt und Transfer
|
||||
|
||||
Lokale Vorbereitung `ad9fd154-b2be-4f5d-9e17-65abb721ceaf` bestanden;
|
||||
Config-SHA256 `2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b`,
|
||||
Manifest `0c9a3ffeed490757f7bd8c63d7e2ec28156212945094621f511e20679ce0b3b0`.
|
||||
Der getrennte Bindungsreview des Operators `a8d55b60…` hat bestanden.
|
||||
Erste tatsächliche Transferphase begann nach `2026-11-15T15:27:41Z`.
|
||||
Der fixierte Controller wurde einmalig übertragen und separat hashgeprüft;
|
||||
Originalantwort `stage-reply.json` im genannten privaten lokalen Fall,
|
||||
SHA256 `29f7654f766ebb53045832bb8c5ed6c83d2cbd96e0a5e1ce6df494cef0c026e6`.
|
||||
Noch kein Konfigurationsinstallations- oder Laufzeitnachweis aus diesem Schritt.
|
||||
|
||||
## Tatsächliche Installation: Teilzustand, nicht abgeschlossen
|
||||
|
||||
Der einmalige Installationsaufruf begann nach `2026-11-15T15:28:18Z`.
|
||||
Die VM hielt vor der ersten Erstellung die Originaluntergrenze
|
||||
`2026-11-15T15:28:24.1309868Z` im Intent fest. Der Bootstrap endete mit
|
||||
`IOException` an Controllerzeile294, dem einzigen
|
||||
`[IO.File]::Move($staged,$target)`. Der ursprüngliche sichere Fehlerbeleg
|
||||
`windows-client/system-pipe-upgrade/remote-error-b01d395c-9141-4bc6-ad70-1b67fb936881.json`
|
||||
enthält Exit1, Fehlerklasse und Zeile, keinen privaten Fehlertext. Die genaue
|
||||
I/O-Ursache ist damit noch nicht geklärt; es wird kein Sharing-/ACL- oder
|
||||
Antivirusproblem als bewiesen ausgegeben. Es gab keinen zweiten Installversuch.
|
||||
|
||||
Ein eigener ausschließlich lesender Originalaufruf begann nach
|
||||
`2026-11-15T15:28:37Z` und bestand. Originalantwort im privaten Fall
|
||||
`ad9fd154-b2be-4f5d-9e17-65abb721ceaf`:
|
||||
`read-51eea530-4155-42d7-9053-1008e84059b6-reply.json`, SHA256
|
||||
`93143fc05e7c814e9b164cd322abd411eee0dedcb485fbb5547a1db8f1975cd2`.
|
||||
Die feste Zieldatei ist **nicht vorhanden**. Der ursprüngliche Intent, aktive
|
||||
NoRetry-Marker, Directory-ACL-Intent und dessen Abschluss sowie der
|
||||
Publish-Intent sind vorhanden; ein `result.json` fehlt. Die nur für diesen
|
||||
Ordner erlaubten Service-Leserechte wurden somit gesetzt, die Konfiguration
|
||||
wurde nicht veröffentlicht. Originale FileIDs/Hashes/PKI-Metadaten, laufende
|
||||
Agent-/Helper-Prozessgenerationen, Jobfreiheit und Journalzeugen bestanden die
|
||||
lesende Erhaltungsprüfung.
|
||||
|
||||
Der Teilzustand bleibt unverändert; kein Retry, Rollback, Dienstwechsel oder
|
||||
RMM-Job wurde ausgeführt. Der passive Zeit-Collector wurde ausdrücklich
|
||||
**nicht** gestartet. `clock_runtime_qualified=false` bleibt bestehen. Nach dem
|
||||
bestätigten Wartungsfenster bis15:30UTC erfolgen keine weiteren VM-Aufrufe.
|
||||
Die gesonderte serverseitige `agent.update`-Inventar-Constraintkorrektur und
|
||||
anschließend frische Heartbeats/ACKs sowie echte signierte Zeitbelege bleiben
|
||||
getrennt zu prüfen. Eine spätere Fortsetzung benötigt zuerst eine lesende
|
||||
Ursachenklärung und einen konkret geprüften Vertrag für den ursprünglichen
|
||||
Teilfall; ein neuer Fall darf diesen Marker nicht umgehen.
|
||||
|
||||
## Sharing-Verletzung bei der Konsolenfinalisierung
|
||||
|
||||
Die VM meldete beim gesonderten Konsolenabschluss für `File.Move` den HRESULT
|
||||
`0x80070020` (Win32 32, Sharing-Verletzung). Der Helper hielt seit seinem
|
||||
Start einen Lesehandle auf `C:\ProgramData\RustDiscoverySystem`. Der Code
|
||||
erlaubte ausschließlich `FILE_SHARE_READ`. Beim Verschieben des Kandidaten
|
||||
aus dem Bootstrap-Verzeichnis öffnet Windows den **Zielordner** für
|
||||
`FILE_ADD_FILE`. Dieser Zugriff kollidiert mit dem gehaltenen Handle. Die
|
||||
native Fehlermeldung nennt keine Prozess-ID. Die Zuordnung folgt aus den
|
||||
Öffnungsmodi des Helpers und der dokumentierten Windows-Rename-Operation.
|
||||
[Windows-Rename](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-fsa/87f86c9b-6c2a-4803-84b7-131a74a434fa)
|
||||
· [Windows-Sharingprüfung](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-fsa/8c0e3f4f-0729-49f4-a14d-7f7add593819)
|
||||
|
||||
Im korrigierten Quellstand öffnen der Helper, der Agent beim Laden des
|
||||
Peer-Pins und die Zeitprüfung genau diesen öffentlichen Stamm über
|
||||
`PinnedFile::open_read_shared`. Der Lesehandle lässt auch einen berechtigten
|
||||
Schreibzugriff auf den Ordner zu. Weiterhin sperrt er das Löschen und
|
||||
Umbenennen des Ordners. Über Kinddateien entscheiden deren eigene DACL und
|
||||
gehaltene Datei-Pins. Einstellungen, Peer-Pin und Zeitprofildatei werden
|
||||
weiterhin mit geteiltem Lesezugriff geöffnet. Die vorhandenen Prüfungen von
|
||||
Owner, DACL, Reparse-Attributen und Dateiidentität laufen bei jedem Pin.
|
||||
|
||||
Workspace-Formatprüfung, Cargo-Check aller Windows-Ziele mit `system-helper`
|
||||
und Clippy mit `-D warnings` bestanden im Windows-Clock-Builder offline.
|
||||
Beide x86-64-PE-Debugprogramme wurden dort gelinkt. Agent-SHA-256
|
||||
`b5fe5ea55c857415c979f06851e54a2d1fbe4cbfe2fe7ad1660e209aae3fa583`,
|
||||
Helper-SHA-256 `c6b41b0867df23f2c04c2550a39678672ef66d35a4b41215769265924deaf8a1`.
|
||||
Der erste Buildversuch endete in einem anderen Builder wegen fehlendem
|
||||
`widl`. Die Windows-VM hat diese Änderungen bisher weder ausgeführt noch
|
||||
durch erneute Profilveröffentlichung und zwei passive Rollenbelege bestätigt.
|
||||
|
||||
### Optimiertes Release-Paar für die nächste Windows-Abnahme
|
||||
|
||||
Am 15. November 2026 wurden Agent und Helper aus Commit
|
||||
`e952698f5e2bab808e816858a727ef40347f6142` auf dem Entwicklungsrechner
|
||||
gebaut. Der Quellstand kam aus einem schreibgeschützt eingebundenen Git-Archiv.
|
||||
Der unabhängige Vergleich nach dem Build bestätigte alle 708 Quelldateien
|
||||
gegen Git-Tree `708c88b4d6a92d9f9cbebc70146250062532f45f`.
|
||||
Rust 1.99.1 und Cargo 1.99.1 liefen im vorhandenen Clock-Builder ohne Netzwerk.
|
||||
Der ausgeführte Befehl war
|
||||
|
||||
```sh
|
||||
cargo build --release --target x86_64-pc-windows-gnu --features system-helper --locked --offline -p rmm-agent-windows --bin rmm-agent-windows --bin rmm-helper-windows
|
||||
```
|
||||
|
||||
| Datei | Bytes | SHA-256 |
|
||||
| --- | ---: | --- |
|
||||
| `rmm-agent-windows.exe` | 23 543 434 | `2dd64e743431ad4c8244e43bef30c4c1c2123ad26a094853811a418626bb87e7` |
|
||||
| `rmm-helper-windows.exe` | 17 191 183 | `9c313c07a20c82797cbd8c8ca7c289c1d227b0bd6a4a686f38c4db3bbdded199` |
|
||||
|
||||
Beide Dateien haben einen ausführbaren PE32+-Header mit AMD64-Maschinenkennung
|
||||
`0x8664`. Der private Originalbeleg `profile-share-release-e952698/receipt.json`
|
||||
hat SHA-256 `1ec1ec472043e8673e5b92f9029fd809434451d9452e3b24bbd85b21f017017d`.
|
||||
Das erste Prüfskript traf auf dem Notebook auf eine ältere Python-Hashlib ohne
|
||||
`file_digest`. Die Nachprüfung lief mit SHA-256 über dieselben fertigen Bytes.
|
||||
Die Installation dieses Paars und die native Profilveröffentlichung mit den
|
||||
zu diesen Binaries passenden Zeitprofilbindungen stehen aus.
|
||||
|
||||
## Unabhängiger lokaler Review des Move-Fehlers und fester Diagnosepfad
|
||||
|
||||
Der nachfolgende Review liest ausschließlich Quellen und vorhandene öffentliche
|
||||
Originalbelege auf dem Entwicklungsrechner. Kein Gast-/Serverzugriff, keine
|
||||
Installation, kein Retry und keine Freigabe wurden dabei ausgeführt.
|
||||
|
||||
Belegt ist der Ablauf bis zum Publish-Intent mit Kandidathash
|
||||
`2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b`,
|
||||
1177Bytes, Volume9815088561147542064 und FileID6d990300000003000000000000000000.
|
||||
Der spätere originale Read93143fc0… belegt das fehlende Ziel und fehlendes Resultat.
|
||||
Er fragt jedoch die Kandidatdatei selbst nicht ab. Ihr aktueller Bestand ist
|
||||
somit **nicht** nachgewiesen. Original-rootSDDL im Intent, ACL-done-SDDL und spätere
|
||||
rootSDDL sind bytegleich: die ACL-Phase wurde ausgeführt, ohne effektive Rechte
|
||||
zu ändern. Bestehende NoRetry-Marker bleiben bestehen.
|
||||
|
||||
Die genaue Ursache der IOException ist mit diesen Belegen nicht bestimmbar.
|
||||
Der alte Fehlerbeleg enthält weder HRESULT noch nativen Fehlercode. Die statisch
|
||||
geprüften WriteBytes-, FileIdentity- und FileVolume-Handles werden in `finally`
|
||||
geschlossen; ein eigener Handleleak ist daraus nicht belegt. Das rechtfertigt
|
||||
weder eine Sharing-Lockerung noch Dienststopp, ACL-Änderung, Antivirusausnahme,
|
||||
Copy/Delete-Fallback oder erneuten Move. Microsoft beschreibt für
|
||||
[File.Move](https://learn.microsoft.com/en-us/dotnet/api/system.io.file.move)
|
||||
mehrere IOException-Ursachen; die Regeln für vorhandene Handles stehen getrennt
|
||||
in [CreateFile](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-createfilew).
|
||||
Sharing, Defender oder ein konkreter Win32-Code bleiben hier ausdrücklich
|
||||
Hypothesen. Der ursprüngliche HRESULT darf aus späteren Lesefehlern nicht
|
||||
rückwirkend abgeleitet werden.
|
||||
|
||||
Der bestehende Pythonoperator hat deshalb einen **separaten, ausschließlich
|
||||
lesenden** Originalfallpfad `diagnose-partial` erhalten. Er bindet ausschließlich
|
||||
Fallad9fd154-b2be-4f5d-9e17-65abb721ceaf, dessen Manifest0c9a3ffe…,
|
||||
Originalgeneratora8d55b60…, Originalcontrollerd8b4fd4f… und Konfigurationshash2b4a….
|
||||
Die vorhandenen Marker und Originaldateien werden nicht geändert. `load_case`
|
||||
wird absichtlich nicht verwendet: dessen Generatorbindung darf nicht auf die
|
||||
neue Quelle umgedeutet werden. Ebenso wird keine neue Skript-SHA als ursprüngliche
|
||||
`request.script_sha256` ausgegeben. Der neue Reader hat eine eigene Source-SHA,
|
||||
die der kleine In-Memory-Launcher vor der Ausführung prüft; genau ausgeführte
|
||||
Readerbytes, Intent, rohe Antwort und separater Receipt werden ausschließlich
|
||||
in einem neuen lokalen700/600-Diagnosefall gespeichert.
|
||||
|
||||
Geplanter Aufruf, **hier nicht ausgeführt**, erst nach erneut ausdrücklich
|
||||
bestätigtem Zugang und dessen erfolgreichem Readback:
|
||||
|
||||
```sh
|
||||
python3 /home/kevin/Schreibtisch/Coding/rust-discovery-signed-clock/deploy/windows/time_profile_config.py diagnose-partial
|
||||
```
|
||||
|
||||
Kein `--case`: der Reader akzeptiert keine andere Fall-ID oder frei wählbare
|
||||
Pfade. Die lokalen Originalbelege liegen weiterhin im Agent-Updater-Worktree.
|
||||
Die geschützte aktuelle Zugangskonfiguration muss noch mindestens60s zulassen;
|
||||
sonst erfolgt kein SSHaufruf. Native PowerShell-AST-/VM-Ausführung dieses neuen
|
||||
Readers sind noch offen. Er enthält keine Publish-/ACL-/Serviceoperation und
|
||||
fragt weder Uhrqualität noch Dienst-Snapshot ab.
|
||||
|
||||
Der Reader liefert nur aktuelle Kandidat-/Zielidentität, Größe, Hash, DACLhash,
|
||||
Attribute und Zeiten sowie feste Originalmarker/active-Bindung und Root-SDDL.
|
||||
Aktuelle Lesefehler werden mit Exceptiontyp/HRESULT und nur bei passender
|
||||
HRESULT-Facility mit Win32-Code aufgezeichnet, ohne freien Fehlertext. Diese
|
||||
Nummern gehören ausschließlich zum **neuen Leseversuch**. Er setzt immer
|
||||
`old_move_hresult_unknown=true`, `retry_authorized=false`,
|
||||
`installation_verified=false` und `clock_runtime_qualified=false`.
|
||||
|
||||
Das Ergebnis ist Grundlage einer späteren Entscheidung, keine Retryerlaubnis:
|
||||
|
||||
- Kandidat unverändert und Ziel fehlt: Veröffentlichung weiterhin nicht erfolgt;
|
||||
im nächsten aktiven Wartungsfenster anhand des Originalzustands mit einem
|
||||
überprüften Finalisierungsbefehl fertigstellen. Das MVP-/Profilvorhaben ist
|
||||
bereits beauftragt; dafür keine pauschale zusätzliche Chatgenehmigung verlangen.
|
||||
- Ziel vorhanden: weder Move noch Install erneut aufrufen; zuerst Ziel-/Kandidat-
|
||||
FileID-/Hash-/ACLbindung und tatsächliche Laufzeitwirkung getrennt beurteilen.
|
||||
- Fehlender/veränderter Kandidat, widersprüchliche Marker, andere Dateiidentität
|
||||
oder Lesefehler: Teilzustand erhalten, keine automatische Rekonstruktion,
|
||||
Löschung oder Rechte-/Dienständerung.
|
||||
|
||||
Lokal tatsächlich bestanden: Pythoncompile, bestehende Sourceguards und acht
|
||||
Vertragsfälle, davon zwei neue für den geschlossenen Reader und seine exakte
|
||||
Source-/Intent-/Receiptbindung ohne Legacy-Hashadoption. Der Transport ist dabei
|
||||
vollständig gemockt; dies ist kein nativer Befund. Die Kontrollbelege des alten
|
||||
fehlgeschlagenen Installationsfalls bleiben bytegleich erhalten. Ein konkreter
|
||||
Publikationsfix wurde mangels belegter nativer Fehlerursache nicht erfunden.
|
||||
|
||||
## Nachlese durch die Bedienperson auf der Windows-VM
|
||||
|
||||
In der administrativen VM-Konsole konnte die Bedienperson den Kandidaten
|
||||
`time-attestation.candidate.json` lesen. SHA-256 stimmte mit dem im
|
||||
Publish-Intent hinterlegten Wert `2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b`
|
||||
überein. Für den festen Zielpfad unter `RustDiscoverySystem` meldete
|
||||
PowerShell `ObjectNotFound`. Dieser Konsolenbefund ergänzt den früheren
|
||||
Readback um den Inhalt des verbliebenen Kandidaten. FileID, DACL und
|
||||
Dienstgeneration wurden bei dieser Konsolenabfrage nicht erfasst.
|
||||
|
||||
Für die Fortsetzung an derselben VM-Konsole liegt
|
||||
[`Complete-OriginalTimeProfile.ps1`](../deploy/windows/Complete-OriginalTimeProfile.ps1)
|
||||
bereit. Der Befehl übernimmt die Prüffunktionen aus den SHA-256-geprüften
|
||||
Bytes des bereits installierten Controllers. Vor der Veröffentlichung prüft er
|
||||
die ursprüngliche Datei-ID und das Volume, den Inhalt, die DACL, die
|
||||
ursprünglichen Marker und beide laufenden Dienstgenerationen. Er hält die
|
||||
beiden Prozesshandles während der Veröffentlichung offen. Ein exklusiv
|
||||
erstellter zusätzlicher Marker verhindert eine doppelte Ausführung.
|
||||
|
||||
Nach der Verschiebung an den festen Zielpfad vergleicht das Skript die
|
||||
Dateiidentität und die Dienstzustände erneut. Bei einem neuen Move-Fehler erfasst
|
||||
es Fehlerklasse und HRESULT für diesen Aufruf. Ein erneuter Start trifft auf
|
||||
den Abschlussmarker oder den vorhandenen Zielpfad und beendet sich. Das
|
||||
Ergebnis einer erfolgreichen Veröffentlichung hält die separate
|
||||
Laufzeitprüfung der beiden Dienstrollen ausdrücklich offen.
|
||||
|
||||
Lokal geprüft wurden die PowerShell-Syntax, die Bindung an die gespeicherten
|
||||
Originalbelege und der Vergleich mit der tatsächlichen Kandidatenidentität.
|
||||
Eine veränderte FileID wurde im lokalen Vergleich abgewiesen. Die Ausführung
|
||||
des Abschlussbefehls auf der VM und die anschließende Zeitprüfung stehen aus.
|
||||
|
||||
## Ergebnis vom Konsolenschritt automatisch abholen
|
||||
|
||||
Für den vorbereiteten Profilabschluss steht `Open-TimeProfileReceiptWindow.ps1`
|
||||
zur Verfügung. Die Bedienperson startet es auf der Windows-VM. Das Skript prüft
|
||||
die beiden Downloads gegen feste SHA-256-Werte, öffnet den vorhandenen
|
||||
Reverse-SSH-Transport und führt den festen Abschluss lokal aus. Die
|
||||
Weiterleitung auf dem Server ist an `127.0.0.1:22240` gebunden. Auf der VM
|
||||
endet sie an einem temporären Loopback-Port. Der Prozess sendet dort den
|
||||
Abschlussstatus und die öffentlichen Belege der beiden Zeitdienstrollen.
|
||||
Er liest keine Befehle vom Socket. Die Gast-Kontofrist und die Aufgabenplanung
|
||||
werden nicht geändert. Strg+C oder zwölf Minuten beenden das Vordergrundfenster.
|
||||
|
||||
Die serverseitige Frist für den vorhandenen Transportschlüssel und der aktive
|
||||
Abschalttimer wurden für den 15. November 2026, 18:00 Uhr MEZ, geprüft.
|
||||
Beim Bereitstellen wurden der PowerShell-Parser, die Downloadhashes, die
|
||||
bestehenden Quellprüfungen und die sechs lokalen Prüffälle für die Zeitbelege
|
||||
ausgeführt. Ein Ergebnis von der VM liegt bei Bereitstellung noch nicht vor.
|
||||
|
||||
Der Ergebnisempfänger auf dem permanenten Server wurde anschließend gestartet.
|
||||
Seine Anfangsprüfung des laufenden Gateways und der gespeicherten
|
||||
Windows-Gerätebindung war erfolgreich. Der Server fragt den Loopback-Port
|
||||
nur bei vorhandenem SSH-Listener ab und legt eingehende Belege im privaten
|
||||
Fall `time-profile-receipt-f7f56e9f` ab. Für Zeitbelege verwendet er die
|
||||
bestehende Rollen-, Boot-, Generations- und Altersprüfung mit je einer
|
||||
Datenbanklesung vor und nach dem Empfang. Die Bereitstellung des Empfängers
|
||||
belegt noch keine Profilveröffentlichung auf dem Gast.
|
||||
|
||||
## Rückmeldung der Windows-VM am 15. November um 17:05:36 Uhr MEZ
|
||||
|
||||
Der Empfänger hat im Fall `time-profile-receipt-f7f56e9f` die Antwort
|
||||
`finalization_failed` gespeichert. Der Abschlussbefehl bestand die Prüfungen
|
||||
auf Kandidat, Berechtigungen und Dienstgenerationen bis zur Veröffentlichung.
|
||||
Der Aufruf von `File.Move` meldete HRESULT **0x80070020**
|
||||
(`ERROR_SHARING_VIOLATION`). Zeile 94 gibt diesen Fehler an den Aufrufer
|
||||
weiter. Empfangsbeleg SHA-256
|
||||
`7cc51d44abfbe7949b0896053a463f3bd140b1844229e9ba206683db34d6f2ba`,
|
||||
Ergebnis `172edeaf54ca08f4e5b1ad3662884da6ec217636ca30bbd8274e73140f6ef35b`.
|
||||
|
||||
Der Code des installierten Helpers öffnet das öffentliche Stammverzeichnis
|
||||
mit Lesezugriff und ausschließlich `FILE_SHARE_READ` und hält diesen Handle
|
||||
im laufenden Dienst. Ein Rename aus einem anderen Verzeichnis benötigt am
|
||||
Zielverzeichnis `FILE_ADD_FILE`. Das erklärt einen konkreten Konflikt.
|
||||
Die VM-Rückmeldung enthält keine Liste der tatsächlich offenen Handles.
|
||||
Für den älteren Installationsaufruf ohne HRESULT bleibt der Fehlercode
|
||||
unbekannt. Das laufende Konsolenskript hat keine weitere Veröffentlichung
|
||||
versucht. Für diesen Lauf liegt keine erfolgreiche Zeitprüfung vor.
|
||||
[Windows-Dateisystemregeln für Rename](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-fsa/87f86c9b-6c2a-4803-84b7-131a74a434fa)
|
||||
|
||||
Nach der fehlgeschlagenen Erstveröffentlichung ergab eine unabhängige Abfrage
|
||||
von `inventory.get_device` über den permanenten Server einen neuen Kontakt
|
||||
um 17:12:44 Uhr MEZ, Präsenz `online` und Quelle `windows.base`.
|
||||
Geräte-ID, Agent-ID, Assignment, Enrollmentgeneration und authentifiziertes
|
||||
Zertifikat stimmten mit der Telemetrieabnahme vor dem Profilversuch überein.
|
||||
Der Agent meldete weiterhin die drei passiven Fähigkeiten `heartbeat/1`,
|
||||
`windows.base/1` und `agent.update/1`.
|
||||
### Erstprovisionierung nach dem belegten Sharingkonflikt
|
||||
|
||||
`Complete-OriginalTimeProfile.ps1 -InitialCreate` ist eine eigene Reparatur
|
||||
für das bislang fehlende Ziel. Sie setzt den vorhandenen Abschlussintent und
|
||||
den gespeicherten Fehler `File.Move / System.IO.IOException / 0x80070020`
|
||||
voraus. Die ursprünglichen Quell-, ACL-, Dienst-, Geräte- und
|
||||
Kandidatenbindungen gelten weiter. Der ursprüngliche Kandidat bleibt als
|
||||
Referenz erhalten. Der alte Move-Erfolg und dessen `result.json` werden durch
|
||||
diesen Pfad nicht nachträglich erzeugt.
|
||||
|
||||
Der feste neue Name wird genau einmal mit `CreateNew` angelegt. Windows
|
||||
erhält dabei bereits eine geschützte DACL mit explizitem Leseverbot für die
|
||||
beiden Service-SIDs. Der kontrollierende Prozess besitzt den einzigen
|
||||
Datenhandle. Er schreibt und flusht die 1177 qualifizierten Bytes und liest sie
|
||||
über denselben Handle vollständig zurück. Er prüft Hash, Volume, neue FileID,
|
||||
einzigen Hardlink, Länge und DACL. Dann prüft er die ursprüngliche
|
||||
Kandidatenidentität und die laufenden Dienste noch einmal und schreibt einen
|
||||
Prüfbeleg. Erst jetzt setzt er die bereits gebundene endgültige DACL auf dem
|
||||
gehaltenen Handle und prüft Identität, Hash und DACL erneut. Nach Schließen
|
||||
folgt eine separate Prüfung beider Pfade und Dienste. Damit wird eine neue
|
||||
Ziel-FileID dokumentiert. Die DACL des öffentlichen Ordners bleibt unverändert.
|
||||
[Windows-Dateierstellung](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-fsa/498a5eeb-afc9-445f-99ed-a7e4b73c648b)
|
||||
[.NET-Framework-Konstruktor mit Erstellungs-DACL](https://learn.microsoft.com/en-us/dotnet/api/system.io.filestream.-ctor?view=netframework-4.8)
|
||||
|
||||
Eine vor der DACL-Freigabe unterbrochene Erstellung kann eine vorhandene
|
||||
Teildatei mit gesperrtem Dienstzugriff hinterlassen. Nach erfolgter
|
||||
DACL-Freigabe ist die Datei lesbar, auch wenn der Prozess vor dem
|
||||
abschließenden Ergebnis ausfällt. Ein neuer Versuch wird in beiden Fällen
|
||||
verweigert. Die getrennten `console-initial-create-*`-Dateien dokumentieren
|
||||
Intent, verifizierte neue Zielidentität und tatsächlichen Abschluss oder
|
||||
Fehlerphase. Das Ergebnis weist `clock_runtime_qualified=false` aus. Für
|
||||
dessen positive Bewertung sind weiterhin die unabhängigen Zeitbelege der
|
||||
installierten Dienste erforderlich.
|
||||
|
||||
Lokal bestanden Parserprüfung, Kompilierung des kleinen nativen
|
||||
Handle-Readers, Prüfung seines Strukturlayouts und drei simulierte
|
||||
Entscheidungsfälle mit echtem beziehungsweise verändertem Fehlerbeleg.
|
||||
Der frühere lokale Prüfharness wählte beim ersten Strukturlayoutaufruf die
|
||||
falsche .NET-Überladung; nach Angabe des Typs bestand die Prüfung. Der
|
||||
Original-Kandidaten-/FileID-Vergleich und die acht bisherigen Profilfixtures
|
||||
bestanden ebenfalls. Dieser Stand wurde auf der Windows-VM noch nicht
|
||||
ausgeführt.
|
||||
|
||||
Das passende Konsolenfenster ruft ausschließlich die Variante `-InitialCreate`
|
||||
auf. Der neue Empfänger `time-profile-receipt-f0488aba` war vor Übergabe des
|
||||
Befehls aktiv und hat die erwartete Geräte- und Gatewaybindung geprüft. Er
|
||||
unterscheidet die neue Rückmeldung von der alten Move-Fehlermeldung und
|
||||
speichert die Erstveröffentlichung und den signierten Rollenvergleich getrennt.
|
||||
Für diesen Skriptstand liegen bei Bereitstellung ausschließlich lokale Prüfungen
|
||||
vor. Die Bestätigung der VM steht aus.
|
||||
|
||||
Am 15. November endete die Freigabe um 18:00 Uhr MEZ. Der Empfänger für
|
||||
die Erstveröffentlichung schloss mit `window_expired`. Es lag keine
|
||||
entsprechende Gastquittung vor. Für die Fortsetzung wurde derselbe
|
||||
Weiterleitungsschlüssel bis 23:45 Uhr MEZ freigegeben. Frist und aktiver
|
||||
Abschalttimer wurden auf dem Server geprüft. Der neue Empfänger
|
||||
`time-profile-receipt-a6bb4e2f` hat den Gateway- und Gerätebezug geprüft
|
||||
und ist bereit. Der Konsolenstarter nimmt die Serverfrist als Parameter
|
||||
`-Until` entgegen und begrenzt jeden lokalen Start weiterhin auf zwölf Minuten.
|
||||
|
||||
### Rückmeldung aus dem Abendfenster
|
||||
|
||||
Um 20:24:02 Uhr MEZ empfing der Server im Fall `time-profile-receipt-a6bb4e2f`
|
||||
die Gastquittung `finalization_failed`. Der Aufruf mit `CreateNew` hatte das
|
||||
Ziel geöffnet. Bei der ersten Prüfung am offenen Handle wich die vom Kernel
|
||||
gelesene SDDL-Zeichenfolge vom vorbereiteten Sicherheitsdeskriptor ab. Der
|
||||
Controller brach in `verify_creation` in Zeile 176 mit `0x80131501` ab.
|
||||
Der Abbruch lag vor dem ersten Schreiben von Profilbytes und vor der Freigabe
|
||||
der Datei für die Dienste. Der HRESULT stammt von der ausgelösten
|
||||
PowerShell-Ausnahme. Er identifiziert keine abweichende Berechtigung.
|
||||
|
||||
Die Quittung enthält weder die beiden Deskriptoren noch eine spätere Nachlese
|
||||
der Zieldatei. Der konkrete Unterschied und der aktuelle Dateizustand bleiben
|
||||
zu prüfen. Der Empfänger beendete sich nach diesem Fehler wie vorgesehen.
|
||||
Es gibt aus diesem Lauf keinen erfolgreichen signierten Rollenvergleich.
|
||||
SHA-256 der Gastantwort samt Serverkontext:
|
||||
`a1725dbc532f022857e828080bec107ec32efd58836e22dd250909b9d7c2d28b`.
|
||||
|
||||
Ein separater MCP-Abruf bestätigte anschließend einen neuen Windows-Heartbeat
|
||||
um 20:25:35 Uhr MEZ. Präsenz war `online`, die Quelle `windows.base`.
|
||||
Gerät, Agent, Assignment, Enrollmentgeneration und authentifiziertes Zertifikat
|
||||
stimmten mit dem früheren Abnahmebeleg überein. Beleg-SHA-256
|
||||
`7ea828b42b3c7948956aad56845502ffa52192ce6ca14728203f8574d70a28ec`.
|
||||
|
||||
Der Konsolenstarter prüft im aktualisierten Quellstand vor einem Aufruf des
|
||||
Abschlussbefehls auf einen vorhandenen Fehler oder einen offenen Intent.
|
||||
In beiden Fällen liest er den vorhandenen Stand. Die Rückmeldung kennzeichnet
|
||||
mit `finalizer_invoked`, ob dieser Start den Abschlussbefehl aufgerufen hat.
|
||||
Enthält der Fehlerbeleg die bei der Erstellung verglichenen Deskriptoren,
|
||||
überträgt der Starter sie mit der Länge und den vorhandenen Datei-IDs an den
|
||||
Ergebnisempfänger. Ältere Fehlerbelege bleiben ohne diese Angaben lesbar.
|
||||
|
||||
Der PowerShell-Parser und fünf lokale Fälle bestanden: erster Aufruf,
|
||||
vorliegender Fehler, offener Intent, bereits vorliegender Erfolg und
|
||||
widersprüchliche Erfolgs-/Fehlermarker. Nur der erste Fall rief im Test den
|
||||
simulierten Abschluss auf. Diese Prüfung lief auf dem Entwicklungsrechner.
|
||||
|
||||
### Fehlerbeleg beim ersten Vergleich des Sicherheitsdeskriptors
|
||||
|
||||
Unterscheiden sich Soll- und Ist-SDDL an der neu angelegten Datei, erfasst der
|
||||
Controller beide Werte für Besitzer, Gruppe und DACL am exklusiv gehaltenen
|
||||
Dateihandle. Der private Fehlerbeleg enthält dazu das optionale Feld
|
||||
`creation_descriptor` mit `expected_sddl`, `actual_sddl` und `bytes`.
|
||||
Bei erfolgreicher nativer Identitätsabfrage kommen `file_id` und
|
||||
`volume_serial` hinzu. Scheitert das Lesen der Zusatzmetadaten, hält
|
||||
`metadata_hresult` dessen Fehlercode fest. Die ursprüngliche Abweichung
|
||||
bricht den Aufruf vor dem Schreiben der Profilbytes und der Rechtefreigabe ab.
|
||||
Der ältere Gastbeleg enthält diese neuen Felder noch nicht.
|
||||
|
||||
Lokal bestanden die Parserprüfung, vier PowerShell-Fälle für Vergleich und
|
||||
Fehlerbeleg sowie die acht vorhandenen Profiltests. Die vier Fälle umfassten
|
||||
ungleiche Deskriptoren mit lesbarer beziehungsweise fehlender FileID, einen
|
||||
gleichen Deskriptor und einen unabhängigen Folgefehler. Die FileID-Abfrage war
|
||||
simuliert. Eine native Abnahme dieser Belegerweiterung steht aus.
|
||||
|
||||
### Konsolennachweis der leeren Zieldatei
|
||||
|
||||
Die Bedienperson las den festen Zielpfad auf dem Windows-Gast. Die
|
||||
Dateigröße betrug 0 Byte. Beim Vergleich der ungebrochenen SDDL-Texte
|
||||
unterschieden sich ausschließlich die DACL-Steuerflags: erwartet `PAI`,
|
||||
gelesen `P`. Beide Deskriptoren enthalten denselben Eigentümer und dieselbe
|
||||
Gruppe (BUILTIN-Administratoren), die geschützte DACL und dieselben sechs
|
||||
expliziten ACEs in identischer Reihenfolge. Die beiden Dienst-SIDs haben
|
||||
je eine explizite Verweigerung von ReadData. Der Befund erklärt den
|
||||
Textvergleichsabbruch. Er belegt keine Freigabe der Datei.
|
||||
|
||||
SHA-256 der UTF-8-Texte ohne die Zeilenumbrüche der Konsolendarstellung:
|
||||
erwartet `d4726c7973c9b0cd8a66c1b129d1b5eb58d2bbfc1b103018e0a31a71fb1d9020`,
|
||||
gelesen `a0e1d856ed3bdbe884b23599f7c53d8a281d6409a42bbfa48649127b2aa22793`.
|
||||
Die erste Fehlerquittung enthielt keine FileID der leeren Zieldatei.
|
||||
|
||||
Der Modus `-ResumeEmpty` prüft die bestehenden Fallbelege und öffnet das
|
||||
leere Ziel exklusiv. Vor dem Schreiben protokolliert er dessen jetzt
|
||||
festgestellte FileID. Dieselbe Kennung muss nach dem Schreiben und nach
|
||||
der Freigabe der Leserechte wieder vorliegen. Beim DACL-Vergleich sind nur
|
||||
die beiden für diesen Fall beschriebenen Formen zulässig. Der Starter
|
||||
vergleicht die FileID zusätzlich mit der Quittung. Der Rückkanal überträgt
|
||||
das Ergebnis und die passiven Zeitmessungen.
|
||||
|
||||
Lokal bestanden acht Profiltests, die PowerShell-Parserprüfung, die
|
||||
C#-Kompilierung, fünf AMD64-Strukturlayoutprüfungen und 20 Vergleiche
|
||||
von Sicherheitsdeskriptoren. Acht lokale Fälle prüften die Auswahl des
|
||||
Startmodus und das Verhalten bei vorhandenen Markern. Die Anwendung auf
|
||||
dem Windowsgast und signierte Zeitmessungen beider Dienste stehen aus.
|
||||
|
||||
### Windows-VM, 15. November 2026, 20:40 Uhr MEZ
|
||||
|
||||
Der Controller schloss die Profilinstallation im Fall
|
||||
`ad9fd154-b2be-4f5d-9e17-65abb721ceaf` ab. Ab
|
||||
`2026-11-15T19:40:47.0850024Z` schrieb er die vorbereiteten 1177 Bytes.
|
||||
Beim Rücklesen stimmten der erwartete SHA-256
|
||||
`2b4a8a7080770304b80e2a665fa5f5ee1ebbd9182e7c80b184e75b114575b42b`
|
||||
und die bei leerer Datei protokollierte FileID
|
||||
`95990300000007000000000000000000` überein. Der Kandidat blieb erhalten.
|
||||
Agent und Helper liefen während der Veröffentlichung weiter.
|
||||
|
||||
Der Empfänger auf dem Projektserver bestätigte die Quittung in Sitzung
|
||||
`d8b4b255-8e3f-4aa7-8377-684ce9adbea1`.
|
||||
SHA-256 des Gast-Ergebnisbelegs
|
||||
`62a04be9c7d08d3687b51eacd6adbe290b91e16ba934d6b5bb531e8764a56cf5`,
|
||||
SHA-256 der serverseitigen Publikationsquittung
|
||||
`1a0ce65c852523072d6822024541591482e0bae3788834993c2548e9cbf7647e`.
|
||||
Um 20:40:59 Uhr MEZ fehlte beim anschließenden Lesen noch mindestens
|
||||
einer der beiden passiven Zeitbelege.
|
||||
@@ -41,3 +41,15 @@ Rustfmt nur dieses Example (`skip_children`), Windows-Examplecheck, Clippy mit `
|
||||
`TimeRouteProbe.exe`:19172660Bytes, AMD64-PE, SHA256 `4ef3fc85f5d140f2ad0ff14745dc5d5453a058203d785235d7dabafdf522b088`, Modus0500/ein Hardlink. Enger Readonly-Capabilitymanifest-SHA256 `22ca87604e942b91e68981f694934bc8c933c5fb5ab5858f27a2d3884d64df42`. Der neue Produktpaarbeleg26dc/5967 und dessen Modulquelle d859 bleiben unverändert; dieses Example installiert oder startet keinen Agenten.
|
||||
|
||||
Offen: unabhängiger Fixture-Review, echtes Gateway-/Brokerdeployment und dessen frische Kontextprovenienz, einmalige native Ausführung mit200/403/409, separater lesender Originalfallnachweis und tatsächliche Erhaltungs-/Nulljobwitnesses. Erst danach ist dieser Endpunktgate für die nächste getrennte passive Paarwartung verfügbar. Windows-MVP-Wirkungsabnahmen bleiben offen.
|
||||
|
||||
## Native passive Protokollabnahme
|
||||
|
||||
Tatsächlich anschließend auf der Windows-VM bestanden: genau ein fester
|
||||
HTTP200/403/409-Lauf mit echter Signatur-/vollständiger Kontextprüfung und Exit0,
|
||||
sowie separater Originalfallread mit bytegleicher Antwort. Fall68b841a5-784f-4a34-a8a4-060b267713f0;
|
||||
Runreplyc556747f75987f8d6ced477086cfd77edfb00f2ac74a99b6e721f3c278ecc28a,
|
||||
Runpreservation04bb81f781656f9e695225885b5088d498d1ebe5708a95db563dd6321525617a,
|
||||
Readpreservatione9ef65dc101505919bcba00e1a214d752f44154d6b3f5789c27234551e01e9b9.
|
||||
Details und die ehrlichen Grenzen des ersetzten alten Abschlusslesers stehen in
|
||||
`windows-time-route-operator.md`. Keine Dienstrolle/Clockfrische/SyncReady oder
|
||||
Jobwirkung durch diese Fixture bewiesen.
|
||||
|
||||
@@ -59,3 +59,63 @@ Eigener unveränderlicher Fall
|
||||
ReceiptSHA `44504007fa7d0379e608375181b926ff2a20ae248cfeb2fb51d127b858b3536d`.
|
||||
ScriptSHA bleibt `4c88fdf36f22b0273baaa08bf522bfefbf8482b45317ef852c0e0a331a1fbef2`.
|
||||
Deployment-/Kontextgates bleiben geschlossen, Stage und Route weiterhin offen.
|
||||
|
||||
## Tatsächliche passive Route und separater Read bestanden
|
||||
|
||||
Root hat den tatsächlichen erfolgreichen Unterfall
|
||||
`continue-backend-v1/result.json` mit SHA
|
||||
`3017634f101ee8aff62988f195ccb3a7a8b9e03eaa48b8fb339af9ceb3ad2b4b`
|
||||
und separater Nachlese gebunden. Der alte fehlgeschlagene Deploymentfall bleibt
|
||||
unverändert fehlgeschlagen. Collectorfall68b841a5-784f-4a34-a8a4-060b267713f0,
|
||||
Receipt658fa5ffa63c6e412237f5feb718b745bb560230f17c54e437ad8bd98e9ad65b,
|
||||
Kontext3c0e4ff3b16b86fb4e98d2ff163686305ea533570c40ae3bef1270ab89648ed3:
|
||||
tatsächliche aktuelle Geräte-/Tenant-/Generation-/Bootbindung und Gatewayimage.
|
||||
Die ungenutzte doppelte Deploymentpfadkonstante wurde entfernt.
|
||||
|
||||
Stage meldete tatsächlich Erfolg, bevor der nachgelagerte alte14fb-finish-
|
||||
Leser nach180s ohne Antwort abbrach. Das ist kein erfolgreicher Originalwitness.
|
||||
Eine direkte lesende Diagnose antwortete sofort, keine laufenden Probeprozesse.
|
||||
Der erste Agentname dieser Diagnose war falsch; `present=false` für
|
||||
`RustDiscoveryAgent` ist kein Ausfall des tatsächlichen `RmmDiscoveryWindows`.
|
||||
Keine Stage wurde wiederholt und bis dahin kein HTTP-Probelauf gestartet.
|
||||
|
||||
Auf ausdrückliche Rootanweisung ersetzte die Fortsetzung den hängenden früheren
|
||||
Upgradeabschlussleser durch dessen vorhandene reine FileID-/SCM-/Kernelprimitive,
|
||||
ohne Journal-/Clock-/Snapshotaufruf. Die ersten umfangreichen Readerbytes
|
||||
überschritten als EncodedCommand die Windows-Kommandozeilengrenze; der Reader
|
||||
wurde danach als feste hashgebundene Nutzlast über stdin übermittelt. Auch dieser
|
||||
Fehler lag vor jedem Probestart. Originalbelege wurden nicht überschrieben.
|
||||
Die Fortsetzung liegt als enge `direct()`-Funktion im bestehenden Operator;
|
||||
keine weitere Operator-Datei entstand. Tatsächlich ausgeführte Quelle ist im
|
||||
Originalfall als `executed-direct-operator.py` unverändert gesichert.
|
||||
|
||||
Der einzige tatsächliche TimeRouteProbe-Lauf ergab:
|
||||
|
||||
- HTTP200, echte Ed25519-Signatur, kompletter eigener Nonce-/Request-/Kontextbezug.
|
||||
- HTTP403 für den fest abweichenden Tenant.
|
||||
- HTTP409 für die vorherige Verbindungsgeneration.
|
||||
- Tatsächliches Kernelprozessende mit Exit0, kein Timeout, stderr leer.
|
||||
|
||||
Runreply `c556747f75987f8d6ced477086cfd77edfb00f2ac74a99b6e721f3c278ecc28a`,
|
||||
Erhaltungsbeleg `04bb81f781656f9e695225885b5088d498d1ebe5708a95db563dd6321525617a`.
|
||||
Separater Read `read-direct-6f2e1bc2-e26c-4dfb-a642-06a6a154ef5c` bestätigt
|
||||
bytegleichen gespeicherten Runreply und neuen Erhaltungsbeleg
|
||||
`e9ef65dc101505919bcba00e1a214d752f44154d6b3f5789c27234551e01e9b9`.
|
||||
Tatsächlicher ReportSHA9f1635c19c801f95c9828e9e31071a487b430f105a61977ee2d60f076f3d3623,
|
||||
ExitfileSHA6d131d2796936913f53286573e56f7fb3e515d04ebbd55ae9d6794440e6053b5.
|
||||
|
||||
Direkt vor/nach Run und Read unverändert: laufende ursprüngliche Dienste mit
|
||||
Kernel-PID/Geburt/Image/Konto, ursprüngliche config/PKI/Publicpin-Bytes,
|
||||
DateiIDs/ACLs und Privatekeymetadaten ohne Keyread, native Telemetriedateiidentität
|
||||
sowie aktuelle Helper-DB-/Lockdateiidentitäten. Deren alte FileID/Geburt stimmen
|
||||
ebenfalls; die historischen ACL-Digests aus dem anderen Probe sind abweichend
|
||||
und werden ausdrücklich nicht als erfolgreicher Altvergleich ausgegeben.
|
||||
Aktuelle direkte ACL-Metadaten sind vor/nach identisch. Geschlossene Windows-
|
||||
Job-/Outbox-/Permitzähler bleiben0; Linux31/31/27 und Rootpolicy unverändert.
|
||||
Der alte umfassende Journalabschlussleser bleibt als Timeout offen; es wurde
|
||||
keine erneute Journalintegritätsprüfung behauptet.
|
||||
|
||||
Dies ist ausschließlich eine tatsächliche passive mTLS-/Signatur-/Kontextabnahme.
|
||||
Dienstrollen-Zeitauthorität, Clockfrische, SyncReady und Jobwirkungen bleiben
|
||||
weiterhin unbewiesen und geschlossen. Kein Agentpaarwechsel oder VM-Neustart
|
||||
war Bestandteil dieses Schrittes.
|
||||
|
||||
@@ -79,3 +79,72 @@ aktuelle Runtime-/Control-/Stateidentitäten, Receipt
|
||||
Unabhängiger Quellenreview des Schema-/Bracket-/Constructorfencedeltas ebenfalls
|
||||
ohne konkreten Befund abgeschlossen. Keine Windows-Rollen-/Zeitkonfiguration,
|
||||
kein RMM-Job oder Effektgate wurde dadurch aktiviert.
|
||||
|
||||
## Tatsächliche öffentliche Vorbereitungsdaten, keine Konfiguration
|
||||
|
||||
Lokaler Fall `windows-time-profile-public-preparation/c3077acf-12da-410e-9f55-e75a1cd0a75f`
|
||||
bindet den tatsächlich selektiv gelesenen KVM-/Hypervclock-Plattformbeleg94ae865e…,
|
||||
den echten öffentlichen Zeitpin c31d31d2…, die unveränderte öffentliche14fb-
|
||||
Gerätebindung und das tatsächliche202-Input-Produktpaar26dc/5967. Receipt
|
||||
`97e4db147f31f3cff134d2bc596d7d73ea5330b8b5a87971f215bb03a9751391`,
|
||||
Provenienz `1c0db66cd0692024f68bddd71949692d274380a86e4b880fea0756479ceb5d0c`.
|
||||
Timekey und konkreter Jobkey sind verschieden. Keine private Signierdatei gelesen.
|
||||
|
||||
Der ausdrücklich gelieferte öffentliche Plattformoriginalbeleg hat Modus0664;
|
||||
der vorhandene0600-Pinloader wies ihn zuerst erwartungsgemäß ab. Originalbytes
|
||||
und Modus wurden nicht geändert. Die bekannte SHA94ae bindet ausschließlich eine
|
||||
neue eigene0600-Kopie innerhalb dieses lokalen700-Falls; sie wird nicht als schon
|
||||
provisionierter geschützter Zielpin ausgegeben. Keine zusätzliche Operatorquelle
|
||||
oder Toolinstallation entstanden.
|
||||
|
||||
Dieser Fall ist ausdrücklich **keine** `time-attestation.json`. Für die beiden
|
||||
Schema2-`qualification_sha256` fehlen noch tatsächliche Dienst-/Prozess-/Imagebelege
|
||||
der neuen Produktimages. Der frühere Rawcapture-Probe601… ist ein anderes Image
|
||||
und ersetzt diese Bindung nicht. Nach der getrennten passiven Paarwartung dürfen
|
||||
die tatsächlichen neuen LocalService-/SYSTEM-Kernel-/Servicebelege mit vorhandenen
|
||||
Source-, Rawcapture- und Plattformbelegen verbunden werden. Erst danach wird die
|
||||
echte V2-Konfiguration erstellt; Runtimefrische und Genehmigungen folgen getrennt.
|
||||
|
||||
## Zeitprüfung bei ausgeschalteten Jobs am 15. November 2026
|
||||
|
||||
Die Konsole der laufenden VM bestätigte, dass weder der Jobschalter noch die
|
||||
Jobbindung konfiguriert waren. Die Zeitprofildatei war noch nicht installiert.
|
||||
Die bisherige Runtime übersprang bei ausgeschalteten Jobs auch den gesamten
|
||||
signierten Zeitvergleich. Damit konnte die geplante Rollenprüfung über diesen
|
||||
passiven Dienststand nicht beginnen.
|
||||
|
||||
Im neuen Quellstand prüft der Agent am Heartbeat, ob das geschützte Zeitprofil
|
||||
vorliegt. Erst dann beginnen Agent und Helper den vorhandenen Vergleich mit
|
||||
eigenen Challenges. Für den passiven Betrieb beträgt die Pause zwischen
|
||||
Vergleichen pro Rolle 30 Sekunden. Die Datei allein belegt keine Zeitqualität.
|
||||
Beide Rollen prüfen Pin, Gerätebindung, Signatur und Fristen. Der Jobschalter,
|
||||
die JobClock und die Genehmigung bleiben getrennt. Ein Fehler beim Start des
|
||||
passiven Vergleichs lässt Heartbeats und Inventar weiterlaufen.
|
||||
|
||||
Neun gezielte Prüfungen bestanden erst lokal und dann auf der Cloud-Linux-VM
|
||||
als UID 65534 (Exit 0, 15 weitere Tests gefiltert, Ergebnis-SHA-256
|
||||
`3424b0f916f0c9e68ed24d8ee0adeeb5feb5e8e834f63cfcbaadc5e45b06f840`).
|
||||
Die neue Prüfung umfasst Profilauswahl und Abfrageintervall. Der Windows-Crossbuild
|
||||
der Librarytests und Clippy mit allen Windows-Targets und `system-helper`
|
||||
bestanden. Die installierten Dienstbinärdateien haben eigene Versionsnachweise.
|
||||
|
||||
Dieselben neun Tests liefen danach aus dem gebauten Windows-Testbinary auf der
|
||||
Windows-11-VM. Die Namensliste der bestandenen Tests stimmte mit der auf der
|
||||
Cloud-Linux-VM überein. Ergebnis: AMD64, Exit 0, neun bestanden, null
|
||||
fehlgeschlagen oder übersprungen, 42 weitere gefiltert. Quittung
|
||||
`39c76e698f5dd351096d1deed40cddbcc1a6677f93457b48ad4a4c3cedb36e88`.
|
||||
Der native Testprozess prüfte die Logik mit Testdaten. Der signierte
|
||||
Zeitvergleich in den beiden installierten Dienstprozessen ist eine eigene
|
||||
offene Abnahme.
|
||||
|
||||
Für den Nachweis aus den laufenden Diensten hält der Agent je passiver Verbindung
|
||||
den ersten vollständig geprüften Zeitvergleich pro Rolle fest. Im Agent-State
|
||||
entstehen `agent-time-sample.json` und `helper-time-sample.json`. Die
|
||||
SYSTEM-Beobachtung setzt die authentifizierte positive Antwort des Helpers auf
|
||||
`TimeComplete` voraus. Beide Belege enthalten Rolle, Agent-PID, Windows-Boot,
|
||||
Verbindungsgeneration, Verifier-Inkarnation, Beobachtungszeit und die SHA-256-Werte
|
||||
der Anfrage und der empfangenen Antwort. Der Agent veröffentlicht sie beim
|
||||
Heartbeat aus dem Zustand der jeweiligen Verbindung. Diese historischen Daten
|
||||
werden bei der Jobfreigabe und der Prüfung der aktuellen Zeit nie eingelesen.
|
||||
Der erweiterte Code bestand den Windows-Alltargets-Clippycheck. Die tatsächlichen
|
||||
Belegdateien der installierten Rollen stehen noch aus.
|
||||
|
||||
@@ -0,0 +1,9 @@
|
||||
-- Passive agent-update observations share the existing tenant/device-bound
|
||||
-- ingest path. Preserve both base scopes and every existing row/RLS/FK.
|
||||
-- SQLx applies this file transactionally and records its normal checksum.
|
||||
SET LOCAL lock_timeout = '3s';
|
||||
SET LOCAL statement_timeout = '15s';
|
||||
ALTER TABLE observations DROP CONSTRAINT observations_source_id_check;
|
||||
ALTER TABLE observations ADD CONSTRAINT observations_source_id_check
|
||||
CHECK (source_id IN ('linux.base', 'windows.base', 'agent.update')) NOT VALID;
|
||||
ALTER TABLE observations VALIDATE CONSTRAINT observations_source_id_check;
|
||||
@@ -0,0 +1,34 @@
|
||||
{
|
||||
"os": "Linux",
|
||||
"hostname": "synthetic-codec-only",
|
||||
"architecture": "x86_64",
|
||||
"root_total_bytes": 2,
|
||||
"root_available_bytes": 1,
|
||||
"root_available_inodes": 1,
|
||||
"collection_started_at": "2026-11-15T12:00:00Z",
|
||||
"collection_completed_at": "2026-11-15T12:00:00Z",
|
||||
"observations": [
|
||||
{
|
||||
"scope": "linux.agent_update.catalog",
|
||||
"source_id": "agent:cached-release-catalog-v1",
|
||||
"observed_at": "2026-11-15T12:00:00Z",
|
||||
"quality": "valid",
|
||||
"completeness": "complete",
|
||||
"truncated": false,
|
||||
"error_code": null,
|
||||
"data": {
|
||||
"schema_version": 1,
|
||||
"source_id": "mtls:release-catalog-v1",
|
||||
"checked_at": "2026-11-15T10:00:00Z",
|
||||
"status": "available",
|
||||
"candidate": {
|
||||
"release_id": "11111111-1111-4111-8111-111111111111",
|
||||
"release_sequence": 8,
|
||||
"version": "0.1.8",
|
||||
"manifest_sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
|
||||
"keyring_generation": 4
|
||||
}
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,17 @@
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { expect, it, vi } from 'vitest';
|
||||
import { renderToStaticMarkup } from 'react-dom/server';
|
||||
import { CatalogCheckNotice } from './catalog-check';
|
||||
|
||||
it('shows actual check time separately from later inventory cache reading without actions or requests', () => {
|
||||
const fetch = vi.fn(); vi.stubGlobal('fetch', fetch);
|
||||
try {
|
||||
const device = { inventory: JSON.parse(readFileSync(new URL('../../tests/agent_update/catalog-check-inventory.json', import.meta.url),'utf8')) };
|
||||
const html = renderToStaticMarkup(<CatalogCheckNotice device={device}/>);
|
||||
for (const expected of ['2026-11-15T10:00:00Z', '2026-11-15T12:00:00Z', '0.1.8', 'available', 'keine Installation']) expect(html).toContain(expected);
|
||||
expect(html).not.toMatch(/<(button|form|input|script)\b/); expect(fetch).not.toHaveBeenCalled();
|
||||
device.inventory.observations[0]!.data.candidate.version = '<script>approve()</script>';
|
||||
expect(renderToStaticMarkup(<CatalogCheckNotice device={device}/>)).toContain('role="alert"');
|
||||
expect(renderToStaticMarkup(<CatalogCheckNotice device={{inventory:{}}}/>)).toBe('');
|
||||
} finally { vi.unstubAllGlobals(); }
|
||||
});
|
||||
@@ -0,0 +1,28 @@
|
||||
import type { RecordValue } from './api';
|
||||
|
||||
function object(value: unknown): RecordValue | null { return value !== null && typeof value === 'object' && !Array.isArray(value) ? value as RecordValue : null; }
|
||||
const exact = (value: RecordValue, keys: string[]) => Object.keys(value).every(key => keys.includes(key));
|
||||
const date = (value: unknown): value is string => typeof value === 'string' && value.length <= 40 && Number.isFinite(Date.parse(value));
|
||||
const positive = (value: unknown) => Number.isSafeInteger(value) && Number(value) > 0;
|
||||
export function CatalogCheckNotice({ device }: { device: unknown }) {
|
||||
const inventory = object(object(device)?.inventory), entries = inventory?.observations;
|
||||
if (!Array.isArray(entries)) return null;
|
||||
const matches = entries.map(object).filter(entry => entry?.scope === 'linux.agent_update.catalog');
|
||||
if (!matches.length) return null;
|
||||
const invalid = <p role="alert">Gespeicherter Releasekatalogcheck ist ungültig; kein Updatebeleg.</p>;
|
||||
if (matches.length !== 1) return invalid;
|
||||
const entry = matches[0]!, report = object(entry.data);
|
||||
if (!report || entry.source_id !== 'agent:cached-release-catalog-v1' || entry.completeness !== 'complete' || entry.truncated !== false || !date(entry.observed_at)
|
||||
|| !exact(report, ['schema_version', 'source_id', 'checked_at', 'status', 'candidate']) || report.schema_version !== 1 || report.source_id !== 'mtls:release-catalog-v1'
|
||||
|| !date(report.checked_at) || Date.parse(report.checked_at) > Date.parse(entry.observed_at) + 1000) return invalid;
|
||||
const status = report.status, candidate = object(report.candidate), available = status === 'available' || status === 'current';
|
||||
if (!(available || status === 'not_configured' || status === 'unavailable') || entry.quality !== (available ? 'valid' : status === 'not_configured' ? 'unknown' : 'error')) return invalid;
|
||||
if (available ? !candidate || !exact(candidate, ['release_id', 'release_sequence', 'version', 'manifest_sha256', 'keyring_generation'])
|
||||
|| typeof candidate.release_id !== 'string' || !/^[a-f0-9]{8}(-[a-f0-9]{4}){3}-[a-f0-9]{12}$/.test(candidate.release_id)
|
||||
|| !positive(candidate.release_sequence) || !positive(candidate.keyring_generation) || typeof candidate.version !== 'string' || !/^[A-Za-z0-9.+_-]{1,64}$/.test(candidate.version)
|
||||
|| typeof candidate.manifest_sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(candidate.manifest_sha256) : Object.hasOwn(report, 'candidate')) return invalid;
|
||||
return <aside aria-label="Gespeicherter Releasekatalogcheck"><h4>Passiver Releasekatalogcheck</h4>
|
||||
<p>Status: {String(status)} · geprüft: <time>{report.checked_at}</time></p><p>Cache im Inventar gelesen: <time>{entry.observed_at}</time></p>
|
||||
{candidate && <p>Release: {String(candidate.version)} · Sequenz {String(candidate.release_sequence)}<br/>Manifest SHA-256: <code>{String(candidate.manifest_sha256)}</code></p>}
|
||||
<p>Katalogmetadaten; keine Installation oder Ausführungserlaubnis.</p></aside>;
|
||||
}
|
||||
+2
-1
@@ -1,3 +1,4 @@
|
||||
import { CatalogCheckNotice } from './catalog-check';
|
||||
import React, { useEffect, useState } from 'react';
|
||||
import { createRoot } from 'react-dom/client';
|
||||
import { actions, Action, ApiError, authConfig, approvalBlockers, expectedStdout, objectId, page, Page, PlanInput, pretty, record, RecordValue, request, session, Session, stringField, tenant, tenantPath, validateInput, windowsPowerShellRemoteSignedProfile, fullMaintenanceScriptProfile } from './api';
|
||||
@@ -97,7 +98,7 @@ function Devices({ tenantId, auth, selected, setSelected }: { tenantId: string;
|
||||
return <section><h2>Geräte und gespeichertes Inventar</h2><p>Präsenz, Datenfrische und fachliche Gesundheit sind unabhängig. „unreachable“ bedeutet nicht „ausgeschaltet“.</p><ErrorBox error={list.error}/>
|
||||
{!list.data ? <p>Lade Geräte …</p> : <><PageStatus data={list.data}/><div className="table"><table><thead><tr><th>Fest auswählen</th><th>Gerät / Asset-ID</th><th>Präsenz / Gesundheit</th><th>Quelle / Qualität</th><th>Erhebung / Alter / Empfang</th></tr></thead><tbody>{list.data.items.map(d => { const id = objectId(d, 'asset'); return <tr key={id}><td><input aria-label={`Ziel ${id}`} type="checkbox" checked={selected.includes(id)} onChange={e => setSelected(e.target.checked ? [...selected, id] : selected.filter(v => v !== id))}/></td><td><button className="link" onClick={() => setAsset(id)}>{typeof d.hostname === 'string' ? d.hostname : id}</button><small>{id}</small></td><td>{stringField(d, 'presence')} / {stringField(d, 'health')}<small>Kontakt: {stringField(d, 'last_contact_at')}</small></td><td>{stringField(d, 'source_id')} / {stringField(d, 'quality')}<small>{stringField(d, 'completeness')}</small></td><td>{stringField(d, 'observed_at')}<small>Alter: <Age value={d.observed_at}/> · empfangen: {stringField(d, 'received_at')}</small></td></tr>; })}</tbody></table></div>{!list.data.items.length && <p>Keine sichtbaren Geräte in diesem Listenabschnitt.</p>}<button disabled={!cursor} onClick={() => setCursor(null)}>Erste Seite</button> <button disabled={!list.data.next_cursor} onClick={() => setCursor(list.data?.next_cursor ?? null)}>Nächste Seite</button></>}
|
||||
<p>Fester Auswahlsnapshot ({selected.length}): {selected.join(', ') || 'keine Ziele'}</p>
|
||||
{asset && <article><h3>Inventardetail {asset}</h3><ErrorBox error={detail.error}/>{detail.data && <JsonView value={detail.data} label="Inventar, Capabilities, Metriken, Dienste, Software, Updates, Logs und Quellen (soweit geliefert)"/>}<AdminControl auth={auth} path={tenantPath(tenantId, `/devices/${encodeURIComponent(asset)}/revocation`)} permission="devices:revoke" title="Geräteidentität widerrufen" warning="ACHTUNG: Widerruf unterbricht die Geräteverwaltung und sperrt neue Starts. Kein Entfernen aus einer Liste, kein Rollback. Wiederaufnahme erfordert einen gesonderten sicheren Enrollment-/Recoveryprozess." done={detail.reload}/></article>}
|
||||
{asset && <article><h3>Inventardetail {asset}</h3><ErrorBox error={detail.error}/>{detail.data && <><CatalogCheckNotice device={detail.data}/><JsonView value={detail.data} label="Inventar, Capabilities, Metriken, Dienste, Software, Updates, Logs und Quellen (soweit geliefert)"/></>}<AdminControl auth={auth} path={tenantPath(tenantId, `/devices/${encodeURIComponent(asset)}/revocation`)} permission="devices:revoke" title="Geräteidentität widerrufen" warning="ACHTUNG: Widerruf unterbricht die Geräteverwaltung und sperrt neue Starts. Kein Entfernen aus einer Liste, kein Rollback. Wiederaufnahme erfordert einen gesonderten sicheren Enrollment-/Recoveryprozess." done={detail.reload}/></article>}
|
||||
</section>;
|
||||
}
|
||||
const initialParameters: Record<Action, RecordValue> = {
|
||||
|
||||
Reference in New Issue
Block a user