Files
rust-discovery/docs/windows-boot-identity.md
T
2026-11-14 04:54:20 +01:00

113 lines
6.8 KiB
Markdown

# Windows-Bootidentität: Bestandsquelle und unqualifizierter Kandidat
Stand 2026-11-14: Die neue Strecke ist **nur als separate Diagnosequelle
implementiert, lokal geprüft und crossgebaut**. Es wurden **keine nativen
Boot-API-Aufrufe**, keine LocalService-Probe, keine Zeitänderung und kein
OS-Reboot damit ausgeführt. `job_binding_qualified` ist in jedem Ergebnis
`false`. Die produktive Agent-/Helper-Bootquelle wurde nicht geändert; es wird
keine zusätzliche Capability angeboten.
## Bestehende CIM-Quelle
Der bestehende Windowscode liest mit einem festen passiven CIM-Aufruf
`Win32_OperatingSystem.LastBootUpTime`, wandelt den Wert in UTC-Ticks um und
bildet daraus einen UUID-förmigen Hash mit dem Namensraum
`rmm.windows.boot.cim.ticks.v1`. Agent und Helper verwenden diese bestehende
Quelle. Die dokumentierte CIM-Eigenschaft bezeichnet den Zeitpunkt des letzten
Betriebssystemstarts; sie ist ein Zeitwert und kein dokumentierter opaker
Boot-Identifier. [Microsoft: Win32_OperatingSystem](https://learn.microsoft.com/en-us/windows/win32/cimwin32prov/win32-operatingsystem).
Übereinstimmende wiederholte CIM-Abfragen belegen ausschließlich die beobachtete
Übereinstimmung. Sie sind kein Nachweis, dass die Ableitung einen Prozessneustart,
einen Wanduhrsprung, Suspend/Resume, Fast Startup oder einen tatsächlichen
OS-Neustart korrekt voneinander unterscheidet. Hier wurde insbesondere **kein
Fehlerverhalten bei einem Zeitsprung beobachtet oder nachgewiesen**. Aus dem
fehlenden Stabilitätsnachweis folgt weder die Behauptung, CIM ändere sich bei
jedem Zeitsprung, noch eine belastbare Garantie, dass dies niemals geschieht.
Für gespeichertes passives Inventar bleibt die Herkunft damit nachvollziehbar.
Eine zukünftige Job-/Rebootbindung benötigt einen eigenständig qualifizierten
Vertrag. Ein bloßer Wechsel vom bisherigen Hash zu einer anderen GUID darf nicht
als tatsächlicher Neustart ausgegeben werden; historische Bindungen bleiben
historisch und werden nicht nachträglich umgedeutet.
## Getrennter nativer Diagnosekandidat
Der unexportierte [native_boot.rs](../crates/agent-windows/src/native_boot.rs)
fragt ausschließlich einen experimentellen Kandidaten ab. Der Decoder ist auf
**Windows 11, x86-64, Build 26300** beschränkt. Fehlendes API-Symbol, andere Builds,
Architekturen, Rückgabelängen oder ungültige Werte bleiben `unsupported`;
Zugangsverweigerung wird als `permission_denied` ausgewiesen. Es gibt keinen
Fallback auf Wanduhr-/Uptime-Subtraktion oder einen Registry-Bootzähler.
Die Implementierung löst `NtQuerySystemInformation` und `RtlGetVersion` dynamisch
im bereits geladenen `ntdll.dll` auf. Sie verwendet Klassenwert 90 und einen
festen, ausgerichteten 32-Byte-Puffer. Nur Status 0, exakt 32 zurückgemeldete Bytes,
eine nichtleere GUID aus den ersten 16 Bytes und ein passender Firmwaretyp an
Offset 16 werden als **Kandidatenbeobachtung** akzeptiert. Der Firmwaretyp wird
zusätzlich mit `GetFirmwareType` gelesen. Andere Pufferinhalte werden nicht
exportiert. Der Kandidat wird nicht aus einem Zeitwert berechnet.
Dabei sind API-Nachweis und Interpretation klar getrennt:
- Microsoft dokumentiert den allgemeinen dynamisch aufzulösenden
`NtQuerySystemInformation`-Einstieg, warnt aber vor Änderungen interner
Strukturen und nennt **keinen öffentlichen Vertrag für Klasse 90 und deren
BootIdentifier-Layout**. Die hier gewählte Feldinterpretation ist deshalb
ausdrücklich eine zu qualifizierende Hypothese, keine allgemeine Windowszusage.
[Microsoft: NtQuerySystemInformation](https://learn.microsoft.com/en-us/windows/win32/api/winternl/nf-winternl-ntquerysysteminformation).
- Die WDK-Dokumentation beschreibt die Versionsstruktur von `RtlGetVersion`;
sie garantiert damit nicht selbst einen unterstützten user-mode Boot-Identifier
aus `ntdll`. Fehlende Exporte werden verweigert.
[Microsoft: RtlGetVersion](https://learn.microsoft.com/en-us/windows-hardware/drivers/ddi/wdm/nf-wdm-rtlgetversion).
- `GetFirmwareType` ist eine dokumentierte lokale Win32-Abfrage. Ihr Abgleich
prüft die Plausibilität eines Feldes; er beweist weder die GUID-Semantik noch
deren Lebenszyklus.
[Microsoft: GetFirmwareType](https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-getfirmwaretype).
Auch zwei gleiche Kandidatenwerte bleiben `candidate_unqualified`. Weder
`job_binding_qualified` noch `public_class_90_abi_documented` werden dadurch wahr.
## Vorbereitete LocalService-Probe, noch nicht ausgeführt
[boot_probe.rs](../deploy/windows/boot_probe.rs) ist ein eigenständiges
SCM-Diagnoseprogramm, kein zusätzlicher RMM-Agent. Es akzeptiert ausschließlich
seinen eigenen Serviceaufruf, prüft den tatsächlichen Prozess als LocalService
`S-1-5-19`, verwirft Thread-Impersonation und aktivierte Administratorrolle und
schreibt zwei begrenzte Kandidatenbeobachtungen in einen neuen privaten Fall.
Ein Administrator-Konsolenaufruf ersetzt diesen Nachweis nicht.
[BootIdentifierProbe.ps1](../deploy/windows/BootIdentifierProbe.ps1) bereitet
gehashte Artefakte vor und kann später ausdrücklich einen eigenen temporären
Manual-/LocalService-Dienst anlegen. Diese SCM-Registrierung ist ausschließlich
Bootstrap für die Probe; es werden keine Registry-Bootzähler, permanenten
Agent-/Helperdienste, Zeiteinstellungen, Privilegien oder Truststores verändert.
Create-only Intents verhindern wiederholtes Starten nach unklarem Reply.
`Readback` liest nur; `Cleanup` entfernt ausschließlich den gebundenen, bereits
beendeten Probedienst. Alte Fälle und Berichte bleiben erhalten.
Zwei unabhängig gestartete frische Fälle könnten später Prozessunabhängigkeit
beobachtbar machen. Auch das ersetzt weder einen tatsächlichen genehmigten
OS-Reboot noch den noch fehlenden Nachweis der behaupteten Zeitsprungsemantik.
Diese Schritte sind hier **geplant, nicht ausgeführt**. Ein produktiver Wechsel
ist dadurch nicht freigegeben.
## Tatsächlich ausgeführte Prüfungen und eingefrorene Quellen
Ein lokaler Decoder-/Fehlerpfadtest bestand ohne Ignorieren: Status, Länge,
Firmware-Abweichung, GUID-Byteordnung und leere GUID führen nicht zu einer
Jobqualifikation. Windows-GNU-Clippy aller Targets mit `-D warnings`, Release-Link
und PowerShell-Parser bestanden. Die resultierende Windows-EXE wurde nicht
nativ ausgeführt. Private Qualifikation:
`devstate/windows-boot-probe/qualification.json`.
| Quelle | SHA-256 |
| --- | --- |
| `crates/agent-windows/src/native_boot.rs` | `4f4dfcce2ec57b7f901dec878ec19f985f6d86379ec90ef7b582be8218eda18f` |
| `deploy/windows/boot_probe.rs` | `f150fc81b4a5f3d9cfdc5f83ec96209a315bc72d2170d04ec59f899f01c34fe8` |
| `deploy/windows/BootIdentifierProbe.ps1` | `60b6787ab77caebbbea4b39689dd9b80cd618517f9292ec8ca9c1ba8ac3bd539` |
Der eigenständige Release-Link hat SHA-256
`7cd57577e8a75b408c9119a6f2f2bf325c0a8978c3f1be1800f254088cfeeb9e`.
Das ist ein Buildnachweis, kein nativer Boot- oder Reboot-Abnahmenachweis.