Files
rust-discovery/docs/windows-system-policy.md
T
2026-11-14 04:41:09 +01:00

117 lines
7.3 KiB
Markdown

# Getrennte Windows-SYSTEM-Policy: Source-Stand
Stand 2026-11-14: Die Serverstrecke ist **implementiert, lokal geprüft und mit
13 ausgewählten reinen Policytests auf der tatsächlichen Cloud-Linux-VM geprüft**.
Sie wurde nicht auf den Cloudserver ausgerollt und nicht über einen echten
Windows-SYSTEM-Job abgenommen. Kein Principal erhielt ein neues Recht; keine
Policydatei oder Capability wurde installiert/veröffentlicht. Domain, Shared Core,
Windowsquellen, deren laufende native Qualifikation und WebUI bleiben unverändert.
Die derzeitige gemeinsame `Action::available_for` verweigert Windows-SCM weiterhin.
`system` ist eine explizite eigene Ausführungsidentität. Der Dispatcher in
`root_policy::authorize` führt ausschließlich diese Identität zur neuen
`windows_policy`; `root` bleibt der Linux-Root-Pfad. Unbekannte Identitäten werden
verweigert. Eine Windowsbasis-Capability kann auch mit Rootcaps keine Rootpolicy
erlangen. `root:execute` enthält niemals `system:execute`.
## Eng begrenzter Serververtrag
Die Policy wird ausschließlich bei `RMM_PROFILE=development`,
`RMM_DEV_SYSTEM_ENABLED=true` und gesetztem `RMM_DEV_SYSTEM_POLICY_FILE` gelesen.
Fehlende, abgelaufene, unbekannte oder ungültige Konfiguration verweigert. Der
Loader liest höchstens 64 KiB von einer regulären Datei mit Modus **0600** und der
UID der administrativen Job-Signierdatei. Von dieser Schlüsseldatei werden nur
Metadaten gelesen, keine privaten Schlüsselbytes. Symlinks in Dateipfad oder
Signing-Key-Pfad sind verboten. Der unmittelbare Parent muss ein geschütztes
Verzeichnis im Besitz von Root oder dieser UID ohne Gruppen-/Fremdschreibrechte
sein. Der offene Dateideskriptor und der anschließende lstat müssen dieselbe
Dateiidentität und unveränderte Metadaten besitzen; ungeschützte oder wechselnde
Dateien werden nicht als Policy akzeptiert.
Auch sämtliche Verzeichnisvorfahren müssen Root oder dieser UID gehören.
Beschreibbare Vorfahren werden nur mit Sticky-Bit akzeptiert, das zusammen mit
der vertrauenswürdigen Besitzerkette das Ersetzen des nächsten Bestandteils
verhindert; der direkte Parent bleibt ohne Gruppen-/Fremdschreibrecht.
Die Kette wird nach dem Lesen erneut geprüft. Ein nur privater direkter Parent
unter einem unsicheren nicht-sticky Vorfahren genügt nicht.
Das JSON-Schema enthält `schema_version=1`, `profile=development`, ein zukünftiges
`expires_at` und bis zu 64 `scopes`. Jeder Scope bindet exakt Tenant-, Asset- und
Agent-UUID, Enrollmentgeneration, Assignmentversion und eine begrenzte Liste
expliziter Principalnamen. Pflicht sind außerdem `helper_policy_sha256`,
`helper_binary_sha256`, eine nichtleere UUID `acceptance_evidence_id`, eine
Fixture-Dienstallowlist und `max_runtime_seconds` zwischen 1 und 120. Unbekannte
Felder werden abgewiesen. Die Evidence-UUID ist eine administrative Nachweispin;
sie erzeugt weder eine Genehmigung noch eine Autorisierung.
Erlaubt ist ausschließlich `set_service_state` für einen expliziten Namen
`RmmDiscoveryFixture…` mit ASCII-Buchstaben/Ziffern/Unterstrich/Bindestrich und
Zielzustand `running` oder `stopped`. Eigener Agent/Helper, fremde Dienste,
`restarted`, freie SYSTEM-Skripte, Pakete, Logs und Reboots erhalten keine
Berechtigung aus diesem Slice. Eine leere Allowlist erlaubt keine Wirkung.
Ausgabe und Laufzeit werden zusätzlich auf 64 KiB und den konkreten Scopewert
begrenzt. Die Policy ersetzt keine unabhängige lokale Helperpolicy oder deren
strengere SCM-/Prozess-/Abhängigkeits-/Recoveryprüfungen.
Der spätere tatsächliche Agent muss alle folgenden Caps besitzen; derzeit
veröffentlicht diese Änderung keine davon:
| Pflicht | Zweck |
| --- | --- |
| `windows.base/1`, ohne `linux.base/1` | Eindeutige Windowsplattform |
| `rmm.sync.v1` | Signed-Sync-Vertrag |
| `helper.system.v1` | Getrennte SYSTEM-Helperrolle |
| `helper.policy.sha256:<exakter Hash>` | Übereinstimmende lokale Policy |
| `helper.binary.sha256:<exakter Hash>` | Übereinstimmendes Helperimage |
| `system:set_service_state` und `set_service_state` | Expliziter typisierter SCM-Adapter |
## Unveränderte Genehmigungsgrenze und zusätzliche Verweigerungen
Planung und Submit prüfen `system:execute` sowohl gegen den tatsächlichen
Principal-Scope als auch gegen die aktuellen DB-Mitgliedschaftsrechte. Submit
prüft zusätzlich die konkrete Policy für seinen Akteur. Revalidation prüft die
unveränderlichen Jobs erneut für den ursprünglichen Planprincipal. Eine neue
WebUI-Genehmigung verlangt denselben zusätzlichen Scope und die aktuelle Policy
für den interaktiven Genehmiger. Bestehende `pending_approval`-Persistenz,
Plan-/Hashbindung und interaktive UI-Grenze bleiben erhalten. Keine neue
MCP-/API-/DB-Genehmigungsabkürzung existiert.
Delivery und Start prüfen die aktuelle Policy erneut für Planprincipal und
Genehmiger. Ein Startgrant für `root` **oder** `system` benötigt zusätzlich
`helper_sync_ready` und tatsächlich einen nichtleeren Helperjournal-Eintrag im
gebundenen Server-Synczustand. Sync setzt ohne Helperjournal keine Ready-Lease
für solche Versuche und gibt keinen Unlock aus. Die Verarbeitung erhaltener
Outcomes bleibt bestehen; ein fehlender Helper darf keine zweite Wirkung oder
blindes Wiederholen autorisieren.
## Tatsächliche Prüfungen und verbleibende Arbeit
Vier neue gezielte Tests bestanden: exakte Ziel-/Principal-/Hashbindung,
getrennte Root-/SYSTEM-Scopes und Helperanforderung, enge SCM-Wirkungsgrenze,
sowie Datei-/Owner-/Mode-/Symlink-/Parent-/Größenfehler. Neun bestehende
Rootpolicy-/Logpolicytests bestanden einschließlich einer zusätzlichen
Windows-Relabel-Verweigerung. Server-Clippy mit `--all-targets -D warnings` bestand.
Danach dieselben13 exakt benannten Tests nativ auf der Cloud-Linux-VM bestanden,
Fall `13b11ce4-7462-4bc4-9bbb-113bf5c9b034`, Release-Testbinary
`ca1df8b28a8ad5e2183fcbb876a35a5c34acb43c2ad41e90a7f81fb48856c884`,
Manifest `build-09ea8b57…`.52 Buildquellen und der feste Runner sind gehasht.
Jeder Test lief einzeln mit geleerter Umgebung, privatem Tempverzeichnis,
eigener Netzwerknamespace und begrenzter Laufzeit/Ausgabe;13 bestanden,
0 fehlgeschlagen,0 ignoriert. Der Datei-Guard verweigerte auch den unsicheren
nicht-sticky Vorfahren und akzeptierte den vertrauenswürdigen Sticky-Fall.
Runner: [`cloud_windows_policy_native.py`](../deploy/cloud_windows_policy_native.py).
Das ist ein nativer Linux-Unitnachweis der zentralen Regeln, keine DB-/WebUI-/
Windows-SYSTEM-Jobabnahme. Es wurden kein Serverdaemon oder DB-Test gestartet,
keine Dienste ersetzt, Schlüssel/Journale gelesen oder RMM-Jobs erzeugt.
Geschützte Rohbelege liegen unter `devstate/server-windows-policy/<Fall>/`.
Der nächste kleine Integrationspatch bleibt **geplant, nicht ausgeführt**:
Nach nativer Helper-/Clock-/SCM-Qualifikation im Shared Domain ausschließlich den
Windows-`SetServiceState`-Zweig für `system` und diese expliziten Caps ergänzen;
alle anderen Windows-SYSTEM-Aktionen bleiben verweigert. Danach im Agenten den
bereits typisierten Helper-Execute-Pfad mit unabhängiger Helper-Sync-Bestätigung
und erhaltenem Grant-/Outcomeledger anbinden. Die WebUI muss die konkrete
SYSTEM-Identität sichtbar im unveränderlichen SCM-Plan darstellen und weiterhin
interaktiv genehmigen. Erst nach gesondert geprüftem Policy-/Rechtesetup folgen
neue tatsächliche WebUI-Pläne und unabhängige OS-Nachprüfungen. Spezifikation und
Projektentscheidungen werden vom Eltern-Orchestrator nach dem Review abgestimmt.