Files
rust-discovery/docs/windows-signed-clock-capture-operator.md
T
2026-11-15 01:42:08 +01:00

160 lines
9.6 KiB
Markdown

# Separater Operator für die Windows-Rohclockprobe
Stand2026-11-15, Spezifikation1.22. Neuer Quellpfad:
`deploy/windows/signed_clock_capture_acceptance.py`. Dieser Runner ist ein
enger Entwicklungsbootstrap für genau zwei eigene temporäre SCM-Fixtures.
Kein RMM-Job, keine Calibration, kein Zeitpin, kein TrustedClock-/Readybeleg.
Die [Probequelle](windows-signed-clock-capture.md) bleibt unverändert.
Der ursprüngliche Quellenauftrag führte keine Zielaktion aus. Die späteren
tatsächlichen Operatorphasen und ihre Fehler sind im Ergebnisabschnitt unten
getrennt dokumentiert; geplante Befehle sind kein Erfolgsnachweis.
## Vorbedingungen und feste Herkunft
Nur der Rootoperator führt den Runner nach unabhängigem Review aus. Sein
`CaptureAccess` verwendet unverändert `system_pipe_upgrade.Access(MainRoot)`
für den bereits gepinnten SSH- und Serverzugang. Credentials bleiben ausschließlich
im Maincheckout und werden erst durch die tatsächliche Operatorphase gelesen.
Keine Kopie, kein alternativer Host, kein Hostkeybypass und keine Shellauswertung
von Konfigurationsdaten. Zwei neue feste Stagenamen sind ausschließlich
`SignedClockCapture.exe` und `SignedClockCaptureAcceptance.ps1`; alte Allowlisten
werden nicht erweitert oder verändert.
Vor der lokalen Vorbereitung werden190 gefrorene Inputs, Receiptba9ba8d8,
Inputmanifest2d21da4d und Readonlymanifest91c75ba8 geprüft. Windowsprobe:
8566784Bytes, SHA256
`601c27a43fb67c662f926f9dc289a23a5c31c7e27f62901a77fc9ceaafaea7fb`.
Die neue vorbereitete Fallkopie verwendet700/600, exklusive Dateien und fsync.
Ein fester lokaler Active-Intent verhindert einen neuen Fall als Ersatz für
einen unklaren Versuch. Es gibt keinen Reset- oder automatischen Retrypfad.
Pflicht ist der tatsächliche Linux-first-Nachweis des exakt selben Rawquellsatzes:
Originalfall `dcef489d-2a24-47cc-b3ca-6628545cdacf`, Originalread
`read-80f83bff-183b-4697-80b2-9b96a8182e8d.json`, SHA256
`91a750e4de266f5effccbd418a680c1ba4f5e0aff5082489fc021922bdfcafa3`.
5Guards bestanden,10 ausdrücklich gefiltert,15vorher gelistet; Originalmanifest,
Receipt und unveränderte Before-/After-/Currentwitnesses müssen passen.
Dieser Pflichtbeleg ist kein tatsächlicher Windows-Timernachweis.
Der angenommene reale Windowsbestand bleibt ausschließlich der akzeptierte
14fb176a-Fall samt originalen Mainindices. Der Runner ruft dessen bestehenden
`finish` ausschließlich lesend auf. Er akzeptiert keine andere Boot-/PID-/
SCM-Generation und repariert keine Indices oder Identität automatisch.
## Geplante Phasen, nicht ausgeführt
Auf dem Entwicklungsrechner, im Clockworktree:
```text
python3 deploy/windows/signed_clock_capture_acceptance.py prepare
python3 deploy/windows/signed_clock_capture_acceptance.py baseline --case <Original-UUID>
python3 deploy/windows/signed_clock_capture_acceptance.py setup --case <Original-UUID>
python3 deploy/windows/signed_clock_capture_acceptance.py start-local-service --case <Original-UUID>
python3 deploy/windows/signed_clock_capture_acceptance.py start-system --case <Original-UUID>
python3 deploy/windows/signed_clock_capture_acceptance.py read --case <Original-UUID>
python3 deploy/windows/signed_clock_capture_acceptance.py cleanup-local-service --case <Original-UUID>
python3 deploy/windows/signed_clock_capture_acceptance.py cleanup-system --case <Original-UUID>
python3 deploy/windows/signed_clock_capture_acceptance.py read --case <Original-UUID>
```
`prepare` ist rein lokal. `baseline` liest tatsächliche Serverflags/Zähler und
den unveränderten nativen Windowsbestand. Vor und nach **jeder** mutierenden
Phase werden exakt sechs vollständige stabile Felder verglichen: `files`,
`service`, `helper_service`, `agent_kernel`, `helper_kernel`, `helper_witness`.
`public_metadata` wird nicht ausgeklammert. Zusätzlich bleiben Journaldatei-ID,
Creation, IdentitySHA, Schema und Corecounts gleich; die passive Telemetrie-
sequenz darf nur steigen. Pending-/ACK-Telemetrie wird nicht bytegleich verlangt.
Windows0/0/0/0, Linux31/31/27/0, geschlossene Rootpolicycf15 und deaktivierte
Transportfaults müssen tatsächlich unverändert sein. Historische30er-Zähler
werden nicht übernommen. Unerwartete neue Generation bedeutet Stop und Befund.
`setup` erzeugt nur seinen neuen eigenen Fall unter
`C:\ProgramData\RustDiscoverySignedClockCapture\<UUID>`, einen privaten
Controllerbereich und genau die beiden festen Demand-Start-/OWN_PROCESS-
Dienste `RmmSignedClockCaptureLocalService` und `RmmSignedClockCaptureSystem`.
Konten sind LocalService/SID19 und LocalSystem/SID18. Beide eigene Dienst-SIDs
werden eingeschaltet, beide Definitionen entstehen vor dem ersten Rollenstart.
Root/System verwalten Definitionen und Case; Lesen erhalten nur beide eigenen
Fixture-SIDs, Schreiben nur die jeweils eigene SID im eigenen Rollenunterordner.
Keine allgemeine SID19-/Users-Schreibfreigabe. Die EXE wird ausschließlich aus
dem vollständig verifizierten unveränderlichen Staging kopiert.
Jede Startphase schreibt ihren dauerhaften Attempt vor dem einmaligen SCM-
Start. Der Operator hält tatsächlichen Prozesshandle, PID, native Geburt,
Imagepfad, Account und aktivierte Dienst-SID. Der feste Commandlinevektor muss
zusätzlich passen. Es gibt keinen PID-basierten globalen Kill. Der Watchdog
beobachtet eigene GetTickCount64-Uptime: nach40s nur den weiterhin exakt
gebundenen eigenen Prozesshandle terminieren, anschließend höchstens5s auf
Kernelprozessende warten. Ohne gehaltene exakte Identität bleibt Timeout unklar;
kein Fremdprozess wird übernommen. Der SSH-Controllertransport hat einen
separaten90s-Abbruch. Synchrone Kernel-/SCM-/CIM-Aufrufe und Schedulerstillstand
sind keine harte Echtzeitgarantie. Die feste Boot-CIM-Probe kann vor der
250ms-Rawerhebung bis15s benötigen. Managed Compiler-/Runtime-Temporärarbeit
des festen Add-Type-Interop folgt dem vorhandenen Bootstrapmuster und erteilt
keine RMM- oder beliebige Programmausführung.
Erfolg verlangt durable Probe-Intent/Report/End, numerische128er-Serie,
ImageSHA601c27, passende Rollen-/Token-/Geburtsbindung und tatsächlich beobachtetes
Kernelprozessende plus SCM-Stopped/Exit0. Ein Timeout oder fehlender Endbeleg
wird nicht durch späteren Zustand geheilt. `calibrated=false` und
`clock_authority=false` bleiben unverändert. Die Antwort enthält nur feste
Rollen, Fall-ID und begrenzte numeric/hash-Diagnosedaten; CLI meldet nur eine
kleine ASCII-JSON-Zusammenfassung.
Cleanup ist ein eigener expliziter Schritt. Nur dieselbe exakt konfigurierte,
bereits gestoppte eigene Definition darf einmal gelöscht werden. Für einen
begonnenen Start ist der erhaltene native Exitbeleg Pflicht; eine nie gestartete
Definition wird dadurch nicht nachträglich gestartet. Dauerhafter Delete-Attempt
vor DeleteService, danach echte Abwesenheitsprüfung. Sobald Cleanup beginnt,
bleiben weitere Starts geschlossen. Fallverzeichnisse und Rohbelege bleiben
zur Prüfung liegen; keine rekursive Bereinigung.
Nach verlorenem Reply ausschließlich `read` desselben Originals. Das startet
weder Probe noch Dienste und löscht nichts. Partielle Setupzustände werden
als unvollständig und unverifiziert sichtbar, nicht als Abnahme ausgegeben.
Auch ein erfolgreich beendeter Rohsampler beweist nur beobachtete Timerwerte
unter OS-/Hypervisorannahmen, keine absolute physikalische Genauigkeit und
keinen zulässigen Grundfehler für einen produktiven Clockpin.
RMM-Dienste, PKI, Datenbanken, Helperpins, Rootpolicy, W32Time und Clocksetter
werden von diesem Controller nicht verändert. Dauerhafte Jobs benötigen
weiterhin ihren unveränderlichen WebUI-genehmigten Plan. Die native Windows-
Ausführung, Grundfehlerbewertung, echte unabhängige Agent-/SYSTEM-Roundtrips
und Runtime-/Deadlineintegration bleiben getrennte Gates.
## Tatsächliche native Schritte, 2026-11-15
Originalfall `efd17b43-7e04-49a7-9bd4-862d13365eec`, Operator-SHA256
`dd6c575a119751429448e40e6f306cf79efa3a86c49bf2cd32a7783937177770`,
Controller-SHA256
`89c19138e2804f263f1875c7697a7d53f54f40722101677b4d29538c917196f4`.
Lokale Vorbereitung und lesende native Baseline bestanden. Auf der Windows-VM
bestand PowerShell5.1.26100.9818 die ASTprüfung ohne Fehler und kompilierte
den extrahierten C#-Interop; der Controller wurde dabei nicht ausgeführt.
Syntaxreceipt-SHA256
`cec5ad635814fba9a6e98932b6df5b5204178b3e39e3c2361ccec211b5676b5a`.
Die anschließende einmalige Einrichtung scheiterte mit Win32Exception auf
Controllerzeile138. Keine Rollenstartphase wurde aufgerufen. Separater
Originalfall-Readback `3890b0a6-2691-4f6b-8968-c268e031dff9` ist vollständig,
Receipt-SHA256
`bc2a4be1b27ef02f6111e7ed82e58efab7df40af84e9253c77836675282f70ae`.
Er meldet ausdrücklich `partial_setup=true`: eigener LocalService-Messdienst
vorhanden und gestoppt, eigener SYSTEM-Messdienst fehlt. Die sechs vollständigen
RMM-Witnesses und Serverzähler wurden unverändert nachgelesen. Das ist kein
erfolgreicher Setup-, Capture-, Calibration- oder Uhrbereitschaftsnachweis.
Eine zusätzliche rein lesende SCM-Abfrage bestätigt LocalService-Konto,
Demandstart, feste Originalkommandozeile, UNRESTRICTED-Dienst-SID und
SYSTEM/Administrators-DACL. Receipt-SHA256
`ff8e2eef73139c8350aa0f86c6fed5125fce95f79d535f25224829ce4fa9c565`
bindet die separaten Originalmarker: LocalService-created vorhanden,
SYSTEM-create-attempt vorhanden, SYSTEM-created fehlt. Damit scheiterte
die zweite Erstellung; die ursprüngliche innere native Fehlernummer wurde
vom bestehenden Transport nicht erhalten. Ein PowerShell-null/String-Binding
ist ein konkreter Quellenverdacht, noch kein gemessener NativeErrorCode.
Kein Setupretry, neuer Ersatzfall, Dienststart oder Cleanup wurde vorgenommen.
Die gestoppte eigene Fixture bleibt bis zu gesondert geprüfter Reparatur oder
Bereinigung sichtbar erhalten. RMM-Dienste und W32Time bleiben unverändert.