156 lines
9.7 KiB
Markdown
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.
|