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

263 lines
16 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.
**Aktueller Stand:** Die spätere User-Konsolenwiederherstellung wurde
erfolgreich ausgeführt; Root bestätigte anschließend die tatsächliche Rückkehr
des gepinnten SSH-Zugangs. Auch der getrennte vollständige Key-/Task-
Erhaltungsabgleich und der lokale Accessmetadaten-CAS sind inzwischen bestanden.
Einzelheiten stehen im neuen Abschlussabschnitt dieser Verlaufserfassung.
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`. Dieser lokale Roundtrip allein war ein
**abgeleiteter Sollwert**, noch kein gemessener Windows-VM-Accountwert. Der
spätere tatsächliche Userreadback ist unten getrennt dokumentiert. 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.
Die anschließende tatsächliche Userausführung des HashFix-Skripts `d366ae17…`
verweigerte im kombinierten anfänglichen Case-/Config-/Bootstrapguard weiterhin
vor Wirkung. Root ließ zunächst ausschließlich fünf Werte lesend ausgeben.
Der Userreadback ergab:
| Tatsächlicher Konsolenwert | Ergebnis |
| --- | --- |
| Recoverycase vorhanden | `false` |
| Config-SHA | `4ad28ec55027718a4e384c79ff7cc15ec9c798411a991a5d479e960310ed6823` |
| Bootstrap-SHA | `332ceeedf49f597eac353e0ef1f6e614c85cef20a5a20cce68d947085aa9d50f` |
| Configablaufzeit | `2026-11-14T12:55:31.254999+00:00` |
| Tatsächliches Account-FILETIME | `134391345312549990` |
Damit ist dieser Guardfehler konkret erklärt: die Recoveryquelle erwartete
den späteren Repositoryhash `9e992602…`, obwohl die VM exakt das ursprünglich
veröffentlichte Bootstrap mit Hash `332ceeed…` behielt. Das erhaltene Original-ZIP
`cba15946…` enthält genau diese Datei und die Config `4ad28ec5…`; das ebenfalls
veröffentlichte Reparaturpaket `2558448b…` bindet denselben Bootstraphash als
Voraussetzung und ersetzt Bootstrap/Config nicht. Der Maintainerteil beider
Bootstrapquellen ist bytegleich. Es wird somit keine unbekannte Datei anhand
eines beliebigen neuen Readbacks übernommen.
Die getrennte lokale Quelle
[`console_access_original_bootstrap.py`](../deploy/windows/console_access_original_bootstrap.py)
mit SHA `c0816055407c17af4c0bf4b5bd5ce3055e5a9d44fe7f2334f5aa7913520478c6`
bindet den tatsächlichen Userreadback und beide publizierten Originalpakete.
Sie erzeugt `Recover-ExistingDevAccess-OriginalBootstrap.ps1` mit SHA
`aba0a5a4152347e639266e95a05eae4343a99be9070a94fa4fc6501bfc3283d2`.
Ausschließlich die eine Bootstrap-Sollhashkonstante wird von `9e992602…` auf
das bestätigte Original `332ceeed…` berichtigt. Alle anderen Bytes des
`d366ae17…`-Skripts, einschließlich gleicher Case-Abwesenheit, voller UTC-
Präzision, Aliasfix, Fristen und Wirkungsschritte, bleiben identisch.
Der Userpatch `Create-VerifiedOriginalBootstrapFix.ps1` hat SHA
`64f1d62ea3a87d4db7103ca01f7d735689caf54a7cc4b2458908956624062549`.
Er verlangt den vollständigen Eingabehash `d366ae17…`, schreibt nur eine
zuvor fehlende neue Datei, prüft deren vollständigen Hash `aba0a5a4…` und
startet erst danach den separaten Bootstrapprozess. Lokaler Python-/AST-Test,
ein tatsächlicher lokaler PowerShelllauf des Patchpräfixes ohne Kindstart und
der unabhängige byteweise Review bestanden. Dadurch wird die Userausführung
der korrigierten Wirkung noch nicht vorweggenommen. Kein Serveraufruf und keine
weitere Serverfriständerung wurden durch diese lokale Korrektur ausgeführt.
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.
## Update: User-Konsolenerfolg und tatsächlicher gepinnter SSH-Kontakt
Der User meldete die erfolgreiche Ausführung der korrigierten Konsolenstrecke
`Recover-ExistingDevAccess-OriginalBootstrap.ps1` mit Hash `aba0a5a4…`.
Root erhielt danach über den bereits gepinnten SSH-Zugang tatsächlich eine
getrennte rein lesende Antwort. Der lokale Verifikationsfall ist
`fc7a6ad5-5ec5-4280-b629-851aad2529b2`; sein `readback.json` hat SHA
`bb0e2b4747068433bcb7c950743ef56007f22206ca5d4b458f6b8221a4a031e2`.
Der Beleg nennt weiterhin den ursprünglichen Consolefall
`5c96d3d8-1657-40c8-a6ec-c00b63a98210`, `read_only=true`,
`completed=true` und `no_jobs=true`.
| Tatsächlich beobachteter Wert | Ergebnis |
| --- | --- |
| Configablaufzeit | `2026-11-15T13:05:58+00:00` |
| Accountablaufzeit als FILETIME | `134392215580000000` |
| Originaler Reverse-Tunneltask | `Running` |
| `RmmDiscoveryWindows` | `Running`, PID `3172`, `NT AUTHORITY\LocalService`, Startart `Auto` |
| `RmmDiscoverySystemHelper` | `Stopped`, PID `0`, `LocalSystem`, Startart `Manual` |
| `W32Time` | `Running`, PID `3488`, `NT AUTHORITY\LocalService`, Startart `Manual` |
Damit ist die Rückkehr des Entwicklungszugangs belegt. Die früheren Aussagen
zur noch offenen Userphase bleiben historische Zwischenstände. Der zusätzliche
rein lesende Erhaltungsbeleg desselben Falls (`preservation.json`, SHA256
`490e01809ca1e4225f1dbb6a0a4414cf77f7822be31233366480b3a0d4810592`)
bestätigt alle sechs festen öffentlichen Dateien samt SHA/SDDL, Metadaten und
SDDL der vier privaten SSH-Schlüssel ohne Lesen ihrer Inhalte, den exakten
Originaltask-XML-Hash und Runningzustand, Account-SID sowie alle öffentlichen
Pins. Danach wurde lokal ausschließlich die Frist im Accessmetadaten-JSON per
CAS auf `2026-11-15T13:05:58+00:00` fortgeschrieben. Der SSH-Präfix blieb exakt
erhalten; Original und neuer Metadatenbeleg sind privat archiviert. Die alten
Fehlerfälle, Pakete und Korrekturquellen bleiben erhalten.
Der Readback ist kein Paarupgrade-, TrustedClock-, Boot- oder RMM-Jobnachweis.
Insbesondere eröffnet `W32Time=Running` keine Clockbereitschaft. Der Helper
war tatsächlich noch gestoppt; daraus wird kein authentisierter neuer
Agent-/Helper-Pipeaustausch abgeleitet. Root führt die getrennten Pipe-/MIDL-
Prüfungen erst anschließend fort.
Der User hat den nächsten Arbeitsfokus ausdrücklich auf die Skriptkonsole mit
vollständigem Shell-/PowerShellinhalt, tatsächlicher WebUI-Plangenehmigung,
Ausgabe und expliziten Root-/SYSTEM-Ausführungsrechten gelegt. Paketabnahmen
sind nachgeordnet. Der erneuerte SSH-Bootstrapzugang verleiht selbst keine
RMM-Ausführungsrechte und ersetzt keine dieser noch separat nachzuweisenden
Genehmigungs- und Ausführungsgrenzen.