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