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

9.7 KiB

Native Windows-Zertifikatserneuerung: vorbereitete Abnahme

Stand 2026-11-16. Vorbereitet, noch nicht nativ ausgeführt. Dieser Ablauf ergänzt die bisherigen Zertifikatsnachweise 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.