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

93 lines
5.8 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.