Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s
Rust development slice / linux (push) Failing after 14s
This commit is contained in:
@@ -1,231 +0,0 @@
|
||||
# Windows-Client: erster nativer Entwicklungsstand
|
||||
|
||||
Stand 2026-11-13, Spezifikation 1.15. Windows-11-Gast und Notebook-Host sind
|
||||
verschiedene Geräte. Auf dem Notebook laufen ausschließlich Entwicklungstools;
|
||||
der Client verwendet den endgültigen Cloudserver `discovery.ease-technologies.de`.
|
||||
|
||||
Neuer Quellenstand 2026-11-15: [passive Zertifikatserneuerung](../../docs/windows-certificate-renewal.md)
|
||||
mit geschützter Keydatei und atomarer Versionswahl ist implementiert; native
|
||||
Windows-Renewal-/Abbruch-/DACLabnahme und Freigabe der permanenten Identität
|
||||
bleiben offen. Frühere Transportabnahmen darunter bleiben historische Belege.
|
||||
|
||||
## Aktueller Dienst dauerhaft auf Auto — 2026-11-13
|
||||
|
||||
Nach dem bestandenen Fallbacktest wurde die bestehende VM im separaten Fall
|
||||
`422562e8-18eb-4865-977d-ab2af65f510b` dauerhaft auf `transport=auto` gestellt.
|
||||
WSS bleibt bevorzugt; zwei frische WSS-Heartbeats und ein konkretes Inventar-ACK
|
||||
sind unter dem tatsächlichen LocalService (`S-1-5-19`) nativ nachgewiesen.
|
||||
Binary, Geräteidentität, CA, Zertifikat, Schlüssel, ACLs und Telemetriehistorie
|
||||
blieben erhalten. Beide Server-Testhooks bleiben deaktiviert; Serverkonfiguration
|
||||
und Rootpolicy wurden bei dieser Umstellung nicht verändert. Windows bleibt bei
|
||||
0 Jobs/Outbox/Grants/ungeklärten Wirkungen, Linux unverändert bei 30/30/26/0.
|
||||
|
||||
Der verifizierte geschützte Beleg liegt unter
|
||||
`devstate/windows-client/auto-default/422562e8-18eb-4865-977d-ab2af65f510b/result.json`.
|
||||
`devstate/windows-client/current-transport.json` bindet ihn per Hash und hält den
|
||||
aktuellen Transport getrennt von historischen Abnahmen fest. Originalkonfiguration
|
||||
und ACLs bleiben versioniert für eine ausdrückliche Wiederherstellung erhalten.
|
||||
Die Installerquelle verwendet ebenfalls `auto`; eine frische Installation wurde
|
||||
damit nicht ausgeführt. Fünf gezielte lokale Schutztests sowie Parserprüfungen
|
||||
bestanden. Es wurden keine Windows-Jobs oder Reboots ausgeführt.
|
||||
|
||||
## Automatischer WSS→HTTPS-Fallback nativ bestanden — 2026-11-13
|
||||
|
||||
Eigener Fall `2ff2e1aa-0037-4831-9bc2-31218bf1461c` auf derselben bestehenden
|
||||
Windows-Identität unter LocalService. Nur der eigene Agenttransport wurde
|
||||
versioniert auf `auto` gestellt. Zunächst zwei frische WSS-Heartbeats;
|
||||
dann exakt gerätegebundene, zehn Minuten gültige dev/test-Störung.
|
||||
Zwei tatsächliche mTLS-authentisierte HTTP503 bei WSS, mit unterschiedlichen
|
||||
Handshake-IDs und den festen Slots1/2, Zertifikatsfingerprint und Config-Hash.
|
||||
Der Agent wechselte selbst zu HTTPS; zwei frische HTTPS-Heartbeats und konkreter
|
||||
Inventar-ACK nach beiden Verweigerungen tatsächlich gespeichert.
|
||||
|
||||
Gleiche Agent-/Asset-/Enrollment-/Zuordnungsversion und Dateien/ACLs, monotone
|
||||
Sequenz, TenantB weiter verweigert. Kein neuer RMM-Job: Windows vor/nach
|
||||
0Jobs/0Outbox/0Grants/0offen; Linux unverändert30/30/26/0. Zentrale Rootpolicy
|
||||
unverändert. Beide realen Serverrollen danach mit Faultflagfalse und ohne
|
||||
konfigurierten Fault-Dateipfad; exakte ursprüngliche WSS-Konfigurationsbytes und
|
||||
ACLs auf Windows restauriert, wieder zwei frische WSS-Heartbeats/ACK0.
|
||||
Dies ist keine Behauptung eines automatischen HTTPS→WSS-Switchbacks: Rückkehr
|
||||
folgte aus der ausdrücklichen operativen Wiederherstellung der Konfiguration.
|
||||
|
||||
Ausgeführt: `python3 deploy/windows/auto_transport_acceptance.py start
|
||||
--https-case 3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458`.
|
||||
Sechs gezielte lokale Guards ergänzen den nativen Nachweis; kein neuer
|
||||
Clientbuild und keine Windows-Syncbereitschaft erfunden. Geschützt:
|
||||
`devstate/windows-client/auto-transport/2ff2e1aa-0037-4831-9bc2-31218bf1461c/result.json`,
|
||||
verifiziert. Am Ende dieses Testfalls lief der Dienst wieder mit ursprünglichem
|
||||
WSS. Die anschließende dauerhafte Auto-Umstellung ist oben separat dokumentiert.
|
||||
|
||||
## TLS-Negativfälle auf Windows nativ bestanden — 2026-11-13
|
||||
|
||||
Feste getrennte Fixture `7b190a5c-c928-4348-bd0d-c9698dad5417`, Schlüssel auf
|
||||
Windows erzeugt und dort behalten. Nur öffentliche CSR zum bestehenden
|
||||
Cloudsignierer, ausschließlich öffentliche CA-/Clientzertifikate zurück.
|
||||
Unregistrierte gültige Kontrolle vor und nach den Negativfällen: tatsächliches
|
||||
HTTP401 nach erfolgreichem TLS. Falsche CA: `TLS_UNKNOWN_ISSUER`; falscher
|
||||
Servername: `TLS_SERVER_NAME_MISMATCH`; abgelaufenes Clientzertifikat:
|
||||
`TLS_PEER_CERTIFICATE_EXPIRED`, jeweils ohne HTTP-Antwort. Alle fünf nativen
|
||||
Probeprozesse mit dem gemeinsamen `https_channel::mtls_client` bestanden.
|
||||
|
||||
Dies sind ausdrücklich Admin-TLS-Proben, keine LocalService- oder
|
||||
Rotationsabnahme. Der tatsächliche LocalService-HTTPS-Pfad ist separat unten
|
||||
nachgewiesen. Permanenter Dienst samt PID/Startkonto, Identität, öffentliche
|
||||
Zertifikatsdateien und private Schlüsseldateimetadaten vor/nach identisch.
|
||||
Keine Dienstoperation, Registrierung, Jobs, Uhränderung oder TLS-Ausnahme.
|
||||
|
||||
Erster Lauf blieb bei unbekannt klassifiziertem CA-Fehler sicher verweigert.
|
||||
Typinformation wurde in verschachtelten io::Error-Quellen übersprungen;
|
||||
gezielter get_ref-Fix samt Test erkennt den echten Rustlsfehler, ohne Timeout,
|
||||
Reset oder Fehlertexte als Zertifikatsablehnung zu werten. Ein Retest wurde
|
||||
vor TLS durch einen Bootstrap-Witness-Timeout unterbrochen. Kurzer begrenzter
|
||||
Witness und erneute Prüfung derselben unveränderten öffentlichen Fixtures
|
||||
bestanden, ohne neue CSR/Signierung/Keyerzeugung. Alte Ergebnisse bleiben erhalten.
|
||||
|
||||
Verifiziertes Ergebnis unter
|
||||
`devstate/windows-client/tls-negative/7b190a5c-c928-4348-bd0d-c9698dad5417/typed-retest-6dd51cc0-deb5-4020-afee-58dbb716cdbb/result.json`.
|
||||
Qualifizierte Probe SHA256
|
||||
`33eb56500908a88e3ff30cc1e61f9416e38d94fbf27633ac6dfaf9903cd4ef1b`:
|
||||
gelockter Windows-GNU-Releasebuild, Clippy mit-Dwarnings, gezielter verschachtelter
|
||||
TLS-Fehlertest und Python-/PowerShell-Parserprüfungen bestanden.
|
||||
Ausgeführt: `python3 deploy/windows/tls_acceptance.py --execute-native-tls-negative
|
||||
--artifact devstate/windows-client/WindowsTlsProbe.exe --resume-case
|
||||
7b190a5c-c928-4348-bd0d-c9698dad5417`.
|
||||
|
||||
## Native HTTPS-Abnahme zusätzlich bestanden — 2026-11-13
|
||||
|
||||
Der bestehende LocalService-Agent wurde im festen Fall
|
||||
`3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458` administrativ und versioniert von WSS auf
|
||||
explizites HTTPS umgestellt. Keine neue Identität, kein Enrollment, kein RMM-Job.
|
||||
Tatsächlicher serverseitiger Transport `https`, zwei frische Heartbeats um
|
||||
22:21:14.183598 und22:21:45.234313 UTC. Der native Readonly-Journalbeleg bestätigt
|
||||
Integrität, gleiche Identität, monotone Sequenz935→941 und0 ausstehende
|
||||
Inventarereignisse nach konkretem ACK. Tatsächlicher Prozessowner `S-1-5-19`
|
||||
(LocalService); unverändertes qualifiziertes Programm, CA, Zertifikat, privater
|
||||
Geräteschlüssel und deren ACLs. Private Schlüssel blieben auf der VM.
|
||||
|
||||
Anschließend exakt ursprüngliche WSS-Konfigurationsbytes und ACLs wiederhergestellt,
|
||||
zweimal frischer WSS-Kontakt sowie abgeschlossener Inventar-ACK nachgewiesen.
|
||||
Beide fremden Tenantzugriffe verweigert; vorher/nachher0Jobs/0Outbox/0Grants/
|
||||
0offene Versuche. `result.json` ist verifiziert. Geschützte Belege:
|
||||
`devstate/windows-client/transport/3c60e1a8-7ab7-4720-8b1a-f89f4f0d7458/`.
|
||||
|
||||
Ausgeführt: `python3 deploy/windows/transport_acceptance.py start`.
|
||||
Der Runner verwendet einen per Hash und SFTP gepinnten Bootstrap-PowerShellcode;
|
||||
prozessbezogenes RemoteSigned ändert keine Maschinen-/Gruppenrichtlinie und
|
||||
keine RMM-Jobausführung. Sieben gezielte lokale Runner-Guards und drei
|
||||
PowerShell-Parserprüfungen bestanden; kein neuer Clientbuild für diese Abnahme.
|
||||
TLS-Negativfälle und automatischer Fallback sind oben separat nativ abgenommen.
|
||||
PowerShell-Jobs bleiben bis zu [ihren Voraussetzungen](../../docs/windows-job-boundary.md)
|
||||
gesperrt. Die folgenden Erstnachweise bleiben historisch erhalten.
|
||||
|
||||
## Tatsächlich nachgewiesen
|
||||
|
||||
`rmm-agent-windows` als eigene Plattform-Crate mit gemeinsamen Domain-/Protobuf-
|
||||
Verträgen und direkt wiederverwendeten WSS-/HTTPS-/TLS-Modulen des Linux-Agenten.
|
||||
Isolierter Docker-Crossbuild mit Rust 1.99.1 für `x86_64-pc-windows-gnu`:
|
||||
Debug und Release erfolgreich; Windows-target Clippy über alle Targets mit
|
||||
`-D warnings` erfolgreich. Zwei gezielte Domain-Tests prüfen die unveränderte
|
||||
Linux-Validierung, Windows ohne erfundene Inodes und abgewiesene Plattformmischung.
|
||||
Das sind ergänzende lokale Prüfungen, keine nativen Windows-Dienstnachweise.
|
||||
|
||||
Releaseartefakt SHA256
|
||||
`31e360e50b177b4d5729d24e436d4f25aeed7b1a7bd35f2a129841ba1abffd37`
|
||||
auf der tatsächlichen Windows-11-Pro-VM (Version 10.0.26300, x64) gestartet:
|
||||
`--native-probe` erfolgreich. Hostname und Systemvolume tatsächlich über Win32
|
||||
lesbar; Bootkennung aus `Win32_OperatingSystem.LastBootUpTime` abgeleitet statt
|
||||
bei jedem Agentstart neu erzeugt. Inodes ausdrücklich `null`/nicht anwendbar.
|
||||
Keine Schlüssel oder realen Hostnamen in der veröffentlichten Probeausgabe.
|
||||
|
||||
Binärtransfer über bestehendes, hostkeygeprüftes SFTP mit SHA256-Nachprüfung.
|
||||
Große PowerShell-Console-JSON-Eingaben waren als Bootstraptransport ungeeignet
|
||||
(Timeout/Console-Reader-Ausnahme); deshalb nur kleine zeilenbegrenzte Metadaten
|
||||
über stdin. SSH-/Hostkeyprüfung und Reverse-Portgrenzen bleiben unverändert.
|
||||
Artefaktverzeichnisse werden nach Hash neu angelegt, keine vorhandene Identität
|
||||
oder Historie gelöscht. Private Evidenz: `devstate/windows-client/`.
|
||||
|
||||
## Nativer Dienst, Inventar und verbleibender Umfang
|
||||
|
||||
- Nativer SCM-Dienstlebenszyklus als `LocalService` mit eigenem
|
||||
Service-SID-Zugriff auf Zustand und ausschließlich lesbarem Programm/Config.
|
||||
- Windows prüft Owner/DACL und verweigert Reparse-Points/breite ACLs. Geräteschlüssel
|
||||
werden nur auf Windows erzeugt; Enrollment über CA- und namensgeprüftes TLS,
|
||||
danach mTLS. Ein verlorener Enrollmentnachweis löst keinen Identitätsreset aus.
|
||||
- SQLite mit FULL-Synchronisierung, Prozesssperre, monotoner persistenter Sequenz,
|
||||
konkretem ACK und begrenzter Telemetriequeue. Kein Löschen für Platzgewinn.
|
||||
- Separate `windows.base`-Beobachtungen mit Erhebungszeit/Quelle/Qualität; Server
|
||||
bindet den Scope an die authentisierte Verbindung und deren Capability.
|
||||
Geräte-API zeigt die gespeicherte Quelle statt eines festen Linuxlabels.
|
||||
- Ausschließlich `windows.base/1` und `heartbeat/1` werden angeboten.
|
||||
**Kein Jobexecutor, keine PowerShell-Jobfähigkeit, kein privilegierter Helper.**
|
||||
Angebote/Startgrants werden verweigert. Es gibt keine Genehmigungsabkürzung.
|
||||
|
||||
Tatsächlich installiert und gestartet: nativer SCM-Dienst mit eigenem Service-SID
|
||||
unter `NT AUTHORITY\LocalService`; tatsächlicher Prozessowner `S-1-5-19`, nicht
|
||||
Administrator/SYSTEM. Eigener Geräteschlüssel auf Windows erzeugt, einmaliges
|
||||
Enrollment erfolgreich und Tokenkopie entfernt; mTLS-Hello und frischer Heartbeat
|
||||
serverseitig bestätigt. Der erste `.ps1`-Aufruf wurde durch die lokale
|
||||
Ausführungsrichtlinie vor jeder Installerwirkung verweigert. Verzeichnis, Dienst
|
||||
und Identität waren nachweislich nicht angelegt; erst danach kontrollierte
|
||||
Fortsetzung mit explizit **prozessbezogenem** `RemoteSigned` wie beim ursprünglichen
|
||||
Bootstrap. Keine Änderung der Maschinen-/Gruppenrichtlinie, keine Jobausnahme.
|
||||
|
||||
Native Rust-Testprogramme direkt über den gepinnten SSH-Zugang ausgeführt:
|
||||
**3 Transporttests + 3 Bibliothekstests + 1 ACL-Integrationstest bestanden**. Diese prüfen Namens-/URL-
|
||||
Validierung und sichere Fallbackauswahl, echte Windows-Inventardaten, zwei
|
||||
unabhängige stabile Bootabfragen sowie SQLite-Reopen, monotone Sequenz,
|
||||
Prozesssperre, gezielten ACK und Identitätsbindung. Der zusätzliche native ACL-Test
|
||||
weist korrekte ACLs nach und verweigert breite ACLs, NULL-DACLs, falschen Pfadtyp
|
||||
und Reparse-Points an ausschließlich neu erzeugten nichtgeheimen Tempfixtures. PowerShell-Pipelinewrapper
|
||||
warteten bei nativen Testprogrammen; direkte native Ausführung lieferte Exit 0.
|
||||
|
||||
Der tatsächliche Online-Lauf fand eine weitere echte Grenze: Migration 0001
|
||||
beschränkte `observations.source_id` auf `linux.base`. Daher bisher Heartbeats,
|
||||
aber kein gespeichertes Windowsinventar. Additive Migration 0013 erweitert nur
|
||||
diesen CHECK auf die beiden validierten Basisscopes. Echter isolierter PostgreSQL-
|
||||
Test der Migrationen 1–13 bestanden: alte Linuxzeile bytegleich, Windows erlaubt,
|
||||
beliebiger Scope verweigert, RLS bei fremdem/fehlendem Kontext und zusammengesetzter
|
||||
Geräte-FK erhalten, keine Jobs/Outbox/Grants. Cloudmigration 0013 anschließend tatsächlich erfolgreich. Der ursprüngliche
|
||||
Windows-Journaleintrag wurde ohne Neuerhebung/Identitätsreset erneut zugestellt
|
||||
und gespeichert: ursprüngliches `observed_at` bleibt erhalten, `received_at` ist
|
||||
separat. Geräte-API/MCP melden `source_id=windows.base`, korrektes Windowsinventar
|
||||
und Inodes `null`; zwei verschiedene frische Heartbeats und `online` belegt.
|
||||
Mandant B wurde sowohl für den A-Kontext als auch für seine eigene Mandantensicht
|
||||
mit der fremden Asset-ID abgewiesen. Gerätespezifisch **0 Jobs / 0 Outbox /
|
||||
0 Startgrants / 0 offene Versuche**. Keine WebUI-Genehmigung ausgeführt, weil diese
|
||||
Strecke ausschließlich passive Standardbeobachtungen verarbeitet.
|
||||
|
||||
Dieser erste Entwicklungsbuild ist **unsigniert**. Kein produktiver signierter
|
||||
Installer/MSVC-Supportnachweis, keine Zertifikatsrotations-/Widerrufs-/Proxy- oder
|
||||
Windows-Paket-/Dienstaktionsabnahme. Der erste native Onlinenachweis verwendete WSS. Explizites HTTPS und automatischer Fallback sind inzwischen oben separat nativ
|
||||
abgenommen. Die passive SCM-/Enrollment-/mTLS-/Inventar-/Mandantentrennungsstrecke sowie
|
||||
die oben benannten nativen Tests sind nun tatsächlich getrennt belegt.
|
||||
Dies ist keine vollständige Windows-/Linux-MVP-Abnahme.
|
||||
|
||||
## Ausgeführte und geplante Befehle
|
||||
|
||||
Tatsächlich ausgeführt: Docker-Build und gezielte Rust-Prüfungen oben sowie
|
||||
`python3 deploy/windows/client_bootstrap.py upload-agent --artifact <Release-EXE>`
|
||||
und `python3 deploy/windows/client_bootstrap.py probe` gegen ausschließlich den
|
||||
Windows-Gast. Keine RMM-Jobs oder Genehmigungen wurden dabei erzeugt.
|
||||
|
||||
Zusätzlich tatsächlich ausgeführt: native `test-lib`/`test-bin`/`test-acl`, Installer nach
|
||||
nachgewiesenem Nichtstart mit `install-after-nonstart` und die oben benannte
|
||||
PostgreSQL-Migrationsprüfung sowie `passive-acceptance` gegen den Cloudserver
|
||||
mit gespeichertem Inventar, zwei Heartbeats, Tenant-B-Verweigerung und Null-Jobgate.
|
||||
Installation ist create-only; bei Teilfehlern Zustand inspizieren und erhalten,
|
||||
nicht blind neu enrollen oder den Bootstrap wiederholen.
|
||||
|
||||
Native ergänzende Receiptprüfung: das separate Entwicklungstool
|
||||
`examples/passive_state.rs` öffnete ausschließlich die vorhandene Windows-SQLite
|
||||
im Read-only-Modus. Integrität `ok`, feste Geräteidentität identisch, Sequenz 59,
|
||||
**0 ausstehende Inventarereignisse**: der konkrete Server-ACK wurde lokal verbucht.
|
||||
Keine neue Erhebung, kein Journalreset und kein neues Enrollment für diesen Nachweis.
|
||||
|
||||
Bekannte Darstellungsgrenze des ersten Collectors: `os` enthält den tatsächlich
|
||||
ausgelesenen Registry-Produktnamen samt DisplayVersion/Build. Auf dieser Windows-
|
||||
11-Pro-VM lautet der historische Registrywert noch `Windows 10 Pro`, mit
|
||||
`DisplayVersion=26H2; Build=26300`. Die unabhängige native CIM-Probe bestätigt
|
||||
Windows 11 Pro. Der Registrywert wird nicht stillschweigend als Marketingversion
|
||||
uminterpretiert; eine einheitliche, quellenbewusste OS-Bezeichnung ist noch offen.
|
||||
Die aktuelle Capability bleibt deshalb ausdrücklich partielles Basisinventar.
|
||||
+22
-128
@@ -1,144 +1,38 @@
|
||||
# Windows-11-Entwicklungszugang
|
||||
# Windows-Agent betreiben
|
||||
|
||||
**Historischer Erstbootstrap und Einrichtungsnachweise. Nicht erneut ausführen.**
|
||||
Aktueller Einstieg für vorhandene Zugänge am 17. November 2026:
|
||||
[Zugangsanleitung](../../docs/operations-access.md) und
|
||||
[Übergabe](../../docs/handover.md).
|
||||
Die Aussagen „noch kein Client“, frühere24-Stunden-Fristen und alte
|
||||
Download-/Repairabläufe unten gelten nur für ihren jeweiligen historischen Stand.
|
||||
Der permanente Entwicklungstransport ist eingerichtet, heute aber ohne aktiven
|
||||
Server-Reverselistener; vorhandene Schlüssel/Identität erhalten.
|
||||
Der offizielle Windows-x64-Kanal verwendet das GNU-Ziel `x86_64-pc-windows-gnu`. Der Dienst `RmmDiscoveryWindows` läuft als LocalService. Er meldet sich ausgehend per mTLS, liefert Inventar und führt genehmigte PowerShell-Skripte aus. Für Aufträge als SYSTEM verwendet er den pro Installation eingerichteten `RmmDiscoverySystemHelper`.
|
||||
|
||||
## Installation
|
||||
|
||||
Userentscheidung 2026-11-13 / Spezifikation 1.8: Windows darf parallel zur noch
|
||||
offenen Linux-MVP-Abnahme entwickelt werden. Notebook-Host bleibt ohne Agent.
|
||||
Dieser Bootstrap schafft SSH-Zugang zum Windows-Gast, keine RMM-Installation
|
||||
und keine Ausnahme von der späteren WebUI-Jobgenehmigung.
|
||||
1. In der WebUI den Kunden wählen und unter **Gerät aufnehmen** einen Einmalcode erzeugen. Auf der Windows-Maschine die 64-Bit-Windows-PowerShell 5.1 als Administrator öffnen.
|
||||
2. Den angezeigten Windows-Befehlsblock für das GNU-Paket ausführen. Er lädt `/install/windows.ps1` per HTTPS und übergibt den Bootstrap-Ursprung. Den Code auf die Frage „One-time enrollment token“ eingeben.
|
||||
3. Für administrative Skripte die Administratoroption im Aufnahmeformular wählen. Der zusätzliche Schalter `-EnableAdministratorScripts` richtet den SYSTEM-Helper mit Gerätebindung, lokalem Journal und signiertem Agent-/Helperpaar ein. Auf einem bereits aufgenommenen Gerät lässt sich derselbe Installer mit dem bisherigen Ursprung und diesem Schalter ausführen.
|
||||
4. Im Gerätedetail den frischen Kontakt und die Agentversion prüfen. Für SYSTEM-Aufträge müssen der SYSTEM-Kontext gemeldet und die zentrale Geräteregel eingerichtet sein. Für MCP kommt das plattformspezifische Tokenrecht hinzu. [Installer](../../crates/server/src/bootstrap/install.ps1) · [MCP-Zugang](../../docs/public-access.md)
|
||||
|
||||
## Vorbereitet und tatsächlich geprüft
|
||||
## Dienste und Selbstupdate
|
||||
|
||||
`python3 deploy/windows/prepare_dev_access.py` hat auf dem endgültigen Server
|
||||
das separate Systemkonto `rmm-win-tunnel` und dessen SSH-Matchprofil angelegt.
|
||||
`sshd -t` und effektive Benutzerkonfiguration bestanden; Root-SSH-Konfiguration
|
||||
vor/nach identisch. Nur Remote-TCP-Forwarding auf `127.0.0.1:22240`, keine
|
||||
Shell/SFTP/Sitzungen (`MaxSessions 0`), keine Local-/Streamlocal-/Agentforwards,
|
||||
keine Passwortanmeldung. Noch kein Windows-Key hinterlegt, kein Windows-
|
||||
Tunnel/Administrationszugang nachgewiesen. Keine neue öffentliche Portfreigabe.
|
||||
`RmmDiscoveryReleasePull` prüft nach erfolgreichem Lauf regulär nach fünf Minuten erneut auf einen veröffentlichten Release. Er verifiziert Signatur, Plattform und Paketinhalt und stimmt den Wechsel mit laufenden Aufträgen ab. Ein neuer Release muss sich unter derselben Geräteidentität zurückmelden. Scheitert die Aktivierung, wählt der Updater den Vorgänger. Programmdateien liegen unter `%ProgramFiles%\RustDiscovery`. Konfiguration, Identität und Journale liegen unter `%ProgramData%\RustDiscovery`. [Nativer Release-Abruf](../../crates/agent-windows/src/release_service.rs) · [HTTPS-Aufnahme und Selbstupdate](../../docs/evidence/windows-gnu-official-vm-20261118.json)
|
||||
|
||||
Public-only Paket lokal unter `devstate/windows-bootstrap/windows-dev-access.zip`:
|
||||
dieses Skript und `bootstrap-public.json` mit Notebook-Public-Key, bereits
|
||||
unabhängig geprüftem Server-ED25519-Hostkey und 24-Stunden-Frist. Kein privater
|
||||
Schlüssel und kein Cloud-Rootzugang werden verteilt. Der neue Tunnelschlüssel
|
||||
wird ausschließlich auf der Windows-VM erzeugt und verlässt sie nicht.
|
||||
|
||||
PowerShell-Parserprüfung mit offiziellem PowerShell 7.7.0 auf dem Notebook:
|
||||
bestanden. **Kein nativer Windows-Ausführungs-/OpenSSH-/ACL-/Tasknachweis.**
|
||||
Das Skript verwendet PowerShell-5.1-Syntax; die Ausführung auf Windows 11 muss
|
||||
noch durch den User erfolgen. Vorhandene laufende SSH-Installation, gleichnamiger
|
||||
Account/Task oder Teilbootstrap werden verweigert statt überschrieben.
|
||||
|
||||
## In der Windows-Test-VM ausführen (geplant, noch nicht nachgewiesen)
|
||||
|
||||
Paket auf die VM kopieren und entpacken. Erhöhte **64-Bit-PowerShell** im
|
||||
entpackten Verzeichnis öffnen, Skript prüfen und dann:
|
||||
Diese Befehle zeigen in einer administrativen PowerShell die beiden Standarddienste und den letzten Updaterstatus.
|
||||
|
||||
```powershell
|
||||
Unblock-File -LiteralPath .\Bootstrap-DevAccess.ps1
|
||||
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\Bootstrap-DevAccess.ps1
|
||||
Get-Service -Name RmmDiscoveryWindows,RmmDiscoveryReleasePull
|
||||
Get-Content -Raw (Join-Path $env:ProgramData 'RustDiscovery\release-state\release-status.json')
|
||||
```
|
||||
|
||||
`RemoteSigned` gilt ausschließlich für den gestarteten Prozess; keine Änderung
|
||||
der systemweiten Ausführungsrichtlinie und kein Umgehen einer Gruppenrichtlinie.
|
||||
Es installiert nötigenfalls ausschließlich die optionalen OpenSSH-Funktionen.
|
||||
`RestartNeeded` stoppt die Vorbereitung; kein automatischer Neustart/OS-Update.
|
||||
Bei eingerichtetem SYSTEM-Kontext zusätzlich `Get-Service -Name RmmDiscoverySystemHelper` prüfen. In der WebUI lassen sich für den konkreten Auftrag der gebundene Skripttext, der Exitcode und die Ausgabe nachlesen. Bei Windows-Updates „Windows-Updates installieren“ als SYSTEM planen. Die PowerShell-Vorlage meldet die Ergebnisse der Installation und den Neustartbedarf. [Abnahme einer echten Updateinstallation](../../docs/evidence/windows-update-installation-20261117.json)
|
||||
|
||||
Es erstellt den bis zur Paketfrist gültigen lokalen Administrator `rmm-dev`
|
||||
mit zufälligem, ausschließlich VM-internem Passwort und Public-Key-only-SSH.
|
||||
Authorized-Keys und Bootstrapstate sind nur für SYSTEM/Administratoren zugänglich
|
||||
(SIDs statt sprachabhängiger Namen). Windows-SSH lauscht ausschließlich auf
|
||||
`127.0.0.1:22222`; Standard-OpenSSH-Firewallregel wird deaktiviert. Konfigurations-
|
||||
und Keydateien einer vorhandenen gestoppten Installation werden gesichert.
|
||||
## Neustart und Wiederanmeldung prüfen
|
||||
|
||||
Ein SYSTEM-Task verbindet ausgehend zum bekannten Server und prüft dessen
|
||||
Hostkey strikt. Reverse-Listener dort nur Loopback. Wiederverbindung alle 30s
|
||||
ist ausschließlich Bootstraptransport, kein RMM-Job-Retry. Task beendet seinen
|
||||
eigenen SSH-Prozess nach Frist; kein Reboot. Bestehende RMM-Policies bleiben.
|
||||
|
||||
Das Skript druckt ausschließlich öffentliche Registrierungsdaten:
|
||||
`windows_user`, `tunnel_public_key`, `windows_host_public_key`, `expires_at`,
|
||||
`windows_architecture` sowie Hostkeyfingerprint. Diese Ausgabe von der tatsächlichen
|
||||
VM-Konsole zurückgeben; keine privaten Schlüssel/Passwörter übertragen.
|
||||
Nach Hinterlegung des Tunnel-Public-Keys und Prüfung/Pinnen des Windows-Hostkeys
|
||||
kann der Entwicklungsrechner über den Cloudserver mit seinem vorhandenen Key
|
||||
auf den Windows-Administrator zugreifen. Native Nachweise folgen erst dann.
|
||||
|
||||
Grundlagen: [Microsoft OpenSSH-Installation](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse),
|
||||
[Windows-Konfiguration und Administrator-Key-ACL](https://learn.microsoft.com/en-us/windows-server/administration/openssh/openssh-server-configuration).
|
||||
|
||||
## Öffentlicher Download auf dem Cloudserver — tatsächlich geprüft
|
||||
|
||||
Auf Userwunsch Public-only Paket separat auf HTTPS **8443**, ausschließlich ein
|
||||
exakter Downloadpfad bis Paketablauf. Gültige öffentliche Let's-Encrypt-Kette
|
||||
mit normalem externem Truststore geprüft; heruntergeladene Bytes SHA256-identisch.
|
||||
RMM-TLS/mTLS auf 443, Verwaltungszugang und Client-Truststores unverändert.
|
||||
Keine Secrets im Bundle. Link und Belege geschützt unter
|
||||
`devstate/windows-bootstrap/{publication.json,published-verified.json}`.
|
||||
|
||||
`deploy/windows/publish_bootstrap.py`: ACME mit gepinntem, geprüftem
|
||||
acme-tiny-Commit `dc2c102314a56580facafce2249b292cebcfc42b`; Account-/Domainkeys
|
||||
bleiben auf dem Server in rootgeschütztem Verzeichnis. HTTP80 nur für ACME,
|
||||
danach tatsächlich gestoppt und Firewallregel entfernt. Downloadserver mit
|
||||
DynamicUser, readonly System, separaten systemd-Credentials für TLS-Key und
|
||||
maximal 16 gleichzeitigen Verbindungen. Kein beliebiges Dateisystemhosting.
|
||||
|
||||
Ein späterer Verbindungsversuch traf zunächst auf eine blockierende TLS-Annahme.
|
||||
Server korrigiert: Timeout/Handshake je begrenztem Worker, Listener blockiert
|
||||
nicht mehr. Danach externer HTTPS-Download während gleichzeitig offener langsamer
|
||||
TCP-Verbindung erfolgreich; `/`, `/etc/passwd`, `/auth/config` und codierter
|
||||
Traversalpfad jeweils 404. Drei lokale Pfad-/Frist-/ACME-Guards bestanden.
|
||||
|
||||
Öffentliche Freigabe endet **2026-11-14 12:55:31 UTC**. Aktiver persistenter
|
||||
systemd-Timer stoppt den eigenen Downloadservice und schließt dessen Firewallport
|
||||
8443; auch die Anwendung verweigert nach Frist weitere Downloads. Dies ist
|
||||
Bootstrapwartung auf dem Server, kein autorisierender RMM-Job oder VM-Reboot.
|
||||
Windows-Ausführung weiterhin nicht nachgewiesen.
|
||||
|
||||
## Tatsächlich hergestellter Zugang / Reparaturen
|
||||
|
||||
Der User führte das erste Paket auf Windows aus. Dienst zunächst Exit 1067,
|
||||
Vordergrundstart dagegen erfolgreich. `Repair-DevAccess.ps1` prüft die bestehenden
|
||||
Skripte/Config gegen die ursprünglichen Hashes, sichert ACLs, setzt SYSTEM als
|
||||
Eigentümer und SYSTEM/Administratoren als einzige Zugriffsberechtigte für
|
||||
SSH-Verzeichnis, Config und Hostprivatekeys. Keine Schlüssel-/Kontoneuerzeugung.
|
||||
Danach Dienst tatsächlich `Running`, Hostkey unverändert. Erstbootstrap-Quelle
|
||||
für neue Pakete entsprechend korrigiert; historisches Public-ZIP unverändert,
|
||||
separates Repair-ZIP mit eigener expliziter Downloadroute veröffentlicht.
|
||||
|
||||
Cloud-Public-Key registriert; anfänglich ungültige Option `permitopen="none"`
|
||||
aus `authorized_keys` entfernt. Sie ist ausschließlich im sshd-Matchprofil gültig
|
||||
und dort unverändert aktiv. Zusätzlich öffentliche `.ssh`-Directorymodi explizit
|
||||
gesetzt, statt sie einer umask zu überlassen. Remote-only/PermitListen/MaxSessions
|
||||
bleiben erhalten. Private Keys wurden nicht übertragen.
|
||||
|
||||
Windows-Tunnel anschließend automatisch durch den Hintergrundtask aufgebaut.
|
||||
Notebook-SSH über Cloud-Loopback mit unabhängig aus der VM-Konsole bestätigtem
|
||||
Hostkey und vorhandenem Notebook-Key erfolgreich. Echt beobachtet: **Windows 11
|
||||
Pro, Build 26300, 64 Bit, Administrator=true**. Zugangsdaten nur unter
|
||||
`credentials/windows-dev-access.json`, Belege unter `devstate/windows-bootstrap/`.
|
||||
**Noch kein RMM-Windows-Client installiert/enrolled/abgenommen.** Keine Änderung
|
||||
am Notebook-Host als reinem Entwicklungsrechner.
|
||||
|
||||
## Zugang bei Bedarf stoppen
|
||||
|
||||
Auf der Windows-VM als Administrator, ausschließlich eigene Bootstrapressourcen:
|
||||
Die Bibliotheksrevision „Windows neu starten“ Version 2 verwendet das systemeigene `shutdown.exe` mit einer Minute Vorlauf. Die folgende Abfrage vor und nach dem Neustart ausführen und den Startzeitpunkt des jüngsten Kernel-General-Ereignisses 12 vergleichen.
|
||||
|
||||
```powershell
|
||||
Stop-ScheduledTask -TaskName RmmDevReverseTunnel
|
||||
Unregister-ScheduledTask -TaskName RmmDevReverseTunnel -Confirm:$false
|
||||
Disable-LocalUser -Name rmm-dev
|
||||
Stop-Service -Name sshd
|
||||
$event = Get-WinEvent -FilterHashtable @{LogName='System'; ProviderName='Microsoft-Windows-Kernel-General'; Id=12} -MaxEvents 1
|
||||
(([xml]$event.ToXml()).Event.EventData.Data | Where-Object Name -eq 'StartTime').InnerText
|
||||
```
|
||||
|
||||
Backups/Hostkeys und Zustandsdateien erhalten. Cloud-Tunnelkey separat sperren;
|
||||
keine pauschale Änderung anderer SSH-Zugänge. Vollständige Entfernung einer
|
||||
vorherigen SSH-Konfiguration ist ein eigener kontrollierter Vorgang.
|
||||
Nach dem Bootwechsel den authentisierten Kontakt derselben Installation und einen Folgeauftrag mit Ergebnis prüfen. Bei einem Gatewaywechsel kann sich der Agent vorübergehend bereits melden, während er den signierten Zeit- und Journalabgleich für ausführbare Aufträge erneuert. Bei dauerhaft ausstehendem Abgleich den letzten authentisierten Kontakt, die Windows-Zeitsynchronisation (`w32tm /query /status`) und die Bereitschaft von Agent und optionalem Helper prüfen. Nach einer bestätigten Ergebnismeldung kann der Helper seinen Abgleich wieder aufnehmen. [Zeitabgleich](../../docs/evidence/windows-gateway-clock-recovery-20261117.json) · [Helper-Abgleich](../../docs/evidence/windows-helper-result-recovery-20261118.json) · [Native MCP-Abnahme](../../docs/evidence/mcp-scoped-script-requests-20261118.json)
|
||||
|
||||
Für Störungen zwischen Agent und SYSTEM-Helper beschreibt die [Pipe-Dokumentation](../../docs/windows-helper-pipe-drain.md) die lokale Transportbestätigung. Für den Entwicklungsgast ohne dauerhaften Helper enthält das [Runbook für befristete Windows-Updatefenster](../../docs/windows-update-dev-window.md) die Voraussetzungen und den Rückbau.
|
||||
|
||||
Build, Veröffentlichung und Entwicklungsbereitstellung stehen im [Entwicklungsweg](../../docs/development.md).
|
||||
|
||||
@@ -1,238 +0,0 @@
|
||||
# Native Windows MSVC build
|
||||
|
||||
Prepared 2026-11-14. The native `Prepare` phase was attempted in the retained
|
||||
case `b208282f-d950-4f5a-bc5e-9e071ccb4d93` and stopped before any download or
|
||||
installer: `SETUP_PREEXISTING_REBOOT_PENDING`. Separate read-only inspection
|
||||
confirmed both the CBS `RebootPending` and Windows Update `RebootRequired` keys
|
||||
already existed; PendingFileRenameOperations had24 entries (contents not read
|
||||
into the report). No compiler installation, Windows update, restart, trust-store
|
||||
change, daemon replacement or RMM job was performed. Agent PID5140 and helper
|
||||
PID6240 remained running; W32Time remained stopped. This is an incomplete
|
||||
prerequisite, not a successful MSVC qualification. No flag is cleared or ignored.
|
||||
|
||||
`Build-NativeMsvc.ps1` is a development build runner, not an installer. Run it in
|
||||
64-bit Windows PowerShell5.1 from a source bundle containing the exact repository
|
||||
sources and this script. `Preflight` inventories installed tools and records
|
||||
private source/tool hashes. `Build` requires an explicitly selected successful
|
||||
preflight receipt, creates a different private case, and builds an isolated
|
||||
source copy. It never reuses a partial build case.
|
||||
|
||||
## Required native tools
|
||||
|
||||
- Rust `1.99.1-x86_64-pc-windows-msvc`, including `cargo`, `rustc`, `rustdoc`,
|
||||
`clippy-driver`, `rustfmt`, supplied by the official rustup installation.
|
||||
- Installed Visual Studio C++ tools in the selected range `[17.14,19.0)`;
|
||||
VS2022 or VS2026 is selected by its signed `vswhere.exe`. The actual product,
|
||||
compiler version, signer thumbprints and tool hashes are recorded. The current
|
||||
official [VS release history](https://learn.microsoft.com/en-us/visualstudio/releases/2026/release-history)
|
||||
includes VS2026; the runner does not download a mutable latest bootstrapper.
|
||||
- The x64 `cl.exe`, `link.exe`, `lib.exe`, `dumpbin.exe`, and Windows SDK
|
||||
`10.0.26100.0` x64 `midl.exe`. Microsoft signatures must be valid. The selected
|
||||
SDK is explicit through `vcvarsall.bat amd64 10.0.26100.0`; see Microsoft's
|
||||
[native build environment](https://learn.microsoft.com/en-us/cpp/build/building-on-the-command-line?view=msvc-170).
|
||||
- At least20GiB available on the evidence/build volume by default. This is the
|
||||
runner's conservative admission threshold, not a measured installation size.
|
||||
- The locked Cargo dependencies must already be available in the build user's
|
||||
registry cache. Builds are `--locked --offline`. A missing crate is a failed
|
||||
prerequisite, never a reason for an automatic online retry. An explicit
|
||||
development preparation can populate the public dependencies with
|
||||
`cargo +1.99.1-x86_64-pc-windows-msvc fetch --locked --target x86_64-pc-windows-msvc`.
|
||||
Do not transfer an entire Cargo home containing credentials or configuration.
|
||||
|
||||
The parent's actual read-only VM report
|
||||
`devstate/windows-client/native-msvc-tools-readonly-20261114.json` now records
|
||||
103300169728 free bytes, x64, no `vswhere`, no `rustup`, no SDK directories,
|
||||
W32Time stopped and all execution-policy scopes undefined. No installation was
|
||||
performed by this preparation. No extra private key, server token or production
|
||||
signing certificate is needed for source build.
|
||||
[Rust's MSVC target contract](https://doc.rust-lang.org/rustc/platform-support/windows-msvc.html)
|
||||
defines native Windows support, Microsoft calling conventions and PE/COFF output.
|
||||
|
||||
## Explicit tool-setup plan, not executed
|
||||
|
||||
If preflight reports missing C++ tools, first select a **fixed-version** Build
|
||||
Tools bootstrapper from Microsoft's release history, retain its download URL,
|
||||
SHA-256, ProductVersion, valid Microsoft Authenticode signature and thumbprint.
|
||||
Verify the intended absent/new install directory and sufficient disk before
|
||||
starting setup. Reuse a suitable existing installation rather than updating it.
|
||||
The exact required component IDs are:
|
||||
|
||||
```text
|
||||
Microsoft.VisualStudio.Workload.VCTools
|
||||
Microsoft.VisualStudio.Component.VC.Tools.x86.x64
|
||||
Microsoft.VisualStudio.Component.Windows11SDK.26100
|
||||
```
|
||||
|
||||
The planned bootstrapper arguments are:
|
||||
|
||||
```text
|
||||
--wait --passive --norestart --installPath C:\RmmBuildTools
|
||||
--add Microsoft.VisualStudio.Workload.VCTools
|
||||
--add Microsoft.VisualStudio.Component.VC.Tools.x86.x64
|
||||
--add Microsoft.VisualStudio.Component.Windows11SDK.26100
|
||||
```
|
||||
|
||||
There is no `--force`, repair, OS update, automatic retry or reboot. Persist the
|
||||
actual setup process/result before returning a bootstrap reply. `0` completes
|
||||
the setup operation; `3010` means installation requires a restart **before use**,
|
||||
so stop without building, clearing the flag or implicitly rebooting. `1641`
|
||||
means a reboot was initiated and violates this no-restart plan. `1618`/`1001`
|
||||
mean another installation is active; preserve the case and inspect, never kill
|
||||
the other installer or blindly rerun. A lost SSH reply permits only process/log
|
||||
readback of that same setup. The build runner itself never launches setup.
|
||||
[Microsoft component IDs](https://learn.microsoft.com/en-us/visualstudio/install/workload-component-id-vs-build-tools?view=visualstudio),
|
||||
[parameters and actual exit-code semantics](https://learn.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio?view=vs-2022).
|
||||
|
||||
## Build invocation and evidence
|
||||
|
||||
Planned, not executed:
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Build-NativeMsvc.ps1 -Mode Preflight -SourceRoot C:\Source\rust-discovery
|
||||
# Review that exact private preflight.json, then use a NEW build case:
|
||||
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Build-NativeMsvc.ps1 -Mode Build -SourceRoot C:\Source\rust-discovery `
|
||||
-ExpectedPreflight C:\Users\Administrator\RmmNativeBuilds\<preflight-id>\preflight.json
|
||||
```
|
||||
|
||||
The runner imports only selected developer environment values, rejects caller
|
||||
compiler flags/wrappers, pins the native compiler/linker/MIDL paths, and keeps
|
||||
each process's stdout/stderr private. It copies only explicit source extensions
|
||||
under `crates/` and `proto/`, root Cargo/toolchain files and the MSVC runner/probe;
|
||||
no `credentials/`, `devstate/`, client key material, repository metadata or local
|
||||
server state. A protected build root and new protected case prevent unrelated
|
||||
service users from changing the copied inputs. Source/tool hashes must match
|
||||
before and after the build.
|
||||
|
||||
Before Cargo, Microsoft MIDL generates the real IDL with `/env amd64 /Oicf
|
||||
/robust /Zp8`; `win64` is intentionally avoided because MIDL documents it as
|
||||
IA64. The native C probe asserts Microsoft LLP64, numeric Rust ABI64 bytes,
|
||||
wire-status ABI120 bytes and explicit field offsets. It raises/catches only a
|
||||
local RPC exception1722 using the same SDK SEH macros/filter; it does not query
|
||||
W32Time, contact RPC or claim trusted time. There is no vendored WIDL stub or
|
||||
SEH workaround. [MIDL AMD64/packing](https://learn.microsoft.com/en-us/windows/win32/midl/-env),
|
||||
[robust NDR checking](https://learn.microsoft.com/en-us/windows/win32/midl/-robust),
|
||||
[C11 assertions](https://learn.microsoft.com/en-us/cpp/c-language/static-assert-c?view=msvc-170),
|
||||
[SDK RPC SEH](https://learn.microsoft.com/en-us/windows/win32/rpc/rpctryexcept).
|
||||
|
||||
The product build script adds only the native MSVC branch, preserving the GNU
|
||||
WIDL/clang branch and the C exception boundary. Both still compile the actual
|
||||
clock sources and preserve their static assertions; SDK or compiler failure is
|
||||
fatal. The Clock readiness gate stays unqualified. The separate native
|
||||
service-SID authentication candidate is not qualified by an ABI or build pass.
|
||||
|
||||
Cargo then checks Windows Clippy with warnings denied, builds agent/helper and
|
||||
examples in release, and **links without running** Windows/core unit tests.
|
||||
The runner records AMD64 PE headers, artifact hashes, generated RPC hashes,
|
||||
dependency listings and actual Authenticode status. Development output may be
|
||||
unsigned; this is no signing/installer/production-PKI acceptance. Native unit
|
||||
execution, LocalService/SYSTEM behavior and a preserving daemon deployment
|
||||
remain separate explicit gates. A timeout retains its exact process/evidence;
|
||||
no process-tree kill or retry is implied.
|
||||
|
||||
Locally executed preparation checks: PowerShell AST parse; isolated compilation
|
||||
and Clippy of `build.rs` using locked-version `cc1.11.1`; rustfmt/source checks.
|
||||
These checks do not prove that Microsoft MIDL, MSVC, the ABI probe or the final
|
||||
agent/helper builds have run successfully on Windows.
|
||||
|
||||
## Concrete native tool bootstrap, prepared separately
|
||||
|
||||
`Install-NativeBuildTools.ps1` supplies separate `Prepare`, `InstallVs`,
|
||||
`InstallRust`, and read-only `Read` phases. Only `Prepare` has been attempted;
|
||||
the pre-existing reboot need blocked it before downloads. Neither install phase
|
||||
has run. Both install calls consume create-only start intents
|
||||
before launching their fixed worker. Each worker runs in its own protected,
|
||||
demand-only Task Scheduler entry as SYSTEM, without a trigger, automatic retry
|
||||
or autostart; a second worker entry refuses before installation. This keeps a
|
||||
long setup independent of the40s SSH/bootstrap reply limit. Results, actual
|
||||
installer PID and exit code are retained, and the task is disabled after its
|
||||
worker result. Lost reply/timeout permits readback only. These are explicitly
|
||||
authorized development-tool bootstrap tasks, never WebUI/RMM jobs or a generic
|
||||
SYSTEM execution provider. [Task registration](https://learn.microsoft.com/en-us/powershell/module/scheduledtasks/register-scheduledtask?view=windowsserver2025-ps),
|
||||
[fixed service-account principal](https://learn.microsoft.com/en-us/powershell/module/scheduledtasks/new-scheduledtaskprincipal?view=windowsserver2025-ps).
|
||||
|
||||
Inputs are fixed official TLS URLs with ordinary certificate/name validation:
|
||||
|
||||
| Input | Pinned SHA-256 |
|
||||
|---|---|
|
||||
| Microsoft Build Tools18.11.4 LTSC bootstrapper, file version18.11.12405.450 | `386b5d9a3d6576eab3772c1ecaa7c107ded38146a9c483f41679c194ae1e63b4` |
|
||||
| rustup1.29.3 Windows x64 MSVC bootstrapper | `38027d51d69a5d05493627a0634dbea52d6cd793c8f072d2373d3f4163eec7db` |
|
||||
| Rust1.99.1 official distribution manifest | `fb152be80975c194aa5fc684b2aec3a6e14e2b855efe2faa4e5f8ae6e590f463` |
|
||||
|
||||
The Microsoft EXE additionally requires valid Microsoft Authenticode and the
|
||||
exact product/file version. Rustup is checked against its exact
|
||||
[official archived checksum](https://static.rust-lang.org/rustup/archive/1.29.3/x86_64-pc-windows-msvc/rustup-init.exe.sha256),
|
||||
with [official archive/install options](https://rust-lang.github.io/rustup/installation/other.html).
|
||||
Its homes are private case subdirectories; `--no-modify-path`,
|
||||
`--no-update-default-toolchain`, minimal profile and exactly clippy/rustfmt keep
|
||||
the developer's default Rust installation/profile/PATH untouched. The fixed
|
||||
Rust distribution origin is set only for that worker process. Using isolated
|
||||
homes is an [official rustup option](https://rust-lang.github.io/rustup/installation/index.html).
|
||||
|
||||
VS setup uses only `--wait --quiet --norestart --noUpdateInstaller`, the new
|
||||
fixed target `C:\RmmBuildTools`, and the three components above. It relies on the
|
||||
official installer's standard Microsoft metadata/package verification. No
|
||||
custom channel/catalog, checksum override, certificate import or weaker
|
||||
verification flag is supplied. Installed VS version must then match exactly
|
||||
18.11.12405.450 and SDK26100 must be present; drift remains incomplete. Setup's
|
||||
required transitive development dependencies remain Microsoft's responsibility;
|
||||
this is no general production-installer trust acceptance. No Windows Update
|
||||
command is invoked. Boot/OS build, machine trust-store fingerprints, machine
|
||||
PATH, execution policies, W32Time and both exact RMM service states/PIDs are
|
||||
observed before/after. Detected changes, unexpected setup version,3010/1641 or
|
||||
restart need stop completion without resetting/undoing or retrying anything.
|
||||
|
||||
Scope decision2026-11-14: an initial **custom manual catalog-bundle** design was
|
||||
rejected. Its channel declared catalog size31851991 and hash
|
||||
`ef56e369d92855a9667cd03602019375f42b3cd2145041df31cacc071a40e1af`;
|
||||
the exact official URL instead returned18733589 bytes with hash
|
||||
`805d16fd14a370cbeb6568179950826ba0cdc6e2cffa44936fddc408ef05cba3`.
|
||||
Those inputs and rejected source remain privately retained; no mismatching
|
||||
catalog was accepted or installed. The extra manual bundle was our design,
|
||||
not an AGENTS/product requirement. The selected replacement uses the supported,
|
||||
independently hash/Authenticode-pinned official EXE and its own verification,
|
||||
not a checksum exception or undocumented JSON-signature workaround.
|
||||
Microsoft documents [standard acquisition and fixed-version bootstrappers](https://learn.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio?view=vs-2022).
|
||||
|
||||
Future successful-case sequence; installation and build remain **not executed**.
|
||||
The failed case above is retained and must not be reused after a prerequisite
|
||||
change. A manual VM restart has been requested for later coordination; it is
|
||||
neither implicitly authorized nor an RMM reboot acceptance.
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase Prepare
|
||||
# Review that exact printed private case and its prepared.json first:
|
||||
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase InstallVs -CaseDirectory <case>
|
||||
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase Read -CaseDirectory <case>
|
||||
# Continue only after verified VS exit0 and no restart need:
|
||||
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase InstallRust -CaseDirectory <same-case>
|
||||
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Install-NativeBuildTools.ps1 -Phase Read -CaseDirectory <same-case>
|
||||
```
|
||||
|
||||
This uses the already authorized **development/bootstrap-only** process option
|
||||
`-ExecutionPolicy RemoteSigned`, as in the previous Windows dev-access and
|
||||
passive-client bootstrap. The worker uses that same process option and invokes
|
||||
the hash-checked `.ps1` file normally with `& $p`; it never executes file content
|
||||
through `ScriptBlock::Create`. A small encoded hash launcher is only transport
|
||||
for that ordinary file invocation. There is no `Set-ExecutionPolicy`, registry
|
||||
policy write, Machine/User/GPO change or Bypass option. Persistent scopes stay
|
||||
unchanged; process scopes are consistently RemoteSigned and GPO precedence is
|
||||
retained. This permission does **not** decide or authorize the separate RMM
|
||||
PowerShell job executor's still-unqualified policy contract.
|
||||
|
||||
After actual successful setup, pass the recorded private homes to the builder:
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File .\deploy\windows\Build-NativeMsvc.ps1 -Mode Preflight -SourceRoot C:\Source\rust-discovery `
|
||||
-RustupExe <case>\cargo_home\bin\rustup.exe -RustupHome <case>\rustup_home -CargoHome <case>\cargo_home
|
||||
```
|
||||
|
||||
Use those same arguments with `-Mode Build -ExpectedPreflight <actual-receipt>`.
|
||||
Populate the isolated public Cargo cache explicitly before an offline build;
|
||||
there is no automatic fetch/retry in the builder. Native setup, native MIDL/ABI,
|
||||
unit execution and deployment results are still outstanding until actually run.
|
||||
|
||||
On November 15, 2026 a read-only check on the running Windows test VM found
|
||||
both CBS and Windows Update restart markers, 96 GiB free on C:, no vswhere
|
||||
at its standard installer path, and no rustc on the development user's PATH.
|
||||
No installer was launched. This check does not determine why the markers are
|
||||
present. Receipt `04a56e7d8a8bf00a110558344248fbb0ca0c2234c5c1ea6e347306bcc84d5c55`.
|
||||
Reference in New Issue
Block a user