diff --git a/deploy/windows/Complete-OriginalTimeProfile.ps1 b/deploy/windows/Complete-OriginalTimeProfile.ps1 index af8eaf6..6afa8a0 100644 --- a/deploy/windows/Complete-OriginalTimeProfile.ps1 +++ b/deploy/windows/Complete-OriginalTimeProfile.ps1 @@ -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 { diff --git a/docs/windows-time-profile-config.md b/docs/windows-time-profile-config.md index 9817ed1..74a7447 100644 --- a/docs/windows-time-profile-config.md +++ b/docs/windows-time-profile-config.md @@ -339,3 +339,46 @@ 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.