Files
rust-discovery/docs/windows-clock-process-privilege-plan.md
T
2026-11-14 19:49:09 +01:00

241 lines
15 KiB
Markdown

# Plan: einmaliger Clockvergleich mit vorhandenem Prozessprivileg
Ursprünglicher Plan 2026-11-14, vor Implementierung verfasst; die inzwischen erfolgte lokale Umsetzung steht im letzten Abschnitt.
**Keine Implementierung, kein Build und keine Zielaktion für diesen Nachfolger.**
Die Freigabe der konkreten Tokenabgrenzung und des Diagnoseumfangs liegt beim
Hauptagenten. Alle bisherigen Empty-, F6-, SYSTEM-, EEInfo- und Produktquellen
sowie deren Casebelege bleiben unverändert.
## Ausgangspunkt und begrenzte Fragestellung
Der Hauptagent meldet aus dem tatsächlichen Empty-Case
`5e0e8ce9-b9a3-4c4a-b739-3f84d714dc94`: eine Statusquery, RPC5/Stage90,
ein numerischer EEInfo-Record; vorhandenes SeSystemtimePrivilege mit
Attributen0/Enabled0. Dieser Plan ergänzt keinen abgeschlossenen
Readback-/Cleanup-/Preservationnachweis und leitet daraus keine Fehlerursache ab.
Der nächste Vergleich soll ausschließlich prüfen, ob sich das Ergebnis eines
einzelnen lesenden Opnum6 ändert, wenn genau das bereits vorhandene
SeSystemtimePrivilege des getrennten Diagnoseprozesses vorübergehend aktiviert
ist. Es werden keine Kontorechte zugewiesen. Auch ein erfolgreicher Vergleich
wäre weder Produktionsfreigabe noch ausreichende Clock-/Serveridentitätsprüfung.
## Geprüfte Microsoft-Verträge
AdjustTokenPrivileges wirkt auf das übergebene Tokenobjekt. Es benötigt
TOKEN_ADJUST_PRIVILEGES, mit PreviousState zusätzlich TOKEN_QUERY. TRUE allein
bedeutet nicht, dass alle angeforderten Rechte angepasst wurden:
GetLastError ist unmittelbar auszuwerten; ERROR_NOT_ALL_ASSIGNED verweigert den
Diagnoseaufruf. Vorhandene Rechte können aktiviert werden, neue werden nicht
hinzugefügt. PreviousState enthält die tatsächlich geänderten ursprünglichen
Zustände und dient als NewState einer Wiederherstellung. Ein zu kleiner
PreviousState-Puffer führt ohne Anpassung zum Fehler.
[AdjustTokenPrivileges](https://learn.microsoft.com/en-us/windows/win32/api/securitybaseapi/nf-securitybaseapi-adjusttokenprivileges)
OpenProcessToken öffnet das einem Prozess zugeordnete Token. Dieser Aufruf ist
kein eigenständiger Vertrag über die Exklusivität aller Referenzen auf dieses
Tokenobjekt.
[OpenProcessToken](https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-openprocesstoken)
TokenStatistics.TokenId identifiziert die konkrete Tokenobjektinstanz.
AuthenticationId identifiziert eine Anmeldesitzung, zu der viele Tokens gehören
können. ModifiedId ändert sich bei Tokenänderung. Deshalb weder gleiche
AuthenticationId als Tokenidentität noch gleiche ModifiedId nach Wiederherstellung
fordern; die ursprüngliche ModifiedId lässt sich nicht durch Zurücksetzen der
Privilegattribute wiederherstellen.
[TOKEN_STATISTICS](https://learn.microsoft.com/en-us/windows/win32/api/winnt/ns-winnt-token_statistics)
Jeder Prozess hat ein Primärtoken; ein impersonierender Thread kann zusätzlich
ein Threadtoken besitzen. Der Vergleich soll weiterhin ohne Impersonation und
ohne Tokenwechsel laufen.
[Access Tokens](https://learn.microsoft.com/en-us/windows/win32/secauthz/access-tokens)
LocalSystem-Dienste erben den Sicherheitskontext des SCM. Diese Aussage und
derselbe SYSTEM-SID belegen für sich allein keine verschiedenen TokenIds.
SeSystemtimePrivilege ist in Microsofts LocalSystem-Beschreibung standardmäßig
deaktiviert; das erklärt nicht allein den konkreten RPC5.
[LocalSystem Account](https://learn.microsoft.com/en-us/windows/win32/services/localsystem-account)
SERVICE_WIN32_OWN_PROCESS belegt einen eigenen Prozess, nicht durch seine bloße
Bezeichnung eine geprüfte Trennung sämtlicher Tokenreferenzen.
[CreateServiceW](https://learn.microsoft.com/en-us/windows/win32/api/winsvc/nf-winsvc-createservicew)
## Noch vom Hauptagenten zu entscheidende Beweisgrenze
Vorgeschlagener enger Gate: Vor jeder Anpassung rein lesend TokenId und
TokenStatistics des Diagnoseprozesses, des SCM-Prozesses und der aktuell an
W32Time, RMM-Agent und RMM-Helper gebundenen Prozesse erfassen. Prozesshandles
und Startzeiten binden die Ablesung gegen PID-Wiederverwendung; Dienst-PID und
Prozessbindung direkt danach erneut prüfen. Nur TOKEN_QUERY gegenüber fremden
Tokens; kein SE_DEBUG_ENABLE, kein fremdes TOKEN_ADJUST_PRIVILEGES.
Bei fehlender erforderlicher Probe, Prozesswechsel, gemeinsamem TokenId,
falschem SYSTEM-Primärtoken oder vorhandenem Threadtoken: Abbruch vor Anpassung
und vor RPC. Gleiche AuthenticationId allein ist kein Fehler.
Dies belegt lediglich Trennung von den tatsächlich abgefragten Peer-Tokenobjekten.
Es beweist nicht, dass kein weiterer Prozess/Thread irgendeine Referenz auf das
Diagnosetoken hält. Die ausgewerteten primären Verträge liefern hierfür keine
ausreichende universelle Exklusivitätsgarantie. **Ohne ausdrückliche Akzeptanz
dieser Grenze wird kein Anpassungscode erstellt.** Alternativ ist zuerst ein
rein lesender TokenId-Vergleich vorzubereiten. Ein dupliziertes Token plus
Impersonation oder neuer Childprozess ist ein anderer Vergleich und wird nicht
stillschweigend als Ersatz eingebaut.
## Vorgeschlagene neue Quellen, erst nach dieser Entscheidung
Vier neue Dateien unter `deploy/windows/clock-spnego-privilege-trace/`:
- `clock_rpc_spnego_privilege.c`: bytegleicher Empty-RPCpfad bis auf das neue
öffentliche Symbolsuffix. Tatsächlich zurückgegebenen nicht-NULL Emptystring
unverändert weitergeben; GSS9/Privacy6/Identify2, kein Authfallback. Maximal
eine Managementdiscovery und bei erfüllten Vorbedingungen eine Opnum6-Query;
Setupfehler bedeuten null Queries. EEInfo weiter maximal vier numerische
Records. Kein Setter und keine neue Serveridentitätsbehauptung.
- `system_trace_spnego_privilege.c`: eigener, einmalig gestarteter
SYSTEM-OWN_PROCESS-Dienst mit dem nachstehend beschriebenen Tokenablauf.
- `build.py`: alter Compiler/MIDL/Header/SDK/DLL-Vertrag unverändert, neue
vier Inputs sowie Empty-Manifest und tatsächlichen Ausgangscase hashen;
alte Inputs nur vergleichen und unverändert erhalten.
- `native.py`: eigene Case-/Service-/Profilbindung, create-once prepare/start,
rein lesender same-case Readback und getrenntes Cleanup nur des eigenen
gestoppten Dienstes. Antwortverlust erlaubt keine Wiederholung des Starts.
Vorgeschlagene Namen: `RmmClockSpnegoPrivilegeDiagnostic`,
`clock-system-spnego-privilege-v1`, `ClockSpnegoPrivilegeTrace.exe`,
`C:\ProgramData\RustDiscoveryBootstrap\clock-spnego-privilege-trace-<UUID>`.
## Geplanter Tokenablauf und Fehlerverhalten
1. Vor Anpassung eigenes gehaltenes Primärtoken mit exakt TOKEN_QUERY und
TOKEN_ADJUST_PRIVILEGES öffnen; keine Vererbung oder Weitergabe des Handles.
SYSTEM, Primärtoken und fehlendes Threadtoken prüfen. Vollständige begrenzte
Privilegliste auslesen, LUIDs numerisch sortieren und auf Duplikate prüfen.
SeSystemtimePrivilege muss genau einmal vorhanden sein, Attribut0 haben und
weder enabled noch removed sein. Abweichung verweigert den Vergleich.
2. Eigenes PID/Startzeit/TokenStatistics und Peer-Proben samt ursprünglicher
numerischer Privilegliste create-once vor Anpassung dauerhaft ablegen.
Geplantes Limit: höchstens256 Privilegien und derselbe4096Byte-Tokenpuffer.
Keine Namen, Anmeldeinformationen oder Tokenhandles als Ausgabedaten.
3. Ein einziges AdjustTokenPrivileges mit DisableAllPrivileges=FALSE,
PrivilegeCount=1, exakter vorhandener LUID und SE_PRIVILEGE_ENABLED.
Ausreichender fester PreviousState-Puffer für genau eine Änderung;
BOOL und sofortiges GetLastError getrennt speichern. Nur TRUE+ERROR_SUCCESS
und genau ein gültiger PreviousState-Eintrag derselben LUID/Attribut0
erlauben den weiteren Ablauf. Kein SE_PRIVILEGE_REMOVED/DisableAllPrivileges.
4. Direkt am gehaltenen eigenen Token nachlesen: gleiche TokenId,
AuthenticationId und TokenType, unveränderte Privilegmenge sowie lediglich
der erwartete Enablebit-Wechsel. Direkt vor RPC fehlendes Threadtoken erneut
prüfen. Fehler springen zuerst in Restore, nicht in RPC. Der Enablezeitraum
umfasst den unveränderten Discovery-/Authsetup-/Querypfad; es wird keine
Behauptung aufgestellt, dass das Bit nur während des einzelnen Opnum6 aktiv ist.
5. Bestehende RPCfunktion höchstens einmal aufrufen; RPCexception/Fehler bleibt
ihr numerischer Befund. Unmittelbar danach Restore auf demselben gehaltenen
eigenen Token mit PreviousState als NewState. Jeder normale Fehlerpfad nach
Anpassungsbeginn erreicht denselben Cleanupblock, bevor Berichtschreiben
oder Dienstende. Auch fehlgeschlagene Nachprüfung löst Restore aus.
Bei unerwartetem PreviousState ist kein RPC erlaubt; der bereits separat
gesicherte eine ursprüngliche LUID/Attribut0 ist die begrenzte Restoreeingabe.
Keine Wiederholung eines RPCs oder Aktivierungsversuchs.
6. Restore-BOOL und unmittelbaren Fehlercode separat erfassen. Vollständige
Privilegliste erneut lesen; exakt ursprüngliche Attribute/Menge fordern.
TokenId/AuthenticationId/TokenType müssen gleich sein. ModifiedId darf und
wird gegebenenfalls anders sein; dies ist keine fehlgeschlagene Rücksetzung.
Peer-TokenIds/Attribute erneut rein lesend prüfen; Wechsel/Fehler ehrlich
als nicht nachgewiesene Erhaltung melden, nicht durch fremden Schreibzugriff
reparieren. Danach Ergebnis plus before/enabled/restored-Snapshots speichern.
Ein Restorefehler kann nicht durch eine Erfolgsmeldung verdeckt werden und
beweist keine erfolgreiche Erhaltung; Dienstexit wird Fehler, kein weiterer
RPC. Unvorhersehbarer Prozessabbruch, TerminateProcess oder Stromverlust kann
keinen benutzerseitigen finally-Block garantieren. Ohne gespeicherte und
nachgelesene Wiederherstellung lautet der Nachweis daher `unknown`, auch wenn
der Prozess bereits beendet ist. Es wird keine universelle Rücksetzgarantie
für solche Abbrüche behauptet.
Die Statusquery bleibt fachlich lesend; der neue Diagnoseprozess insgesamt ist
wegen AdjustTokenPrivileges **nicht rein lesend**. Maschinen-/Kontorechte,
ACL/GPO, W32Time-Konfiguration, Dienstkonten und Uhrzeit werden nicht geändert.
Die Erzeugung des eigenen Diagnosedienstes bleibt eine gesonderte ausdrückliche
Bootstrapwirkung. Kein Produktgate und keine Job-/Freigabe-/Policyänderung.
## Geplante lokale und native Nachweise, sämtlich noch nicht ausgeführt
Nach akzeptiertem Scope zunächst Quellenreview: genau ein Enable, ein gebundener
Restorepfad, kein Tokenwechsel, keine fremden Tokenwrites, bestehender RPCpfad
bis auf Symbol bytegleich. Lokale gezielte Guardfälle: TRUE mit1300 verweigern,
fehlendes/removed/dupliziertes Recht, bereits enabled, falscher PreviousState,
fremder gleicher TokenId, Peerwechsel, nichtlesbarer Peer, aktiver Threadtoken,
Nachprüfungsfehler, RPCexception sowie Restorefehler. Nicht jeder synthetisch
abgedeckte Fehler ist damit ein nativer Windowsnachweis.
Erst nach getrenntem Source-/Buildreview kann der Hauptagent einen neuen nativen
Case ausdrücklich starten. Benötigte Belege: originale Snapshots vor Anpassung,
sichtbare einzelne Enableänderung, exakter RPC-/EEInfo-Befund, nachgelesener
Restore, unveränderte Peer-Zustände, gestoppter eigener Dienst, same-case
Readback sowie getrenntes Cleanup/Preservation bestehender RMM-Dienste. Keine
Clockqualifikation allein aus einem erfolgreichen Statusqueryreturn ableiten.
## Lokale Umsetzung nach ausdrücklicher Rootfreigabe
Der Hauptagent hat die begrenzte TokenId-Trennung zu gehaltenen SCM-/W32Time-/
Agent-/Helper-Prozessen ausdrücklich akzeptiert. Universelle Exklusivität aller
Referenzen wird weiterhin nicht behauptet. Der ursprüngliche176Zeilen-Plan
mit SHA25627b1035c… ist zusätzlich create-once unter
`devstate/windows-clock-spnego-privilege-trace/local-review/accepted-plan.md`
erhalten. Dieser Abschnitt ersetzt keine Freigabe einer Zielaktion.
Die vier oben benannten neuen Dateien sind jetzt lokal implementiert.
Vorher werden eigene TokenUser/SYSTEM, Primärtoken, fehlender Threadtoken und
vollständige numerische Privilegliste geprüft. SCM wird eindeutig über
services.exe samt Systempfad ermittelt; die anderen drei Prozesse sind über
gehaltene Service-/Prozesshandles, Running/PID, Erstellzeit und feste Images
gebunden. Fremde Tokenhandles verlangen ausschließlich TOKEN_QUERY. Der eigene
Tokenhandle verlangt QUERY|ADJUST_PRIVILEGES. Vor Enable wird der vollständige
Beforebeleg create-once geschrieben. Der unmittelbare Enable-Rückgabecode und
GetLastError, PreviousState und volle Nachlese begrenzen den einzigen RPCpfad.
Alle kontrollierten Fehlerpfade nach Enable erreichen dieselbe einzelne
Restorestelle; danach werden volle ursprüngliche Attribute und die
unveränderten numerischen Peer-Privilegzustände/TokenIds/ModifiedIds geprüft.
ModifiedId des eigenen Tokens darf nach korrektem Restore geändert sein.
Berichte kennzeichnen die gesamte Diagnose ausdrücklich als read_only=false;
SYSTEM wird nur bei erfolgreicher tatsächlicher Probe ausgewiesen. Ein eigener
Cleanupreceipt erhält den vorherigen Dienstexitcode, damit Serviceentfernung
keinen fehlgeschlagenen Ablauf nachträglich als vollständig erscheinen lässt.
Finaler lokaler Build:
`devstate/windows-clock-spnego-privilege-trace/build-b56e3f3d-8904-4fd8-9c34-0e55e57c8f07/manifest.json`, SHA256
`6c97658307ec66e6605574dca27cdbc79efefa9cd7f386e6e2cb3f73d9b5c6d3`.
PE114087Bytes, SHA256
`68a217914c15f28b19c52a2f5adfd595854f88210fbb0b69c20e73a59952b65e`.
Originales Microsoft-MIDL/Header und gepinnter Compiler unverändert; eigene
C-Units Wall/Wextra/Werror, gleiche vier DLL-Imports ADVAPI32/KERNEL32/RPCRT4/
msvcrt. PowerShell-AST bestanden, EncodedCommand18858Zeichen unter32767.
Alle131Produktinputs,15bisherige Diagnosequellen sowie F6-/Empty-Manifeste und
Ergebnisbelege unverändert geprüft. Der RPCwrapper unterscheidet sich vom
Empty-Elternteil ausschließlich durch das öffentliche Symbolsuffix.
Gezielte lokale Nachweise, keine Windows-API- oder RPC-Ausführung: der tatsächliche
C-run_service-Block wurde bytegleich extrahiert und mit kontrollierten lokalen
API-Stubs übersetzt/ausgeführt.13Fälle bestanden, unter anderem TRUE/1300,
FALSE, ungültiger PreviousState, aktive Attributabweichung, Own-/Peerprobe-Fehler,
Restorefehler, fehlgeschlagene Nachlese sowie Writefehler vor/nach Enable.
Jeder Fall prüft höchstens1Enable, genau1Restore je Enable und höchstens1RPC.
Der echte Python-Reader akzeptierte zwei synthetische gültige Berichte und
verweigerte17Fälschungen/Fehler einschließlich fremdem TokenId, nicht erhaltenen
Attributen, Peerdrift, schwächerer Privacy und verstecktem Fehlerexit nach Cleanup.
Guardreceipt `local-review/guards.json`, SHA256
`c12c5d06ecad63101874f7c66af1f49eb9f6d9b51dbba9c75e367462660fa831`.
Dies sind lokale Fehlerpfadbelege, keine nativen Token-/Erhaltungsnachweise.
**Bis zum Abschluss dieser lokalen Vorbereitung war kein Privilegvergleich auf
Windows ausgeführt. Der Subagent hat keinen VM-/SSH-/SCM-Start vorgenommen und
keinen Produktcode/Clockgate geändert.** Das erforderliche unabhängige
Source-/Manifestreview und die spätere native Ausführung durch den Hauptagenten
sind inzwischen im [tatsächlichen Ergebnis](windows-clock-process-privilege-result.md)
mit Startfehler, separatem Readback, Restore, Cleanup und Preservation dokumentiert.
Auch eine künftig erfolgreiche Query ließe produktive LocalService-Privilegien,
gebundene Serveridentität und Transport-Positiv-/Negativnachweise weiter offen;
Discovery/NTLM/Mutualauth-Flags allein ersetzen diese nicht.