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

7.3 KiB

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