Files
rust-discovery/docs/windows-certificate-runtime-acceptance.md
T
2026-11-16 14:24:44 +01:00

156 lines
9.7 KiB
Markdown

# Native Windows-Zertifikatserneuerung: vorbereitete Abnahme
Stand 2026-11-16. **Vorbereitet, noch nicht nativ ausgeführt.** Dieser Ablauf
ergänzt [die bisherigen Zertifikatsnachweise](windows-certificate-renewal.md)
um tatsächliches LocalService-Datei-I/O und echte Serverantworten. Er ist kein
Nachweis einer bereits erfolgten Erneuerung des permanenten Agentzertifikats.
Das Beispiel `windows_certificate_acceptance` verwendet die unveränderten
Produktimplementierungen `RotationStore`, `ProtectedKeyFiles` und `Journal`.
Es akzeptiert ausschließlich den bestehenden LocalService-Prozesstoken ohne
Administratorrechte oder Threadimpersonation. Deshalb wird das geprüfte Binary
als Kind eines einzeln WebUI-genehmigten LocalService-PowerShell-Auftrags
gestartet; eine Administrator-Konsole ersetzt diesen Rollenbeleg nicht.
## Vorbereitung und Grenzen
Der Bootstrap legt einen neuen zufälligen Fall unter
`C:\ProgramData\RustDiscovery\certificate-acceptance\<UUID>` an. Nur SYSTEM,
Administratoren und die bestehende Agent-Service-SID erhalten geerbte Rechte.
Die beiden Eingabedateien sind `ca.pem` mit der öffentlichen Projekt-CA und
`enrollment-token` mit einem neuen, einmaligen Enrollmentnachweis ausschließlich
für eine **separate Testidentität**. Den Token weder in den Plan noch in
Jobausgabe, Dokumentation oder Repository aufnehmen. Das geprüfte Binary wird
vom Bootstrap geschützt und mit seinem exakten Hash im Testplan festgehalten.
Die Probe liest niemals State, private Schlüssel oder Zertifikat der permanenten
Installation. Ein Startmarker verhindert Wiederholung des Enrollment-/Renewal-
Ablaufs bei erneutem Aufruf. Fehler werden nur als fester Fehlercode und Phase
ausgegeben; der isolierte Fall bleibt zur Nachprüfung erhalten. Es gibt keine
automatische Neuregistrierung, Geheimnisausgabe oder Löschung fremder Dateien.
## Geplanter tatsächlicher Ablauf
1. Fester MCP-Antrag für `windows_certificate_acceptance.exe renew <UUID>` im
LocalService-Skript. Vor dem WebUI-Klick keine ausführbaren Jobs oder Grants.
2. Enrollment mit eigener lokaler Schlüsselerzeugung, neue Testidentität,
geschützte Schlüssel-/Identitätsdateien und journalisierter Selektor.
3. Tatsächliches mTLS-Hello und Heartbeat mit dem ursprünglichen Testzertifikat.
4. Produktpfad `prepare`, echte Erneuerungsantwort empfangen und absichtlich
**nicht installieren**. SQLite- und KeyFiles-Handles vollständig schließen.
5. Neu öffnen, exakt denselben gespeicherten CSR nachweisen, denselben Request
mit dem noch gültigen alten Testzertifikat erneut senden und byteidentische
Serverantwort prüfen. Das bleibt innerhalb des bestehenden 300s-Overlap.
6. Produktpfad `install`, erneut schließen/öffnen, neues Zertifikat und neue
mTLS-Verbindung mit höherer Verbindungsgeneration samt Heartbeat-ACK prüfen.
Ursprüngliche Testschlüssel-/Zertifikatsdateien müssen unverändert sein.
7. Öffentliche Quittung `renewal-result.json` unabhängig mit Serverbestand und
späterem MCP-Gerätestand vergleichen. Die Probe beweist einen kontrollierten
Erneuerungsaufruf unter LocalService, **nicht** den automatischen 20-Tage-
Schedulertrigger oder einen Betriebssystem-Prozessabsturz.
8. Ausschließlich diese Testidentität über die WebUI widerrufen. Ein neuer,
eigener WebUI-genehmigter Probeauftrag
`windows_certificate_acceptance.exe revoked-read <UUID>` verwendet weiter
das erneuerte Testzertifikat. Nur ein tatsächliches HTTP401 nach gültigem
TLS wird als Widerrufsbeleg anerkannt; Netzwerk-/TLS-Fehler genügen nicht.
9. `revocation-result.json` und Serveraudit unabhängig nachlesen. Permanente
Geräteidentität und deren passive Heartbeats müssen erhalten sein.
Beide Probeausführungen sind eigenständige feste Jobs mit Planhash, simuliertem
Testprincipal und `approval_origin`/`testsimulation` im Audit. Der vorbereitete
Dateipfad oder ein erfolgreicher Crossbuild autorisiert keine Ausführung.
## Aktive Erneuerung im Quellstand, native Abnahme offen
Die bisher installierte Version erneuert ausschließlich mit
`enable_jobs=false`. Der neue Quellstand erlaubt zusätzlich automatische
Erneuerung im aktiven **Leerlauf**: kein offener/akzeptierter/unbekannter Auftrag,
keine unvollständigen Verbrauchs-/Start-/Ergebniszeugen, keine offene Helper-
Delegation oder Kontrollantwort, keine ausstehenden Ergebnis-/Inventarereignisse.
Ein frischer regulärer signierter Sync mit qualifizierter Uhr ist vor der
Zulassung erforderlich; ein konfigurierter Helper muss unabhängig bestätigt sein.
Vor der Netzwerkanfrage schließen die Startgates und die bisherigen Zeitworker.
Ein kleines öffentliches Idlezeugnis wird in **derselben SQLite-Transaktion**
wie der neue CSR und Pendingselektor gespeichert. Es bindet Gerät, Boot,
Originaljournal-/Ledgerdateikennungen, festen Bindinghash, vollständigen
Kontrollhead und die erhaltenen Versuche/Verbrauchs-/Start-/Ergebnisbytes sowie
Helperpin und vorherigen unabhängigen Helperanker. Die Zeile ist append-only.
Bei Antwortverlust darf ausschließlich derselbe Pendingrequest fortgesetzt
werden, solange alle gebundenen lokalen Zustände exakt erhalten und wirkungslos
sind. Das gespeicherte Zeugnis stellt **keine** Bereitschaft wieder her. Nach
Zertifikatswahl werden authentisierter Kontakt und der normale unabhängige
Agent-/Helpersync erneut benötigt. Ein altes passives Pending ohne dieses
Zeugnis darf nicht durch einen Konfigurationswechsel zum aktiven Request werden.
Ein veränderter Boot, Head, Pin, File-ID oder Ledger verweigert diesen Retry;
keine Legacyidentität, kein Reset und keine nachträgliche Heilung von Unknown.
Die isolierte Renewalprobe oben verwendet bewusst keine künstlich gealterte
Uhr. Der echte Schedulertrigger und die neue aktive Leerlaufzulassung bleiben
gesonderte native Gates. Quellen-/Crossbuild-/Unitbelege werden nicht als
Dienstabnahme ausgegeben.
## Konkrete Vorbereitung vom 16. November
Der bereits gebaute SDK ist lokal erhalten:
`devstate/windows-certificate-acceptance/windows_certificate_acceptance.exe`,
SHA256 `c6b581b60ce803318ff946cd3cc8306aa8589d6bff6b022c0bf1d48eb8f5a8e1`.
Sein Beispielquelltext hat SHA256
`74b2bc85d3d68d27154e87fcaca0ed313d3d721692473e1a47e577bff34474b7`.
Die Produktionsdateien `certificate_rotation.rs`, `native.rs` und `journal.rs`
stimmen bytegenau mit dem qualifizierten Dienstpaar aus
`devstate/windows-helper-apply-fix/source` überein. Buildreceipt und tatsächliche
Quellen liegen unter `devstate/windows-certificate-acceptance/`; das SDK wurde
bei dieser Vorbereitung weder auf der VM ausgeführt noch dort neu installiert.
`deploy/windows/Prepare-CertificateAcceptanceFixture.ps1` ist ein expliziter
Bootstrap, der **keinen** SDK-Prozess startet. Er erwartet ausschließlich eine
JSON-Zeile auf stdin mit `case_id`, `ca_base64`, `ca_sha256` und
`enrollment_token`. Der Token muss unmittelbar vor dem koordinierten Test für
eine neue, separate Identität erzeugt werden; bestehende Geräte-/Enrollmentdaten
werden nicht übernommen. Ein vorhandenes Fallverzeichnis verweigert die
Vorbereitung statt Token oder Dateien zu ersetzen. Teilfehler erfordern Lesen
des bestehenden Falls, keine blinde Wiederholung.
Das SDK wird nach
`C:\Program Files\RustDiscoveryCertificateAcceptance\<SDK-SHA256>\WindowsCertificateAcceptanceSDK.exe`
kopiert, mit SYSTEM-/Administrator-Schreibrecht und Agent-Service-SID-Leserecht.
Das Fallverzeichnis liegt getrennt unter dem oben genannten festen Pfad;
nur SYSTEM, Administratoren und die tatsächliche Agent-Service-SID erhalten
Schreibrecht. Die permanente Geräteidentität, RMM-Journale, Helperpolicy,
Dienste und Zeitprofile werden nicht gelesen oder geändert.
`deploy/windows_certificate_acceptance.py` erzeugt ausschließlich lokal die
vollständigen PowerShell-Pläne für `renew` und `revoked-read`. Es führt keine
Netzwerkanfrage aus, plant keinen MCP-Auftrag und genehmigt nichts. Das Skript
bindet SDK-Hash und Fallkennung, hält das SDK während Prüfung und Ausführung
gegen Schreiben/Löschen geöffnet und verlangt die tatsächliche LocalService-
Quittung. Die vorgesehenen Aufträge laufen mit 120s Laufzeitgrenze,
`powershell_51_remote_signed` und festen Ausgabepostconditions. Der zweite Plan
darf erst nach unabhängig geprüftem Renewal und tatsächlichem WebUI-Widerruf
**ausschließlich der Testidentität** eingereicht/genehmigt werden. Zeitplan beim
tatsächlichen MCP-Antrag neu rendern; ein lokaler Entwurf ist keine Genehmigung.
Tatsächlich ausgeführt wurden Python-Syntaxprüfung und der rein lesende
PowerShell-5.1-AST-Parser für den Bootstrap: null Syntaxfehler. Es wurden kein
Fixturetoken erzeugt, keine Registrierung/Erneuerung/Widerruf ausgelöst und
keine neuen Jobs erstellt. Die ACL-/I/O-Wirkung des neuen Bootstrap bleibt bis
zur koordinierten nativen Ausführung ausdrücklich **nicht abgenommen**. Der
Linux-Vergleich bleibt die bereits tatsächlich ausgeführte separate
Cloud-Identitätsabnahme in `deploy/cloud_lifecycle_acceptance.py`.
## Weitere offene Neustartvoraussetzung
Der tatsächliche lesende SCM-Stand am 16. November nach Installation von
Profil 7: Agent `Running/Auto/LocalService`, Helper `Running/Manual/LocalSystem`.
`system_helper_bootstrap.py` legt den Helper ausdrücklich mit Startart Manual
an. Der Agent besitzt keinen eigenen Helper-Startpfad; der vorhandene
`PreparedService::execute` startet nur separat genehmigte, allowlistgebundene
Dienstaufträge und aktiviert nicht den eigenen SYSTEM-Helper. Ein laufendes
Paar beweist daher noch keinen vollständigen Wiederanlauf nach Windows-Boot.
Eine eng koordinierte automatische Helper-Startkonfiguration und die dazu
gehörenden tatsächlichen SCM-/Rollen-/Zeitbelege sind vor einer vollständigen
Windows-MVP-Neustartabnahme nötig. Diese Vorbereitung hat die Startart nicht
verändert und keinen Neustart ausgeführt.