Add reviewed Windows scope completion and idle certificate renewal; deploy completion API
Rust development slice / linux (push) Failing after 7s
Rust development slice / linux (push) Failing after 7s
This commit is contained in:
@@ -0,0 +1,92 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user