diff --git a/deploy/windows/Set-PersistentDevelopmentAccess.ps1 b/deploy/windows/Set-PersistentDevelopmentAccess.ps1 new file mode 100644 index 0000000..5bf8117 --- /dev/null +++ b/deploy/windows/Set-PersistentDevelopmentAccess.ps1 @@ -0,0 +1,69 @@ +#requires -Version 5.1 +#requires -RunAsAdministrator +[CmdletBinding()] +param( + [Parameter(Mandatory)][ValidatePattern('^[a-f0-9]{64}$')][string]$ExpectedTaskSha256, + [Parameter(Mandatory)][DateTimeOffset]$HandoffAt +) +# Explicit operator request: persistent access to the development VM only. +# No RMM job, enrollment, credential replacement or public Windows listener. +$ErrorActionPreference = 'Stop' +if ($HandoffAt -le [DateTimeOffset]::UtcNow.AddMinutes(1) -or + $HandoffAt -gt [DateTimeOffset]::UtcNow.AddHours(2)) { throw 'Expected near-term handoff after the existing window.' } +$root = 'C:\ProgramData\RmmDevAccess' +$case = Join-Path $root 'persistent-development-access-20261116' +if (Test-Path -LiteralPath $case) { throw 'Existing access change: inspect original receipt, never repeat.' } +function Get-RmmAccessTextSha256([string]$Value) { + $sha = [Security.Cryptography.SHA256]::Create() + try { return [BitConverter]::ToString($sha.ComputeHash([Text.Encoding]::UTF8.GetBytes($Value))).Replace('-','').ToLowerInvariant() } + finally { $sha.Dispose() } +} +# Preserve the exact existing descriptors; the public .pub file has read-only Everyone access. +$expectedAccessDescriptors = @{ + 'RmmDevAccess' = 'O:BAG:S-1-5-21-2396205367-1554564896-454414693-513D:PAI(A;OICI;FA;;;SY)(A;OICI;FA;;;BA)' + 'bootstrap-public.json' = 'O:BAG:S-1-5-21-2396205367-1554564896-454414693-513D:AI(A;ID;FA;;;SY)(A;ID;FA;;;BA)' + 'known_hosts' = 'O:BAG:S-1-5-21-2396205367-1554564896-454414693-513D:AI(A;ID;FA;;;SY)(A;ID;FA;;;BA)' + 'tunnel_ed25519' = 'O:BAG:S-1-5-21-2396205367-1554564896-454414693-513D:PAI(A;;FA;;;SY)(A;;FA;;;BA)' + 'tunnel_ed25519.pub' = 'O:LAG:S-1-5-21-2396205367-1554564896-454414693-513D:P(A;;0x1200a9;;;WD)(A;;FA;;;SY)(A;;FA;;;BA)(A;;0x1301bf;;;LA)' +} +foreach ($path in @($root,(Join-Path $root 'bootstrap-public.json'),(Join-Path $root 'known_hosts'),(Join-Path $root 'tunnel_ed25519'),(Join-Path $root 'tunnel_ed25519.pub'))) { + $item = Get-Item -LiteralPath $path -Force + if (($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0) { throw 'Original access path required.' } + $acl = Get-Acl -LiteralPath $path + if ($acl.Sddl -cne $expectedAccessDescriptors[(Split-Path -Leaf $path)]) { throw 'Original access descriptor differs.' } +} +$cfg = Get-Content -LiteralPath (Join-Path $root 'bootstrap-public.json') -Raw | ConvertFrom-Json +if ($cfg.server -cne 'discovery.ease-technologies.de') { throw 'Expected fixed server.' } +if ((Get-Content -LiteralPath (Join-Path $root 'known_hosts') -Raw).Trim() -cne + ('discovery.ease-technologies.de ' + $cfg.server_host_key)) { throw 'Confirmed original host pin required.' } +$public = ((Get-Content -LiteralPath (Join-Path $root 'tunnel_ed25519.pub') -Raw).Trim() -split '\s+')[0..1] -join ' ' +if ($public -cne 'ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJEkk35zkrDXkOqggrvgsrataMZOzrqFTSh3jWbptbSa') { throw 'Original tunnel public key required.' } +$listen = @(Get-NetTCPConnection -State Listen -LocalPort 22222) +if ($listen.Count -ne 1 -or $listen[0].LocalAddress -cne '127.0.0.1' -or + (Get-Service sshd).Status -ne 'Running') { throw 'Original loopback-only sshd required.' } +$user = Get-LocalUser -Name 'rmm-dev' +if (!$user.Enabled -or $user.SID.Value -cne 'S-1-5-21-2396205367-1554564896-454414693-1002') { throw 'Original development account required.' } +$xml = Export-ScheduledTask -TaskPath '\' -TaskName 'RmmDevReverseTunnel' +if ((Get-RmmAccessTextSha256 $xml) -cne $ExpectedTaskSha256) { throw 'Previous task differs.' } +if ([string](Get-ScheduledTask -TaskPath '\' -TaskName 'RmmDevReverseTunnel').State -ceq 'Running') { throw 'Do not replace a running task.' } +$null = New-Item -ItemType Directory -Path $case +[IO.File]::WriteAllText((Join-Path $case 'original-task.xml'),$xml,[Text.UTF8Encoding]::new($false)) +$originalExpiry = if ($null -ne $user.AccountExpires) { $user.AccountExpires.ToUniversalTime().ToString('o') } else { $null } +@{original_task_sha256=$ExpectedTaskSha256;original_account_expiry_utc=$originalExpiry;handoff_at_utc=$HandoffAt.UtcDateTime.ToString('o');account_sid=$user.SID.Value} | + ConvertTo-Json -Compress | Set-Content -LiteralPath (Join-Path $case 'intent.json') -Encoding UTF8 +$tunnelArguments = '-F NUL -N -T -o BatchMode=yes -o IdentitiesOnly=yes -o ForwardAgent=no -o StrictHostKeyChecking=yes -o GlobalKnownHostsFile=NUL -o UserKnownHostsFile=C:\ProgramData\RmmDevAccess\known_hosts -o ExitOnForwardFailure=yes -o ConnectTimeout=10 -o ServerAliveInterval=15 -o ServerAliveCountMax=2 -i C:\ProgramData\RmmDevAccess\tunnel_ed25519 -R 127.0.0.1:22240:127.0.0.1:22222 rmm-win-tunnel@discovery.ease-technologies.de' +$action = New-ScheduledTaskAction -Execute "$env:WINDIR\System32\OpenSSH\ssh.exe" -Argument $tunnelArguments +$triggers = @((New-ScheduledTaskTrigger -AtStartup),(New-ScheduledTaskTrigger -Once -At $HandoffAt.LocalDateTime)) +$settings = New-ScheduledTaskSettingsSet -ExecutionTimeLimit ([TimeSpan]::Zero) -RestartCount 999 -RestartInterval (New-TimeSpan -Minutes 1) -MultipleInstances IgnoreNew -StartWhenAvailable -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries +$principal = New-ScheduledTaskPrincipal -UserId 'SYSTEM' -LogonType ServiceAccount -RunLevel Highest +$task = New-ScheduledTask -Action $action -Trigger $triggers -Settings $settings -Principal $principal -Description 'Operator-authorized persistent SSH transport for this development Windows VM only; no RMM authorization.' +$null = Register-ScheduledTask -TaskPath '\' -TaskName 'RmmDevReverseTunnel' -InputObject $task -Force +Set-LocalUser -SID $user.SID -AccountNeverExpires +$actual = Get-ScheduledTask -TaskPath '\' -TaskName 'RmmDevReverseTunnel' +$actualUser = Get-LocalUser -SID $user.SID +if ($null -ne $actualUser.AccountExpires -or $actual.Actions.Count -ne 1 -or + $actual.Actions[0].Arguments -cne $tunnelArguments -or $actual.Settings.ExecutionTimeLimit -cne 'PT0S' -or + $actual.Principal.UserId -notin @('SYSTEM','NT AUTHORITY\SYSTEM','S-1-5-18') -or $actual.Triggers.Count -ne 2) { throw 'Persistent access readback differs; inspect original case.' } +$result = [ordered]@{schema_version=1;utc=[DateTime]::UtcNow.ToString('o');development_transport_only=$true;account_expires=$false;task='RmmDevReverseTunnel';task_sha256=(Get-RmmAccessTextSha256 (Export-ScheduledTask -TaskPath '\' -TaskName 'RmmDevReverseTunnel'));handoff_at_utc=$HandoffAt.UtcDateTime.ToString('o');reverse_listen='127.0.0.1:22240';windows_listen='127.0.0.1:22222';existing_keys_preserved=$true;current_tunnel_stopped=$false;rmm_jobs_created=$false;rmm_services_changed=$false} +$result | ConvertTo-Json -Compress | Set-Content -LiteralPath (Join-Path $case 'result.json') -Encoding UTF8 +$result | ConvertTo-Json -Compress diff --git a/docs/development.md b/docs/development.md index 2251fcc..4b992e5 100644 --- a/docs/development.md +++ b/docs/development.md @@ -343,3 +343,12 @@ eine neue Geräteidentität samt Historie. Kein DB-/PKI-Reset und kein Token-/Ke Long Polling, Reconnect-/Widerrufsabnahme auf VM, Proxy-/Klon-/Restore-/Lastabnahme. Keine Jobs, WebUI-Freigaben, Updates oder Reboots ausgeführt. Der passive VM-Erstnachweis ist erfolgreich, **M1 insgesamt und Linux-MVP bleiben unabgenommen**. + + +## Betreiberentscheidung: dauerhafter Windows-Entwicklungstransport + +Für die reine Windows-Test-VM hat der Betreiber ausdrücklich einen dauerhaft +gültigen bestehenden SSH-Rückkanal beauftragt. Die bisherige Befristung wird +ausschließlich für diesen Entwicklungstransport ersetzt. Keine RMM- oder +WebUI-Genehmigungsregel ändert sich. Notebook weiterhin nur Entwicklung. +[Tatsächliche Konfiguration und noch ausstehende Übergabeprüfung](windows-development-access.md). diff --git a/docs/project-decisions.md b/docs/project-decisions.md index 5756d4f..3994520 100644 --- a/docs/project-decisions.md +++ b/docs/project-decisions.md @@ -449,3 +449,14 @@ keine History-/Marker-Löschung und keine Fail-closed-Ausnahme. Native Prüfstä stehen getrennt im [Journalbericht](journal-capacity.md); die Entscheidung selbst behauptet keine bereits ausgeführte Installation. Kompaktierung bleibt nach dem MVP. + + +## Dauerhafter Entwicklungszugang zur Windows-Test-VM + +Der Betreiber verlangt ausdrücklich, den vorhandenen SSH-Rückkanal dieser +reinen Entwicklungstestmaschine dauerhaft zu betreiben. Die frühere Befristung +des Wartungstransports gilt dafür nicht mehr. Gleiche Schlüssel, bestätigte +Hostpins und ausschließlich Loopback gebundene Weiterleitung bleiben Pflicht. +Dies ist keine Job-, Root-/SYSTEM- oder dauerhafte WebUI-Planfreigabe. Der +MVP-Produktvertrag und die Historie der RMM-Agenten bleiben unverändert. +[Einrichtung, Nachweise und aktueller Übergabestatus](windows-development-access.md). diff --git a/docs/windows-development-access.md b/docs/windows-development-access.md new file mode 100644 index 0000000..0b7bf3c --- /dev/null +++ b/docs/windows-development-access.md @@ -0,0 +1,55 @@ +# Entwicklungszugang zur Windows-Test-VM + +Stand 16. November 2026, 12:18 UTC. Der Betreiber hat für diese reine +Entwicklungstestmaschine ausdrücklich einen dauerhaft gültigen SSH-Rückkanal +beauftragt, damit keine wiederholten Konsolenbefehle nötig sind. Dies ersetzt +nur die bisherige Befristung des Entwicklungstransports. Geräteidentität, +RMM-Rechte, WebUI-Genehmigung und Einmalverbrauch bleiben eigenständig. +Das Notebook bleibt ausschließlich Entwicklungsrechner. + +## Tatsächlich eingerichtet + +Auf `discovery.ease-technologies.de` wurde beim vorhandenen Tunnelkey allein +`expiry-time` entfernt. Key, Account und die Beschränkungen auf ausschließlich +`127.0.0.1:22240` bleiben erhalten. Die vorherige Datei und ein Änderungsbeleg +liegen geschützt auf dem Server. Kein SSH-/RMM-/Zeitdienst wurde dafür neu +gestartet. SHA-256 der neuen Authorized-Keys-Datei: +`db10a5ce8e859bc7fc9bfe995006051c2bac3d15e3a5ce5166a82c4929457885`. + +Auf der Windows-VM hat `Set-PersistentDevelopmentAccess.ps1` den vorhandenen +Task `RmmDevReverseTunnel` unter SYSTEM durch den direkten OpenSSH-Aufruf +mit denselben Schlüsseln und strikter Prüfung des bestätigten Serverhostkeys +ersetzt. Das bestehende Konto `rmm-dev` hat jetzt kein Ablaufdatum. Der Task +startet beim Boot sowie zur Übergabe um **12:39:57 UTC / 13:39:57 MEZ**, +hat keine Laufzeitbegrenzung und startet nach einem Fehler erneut. Der +vorherige Task und das alte Kontoablaufdatum sind im privaten Windows-Fall +`C:\ProgramData\RmmDevAccess\persistent-development-access-20261116` +aufbewahrt. Task-XML-Hash nach tatsächlichem Readback: +`e7e8c304a8eb13ec06fd78b6d1fd6b90994f7741a0efe8feae61fc7539abc7fc`. + +Der derzeitige Vordergrundtunnel wurde nicht beendet. **Der automatische +Verbindungsaufbau nach der geplanten Übergabe ist noch separat zu prüfen.** +Die Konfiguration allein ist kein Beleg für einen durchgehend aktiven Tunnel. + +Windows-sshd lauscht weiterhin ausschließlich auf `127.0.0.1:22222`; +kein öffentlicher Windows-Port wurde geöffnet. Agent und Helper bleiben für +den gesondert genehmigten Kontrollabschluss 205 gestoppt. Dieser Zugang +führt selbst keine RMM-Jobs aus und erteilt keine Jobgenehmigungen. + +## Prüfumfang und Grenzen + +Ein erster Versuch stoppte vor jeder Windows-Änderung: Die vorhandene +öffentliche `.pub`-Datei gehört dem eingebauten Administrator und besitzt +zusätzlich einen lesenden Everyone-Eintrag. Der Controller erwartete zunächst +bei allen Dateien dieselben privaten Eigentümer. Anschließend wurden nur +Eigentümer und ACL-Metadaten der festen Pfade gelesen. Der korrigierte +Controller bindet deren **exakte unveränderte Deskriptoren** einschließlich +der öffentlichen Datei. Private Schlüsselbytes wurden dafür nicht gelesen; +keine ACL wurde gelockert. Der tatsächliche PowerShell-5.1-Parserlauf war +fehlerfrei, danach lief die Konfiguration einmalig mit erfolgreicher Nachlese. + +Lokale Originalbelege liegen unter +`devstate/windows-client/mvp-closeout-20261116/persistent-access-*` und +sind absichtlich nicht Teil des Git-Repositorys. Bei einer späteren Entfernung +zuerst den konkreten Task und die einzige Server-Keyzeile prüfen; erhaltene +Originale nicht blind über einen zwischenzeitlich geänderten Stand kopieren.