Configure operator-requested persistent SSH transport for the development Windows VM
Rust development slice / linux (push) Failing after 7s

This commit is contained in:
2026-11-16 13:33:45 +01:00
parent 090fcdffda
commit 67f6f582c7
4 changed files with 144 additions and 0 deletions
@@ -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
+9
View File
@@ -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).
+11
View File
@@ -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).
+55
View File
@@ -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.