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

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