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

158 lines
9.7 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. Der neue enge
Domain-/WebUI-SCM-Schnitt ist inzwischen separat implementiert und zuerst mit
15 reinen Domain-Vertragstests zuerst auf Cloud-Linux und danach auf Windows geprüft.
Keine bestehende Linux-Job-/Grantserialisierung wurde geändert.
`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>/`.
## Enger Domain-/WebUI-Schnitt und erster Linuxnachweis
`Action::available_for` verlangt bei SYSTEM ausschließlich typisiertes SCM mit
Windowsbasis ohne Linuxbasis, Helper-/Sync-/SCM-Caps und `running|stopped`.
Alle anderen SYSTEM-Aktionen werden auch bei Linuxcaps schon hier verweigert;
die zentrale Policy bleibt eine zusätzliche unabhängige Grenze. Linux-Root-
und Agentservice-Verhalten sowie die Goldenbytes bleiben erhalten.
Die WebUI bietet SYSTEM ausdrücklich nur für diese Aktion und mit eigenem
`system:execute` an. Sie prüft feste Fixturekennung, Zustand und120s/64KiB-
Obergrenzen. Die konkrete Identität/Dienst-/Asset-/Zustandsbindung stammt in der
Detailansicht aus den gespeicherten Planbytes. Unlesbare Bytes erzeugen einen
Fehlerhinweis; die strenge Hash-/Genehmigungsprüfung bleibt bestehen. Keine
automatische Rechteerhöhung und keine zusätzlichen Genehmigungscontrols.
Lokal15 Domain- und26 betroffene Webtests, Clippy, Typecheck und Webbuild
bestanden. Nach unabhängigem Review wurden zwei konkrete Fehler behoben:
SYSTEM durfte nicht in den Linux-Fallback anderer Aktionen fallen; fehlerhafte
Planbytes dürfen den Renderer nicht abstürzen lassen. Die früheren lokalen
Belege bleiben getrennt erhalten.
Danach15 Domain-Bibliothekstests auf der Cloud-Linux-VM tatsächlich bestanden,
Fall `0dd12ed9-cc0b-407e-8b27-9334527ef91d`, Binary `635a6dd6…`, Manifest
`build-162ecea1…`.0 fehlgeschlagen/ignoriert/gefiltert, geleerte Umgebung und
eigene Netzwerknamespace; keine Dienste, DB-/RMM-Jobs oder Zielwirkung.
[`domain_scm_acceptance.py`](../deploy/domain_scm_acceptance.py) verlangt diesen
exakten Linuxbeleg vor der Windows-Unitphase desselben Manifests.
Geschützte Rohbelege liegen unter `devstate/domain-scm/`.
Danach dieselben15 Tests tatsächlich auf der Windows-VM bestanden, Fall
`60e404a2-242b-4797-9385-237ad2758207`, Binary `bdadedef…`,0 fehlgeschlagen,
ignoriert oder gefiltert. Der Windowsintent bindet den Hash des originalen
Linux-Passbelegs. Das ist ein Administrator-Bootstrap-Unitnachweis, keine
LocalService-/Helper-/SCM- oder WebUI-Aktionsabnahme. Eine vorherige SSH-
Verbindungsstörung lag bereits vor Artefaktbereitstellung und Unitstart.
Readonlyprüfung bestätigte fehlendes Artefakt und fehlenden entfernten Testfall;
erst danach wurde die noch nicht erreichte erste Unitphase im selben lokalen
Fall fortgesetzt. Kein ausgeführter Test wurde wiederholt und kein Fehlerbeleg
in einen Erfolg umgeschrieben.
Der vorbereitete Runtime-/Helperclient-SCM-Pfad ist **noch nicht freigegeben**:
Ein unabhängiger Quellreview fand den Vor-Delegation-Abbruchfall, bei dem eine
lokale SYSTEM-Consumption ohne Helperconsumption den späteren Sync dauerhaft
verweigern würde. Diese Invariante wird vor einer Runtimequalifikation korrigiert;
keine Abschwächung des gemeinsamen Helperabgleichs. Neue Capabilities, Jobs,
Clockqualifikation oder Helperwirkungen wurden dadurch nicht aktiviert.
Tatsächliche Helper-/Clock-/SCM-/WebUI- und Policy-/Rechtesetupabnahmen bleiben
eigenständige nächste Schritte. Die SCM-Basis stammt aus Spezifikation1.16;
der inzwischen präzisierte Nichtstartvertrag ist
[Spezifikation1.17](windows-system-abandon.md) und wird separat umgesetzt.