Files
rust-discovery/docs/windows-dev-access-recovery.md
T
2026-11-14 15:00:03 +01:00

167 lines
10 KiB
Markdown

# Windows-Entwicklungszugang: Ablauf und vorbereitete Konsolenwiederherstellung
Stand: 2026-11-14. Der bisherige SSH-Entwicklungszugang lief am
**2026-11-14T12:55:31.254999+00:00** ab. Die vorher vorbereitete automatische
Verlängerung wurde **nicht betreten**: kein Server- oder Windows-Enter, keine
Ablaufzeitänderung und kein angelegter Renewalworker. Die drei fehlgeschlagenen
Vorbereitungen und ihre Quellen bleiben historische Belege.
Diese Entwicklungshilfe ist SSH-Bootstrap, keine RMM-Aktion und kein Ersatz für
Geräte-mTLS, Tenantgrenzen, TrustedClock, signierte Grants oder die
WebUI-Genehmigung. Das Notebook bleibt ausschließlich Entwicklungsrechner.
## Tatsächliche abgebrochene Vorbereitungen
| Fall unter `devstate/windows-client/dev-access-renewal/` | Tatsächliches Ergebnis |
| --- | --- |
| `45626a0c-edc4-4f35-9f36-921692bccbc1` | Rein lesende Windows-Vorbereitung verweigerte `Transport owner` vor dem Serveraufruf. Die zwei öffentlichen `.pub`-Dateien gehörten dem tatsächlichen lokalen Builtin-Administrator mit SID-Endung `-500`; deren bestehende öffentlichen Leserechte waren für die ursprüngliche private Dateiprüfung zu weit. Nur die separate öffentliche Metadatenprüfung wurde später präzisiert; keine ACL-Reparatur. |
| `d40c06a4-d6d3-4dc0-9ef6-b1ef1197bcc9` | Rein lesende Windows-Vorbereitung verweigerte `VariableNotWritable`: die Hilfsvariable `$host` kollidierte mit PowerShells schreibgeschütztem `$Host`. Die Quelle wurde anschließend auf `$hostPublic` korrigiert. Keine Server- oder Windowsmutation. |
| `6988fd11-0e0a-4fd7-878d-96b130d83aee` | Der lokale Datums-/Fristguard verweigerte nach Ablauf der alten Frist, noch vor `prepare-intent.json`. Dies war kein weiterer ausgeführter Windows-Readonly-Test. Der leere lokale Fall bleibt erhalten. |
Die ersten beiden Fälle enthalten nur Vorbereitungsintent und Controllerkopie;
keiner enthält einen Server-/Windows-Enterintent. Root bestätigte zusätzlich,
dass kein Renewal-Enter und kein Worker ausgeführt wurden. Ablauf und Fehler
werden nicht nachträglich als erfolgreiche Verlängerung ausgegeben.
## Getrennte Wiederherstellung des bereits abgelaufenen Zugangs
Die neue Quelle
[`console_access_recovery.py`](../deploy/windows/console_access_recovery.py)
hat SHA-256
`703fb5e4ae04d8555bad858c5d7b2ac4880e06d6fa951010acd43f7201a58053`.
Sie trennt den Server-CAS von der erst anschließend durch den User in der
Windows-Administratorkonsole auszuführenden Phase. Die frühere
[`dev_access_renewal.py`](../deploy/windows/dev_access_renewal.py) wird für den
abgelaufenen Lease nicht umgedeutet oder erneut gestartet.
Root führte ausschließlich den Serverteil im neuen Fall
`4b6506a7-6c3e-4cca-a497-618fa8666300` aus. Dessen `server-entered.json`
meldet `completed=true`; ein getrennt gespeicherter lesender Readback bestätigt
dieselbe neue Autorisierungsdatei und Frist:
| Bindung | Tatsächlicher Beleg |
| --- | --- |
| Neue feste UTC-Frist | `2026-11-15T13:05:58+00:00` |
| `authorized_keys` nach CAS | `fef4db300dd39fba9b52428817f453451c251c7768dd2fb6a76b39dd110dbbf2` |
| Unverändertes SSH-Profil | `932adc2ad3e88c3a47054c3d09e44024f21918cf144f0bb349bd8763e844e482` |
| Unveränderte effektive SSH-Konfiguration | `3a345912fdd4bb9bb29628d670a8bdbdfbbc22b3e308ab56fb3bafb7bc15533a` |
| Server-Enterbeleg | SHA `2185a88fc32db72119a584d84a46fb25cfca5f32f6e0c4ee5b7cf0728a361317` |
| Getrennter Readback | SHA `f6e3f69a6cd4f006d00c90cadd8bfd47f94e954f1297bea5f6eecc4fd27d3787` |
Der Serverteil ersetzte ausschließlich den Ablaufwert des gleichen bestehenden
restriktiven Tunnelkeys. Keybytes und Optionen, Loopbacklistener
`127.0.0.1:22240`, SSH-Profil, Serverhostpin und der Account
`rmm-win-tunnel` mit Shell `/usr/sbin/nologin` blieben gebunden. Historische
`prepared.json`/`registered.json` wurden nicht überschrieben. Dieser CAS
veränderte weder einen Downloadlease noch die RMM-Konfiguration.
## Öffentliches Paket und noch offene Userphase
Unter dem privaten Consolefall liegt das **inzwischen zurückgezogene,
historisch erhaltene** öffentliche Paket mit genau
`Recover-ExistingDevAccess.ps1`, `public-recovery.json` und `README.txt`.
Es enthält öffentliche Pins und feste Parameter, keine privaten Schlüssel oder
Tokens. Die Paketdateien sind zusätzlich im unveränderlichen Intent gebunden.
| Datei | SHA-256 |
| --- | --- |
| `windows-dev-access-recovery.zip` | `7bf4f7bb8336fb50852f72eec2f3e370e96cb7009b14ee15aa7232c025a38ed7` |
| `Recover-ExistingDevAccess.ps1` | `564da57d70ef06df7bd9adc37565b7e28ef446a6c69b984711c5b77b28441e8a` |
| Consoleintent | `cd827d4056fb0045f23bff1fd9bd21b6137b53f063fe8215ad0945c2013cc44a` |
Vor der Userausführung fand Root im Konsolenguard eine unbelegte
Ganzsekundenannahme für den alten `AccountExpires`-Wert. Der feste Wert
`134391345310000000` ließ den Bruchteil `.254999` der ursprünglichen
Konfigurationszeit weg. Ein lokaler .NET-Roundtrip derselben vollständigen
UTC-Zeit ergibt `134391345312549990`. Das ist ein **abgeleiteter Sollwert**,
kein gemessener Windows-VM-Accountwert. Das alte Paket wird deshalb nicht zur
Ausführung weitergegeben; sein gültiger getrennter Server-CAS bleibt erhalten.
Die kleine neue Quelle
[`console_access_precision.py`](../deploy/windows/console_access_precision.py)
mit SHA
`8b4d14edf0794c4ef662d7587b4538f8e7aebc06c11db76c3cafc2c24c11a37b`
erzeugte den neuen lokalen Consolefall
`5c96d3d8-1657-40c8-a6ec-c00b63a98210`. Sie bindet den ursprünglichen
Serverintent, Enterbeleg und getrennten Readback des Falls `4b6506…` sowie
sämtliche alten Paketdateihashes. Es gibt weder einen Serveraufruf noch eine
erneute Fristverlängerung: `2026-11-15T13:05:58+00:00` bleibt unverändert.
Der neue Guard berechnet genau einen erwarteten 64-Bit-Wert über
`[DateTimeOffset]::Parse($cfg.expires_at).UtcDateTime.ToFileTimeUtc()` aus der
zuvor anhand der Originalbytes und der exakten alten Zeit geprüften Config.
Keine Rundung, Toleranz oder alternative Zeit wird akzeptiert. UUID und
Provenienzbeleg sind neu; die drei Mutationsschritte ab `File.Replace` bis
zum Ende sind gegenüber dem alten Paket bytegleich. Falls ein früheres Paket
entgegen dem bisherigen Kontrollstand bereits erfolgreich ausgeführt wurde,
muss der alte Config-Hashguard verweigern. Dann nur lesen und durch Root
abgleichen, kein neuer Versuch.
| Neues Korrekturartefakt | SHA-256 |
| --- | --- |
| ZIP im Fall `5c96d3d8…` | `dbcd5ca863c0b09f89b67eb10eeaeaf89b941bbc5840079f1bb0c36dc6ff3b3e` |
| Neues `Recover-ExistingDevAccess.ps1` | `4977665fb092723998473f1c4be6685b1d93975176f8957bc3287d7e2f61cb69` |
| Neuer unveränderlicher Intent | `eae7995b5735bf1e8f0fafc0ae6ccf6bdd4576566663c1256a511f6c3408e32e` |
Die Userphase mit dem Konsolenskript des Falls `5c96…` wurde inzwischen begonnen,
scheiterte aber vor jeder Wirkung an `Get-History / IdCannotConvert`: PowerShells
standardmäßiger Alias `h` wird auch unter `-NoProfile` vor der Funktion `H`
aufgelöst. Der Fehler trat im ersten Case-/Configguard vor `New-Item` auf.
Es wurde damit keine Konfigurations-/Accountablaufzeit geändert und kein
Tunneltask gestartet. Die unveränderte Case-Abwesenheitsprüfung bleibt für die
erste tatsächlich noch unerreichte Wirkung verbindlich.
Die separate lokale Quelle
[`console_access_hash_command.py`](../deploy/windows/console_access_hash_command.py)
hat SHA `b682ced57bf7ac71c0b1ba67eb5a51a20dde814fe361e1ae2cc17872147444ad`.
Sie erzeugt `Recover-ExistingDevAccess-HashFix.ps1` mit SHA
`d366ae1705dac3252726dedf369c04462e42534ddcf6e15dc27bba8583427d2c`.
Ausschließlich die eine Funktionsdefinition und alle fünf Aufrufe heißen nun
`Get-RmmRecoveryFileSha256`; eine inverse Ersetzung ergibt exakt die alten
PS1-Bytes. Alle übrigen Guards, Pins, Fristen, die gleiche Console-UUID und
Mutationsschritte bleiben erhalten. Kein Alias wird entfernt oder geändert.
Der kleine Userpatch `Create-VerifiedHashFix.ps1` mit SHA
`385a388476cef0c85f02bca236ade48f28a041476330d3e309ab1ca2f22bb9f5`
prüft zuerst den ursprünglichen PS1-Hash `4977665f…`, erzeugt ausschließlich
eine zuvor fehlende neue Datei mit UTF-8 ohne BOM, verlangt deren vollständigen
Hash `d366ae17…` und startet erst dann den separaten Bootstrapprozess mit
`-NoProfile -ExecutionPolicy RemoteSigned`. Kein neuer Download ist für diese
lokale Korrektur erforderlich. Bereits vorhandene Korrekturdateien werden
nicht überschrieben und eine unklare frühere Wirkung wird nicht wiederholt.
ASTs, vollständige Command-AST-Ersetzung sowie ein tatsächlicher lokaler
Hashfunktionsaufruf bei unverändert vorhandenem Alias `h=Get-History` bestanden;
der unabhängige Review bestätigte die reine Namensänderung. Das sind lokale
PowerShellprüfungen, kein weiterer Windows-VM-Erfolgsnachweis. Alte Quellen,
ZIPs und Fehlerbelege bleiben unverändert.
Eine erfolgreiche Windows-Konsolenphase und Tunnelwiederkehr sind **noch nicht
nachgewiesen**. Die korrigierte Strecke prüft die alten
Config-/Bootstrapbytes und öffentlichen Pins, den bestehenden Account sowie den
unveränderten SYSTEM-Tunneltask. Erst bei `Ready` und ohne verbliebenen
Maintainer/SSH-Kindprozess darf sie die vorhandene Konfigurations- und
Accountablaufzeit erneuern und den Originaltask mit dauerhaftem Startintent
**einmal** starten. Private Keydateien werden nur über Metadaten beobachtet,
nicht inhaltlich gelesen. Keine Installation, ACL-Reparatur, neue Schlüssel,
zusätzlichen SSH-Rechte, Prozesskills, Reboots oder RMM-Wirkungen.
Die README verlangt den unabhängig mitgeteilten Downloadhash und den festen
PS1-Hash. Ein etwaiges `Unblock-File` betrifft nur diese exakt geprüfte
Download-Datei; `RemoteSigned` nur den separaten Bootstrapprozess. Eine
verweigernde GPO oder ein fehlgeschlagener Guard wird nicht umgangen. Ein
bereits vorhandener Recoveryfall bleibt zur lesenden Inspektion erhalten.
Eine gesonderte, auf 45 Minuten begrenzte Veröffentlichung über den vorhandenen
öffentlichen TLS-Bootstrapdienst wird durch Root separat behandelt. Dieser
Server-CAS und diese Dokumentation belegen noch keine Downloadveröffentlichung.
Nach der Userausführung bleiben tatsächliche Tunnelwiederkehr, ursprüngliche
SSH-Hostidentität, erhaltene Schlüssel/Taskdefinition und die lokale
Accessmetadatenfortschreibung durch Root zu prüfen. **Neuer Windowszugriff ist
bis dahin nicht nachgewiesen.**
Lokale Python-/AST- und Paketprüfungen sowie unabhängige Source-Reviews bestanden.
Der lokale Paketfixture verwendete einen gemockten Serveraufruf und ist kein
zusätzlicher nativer Recoverybeleg. Kein RMM-Job, keine Capability oder
Clockbereitschaft folgt aus der Zugangswiederherstellung.