Compare commits

..
Author SHA1 Message Date
kevin_janssen 5f21b753ed Provision the missing original Windows time profile through an exclusive first-create handle
Rust development slice / linux (push) Failing after 7s
2026-11-15 17:13:01 +01:00
kevin_janssen 00717e4283 Record native Windows time profile sharing violation and cloud receipt
Rust development slice / linux (push) Failing after 6s
2026-11-15 17:08:37 +01:00
5 changed files with 226 additions and 65 deletions
+1 -1
View File
@@ -53,7 +53,7 @@ impl Client {
ipc::service_sid(crate::SERVICE_NAME)?,
ipc::service_sid(ipc::HELPER_SERVICE)?,
];
let _root = ipc::PinnedFile::open_read_shared(Path::new(PUBLIC_ROOT), true, &readers, &[])?;
let _root = ipc::PinnedFile::open(Path::new(PUBLIC_ROOT), true, &readers, &[], false)?;
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();
+1 -3
View File
@@ -216,9 +216,7 @@ 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];
// 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 root = PinnedFile::open(Path::new(PUBLIC_ROOT), true, &readers, &[], false)?;
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;
+2 -1
View File
@@ -751,11 +751,12 @@ mod installed {
settings.agent.service_sid.clone(),
settings.helper.service_sid.clone(),
];
files.push(PinnedFile::open_read_shared(
files.push(PinnedFile::open(
Path::new(PUBLIC_ROOT),
true,
&readers,
&[],
false,
)?);
let mut config_file =
PinnedFile::open(Path::new(CONFIG_PATH), false, &readers, &[], false)?;
+158 -2
View File
@@ -2,6 +2,8 @@
#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)
$ErrorActionPreference = 'Stop'
$caseId = 'ad9fd154-b2be-4f5d-9e17-65abb721ceaf'
$controllerHash = 'd8b4fd4fd9ca5310cc1591ce3c2ccae5bd72a2ade43b21a8187cfdfb960b3427'
@@ -49,10 +51,28 @@ $aclDone = Get-Content -LiteralPath (Join-Path $folder 'directory-acl-done.json'
$staged = Join-Path $folder 'time-attestation.candidate.json'
$resultPath = Join-Path $folder 'result.json'
$reservation = Join-Path $folder 'console-finalization-intent.json'
foreach ($path in @($target,$resultPath,$reservation)) {
$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'
$absent = @($target,$resultPath,$initialReservation,$initialResult,$initialError)
if ($InitialCreate) {
$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' }
}
$null = ReadAcl $staged $false
$stagedAcl = ReadAcl $staged $false
$rootAcl = ReadAcl $helperRoot $true
$expected = @{
volume_serial = '9815088561147542064'
@@ -77,12 +97,148 @@ 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.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);
public static void CheckSingleFile(SafeFileHandle handle, long expectedLength) {
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-HeldProfileIdentity([IO.FileStream]$Stream) {
[RmmInitialProfileFile]::CheckSingleFile($Stream.SafeFileHandle, 1177)
$id = New-Object RmmPipeNative+FileId
if (![RmmPipeNative]::GetFileInformationByHandleEx($Stream.SafeFileHandle, 18, [ref]$id, 24)) {
throw 'New file identity unavailable'
}
$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)
return @{
volume_serial=$id.Volume.ToString([Globalization.CultureInfo]::InvariantCulture)
file_id=([BitConverter]::ToString($id.Id)).Replace('-','').ToLowerInvariant()
bytes=$Stream.Length; sha256=$digest; acl_sha256=(BytesHash ([Text.Encoding]::UTF8.GetBytes($sddl)))
}
}
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' }
# Record the lower bound immediately before the only possible first creation.
$since = [DateTime]::UtcNow.ToString('o')
WriteNew $initialReservation @{id=$caseId; config_sha256=$configHash; utc=$since; staged=$expected; create_new=$true}
$phase = 'CreateNew'
try {
$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'
if ($stream.GetAccessControl().GetSecurityDescriptorSddlForm($aclSections) -cne $draftSddl) {
throw 'Unexpected security descriptor on new file'
}
[RmmInitialProfileFile]::CheckSingleFile($stream.SafeFileHandle, 0)
$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 -ceq ('0' * 32) -or $new.sha256 -cne $configHash -or
$new.acl_sha256 -cne (BytesHash ([Text.Encoding]::UTF8.GetBytes($draftSddl)))) {
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 (Join-Path $folder 'console-initial-create-verified.json') @{
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)
$new.acl_sha256 = $expected.acl_sha256
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
WriteNew $initialResult @{
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
}
} catch {
$cause = $_.Exception.GetBaseException()
WriteNew $initialError @{id=$caseId; phase=$phase; hresult=('0x{0:X8}' -f $cause.HResult); exception=$cause.GetType().FullName}
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) {
$rootAclHash = '186d85132cf0e16cbb9623ad9636b7777741939a8cae3d689a2af1eb267a7f49'
New-OriginalPublicProfile
'Zeitprofil erstmalig erstellt und anhand seiner neuen Dateiidentitaet geprueft.'
return
}
# WriteNew uses CreateNew. Concurrent or later invocations cannot republish.
WriteNew $reservation @{id=$caseId; config_sha256=$configHash; utc=[DateTime]::UtcNow.ToString('o')}
try {
+64 -58
View File
@@ -180,64 +180,6 @@ 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
@@ -376,3 +318,67 @@ 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)
### 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.