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

9.7 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. 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. 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 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 und wird separat umgesetzt.