From 1a5123844ee51e083a4d7619453bf730aea60d45 Mon Sep 17 00:00:00 2001 From: Kevin Janssen Date: Sat, 14 Nov 2026 04:26:43 +0100 Subject: [PATCH] Verify native Windows MSI fixture authoring and retain COM failures --- deploy/windows/Build-MsiFixture.ps1 | 302 ++++++++++++++++++++++++ docs/handover.md | 16 ++ docs/windows-gates.md | 5 +- docs/windows-msi-fixture.md | 46 ++++ docs/windows-system-helper-bootstrap.md | 19 +- 5 files changed, 380 insertions(+), 8 deletions(-) create mode 100644 deploy/windows/Build-MsiFixture.ps1 create mode 100644 docs/windows-msi-fixture.md diff --git a/deploy/windows/Build-MsiFixture.ps1 b/deploy/windows/Build-MsiFixture.ps1 new file mode 100644 index 0000000..5bf51bc --- /dev/null +++ b/deploy/windows/Build-MsiFixture.ps1 @@ -0,0 +1,302 @@ +#requires -Version 5.1 +<# +Build-only, fixed MSI 1.0.0 fixture. Writes only a NEW private child directory. +Never calls InstallProduct/OpenPackage/msiexec, modifies installed products, +services, execution policy, certificate trust or reboot state. No downloads. +No upgrade/EXE package is authored by this version. + +Primary API/format contracts: +https://learn.microsoft.com/en-us/windows/win32/msi/installer-opendatabase +https://learn.microsoft.com/en-us/windows/win32/msi/database-summaryinformation +https://learn.microsoft.com/en-us/windows/win32/msi/record-setstream +https://learn.microsoft.com/en-us/windows/win32/msi/record-readstream +https://learn.microsoft.com/en-us/windows/win32/msi/cabinet-files +https://learn.microsoft.com/en-us/windows/win32/msi/suggested-installexecutesequence +https://learn.microsoft.com/en-us/windows/win32/msi/package-codes +#> +[CmdletBinding()] +param( + [Parameter(Mandatory=$true)][string]$OutputParent, + [Guid]$CaseId=([Guid]::NewGuid()) +) +Set-StrictMode -Version Latest +$ErrorActionPreference='Stop' +$case=$null;$created=$false;$installer=$null;$database=$null;$summary=$null;$makecabLock=$null +$product='{3F070B4B-9C08-4D65-BD41-13D81B884AEC}' +$upgrade='{C9BF1FB8-E31D-4BD7-BA0D-AB46539BBBAA}' +$component='{4D1CA80F-9AF8-4F54-B426-450AFBAFF92E}' +$version='1.0.0' +# Product/family/component identities are fixed. Nonidentical MSI bytes must +# have distinct PackageCodes, so each new authoring case gets its own code. +$package='{'+([Guid]::NewGuid().ToString().ToUpperInvariant())+'}' +$artifact=[Guid]::NewGuid().ToString() +$report=[ordered]@{schema_version=1;case_id=$CaseId.ToString();completed=$false;stage='preflight'; + build_only=$true;native_installation_tested=$false;product_changes=$false;services_changed=$false; + reboot_requested=$false;trust_changed=$false;downloads=$false;upgrade_authored=$false; + product_code=$product;upgrade_code=$upgrade;component_code=$component;package_code=$package;version=$version} + +function Require([bool]$Value,[string]$Code) {if (!$Value) {throw $Code}} +function Hash([string]$Path) {return (Get-FileHash -LiteralPath $Path -Algorithm SHA256).Hash.ToLowerInvariant()} +function Hash-Bytes([byte[]]$Value) { + $sha=[Security.Cryptography.SHA256]::Create() + try {return ([BitConverter]::ToString($sha.ComputeHash($Value))).Replace('-','').ToLowerInvariant()} + finally {$sha.Dispose()} +} +function No-Reparse([string]$Path) { + $item=Get-Item -LiteralPath $Path -Force + while ($null -ne $item) { + Require (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -eq 0) 'MSI_BUILD_REPARSE' + if ($item -is [IO.FileInfo]) {$item=$item.Directory} else {$item=$item.Parent} + } +} +function Write-New([string]$Path,[byte[]]$Bytes) { + $stream=[IO.File]::Open($Path,[IO.FileMode]::CreateNew,[IO.FileAccess]::Write,[IO.FileShare]::None) + try {$stream.Write($Bytes,0,$Bytes.Length);$stream.Flush($true)} finally {$stream.Dispose()} +} +function Write-Json([string]$Path,$Value) {Write-New $Path ([Text.Encoding]::UTF8.GetBytes(($Value|ConvertTo-Json -Depth 30)))} +function Release-Com($Object) { + if ($null -ne $Object -and [Runtime.InteropServices.Marshal]::IsComObject($Object)) { + [void][Runtime.InteropServices.Marshal]::FinalReleaseComObject($Object) + } +} +function Com-Operation($Object,[string]$Kind,[string]$Name,[object[]]$Arguments) { + $report.last_com_operation=$Kind+':'+$Name + $report.last_com_target_type=if ($null -eq $Object) {'null'} else {$Object.GetType().FullName} + $report.last_com_argument_types=@($Arguments|ForEach-Object { + if ($null -eq $_) {'null'} else {$_.GetType().FullName} + }) + $report.last_com_argument_count=$Arguments.Count +} +function Com-NativeArguments([object[]]$Values=@()) { + # Join-Path/COM results may carry ETS PSObject wrappers. GetType() in + # PowerShell unwraps them, but COM reflection marshals nested object[] + # values as their real CLR types. Preserve the values, remove only ETS. + $native=New-Object 'object[]' $Values.Length + for ($n=0;$n -lt $Values.Length;$n++) { + if ($null -eq $Values[$n]) {$native[$n]=$null} + else {$native[$n]=$Values[$n].PSObject.BaseObject} + } + return ,$native +} +function Com-Method($Object,[string]$Name,[object[]]$Arguments=@()) { + $target=$Object.PSObject.BaseObject;$native=Com-NativeArguments $Arguments + Com-Operation $target 'method' $Name $native + return $target.GetType().InvokeMember($Name,[Reflection.BindingFlags]::InvokeMethod,$null,$target,$native) +} +function Com-Get($Object,[string]$Name,[object[]]$Arguments=@()) { + $target=$Object.PSObject.BaseObject;$native=Com-NativeArguments $Arguments + Com-Operation $target 'get' $Name $native + return $target.GetType().InvokeMember($Name,[Reflection.BindingFlags]::GetProperty,$null,$target,$native) +} +function Com-Set($Object,[string]$Name,[object[]]$Arguments) { + $target=$Object.PSObject.BaseObject;$native=Com-NativeArguments $Arguments + Com-Operation $target 'set' $Name $native + [void]$target.GetType().InvokeMember($Name,[Reflection.BindingFlags]::SetProperty,$null,$target,$native) +} +function Sql([string]$Query) { + $report.last_sql_sha256=Hash-Bytes ([Text.Encoding]::UTF8.GetBytes($Query)) + $view=Com-Method $database 'OpenView' @($Query) + try {[void](Com-Method $view 'Execute');[void](Com-Method $view 'Close')} + finally {Release-Com $view} +} +function Rows([string]$Query) { + $view=Com-Method $database 'OpenView' @($Query);$rows=New-Object 'Collections.Generic.List[object]' + try { + [void](Com-Method $view 'Execute') + while ($true) { + $row=Com-Method $view 'Fetch';if ($null -eq $row) {break} + try { + Require ($rows.Count -lt 64) 'MSI_BUILD_ROW_LIMIT' + $count=[int](Com-Get $row 'FieldCount');Require ($count -le 12) 'MSI_BUILD_FIELD_LIMIT' + $fields=New-Object 'Collections.Generic.List[string]' + for ($i=1;$i -le $count;$i++) {$text=[string](Com-Get $row 'StringData' @($i));Require ($text.Length -le 512) 'MSI_BUILD_STRING_LIMIT';$fields.Add($text)} + $rows.Add($fields.ToArray()) + } finally {Release-Com $row} + } + [void](Com-Method $view 'Close') + } finally {Release-Com $view} + return ,$rows.ToArray() +} +function Run-Makecab([string]$Tool,[string]$Ddf) { + $si=New-Object Diagnostics.ProcessStartInfo;$si.FileName=$Tool;$si.Arguments='/F "'+$Ddf+'"' + $si.WorkingDirectory=$case;$si.UseShellExecute=$false;$si.CreateNoWindow=$true + $si.RedirectStandardOutput=$true;$si.RedirectStandardError=$true + $process=New-Object Diagnostics.Process;$process.StartInfo=$si + Require ($process.Start()) 'MSI_MAKECAB_START' + try { + $stdout=$process.StandardOutput.ReadToEndAsync();$stderr=$process.StandardError.ReadToEndAsync() + if (!$process.WaitForExit(30000)) {$process.Kill();throw 'MSI_MAKECAB_TIMEOUT'} + Require ($stdout.Result.Length -le 8192 -and $stderr.Result.Length -le 8192) 'MSI_MAKECAB_OUTPUT_LIMIT' + Write-New (Join-Path $case 'makecab.stdout.txt') ([Text.Encoding]::UTF8.GetBytes($stdout.Result)) + Write-New (Join-Path $case 'makecab.stderr.txt') ([Text.Encoding]::UTF8.GetBytes($stderr.Result)) + Require ($process.ExitCode -eq 0) 'MSI_MAKECAB_FAILED' + } finally {$process.Dispose()} +} +try { + Require ([Environment]::OSVersion.Platform -eq 'Win32NT' -and [Environment]::Is64BitProcess) 'MSI_BUILD_NATIVE_X64_REQUIRED' + Require ($CaseId -ne [Guid]::Empty -and $OutputParent -match '^[A-Za-z]:\\' -and $OutputParent -cmatch '^[\x20-\x7e]+$' -and $OutputParent -notmatch '["\x00\r\n]') 'MSI_BUILD_LOCAL_ASCII_PARENT' + $OutputParent=[IO.Path]::GetFullPath($OutputParent).TrimEnd('\');No-Reparse $OutputParent + Require ((New-Object IO.DriveInfo($OutputParent.Substring(0,3))).DriveType -eq 'Fixed') 'MSI_BUILD_LOCAL_FIXED_DRIVE' + Require ((Get-Item -LiteralPath $OutputParent).PSIsContainer) 'MSI_BUILD_EXISTING_PARENT' + $me=[Security.Principal.WindowsIdentity]::GetCurrent().User + $allowed=@($me.Value,'S-1-5-18','S-1-5-32-544')|Select-Object -Unique + $parentAcl=Get-Acl -LiteralPath $OutputParent + Require ($parentAcl.GetOwner([Security.Principal.SecurityIdentifier]).Value -in $allowed) 'MSI_BUILD_PARENT_OWNER' + $rules=@($parentAcl.GetAccessRules($true,$true,[Security.Principal.SecurityIdentifier]));Require ($rules.Count -gt 0) 'MSI_BUILD_PARENT_DACL' + foreach ($rule in $rules) { + Require ($rule.AccessControlType -eq 'Allow') 'MSI_BUILD_PARENT_ACE' + Require ($rule.IdentityReference.Value -in $allowed -or ([long]$rule.FileSystemRights -band 0x500d0156) -eq 0) 'MSI_BUILD_PARENT_WRITABLE' + } + $case=Join-Path $OutputParent ('msi-fixture-'+$CaseId.ToString()) + # New-Item without Force refuses an existing directory; no case is reused. + [void](New-Item -ItemType Directory -Path $case -ErrorAction Stop) + $created=$true + $acl=New-Object Security.AccessControl.DirectorySecurity;$acl.SetAccessRuleProtection($true,$false);$acl.SetOwner($me) + foreach ($sid in $allowed) {$acl.AddAccessRule((New-Object Security.AccessControl.FileSystemAccessRule((New-Object Security.Principal.SecurityIdentifier($sid)),'FullControl','ContainerInherit,ObjectInherit','None','Allow')))} + Set-Acl -LiteralPath $case -AclObject $acl;No-Reparse $case + $report.builder_sha256=Hash $PSCommandPath;Write-Json (Join-Path $case 'started.json') $report + $report.stage='native_tools' + Require ([Environment]::GetFolderPath([Environment+SpecialFolder]::ProgramFiles) -ceq 'C:\Program Files') 'MSI_FIXED_PROGRAMFILES_CONTRACT' + $system=[Environment]::GetFolderPath([Environment+SpecialFolder]::System) + $makecab=Join-Path $system 'makecab.exe';$msiDll=Join-Path $system 'msi.dll' + $tools=[ordered]@{} + foreach ($tool in @($makecab,$msiDll)) { + No-Reparse $tool;$signature=Get-AuthenticodeSignature -LiteralPath $tool + Require ($signature.Status -eq 'Valid' -and $signature.SignerCertificate.Subject -match 'Microsoft Corporation') 'MSI_MICROSOFT_TOOL_SIGNATURE' + $tools[(Split-Path $tool -Leaf)]=[ordered]@{sha256=(Hash $tool);signature_status=[string]$signature.Status;file_version=(Get-Item -LiteralPath $tool).VersionInfo.FileVersion} + } + $makecabLock=[IO.File]::Open($makecab,[IO.FileMode]::Open,[IO.FileAccess]::Read,[IO.FileShare]::Read) + $report.tools=$tools + $report.stage='payload_and_cabinet' + $payload=Join-Path $case 'msi-payload.txt' + $payloadBytes=[Text.Encoding]::ASCII.GetBytes("RustDiscovery MSI fixture 1.0.0`r`n") + Write-New $payload $payloadBytes + $ddf=Join-Path $case 'fixture.ddf' + $ddfText=@" +.OPTION EXPLICIT +.Set Cabinet=ON +.Set Compress=ON +.Set CompressionType=MSZIP +.Set CabinetNameTemplate=fixture.cab +.Set DiskDirectoryTemplate=. +.Set InfFileName=fixture.inf +.Set RptFileName=fixture.rpt +.Set MaxDiskSize=0 +.Set MaxCabinetSize=262144 +"$payload" PayloadFile +"@ + Write-New $ddf ([Text.Encoding]::ASCII.GetBytes($ddfText)) + Run-Makecab $makecab $ddf + $cab=Join-Path $case 'fixture.cab';No-Reparse $cab + Require ((Get-Item -LiteralPath $cab).Length -gt 0 -and (Get-Item -LiteralPath $cab).Length -le 65536) 'MSI_CABINET_LIMIT' + $report.stage='database_authoring:com_activation' + $msi=Join-Path $case 'RustDiscoveryFixture-1.0.0-x64.msi';Require (!(Test-Path -LiteralPath $msi)) 'MSI_OUTPUT_EXISTS' + $installer=New-Object -ComObject WindowsInstaller.Installer + $report.stage='database_authoring:open_create' + $database=Com-Method $installer 'OpenDatabase' @($msi,[int]3) + $tables=[ordered]@{ + Property='`Property` CHAR(72) NOT NULL, `Value` CHAR(0) LOCALIZABLE PRIMARY KEY `Property`' + Directory='`Directory` CHAR(72) NOT NULL, `Directory_Parent` CHAR(72), `DefaultDir` CHAR(255) NOT NULL LOCALIZABLE PRIMARY KEY `Directory`' + Component='`Component` CHAR(72) NOT NULL, `ComponentId` CHAR(38), `Directory_` CHAR(72) NOT NULL, `Attributes` SHORT NOT NULL, `Condition` CHAR(255), `KeyPath` CHAR(72) PRIMARY KEY `Component`' + Feature='`Feature` CHAR(38) NOT NULL, `Feature_Parent` CHAR(38), `Title` CHAR(64) LOCALIZABLE, `Description` CHAR(255) LOCALIZABLE, `Display` SHORT, `Level` SHORT NOT NULL, `Directory_` CHAR(72), `Attributes` SHORT NOT NULL PRIMARY KEY `Feature`' + FeatureComponents='`Feature_` CHAR(38) NOT NULL, `Component_` CHAR(72) NOT NULL PRIMARY KEY `Feature_`, `Component_`' + File='`File` CHAR(72) NOT NULL, `Component_` CHAR(72) NOT NULL, `FileName` CHAR(255) NOT NULL LOCALIZABLE, `FileSize` LONG NOT NULL, `Version` CHAR(72), `Language` CHAR(20), `Attributes` SHORT, `Sequence` SHORT NOT NULL PRIMARY KEY `File`' + Media='`DiskId` SHORT NOT NULL, `LastSequence` LONG NOT NULL, `DiskPrompt` CHAR(64) LOCALIZABLE, `Cabinet` CHAR(255), `VolumeLabel` CHAR(32), `Source` CHAR(72) PRIMARY KEY `DiskId`' + InstallExecuteSequence='`Action` CHAR(72) NOT NULL, `Condition` CHAR(255), `Sequence` SHORT PRIMARY KEY `Action`' + LaunchCondition='`Condition` CHAR(255) NOT NULL, `Description` CHAR(255) NOT NULL LOCALIZABLE PRIMARY KEY `Condition`' + } + foreach ($table in $tables.Keys) {$report.stage='database_authoring:create_table:'+$table;Sql ('CREATE TABLE `'+$table+'` ('+$tables[$table]+')')} + $report.stage='database_authoring:insert_rows' + $properties=[ordered]@{ProductCode=$product;UpgradeCode=$upgrade;ProductVersion=$version;ProductLanguage='1033';ProductName='RustDiscovery MSI Fixture';Manufacturer='Ease Technologies';ALLUSERS='1';INSTALLLEVEL='1';REBOOT='ReallySuppress'} + foreach ($key in $properties.Keys) {Sql ("INSERT INTO ``Property`` (``Property``,``Value``) VALUES ('$key','$($properties[$key])')")} + Sql 'INSERT INTO `Directory` (`Directory`,`DefaultDir`) VALUES (''TARGETDIR'',''SourceDir'')' + Sql 'INSERT INTO `Directory` (`Directory`,`Directory_Parent`,`DefaultDir`) VALUES (''ProgramFiles64Folder'',''TARGETDIR'',''.'')' + Sql 'INSERT INTO `Directory` (`Directory`,`Directory_Parent`,`DefaultDir`) VALUES (''INSTALLDIR'',''ProgramFiles64Folder'',''RUSTDI~1|RustDiscoveryFixtures'')' + Sql ("INSERT INTO ``Component`` (``Component``,``ComponentId``,``Directory_``,``Attributes``,``KeyPath``) VALUES ('PayloadComponent','$component','INSTALLDIR',256,'PayloadFile')") + Sql 'INSERT INTO `Feature` (`Feature`,`Title`,`Display`,`Level`,`Directory_`,`Attributes`) VALUES (''Fixture'',''Fixture'',1,1,''INSTALLDIR'',0)' + Sql 'INSERT INTO `FeatureComponents` (`Feature_`,`Component_`) VALUES (''Fixture'',''PayloadComponent'')' + Sql ("INSERT INTO ``File`` (``File``,``Component_``,``FileName``,``FileSize``,``Attributes``,``Sequence``) VALUES ('PayloadFile','PayloadComponent','MSIPAY~1.TXT|msi-payload.txt',$($payloadBytes.Length),16896,1)") + Sql 'INSERT INTO `Media` (`DiskId`,`LastSequence`,`Cabinet`) VALUES (1,1,''#fixture.cab'')' + Sql 'INSERT INTO `LaunchCondition` (`Condition`,`Description`) VALUES (''VersionNT64'',''This fixture requires 64-bit Windows.'')' + $sequence=[ordered]@{LaunchConditions=100;CostInitialize=800;FileCost=900;CostFinalize=1000;InstallValidate=1400;InstallInitialize=1500;ProcessComponents=1600;UnpublishFeatures=1800;RemoveFiles=3500;RemoveFolders=3600;CreateFolders=3700;InstallFiles=4000;RegisterUser=6000;RegisterProduct=6100;PublishFeatures=6300;PublishProduct=6400;InstallFinalize=6600} + foreach ($action in $sequence.Keys) {Sql ("INSERT INTO ``InstallExecuteSequence`` (``Action``,``Sequence``) VALUES ('$action',$($sequence[$action]))")} + $view=Com-Method $database 'OpenView' @('INSERT INTO `_Streams` (`Name`,`Data`) VALUES (?,?)');$record=$null + try {$record=Com-Method $installer 'CreateRecord' @([int]2);Com-Set $record 'StringData' @([int]1,'fixture.cab');[void](Com-Method $record 'SetStream' @([int]2,$cab));[void](Com-Method $view 'Execute' @($record));[void](Com-Method $view 'Close')} + finally {Release-Com $record;Release-Com $view} + $summary=Com-Get $database 'SummaryInformation' @([int]10) + foreach ($entry in @(@(1,1252),@(2,'RustDiscovery MSI fixture'),@(3,'Isolated machine/x64 file fixture'),@(4,'Ease Technologies'),@(7,'x64;1033'),@(9,$package),@(14,500),@(15,2),@(18,'RustDiscovery Build-MsiFixture.ps1'))) {Com-Set $summary 'Property' @([int]$entry[0],$entry[1])} + [void](Com-Method $summary 'Persist');Release-Com $summary;$summary=$null + [void](Com-Method $database 'Commit');Release-Com $database;$database=$null + $report.stage='independent_readback' + No-Reparse $msi;$length=(Get-Item -LiteralPath $msi).Length;Require ($length -gt 0 -and $length -le 262144) 'MSI_ARTIFACT_LIMIT' + $database=Com-Method $installer 'OpenDatabase' @($msi,[int]0) + $readback=[ordered]@{} + foreach ($table in $tables.Keys) {$readback[$table]=Rows ('SELECT * FROM `'+$table+'`')} + Require ($readback.Property.Count -eq $properties.Count -and $readback.Directory.Count -eq 3 -and $readback.File.Count -eq 1 -and $readback.Component.Count -eq 1 -and $readback.Media.Count -eq 1 -and $readback.InstallExecuteSequence.Count -eq $sequence.Count) 'MSI_TABLE_READBACK_COUNTS' + foreach ($key in $properties.Keys) {$row=Rows ("SELECT ``Value`` FROM ``Property`` WHERE ``Property``='$key'");Require ($row.Count -eq 1 -and $row[0][0] -ceq $properties[$key]) 'MSI_PROPERTY_READBACK'} + $allTables=Rows 'SELECT `Name` FROM `_Tables`';$names=@($allTables|ForEach-Object {$_[0]}) + Require ($names.Count -eq $tables.Count -and @($names|Where-Object {$_ -notin $tables.Keys}).Count -eq 0) 'MSI_UNEXPECTED_TABLE' + Require ('CustomAction' -notin $names -and 'Upgrade' -notin $names -and 'Registry' -notin $names -and 'ServiceInstall' -notin $names) 'MSI_FORBIDDEN_TABLE' + $summary=Com-Get $database 'SummaryInformation' @([int]0) + Require ((Com-Get $summary 'Property' @([int]7)) -ceq 'x64;1033' -and (Com-Get $summary 'Property' @([int]9)) -ceq $package -and [int](Com-Get $summary 'Property' @([int]15)) -eq 2) 'MSI_SUMMARY_READBACK' + Release-Com $summary;$summary=$null + $view=Com-Method $database 'OpenView' @('SELECT `Data` FROM `_Streams` WHERE `Name`=''fixture.cab''');$record=$null + try { + [void](Com-Method $view 'Execute');$record=Com-Method $view 'Fetch';Require ($null -ne $record) 'MSI_EMBEDDED_CAB_MISSING' + $embedded=New-Object 'Collections.Generic.List[byte]' + while ($true) { + $chunk=[string](Com-Method $record 'ReadStream' @([int]1,[int]8192,[int]1));if (!$chunk.Length) {break} + Require ($embedded.Count+$chunk.Length -le 65536) 'MSI_EMBEDDED_CAB_LIMIT' + foreach ($char in $chunk.ToCharArray()) {Require ([int]$char -le 255) 'MSI_STREAM_BYTE_ENCODING';$embedded.Add([byte]$char)} + } + Require ((Hash-Bytes $embedded.ToArray()) -ceq (Hash $cab)) 'MSI_EMBEDDED_CAB_HASH' + $extra=Com-Method $view 'Fetch';Require ($null -eq $extra) 'MSI_DUPLICATE_CAB_STREAM';[void](Com-Method $view 'Close') + } finally {Release-Com $record;Release-Com $view} + Release-Com $database;$database=$null + $recipe=[ordered]@{schema_version=1;recipe_id='rmm-windows-msi-fixture-install-1.0';recipe_version='1';platform='windows';upgrade_code=$upgrade;architecture='x64';context='machine';command_profile='fixture_quiet_no_reboot_v1';artifact=[ordered]@{artifact_id=$artifact;sha256=(Hash $msi);bytes=$length};postcondition=[ordered]@{product_code=$product;product_version=$version;payload_path='C:\Program Files\RustDiscoveryFixtures\msi-payload.txt';payload_sha256=(Hash $payload);payload_bytes=$payloadBytes.Length};no_reboot=$true} + $recipeJson=$recipe|ConvertTo-Json -Depth 12 -Compress + Write-New (Join-Path $case 'recipe.json') ([Text.Encoding]::UTF8.GetBytes($recipeJson)) + Write-Json (Join-Path $case 'tables.json') $readback + $report.artifact=[ordered]@{path=$msi;sha256=(Hash $msi);bytes=$length;artifact_id_proposal=$artifact} + $report.payload=[ordered]@{sha256=(Hash $payload);bytes=$payloadBytes.Length;content_ascii="RustDiscovery MSI fixture 1.0.0`r`n";installed_path=$recipe.postcondition.payload_path} + $report.cabinet=[ordered]@{sha256=(Hash $cab);bytes=(Get-Item -LiteralPath $cab).Length;embedded_hash_verified=$true;stream='fixture.cab'} + $report.tables_sha256=Hash (Join-Path $case 'tables.json');$report.table_names=$names + $report.resolved_recipe=[ordered]@{recipe=$recipe;recipe_sha256=(Hash (Join-Path $case 'recipe.json'))} + $report.rust_recipe_validation_executed=$false;$report.artifact_registered_on_server=$false + $report.makecab_sha256_after=Hash $makecab;Require ($report.makecab_sha256_after -ceq $tools['makecab.exe'].sha256) 'MSI_BUILD_TOOL_CHANGED' + Require ((Hash $PSCommandPath) -ceq $report.builder_sha256) 'MSI_BUILDER_CHANGED' + $report.completed=$true;$report.stage='authored_and_read_back_not_installed' + Write-Json (Join-Path $case 'result.json') $report + [ordered]@{completed=$true;build_only=$true;report_path=(Join-Path $case 'result.json');artifact=$report.artifact;native_installation_tested=$false;upgrade_authored=$false}|ConvertTo-Json -Depth 5 +} catch { + $report.completed=$false;$report.error_type=$_.Exception.GetType().FullName;$report.error_hresult=$_.Exception.HResult + $report.error_line=$_.InvocationInfo.ScriptLineNumber + $report.error_column=$_.InvocationInfo.OffsetInLine + $report.error_stack=([string]$_.ScriptStackTrace).Substring(0,[Math]::Min(2048,([string]$_.ScriptStackTrace).Length)) + $chain=New-Object 'Collections.Generic.List[object]';$exception=$_.Exception + while ($null -ne $exception -and $chain.Count -lt 6) { + $chain.Add([ordered]@{type=$exception.GetType().FullName;hresult=$exception.HResult}) + $exception=$exception.InnerException + } + $report.exception_chain=$chain.ToArray() + # Numeric MSI diagnostics only; never echo argument values, paths, raw SQL, + # COM error messages or formatted installer records. Preserve the original + # exception even when no LastErrorRecord is available. + $errorRecord=$null + if ($null -ne $installer) { + try { + $errorRecord=$installer.GetType().InvokeMember('LastErrorRecord',[Reflection.BindingFlags]::InvokeMethod,$null,$installer,@()) + if ($null -ne $errorRecord) { + $count=[int]$errorRecord.GetType().InvokeMember('FieldCount',[Reflection.BindingFlags]::GetProperty,$null,$errorRecord,@()) + $report.msi_error_record_fields=$count + if ($count -ge 1) {$report.msi_error_code=[int]$errorRecord.GetType().InvokeMember('IntegerData',[Reflection.BindingFlags]::GetProperty,$null,$errorRecord,@([int]1))} + } + } catch {$report.msi_diagnostic_hresult=$_.Exception.HResult} + finally {Release-Com $errorRecord} + } + if ($created -and (Test-Path -LiteralPath $case)) {Write-Json (Join-Path $case 'failed.json') $report} + throw 'MSI_FIXTURE_BUILD_FAILED: retain the private case; do not reuse or install an incomplete artifact.' +} finally { + Release-Com $summary;Release-Com $database;Release-Com $installer + if ($null -ne $makecabLock) {$makecabLock.Dispose()} +} diff --git a/docs/handover.md b/docs/handover.md index ed362b4..f13fb1f 100644 --- a/docs/handover.md +++ b/docs/handover.md @@ -52,6 +52,22 @@ Zugänge und private Rohbelege bleiben gitignoriert. ## Aktuelle Windowsfortsetzung +MSI-Fixturebau auf dem Windowsgast tatsächlich bestanden, Fall `48291dbe…`: +20480Byte, Artefakt `2204dc82…`, unabhängiger Tabellen-/CAB-/Hashreadback und +lokale Rust-Rezeptvalidierung. Zwei alte COM-Fehlerfälle bleiben fehlgeschlagen; +Ursache des Typfehlers war ein ETS-Wrapper im Argumentarray. Keine Installation +oder RMM-Jobwirkung. Einzelheiten und noch offene Integration/Upgrade-/EXE-Abnahmen: +[MSI-Bericht](windows-msi-fixture.md). + +Eigener SYSTEM-Helper inzwischen nativ installiert und einmal gestartet, +Fall `59c2fd6f…`, Helper `921cf182…`, LocalSystem/Manual, PID6240. +`allowed_services=[]`, `enable_effects=false`, `allow_reboot=false`; +eigenes geschütztes Ledger und Lock vorhanden. Der echte unveränderte +LocalService-Agent PID5140 meldet jedoch `HELPER_NOT_AVAILABLE`; die positive +Peerprüfung ist ausdrücklich fehlgeschlagen. Diagnose ohne RMM-Wirkung läuft, +keine Readiness/Systemfähigkeit daraus ableiten. Ältere Aussagen „noch nicht +installiert“ unten sind historische Zwischenstände. + Neuester Windowsruntimeindex: Agent `2beed7fa…`, tatsächlicher LocalService PID5140, Featurefall `cea4d30f…`, davor neue native21+6-Unitqualifikation `23b0e0aa…`. Gleiche Identität, sechs Konfigurationsfelder, Telemetrie-DB und diff --git a/docs/windows-gates.md b/docs/windows-gates.md index 8a359e8..b72e6fe 100644 --- a/docs/windows-gates.md +++ b/docs/windows-gates.md @@ -13,8 +13,8 @@ bleibt eine eigenständige Abnahme. Dieser Bericht erweitert dessen Umfang nicht | TLS-Lifecycle | Falsche CA, falscher Name und abgelaufenes Clientzertifikat mit gültigen Kontrollen nativ als getrennte Admin-TLS-Proben bestanden. Permanente Identität/Dienst unverändert. | Rotation und Widerruf noch gesondert sicher implementieren und prüfen. Permanente Identität nicht widerrufen oder ersetzen. | | Signierter Jobkern | Gemeinsamer Core/Helper-Sync und atomare Outcomes nativ zuerst Linux, dann Windows geprüft; letzter Fixturelauf76/54. Default-Windowsdienst mit additiver Journalmigration erhaltend als LocalService aktualisiert; native Unitqualifikation12+6. Jobs bleiben deaktiviert, kein Binding/Ledger angelegt. | Tatsächlichen signierten Dienst-Sync, qualifizierte Uhr und vollständige Startgrenze nachweisen. Passive Migration und Unit-Fixturen ersetzen keinen Jobnachweis. | | PowerShell | Begrenzter5.1-Executor implementiert; exakte Skriptbytes, atomarer Prozessbaum, Rohbytes und Unknown bei unklarer Wirkung. Server/UI unterstützen feste Plattformvarianten. Keine tatsächliche Ausführung, Richtlinie derzeit geerbt. | Ausstehende konkrete Richtlinienentscheidung beachten, Encoding/Prozessgrenzen unter LocalService tatsächlich qualifizieren; ausschließlich vollständiger Antrag und tatsächlicher WebUI-Klick. | -| Privilegierte Aktionen | Featureisolierte SYSTEM-Helper-/Named-Pipe-Quelle mit eigener Policy und unabhängigem Sync vorbereitet; keine Installation oder native Peer-/Wirkungsabnahme. | Gegenseitige tatsächliche SID/PID/Binary-/Dateibindung und unabhängigen Sync nativ prüfen; erst danach eng erlaubte Systemaktion. | -| Pakete/Dienste/Logs | Noch keine native Windows-Aktionsabnahme. | Begrenzte geprüfte MSI-/EXE-Rezepte, Dienst-/Eventlogadapter und unabhängige Nachbedingungen. Keine allgemeinen Installershellstrings oder impliziten Reboots. | +| Privilegierte Aktionen | Eigener SYSTEM-Helper nativ installiert und einmal gestartet, Manual/LocalSystem, leere Aktionsliste und Wirkungen/Reboot gesperrt. Die echte LocalService-Agentprobe scheitert derzeit; kein positiver Peer-/Sync-/Wirkungsnachweis. | Fehler ohne Erweiterung der Sicherheitsgrenze diagnostizieren; gegenseitige SID/PID/Binary-/Dateibindung und unabhängigen Sync nativ prüfen. | +| Pakete/Dienste/Logs | Kleines MSI1.0.0 auf der VM erstellt, nur lesend geprüft und nach Download gehasht; keine Installation. Dienst-/Eventlog-/Paketquellen teilweise vorbereitet, keine native Aktionsabnahme. | Unveränderliche Tenantrezepte integrieren; UI-genehmigte MSI-/EXE-Installation/Upgrade/Noop, Dienste und Logs mit unabhängigen Nachbedingungen prüfen. | | Dauerhafte Jobs/Fehlerfälle | Linuxnachweise vorhanden; sie ersetzen keine nativen Windowsnachweise. | Redelivery/ACK-Verlust, Prozessabbruch, Offline/Ablauf/Entzug und Wiederanlauf am tatsächlichen Windows-Jobpfad prüfen. | | Mischplattform | Windows/Linux sind separat inventarisierbar; noch keine gemischte Skriptabnahme. | AT-15 mit festen Varianten/Zielen, passenden Interpretern und nachvollziehbaren Einzelresultaten. | | Reboot/Installer | Entwicklungsbuild unsigniert, GNU-Crossbuild; kein MSVC-/signierter Installer-/Windows-Rebootnachweis. | Eigene Abnahmen; kein Windows-Reboot ist durch den bereits ausgeführten Linux-Testreboot autorisiert. | @@ -28,4 +28,5 @@ keine RMM-Ausführungsberechtigung. Live-Diagnose nicht als Inventar tarnen. Quellen und bisherige native Nachweise: [Windows-Client](../deploy/windows/CLIENT.md), +[MSI-Paketbau](windows-msi-fixture.md), [Plattformmatrix](platform-support.md), [Implementierungsstand](implementation-status.md). diff --git a/docs/windows-msi-fixture.md b/docs/windows-msi-fixture.md new file mode 100644 index 0000000..3a2e5ee --- /dev/null +++ b/docs/windows-msi-fixture.md @@ -0,0 +1,46 @@ +# Windows-MSI-Fixture: Paketbau, noch keine Installation + +Stand 2026-11-14. Der feste Builder +[`Build-MsiFixture.ps1`](../deploy/windows/Build-MsiFixture.ps1) hat auf der +Windows-11-x64-VM ein kleines MSI1.0.0 erstellt und unabhängig nur lesend wieder +geöffnet. Fall `48291dbe-88e2-4221-954a-37a0c8faf04e`, Builder-SHA256 +`0465be3b43ffb8f9b9233eb402e64a4a585945609c72546b2e1b1d97b7a079cf`. + +Das tatsächlich heruntergeladene und erneut gehashte Artefakt umfasst20480Bytes, +SHA256 `2204dc823fe84f69df54b63662e7c4f14042799c2c9f4938eaec69ebc6c79e57`. +Es enthält genau eine33Byte-Nutzdatei und einen eingebetteten CAB-Stream. +Tabellen, feste Produkt-/Komponentenkennung, Version, Machine-/x64-Kontext, +Summary und CAB-Hash wurden nativ zurückgelesen. Es gibt keine CustomActions, +Serviceinstallation, Registrytabelle oder Upgradetabelle. Die tatsächliche +PowerShell-Rezeptserialisierung wurde danach lokal mit dem Rust-Vertrag samt +kanonischem Rezepthash geprüft: bestanden. Dieser Rustlauf war kein nativer +Windows-Installationsnachweis. + +Zwei vorherige Fälle bleiben fehlgeschlagen und erhalten: + +- `4ea41b17…`: COM-Aufruf beim Erstellen der Datenbank fehlgeschlagen; + zu diesem Zeitpunkt war die genaue Ursache noch nicht belegt. +- `24da513c…`: derselbe Aufruf mit zusätzlicher begrenzter Diagnose meldete + `0x80020005` (`DISP_E_TYPEMISMATCH`). Eine separate CLR-Probe zeigte danach, + dass ein von `Join-Path` kommender Wert im verschachtelten Argumentarray als + `PSObject` statt als CLR-String ankam. Die COM-Wrapper entfernen jetzt nur + diesen ETS-Wrapper; Pfad, Werte, Dispatchart und Create-Modus3 bleiben gleich. + +Der Builder schreibt ausschließlich einen neuen privaten Bootstrapfall, prüft +Microsoft-signierte lokale MakeCab-/MSI-Werkzeuge und behält Fehlerbelege. +Er ruft weder `msiexec` noch `InstallProduct` oder `OpenPackage` auf. Es wurden +keine Produkte installiert, Dienste geändert, Reboots angefordert oder +Vertrauensspeicher verändert. Die vorhandene Bootstrap-Prozessrichtlinie +`RemoteSigned` wurde verwendet; daraus folgt keine Richtlinienentscheidung für +spätere RMM-PowerShell-Jobs. + +Geschützte Rohbelege liegen unter +`devstate/windows-client/msi-fixture-authoring/48291dbe-88e2-4221-954a-37a0c8faf04e/`; +alte Fälle und gehashte Quellstände bleiben separat erhalten. Artefakte, +Zugangsdaten und private Rohbelege werden nicht ins Git übernommen. + +**Offen:** Registrierung als unveränderliches Tenantartefakt/Rezept, Integration +in Plan/UI/Helper, native Erstinstallation und Noop sowie1.1-Upgrade und der +getrennte EXE-Provider. Jede tatsächliche Installation benötigt einen festen +Antrag und die interaktive WebUI-Genehmigung. Dieser Paketbau ersetzt keinen +dieser Nachweise. diff --git a/docs/windows-system-helper-bootstrap.md b/docs/windows-system-helper-bootstrap.md index be200fb..3aabc65 100644 --- a/docs/windows-system-helper-bootstrap.md +++ b/docs/windows-system-helper-bootstrap.md @@ -1,10 +1,13 @@ # Passiver SYSTEM-Helper: Installation und echter Agent-IPC-Nachweis -Stand 2026-11-14: Die folgende Strecke ist **implementiert und lokal -quellqualifiziert, noch nicht auf der Windows-VM ausgeführt**. Die bisherige -native Abnahme von 21 Helper-/Bibliothekstests bleibt ein Unit-Nachweis aus dem -Administrator-Bootstrap; sie belegt weder einen laufenden SYSTEM-Dienst noch eine -erfolgreiche Pipeverbindung des echten LocalService-Agenten. +Stand 2026-11-14: Featureagent nativ21+6 qualifiziert und erhaltend aktualisiert, +Helper im Fall `59c2fd6f-0503-46fd-88f3-985bca376c51` installiert und einmal +gestartet. Tatsächlich LocalSystem/Manual/PID6240, Helper `921cf182…`, eigene +Service-SID, geschütztes Ledger/Lock, leere Aktionsliste, Wirkungen und Reboot +gesperrt. Der echte unveränderte LocalService-Agent PID5140 meldet jedoch +`HELPER_NOT_AVAILABLE`: `verify-peer` ist fehlgeschlagen. **Kein positiver +Pipe-/Readiness-/Wirkungsnachweis.** Die21 nativen Helper-/Bibliothekstests +bleiben ein getrennter Unit-Nachweis aus dem Administrator-Bootstrap. Der optionale Build `system-helper` erkennt ausschließlich die geschützte Datei `C:\ProgramData\RustDiscoverySystem\agent-pin.json`. Die bestehende sechsstellige @@ -33,7 +36,11 @@ Eine einzige create-only Stagingdatei begrenzt auch unterbrochene Schreibvorgän ein Überbleibsel nach Prozessabbruch wird nicht überschrieben. Der Zeitstempel dient nur der Abnahmefrische, niemals als vertrauenswürdige Jobuhr. -## Geplante native Reihenfolge, nicht ausgeführt +## Native Reihenfolge und verbleibender Nachweis + +Schritte1–5 wurden tatsächlich ausgeführt. Schritt6 wurde ausgeführt und +scheiterte; der Fehlerbeleg bleibt unverändert erhalten. Neue Diagnosekontrollen +sind eine eigene Quellqualifikation und noch kein erfolgreicher Nachweis. 1. Einen neuen Agentbuild mit `system-helper` nativ qualifizieren und den bestehenden Agenten identitätserhaltend aktualisieren. Der maßgebliche